# 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` (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/
## Other tools used for Volumetric Regimes
See: `./tools/`
Most of these tools are used for PDF manipulation.
With a big thanks to OSP's PDFUTILS! < http: / / osp . kitchen / tools / pdfutils / >
### OSP-tools.pdfutils: `color_convert.sh`
**Convert PDF RGB to only-Black**
This will convert an RGB PDF (even if it appears only black) to `input-K.pdf` .
./color_convert.sh black input.pdf input-K.pdf
Link: < http: / / osp . kitchen / tools / pdfutils / >
### OSP-tools.pdfutils: `rgb2cmyk.sh`
**Convert PDF from RGB to CMYK**
Dependencies:
- `gs` (Ghostscript)
- `pdftops`
- `control.txt`
- `apple_to_jNP_photo.icc`
- `apple_to_jNP_neutral.icc`
This will convert a PDF to `input-cmyk.pdf` .
Usage:
./rgb2cmyk.sh input.pdf
Link: < http: / / osp . kitchen / tools / pdfutils / >
### OSP-tools.pdfutils: `rgb2cmyk-overprint.sh`
**Convert PDF from RGB to CMYK, with overprint enabled on the whole document**
Dependencies:
- `gs` (Ghostscript)
- `pdftops`
- `control.txt`
- `apple_to_jNP_photo.icc`
- `apple_to_jNP_neutral.icc`
This will convert a PDF to `input-CMYK-op.pdf` .
Usage:
./rgb2cmyk-overprint.sh input.pdf
Link: < http: / / osp . kitchen / tools / pdfutils / >
### OSP-tools: `resample.sh`
Dependencies:
- `gs` (Ghostscript)
This will change the resolution of a PDF.
Usage:
./resample input.pdf 150
### Custom VR tools: `make-images-bw.sh`
Dependencies:
- `imagemagick`
This will create a copy of an image folder, with all images converted to BW.
Usage:
./make-images-bw.sh ./images-folder/
### Custom VR tools: `convert-to-PDFX-3-2002.sh`
Dependencies:
- `texlive-xetex` (xelatex)
This will convert a PDF into the PDFX/3:2002 format + edit the PDF metadata.
Edit PDF metadata:
Open the xelatex template (`xelatex-PDFX-3-2002.template.tex`) and edit the metadata on line 7-12.
Usage:
convert-to-PDFX-3-2002.sh input.pdf output.pdf
### Custom VR tools: `separatecolors.sh`
Dependencies:
- `gs` (Ghostscript)
This will convert the PDF into a set of TIFF files, which is useful to inspect how the colors are spread over the different color "plates".
The script generates one TIFF for:
- full color
- cyan plate
- magenta plate
- yellow plate
- black plate
Usage:
./simulateoverprint.sh input.pdf
### Other useful tools
- Check metadata of PDF: `pdfinfo filename.pdf`
- Check color space of PDF: `pdfimages -list filename.pdf`
- Check colors of PDF: `identify -verbose filename.pdf`
