volumetric-regimes-book/README.md

# Volumetric Regimes (book)

`MediaWiki Unfolded page > update.py > MediaWiki API > Unfolded HTML page + images (saved to file) > Jinja template > CSS + Paged.js > PDF`

<https://volumetricregimes.xyz/>

<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`
* `pdfunite`
* `resample`

## 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/