doc/mkdocs/build.sh

   1 #!/bin/sh -e
   2
   3 # Patch Python-Markdown
   4 MARKDOWN_FILE=$(pip show markdown | awk '/Location/ { print $2 }')/markdown/extensions/codehilite.py
   5 patch -N -r - $MARKDOWN_FILE lua_highlight.patch || true
   6
   7 # Split lua_api.txt on top level headings
   8 cat ../lua_api.txt | csplit -sz -f docs/section - '/^=/-1' '{*}'
   9
  10 cat > mkdocs.yml << EOF
  11 site_name: Minetest API Documentation
  12 theme:
  13     name: readthedocs
  14     highlightjs: False
  15 extra_css:
  16     - css/code_styles.css
  17     - css/extra.css
  18 markdown_extensions:
  19     - toc:
  20         permalink: True
  21     - codehilite
  22 plugins:
  23     - search:
  24         separator: '[\s\-\.\(]+'
  25 nav:
  26 - "Home": index.md
  27 EOF
  28
  29 mv docs/section00 docs/index.md
  30
  31 for f in docs/section*
  32 do
  33         title=$(head -1 $f)
  34         fname=$(echo $title | tr '[:upper:]' '[:lower:]')
  35         fname=$(echo $fname | sed 's/ /-/g')
  36         fname=$(echo $fname | sed "s/'//g").md
  37         mv $f docs/$fname
  38         echo "- \"$title\": $fname" >> mkdocs.yml
  39 done
  40
  41 mkdocs build --site-dir ../../public