|
| 1 | +#!/bin/bash |
| 2 | + |
| 3 | +# Usage: ./docs-devsite.sh |
| 4 | + |
| 5 | +set -e |
| 6 | + |
| 7 | +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" |
| 8 | +DOCS_DIR="$SCRIPT_DIR/docs" |
| 9 | +ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)" |
| 10 | + |
| 11 | +# Copy root README.md to getting-started.md |
| 12 | +mkdir -p $DOCS_DIR |
| 13 | +echo "Copying root README.md to help/docs/getting-started.md..." |
| 14 | +cp "$ROOT_DIR/README.md" "$DOCS_DIR/getting-started.md" |
| 15 | + |
| 16 | +# Generate toc.yaml |
| 17 | +echo "Generating toc.yaml in $ABS_DIR..." |
| 18 | +TOC_FILE="$DOCS_DIR/toc.yaml" |
| 19 | + |
| 20 | +# Write the top-level structure |
| 21 | +echo "-" > "$TOC_FILE" |
| 22 | +echo " uid: product-neutral-guides" >> "$TOC_FILE" |
| 23 | +echo " name: 'Client library help'" >> "$TOC_FILE" |
| 24 | +echo " items:" >> "$TOC_FILE" |
| 25 | +echo " -" >> "$TOC_FILE" |
| 26 | +echo " name: 'Getting started'" >> "$TOC_FILE" |
| 27 | +echo " href: getting-started.md" >> "$TOC_FILE" |
| 28 | + |
| 29 | +# Find .md files and append to TOC |
| 30 | +for f in $(ls "$ROOT_DIR"/docs/*.md | sort); do |
| 31 | + if [ -f "$f" ]; then |
| 32 | + filename=$(basename "$f") |
| 33 | + echo "Copying $filename to help/docs/$filename..." |
| 34 | + cp $f $DOCS_DIR |
| 35 | + case "$filename" in |
| 36 | + "authentication.md") |
| 37 | + name="Authentication" |
| 38 | + ;; |
| 39 | + "faq.md") |
| 40 | + name="FAQ" |
| 41 | + ;; |
| 42 | + "troubleshooting.md") |
| 43 | + name="Troubleshooting" |
| 44 | + ;; |
| 45 | + "getting-started.md") |
| 46 | + name="Getting Started" |
| 47 | + ;; |
| 48 | + *) |
| 49 | + name="${filename%.md}" # Fallback |
| 50 | + name="$(echo "$name" | awk '{print toupper(substr($0,1,1))substr($0,2)}')" |
| 51 | + ;; |
| 52 | + esac |
| 53 | + echo " -" >> "$TOC_FILE" |
| 54 | + echo " name: '$name'" >> "$TOC_FILE" |
| 55 | + echo " href: $filename" >> "$TOC_FILE" |
| 56 | + fi |
| 57 | +done |
| 58 | + |
0 commit comments