1all: update_apis_and_listings html pdf 2 3html: 4 # create docs/ports/existing_ports.md + adds images 5 ./ports2markdown.py 6 # re-create docs_final 7 cp -r docs docs_final 8 # docs -> docs_final 9 ./markdown2mkdocs.py 10 mkdocs build --clean 11 # ./mkdocs2html.py 12 13pdf: 14 mkdir -p latex 15 cp -r docs/picts latex 16 # create docs/ports/existing_ports.md 17 ./ports2markdown.py 18 # create latex/btstack_generated.md -> latex/btstack_final.tex 19 ./markdown2tex.py 20 cp btstack_gettingstarted.tex latex 21 cp docs/ports/*.jpg latex 22 cd latex && pdflatex btstack_gettingstarted.tex && pdflatex btstack_gettingstarted.tex 23 mv latex/btstack_gettingstarted.pdf btstack.pdf 24 rm -rf latex tmp 25 26 27preview: update_apis_and_listings html 28 # race condition, open browser before startnig MKdocs 29 open http://127.0.0.1:8000 30 mkdocs serve 31 32update_apis_and_listings: 33 sed -e "s|../doc/manual/docs/||g" ../../chipset/README.md > docs/chipsets.md 34 rm -rf tmp 35 mkdir tmp 36 # create docs/appendix/apis.md 37 ./update_apis.py 38 # create docs/examples/examples.md 39 ./update_listings.py 40 41clean: 42 rm -rf docs_final tmp btstack *.pdf latex/btstack_generated.* latex/btstack_final.tex 43 rm -rf docs/appendix/apis.md docs/appendix/index.md docs/examples/examples.md docs/chipsets.md 44 rm -rf latex btstack help 45 46 47 48