From a30bd1068e434c253cb558f12f94ed29dddf85a7 Mon Sep 17 00:00:00 2001 From: manetta Date: Wed, 6 Apr 2022 17:33:39 +0200 Subject: [PATCH] adding more materials to the README --- README.md | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 613c2a3..54c3a1f 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,34 @@ # Volumetric Regimes (book) - +`MediaWiki Unfolded page > update.py > MediaWiki API > Unfolded HTML page + images (saved to file) > Jinja template > CSS + Paged.js > PDF` - + -`MediaWiki > MediaWiki API > Unfolded HTML page > Jinja template > CSS + Paged.js > PDF` + +## Using the wiki-to-pdf publishing pipeline + +* `make wiki`: downloads the materials from the `Unfolded wiki page` and generates `Unfolded.html` +* `make run`: runs a local server on port 8000 to preview the PDF at `http://localhost:8000/Unfolded.html` + +## Tools + +* PDF rendering: Paged.js () * hyphens: hyphenology, see `templates/template.html` and `js/runHyphens.js` * baseline grid: px calculation + manual shifts of images in `css/print.css` -* footnotes: are structured by MediaWiki and are wrapped in HTML elements when the content is pulled using the MediaWiki API \ No newline at end of file +* footnotes: are structured by MediaWiki and are wrapped in HTML elements when the content is pulled using the MediaWiki API + +## Notes and contingent documentation + +* Notes, style/structure guide and a process log can be found here: +* An attempt to document why sentences dissapear in Paged.js: + +## Publishing pipeline continuations + +The choice to work with Mediawiki and web-to-print techniques, continues practices through which the following publications and tools emerged: + +* html2print (OSP), http://osp.kitchen/tools/html2print/ +* Mondoteque (Constant, André Castro, Alexia de Visscher) https://www.books.constantvzw.org/home/mondotheque, https://www.mondotheque.be/wiki/index.php?title=The_radiated_book +* DiVersions (Constant, OSP) https://www.books.constantvzw.org/home/diversions-v2, https://diversions.constantvzw.org/, https://diversions.constantvzw.org/wiki/index.php?title=PublicationUnfolded, http://osp.kitchen/work/diversions/, https://gitlab.constantvzw.org/osp/work.diversions +* web-to-pdf (TiTiPi, Martino Morandi) http://titipi.org/wiki/index.php/Wiki-to-pdf, https://gitlab.constantvzw.org/titipi/wiki-to-pdf, http://titipi.org/wiki/index.php/Wiki-to-pdf-manual, http://titipi.org/wiki/index.php/Unfolding:Infrastructural_Interactions, http://titipi.org/wiki-to-pdf/pagedjs/Infrastructural_Interactions +