wiki-to-print/README.md

# wiki-to-print

Slightly adapted version of <https://github.com/hackersanddesigners/wiki2print>, in continuation of <https://gitlab.constantvzw.org/titipi/wiki-to-pdf> and <https://git.vvvvvvaria.org/mb/volumetric-regimes-book>.

Installed at: <https://cc.vvvvvvaria.org/wiki/Wiki2print>.

The code of the wiki-to-print instance that is running on the *creative crowd* server is published at [Varia's Gitea](https://git.vvvvvvaria.org/varia/wiki-to-print) under the [CC4r](https://constantvzw.org/wefts/cc4r.en.html) license.

## Continuations

This project is inspired by and builds upon several previous iterations
of and experiments with mediawiki-to-pdf workflows:

-   [Hackers & Designer](https://hackersanddesigners.nl/)\'s work on
    [Making
    Matters](https://wiki2print.hackersanddesigners.nl/wiki/Publishing:Making_Matters_Lexicon)
-   [TITiPI](http://titipi.org/)\'s work on [Infrastructural
    Interactions](http://titipi.org/wiki-to-pdf/unfold/Infrastructural_Interactions)
-   [Manetta](https://git.vvvvvvaria.org/mb)\'s work on [Volumetric
    Regimes](https://volumetricregimes.xyz/index.php?title=Volumetric_Regimes)
-   [Constant](https://constantvzw.org/site/)\'s and
    [OSP](https://osp.kitchen/)\'s work on
    [Diversions](https://diversions.constantvzw.org/wiki/index.php?title=Main_Page)
-   [many
    more\...](https://constantvzw.org/wefts/webpublications.en.html)

Writing and notes on wiki printing practices:

* <https://cc.vvvvvvaria.org/wiki/Wiki2print>
* <https://titipi.org/wiki/index.php/Wiki-to-pdf>
* <https://pad.vvvvvvaria.org/wiki-printing>

## How does it work?

When you create a page in the `Pdf` namespace on <https://cc.vvvvvvaria.org/wiki/>, it will load the wiki-to-print buttons in the navigation bar:

-   `CSS!`
-   `View HTML`
-   `View PDF`
-   `Update text`
-   `Update Media`

You can transclude pages into this page, structure your publication and edit the CSS.

- When you click `View HTML`: the Flask application returns you a HTML version of the page.
- When you click `View PDF`: the Flask application returns you a HTML version of the page, loaded with Paged.js. The HTML page is rendered into pages, giving you a preview of the PDF. You can use the inspector to work on the lay out.
- When you click `Update text`: the Flask application makes a copy of all the text of the page and saves it to a file on the server (in the `static` folder).
- When you click `Update media`: the Flask application downloads all the images on the page and saves tem to a folder on the server (in the `static` folder).

## In this repository

* **command-line**: Python script to work on a local copy of your publication
* **wiki-to-print**: Flask application that renders a wiki page into HTML