btstack/doc/manual/Makefile

55 lines
1.5 KiB
Makefile
Raw Normal View History

all: update_content html pdf
2018-01-08 12:39:43 +01:00
html:
2017-12-23 22:22:41 +01:00
# docs -> docs_final
2015-06-18 16:33:34 +02:00
./markdown2mkdocs.py
# generate HTML
mkdocs build --clean
# post-process HTML
./mkdocs2html.py
pdf:
rm -rf latex
2015-06-05 17:38:11 +02:00
mkdir -p latex
cp -r docs/picts latex
2021-05-25 08:53:22 +02:00
# create latex/btstack_gettingstartec.tex with version
./update_getting_started.sh
2017-12-23 22:22:41 +01:00
# create latex/btstack_generated.md -> latex/btstack_final.tex
./markdown2tex.py
cp docs/ports/*.jpg latex
2015-06-05 17:38:11 +02:00
cd latex && pdflatex btstack_gettingstarted.tex && pdflatex btstack_gettingstarted.tex
2015-06-18 16:33:34 +02:00
mv latex/btstack_gettingstarted.pdf btstack.pdf
preview: update_content html
2020-10-06 11:52:23 +02:00
# race condition, open browser before starting MKdocs server
open http://127.0.0.1:8010
mkdocs serve -a localhost:8010
update_content:
sed -e "s|../doc/manual/docs-template/||g" ../../chipset/README.md > docs-template/chipsets.md
rm -rf tmp
mkdir tmp
2020-10-06 11:52:23 +02:00
# create mkdocs.yml
./update_mkdocs_yml.sh
# create docs-template/appendix/apis.md
./update_apis.py
# create docs-template/examples/examples.md
./update_listings.py
# create docs-template/ports/existing_ports.md
./ports2markdown.py
# create docs-template/gatt_clients.md and docs-template/gatt_services.md
./update_gatt_services.py
# re-create docs_final
rm -rf docs
cp -r docs-template docs
clean:
rm -rf docs tmp btstack *.pdf latex/btstack_generated.* latex/btstack_final.tex mkdocs.yml
rm -rf docs-template/appendix/apis.md docs-template/examples/examples.md docs-template/chipsets.md
rm -rf docs-template/gatt_clients.md docs-template/gatt_services.md
rm -rf api_index.md
2017-12-23 22:22:41 +01:00
rm -rf latex btstack help
2016-03-09 10:34:41 +01:00