diff options
Diffstat (limited to 'info/drawing-with-metapost/README.md')
-rw-r--r-- | info/drawing-with-metapost/README.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/info/drawing-with-metapost/README.md b/info/drawing-with-metapost/README.md new file mode 100644 index 0000000000..5b84892242 --- /dev/null +++ b/info/drawing-with-metapost/README.md @@ -0,0 +1,37 @@ +# Drawing-with-Metapost + +This project provides a document that discusses how to draw technical diagrams +with John Hobby's Metapost language. It includes over 200 illustrations +created with Metapost, complete with source code as inspiration and examples. +The intended level is for intermediate to advanced users rather than complete +beginners. For introductions, tutorials, and other articles about Metapost, +see http://www.tug.org/metapost.html + +Start with "Drawing-with-Metapost.pdf" in the top directory. + +The `src` directory contains +- the TeX source for the main document +- the style file used for marking up Metapost source code +- the Metapost source for each illustration used in the main document +- the corresponding PDF file created from the MP source + +You might like to read the main document first, but you might also like to +browse through the PDFs in the src directory, and when you find one that is +interesting, have a look at the corresponding MP source file. There is a +one-to-one match between the PDF names and the MP source names, so +"apollonius.pdf" is created from "apollonius.mp". The src directory contains +a few drawings that are not (yet) included in the main document. + +To update the main PDF document I follow these steps + +- build any new or updated Metapost source files with `lualatex` to create PDFs in the src directory +- build the main tex file with `lualatex -output-directory=.. -recorder Drawing-with-Metapost` +- run a Python script to read the .fls and `git add` all the files used +- git commit and push + +Toby Thurston -- 14 Apr 2023 + +Copyright (c) 2023 by Toby Thurston. This material may be distributed only +subject to the terms and conditions set forth in the Open Publication License, +v1.0 or later (the latest version is presently available at +http://www.opencontent.org/openpub/). |