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.
 
 
 
 
mb 2c3d8d82d2 Update 'README.md' 1 year ago
command-line adding tools to the repo + documentation in the README 1 year ago
snapshots the final files for the printed versiongit status 2 years ago
web-interface disabling the web interfaces, to not get confused between versions 2 years ago
.gitignore sync web interface 2 years ago
LICENSE.txt 'LICENSE.txt' updaten 3 years ago
README.md Update 'README.md' 1 year ago

README.md

Wiki-to-print

Wiki-to-print is used to make Volumetric Regimes.

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-print 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

Publishing pipeline continuations

The choice to work with Mediawiki and web-to-print techniques, continues practices through which the following publications and tools emerged:

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