Tools for generating the Volumetric Regimes book https://volumetricregimes.xyz/ (wiki-to-print, using Paged.js)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

45 lines
2.6 KiB

3 years ago
# Volumetric Regimes (book)
`MediaWiki Unfolded page > update.py > MediaWiki API > Unfolded HTML page + images (saved to file) > Jinja template > CSS + Paged.js > PDF`
3 years ago
<https://volumetricregimes.xyz/>
3 years ago
<https://volumetricregimes.xyz/index.php?title=Unfolded>
## 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 (<https://pagedjs.org/>)
* generate HTML: `update.py` is used to download the *Unfolded* wiki page to a local HTML file, download new images and rewrite/replace structural elements and details
* hyphens: hyphenology, see `templates/template.html` and `js/runHyphens.js`
* baseline grid: px calculation + manual shifts of images in `css/print.css` + `csss/baseline.css`
* footnotes: are structured by MediaWiki and are wrapped in HTML elements when the content is pulled using the MediaWiki API
* pre-press: see the folder `tools` for different scripts to convert PDF color space, PDF format, PDF resizing, and more
## Software dependencies
* `jinja2==3.1.2`
* `markupsafe==2.0.1`
* `pdftk` (adding Multi)
* `pdfunite` (adding Multi)
* `resample` (PDF resizing)
* `xelatex` (PDF formatting)
## Notes and contingent documentation
* Notes, style/structure guide and a process log can be found here: <https://pad.vvvvvvaria.org/volumetric-regimes-in-process>
* An attempt to document why sentences dissapear in Paged.js: <https://pad.vvvvvvaria.org/paged.js-missing-sentences>
## Publishing pipeline continuations
The choice to work with Mediawiki and web-to-print techniques, continues practices through which the following publications and tools emerged:
* 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
* 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
* 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
* html2print (OSP), http://osp.kitchen/tools/html2print/