Add demo docs (#2246)

.gitmodules

@@ -8,3 +8,6 @@
 [submodule "content-modules/opentelemetry-specification"]
 	path = content-modules/opentelemetry-specification
 	url = https://github.com/open-telemetry/opentelemetry-specification.git
+[submodule "content-modules/opentelemetry-demo"]
+	path = content-modules/opentelemetry-demo
+	url = https://github.com/open-telemetry/opentelemetry-demo

hugo.yaml

@@ -54,6 +54,8 @@ params:
   github_repo: https://github.com/open-telemetry/opentelemetry.io
   github_branch: main
   gcs_engine_id: bde3d634eca9cd335
+  # The following mermaid config can be dropped after we update Docsy to v0.6.0 or later
+  mermaid: { enable: true }
 
   ## Social media image path, such as Open Graph's og:image
   #
@@ -169,6 +171,8 @@ services:
 
 module:
   mounts:
+    - source: tmp/demo/docs
+      target: content/docs/demo
     - source: tmp/specification
       target: content/docs/reference/specification
     - source: content/en

scripts/adjust-spec-pages.pl

@@ -72,6 +72,8 @@ ()
     next;
   }
 
+  # SPECIFICATION custom processing
+
   s|\(https://github.com/open-telemetry/opentelemetry-specification\)|(/docs/reference/specification/)|;
   s|\.\./semantic_conventions/README.md|$semConvRef| if $ARGV =~ /overview/;
 
@@ -105,5 +107,12 @@ ()
   # Make website-local page references local:
   s|https://opentelemetry.io/|/|g;
 
+  # DEMO DOCS custom processing
+
+  s|\./(services/\w+)\.md|$1/|g if $ARGV =~ /demo.docs._index/;
+  s/#demo-screenshots/./;
+  s|(/vendors/)|/ecosystem$1|g;
+  s|(\.\.\/)+(src/)|https://github.com/open-telemetry/opentelemetry-demo/blob/main/$2|g if $ARGV =~ /demo.docs/;
+
   print;
 }

scripts/cp-spec-pages.sh

@@ -1,8 +1,10 @@
 #!/usr/bin/env bash
 
 BASE_DIR=$(dirname $0)
+DEST_BASE=tmp
+
 SPEC=content-modules/opentelemetry-specification/specification
-DEST=tmp/specification
+DEST=$DEST_BASE/specification
 
 rm -Rf $DEST
 mkdir -p $DEST
@@ -16,3 +18,21 @@ FILES=$(find $DEST -name "*.md")
 $BASE_DIR/adjust-spec-pages.pl $FILES
 
 echo "Specification pages copied and processed."
+
+# Demo docs
+
+SRC=content-modules/opentelemetry-demo/docs
+DEST=$DEST_BASE/demo/docs
+
+rm -Rf $DEST
+mkdir -p $DEST
+cp -R $SRC/* $DEST/
+
+find $DEST/ -name "README.md" -exec sh -c 'f="{}"; mv -- "$f" "${f%README.md}_index.md"' \;
+
+# To exclude a file use, e.g.: -not -path '*/some-path/_index.md'
+FILES=$(find $DEST -name "*.md")
+
+$BASE_DIR/adjust-spec-pages.pl $FILES
+
+echo "Demo doc pages copied and processed."