diff --git a/book/makefile b/book/makefile index 06a5b56..ce1dc06 100644 --- a/book/makefile +++ b/book/makefile @@ -131,54 +131,51 @@ help: @echo "" @echo "default: builds the book in pdf format (serif)" @echo "" - @echo "all: pdf serif and sans-serif accessible version, as well as ebooks" - @echo " in colour and black&white versions" + @echo "Releases:" + @echo " all: pdf serif and sans-serif accessible version, ebooks in colours" + @echo " and black&white versions and the website" @echo "" - @echo "bake: same as build all" + @echo " bake: same as build all" + @echo "" + @echo " release_serif: build serif only version of pdf and ebook" + @echo " release_sans_serif: build sans-serif/accessible version of pdf" + @echo "" + @echo "Portable Document Format (pdf):" + @echo " build_sans_serif_pdf: build accessible pdf only (same as release_sans_serif)" + @echo " build_serif_pdf: build serif pdf only" + @echo " build_pdf: builds both serif and accessible pdf" + @echo "" + @echo "Ebooks (epub):" + @echo " build_ebook: builds only the colour ebook" + @echo " build_bw_ebook: builds the low res black & white ebook" + @echo "" + @echo "Website:" + @echo " website: build the static website from LaTeX sources and post-process it" + @echo " html: build the static website from LaTeX sources _without_ post-processing" @echo "" @echo "check: runs static analysis checker on LaTeX source to spot" @echo " programming or typographic mistakes" @echo "" - @echo "clean: delete all intermediate files keep targets (pdf/ebooks/website)" - @echo "" - @echo "mrproper: delete all generated files intermediate and pdf/ebooks/website" + @echo "Cleanup:" + @echo " mrproper: delete all generated files intermediate and pdf/ebooks/website" + @echo " clean: delete all intermediate files keep targets (pdf/ebooks/website)" @echo " clean_figures: delete intermediate TikZ files" @echo " clean_website_build: delete intermediate website files" @echo " clean_ebook_build: delete intermediate ebook files" @echo "" - @echo "build_pdf: builds both serif and accessible pdf" - @echo "" - @echo "build_ebook: builds only the colour ebook" - @echo "" - @echo "build_booklet: builds only the short booklet" - @echo "" - @echo "build_bw_ebook: builds the low res black & white ebook" - @echo "" - @echo "build_sans_serif_pdf: build accessible pdf only" - @echo "" - @echo "build_serif_pdf: build serif pdf only" - @echo "" - @echo "figures: build TikZ figures" - @echo "" - @echo "release_serif: build serif only version of pdf and ebooks" - @echo "release_sans_serif: build sans-serif/accessible version of pdf" - @echo "" - @echo "website: build the static website from LaTeX sources and post-process it" - @echo "html: build the static website from LaTeX sources _without_ post-processing" - @echo "" @echo "Debug targets:" @echo "" - @echo "quick: compiles serif_pdf but runs lulatex only once" + @echo "figures: build TikZ figures only" @echo "" - @echo "quick_ebook: compiles ebook but runs lulatex only once" + @echo "Quick builds:" + @echo " quick: compiles serif_pdf but runs lulatex only once" + @echo " quick_ebook: compiles ebook but runs lulatex only once" + @echo " quick_booklet: compiles booklet but runs lulatex only once" @echo "" - @echo "quick_booklet: compiles booklet but runs lulatex only once" - @echo "" - @echo "show_tools_version: Show version of tools used on the build machine" - @echo "" - @echo "print-X: print makefile variable X" - @echo "" - @echo "printvars: print all variables in the makefile" + @echo "Dump informations:" + @echo " show_tools_version: Show version of tools used on the build machine" + @echo " printvars: print all variables in the makefile" + @echo " print-X: print makefile variable X" @echo "" @echo "set DEBUG i.e make DEBUG=1 build_ebook to add debug flags to commands"