Wiki-to-pdf-manual: Difference between revisions

From titipi
Jump to navigation Jump to search
No edit summary
No edit summary
Line 19: Line 19:
For now, when using the transclusion method, each page to be transcluded needs to include the following snippet:
For now, when using the transclusion method, each page to be transcluded needs to include the following snippet:


  <nowiki><pre><span class="hidden-tweaks" id={{PAGENAME}}></span></pre></nowiki>
  <nowiki><span class="hidden-tweaks" id={{PAGENAME}}></span></nowiki>


CSS can be added in the tab ''''Print CSS''''
CSS can be added in the tab ''''Print CSS''''

Revision as of 15:37, 21 October 2021

Publishing with wiki-to-pdf

wiki-to-pdf is a contraption for ongoing publication efforts. It uses the characteristics of Mediawiki for collaborative editing together with the pagedjs library to produce paginated, elastic, malleable and re-editable publications for printing and on-line reading.

Code repository: http://gitlab.constantvzw.org/titipi/wiki-to-pdf/

These tools are based on the work of Manetta Berends for the Volumetric Regimes book https://git.vvvvvvaria.org/mb/volumetric-regimes-book/

titipi wiki-to-pdf

To initiate a new publication, create a page in this wiki in the unfolding namespace:

http://titipi.org/wiki/index.php/Unfolding:NAMEOFPUBLICATION

On this page, add content or transclude pages that are published elsewhere on the wiki.

{{:Peripheral politics}}
{{:The politics of listening}}
{{:word2complex}}

For now, when using the transclusion method, each page to be transcluded needs to include the following snippet:

<span class="hidden-tweaks" id={{PAGENAME}}></span>

CSS can be added in the tab 'Print CSS'

Go to 'open in wiki to pdf' to view the resulting html page and access the PDF.

All current wiki-to-pdf publications are listed here: http://titipi.org/wiki-to-pdf

All publicly shareable publications are listed here: http://titipi.org/pub/

Publication URLs are constructed as follows: http://titipi.org/pub/NAMEOFPUBLICATION

Server setup

The wiki-to-pdf interface is installed as a systemd service on the titipi server. It uses pagedjs and flask.

In case of trouble, login to the server and:

$ sudo service flask restart

Various functions described in:

web-interface/web-interface.py

Templates in:

web-interface/templates/flask

css for wiki-to-pdf publications:

wiki-to-pdf/static/out/NAMEOFPUBLICATION

Custom css for the application in:

wiki-to-pdf/static/css