Wiki-to-pdf-manual: Difference between revisions

From titipi
Jump to navigation Jump to search
m (MMo moved page Wiki-to-pdf to Wiki-to-pdf-manual)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Publishing with wiki-to-pdf ==
== wiki-to-pdf manual ==


'''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.
=== wiki-to-pdf ===
For more informations on wiki-to-pdf, see [[Wiki-to-pdf]]


Code repository: http://gitlab.constantvzw.org/titipi/wiki-to-pdf/
=== working with titipi's 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:
To initiate a new publication, create a page in this wiki in the unfolding namespace:
Line 13: Line 10:


On this page, add content or transclude pages that are published elsewhere on the wiki.  
On this page, add content or transclude pages that are published elsewhere on the wiki.  
  <nowiki>{{:Peripheral politics}}</nowiki>
  <nowiki>{{TT|Peripheral politics}}</nowiki>
  <nowiki>{{:The politics of listening}}</nowiki>
  <nowiki>{{TT|The politics of listening}}</nowiki>
  <nowiki>{{:word2complex}}</nowiki>
  <nowiki>{{TT|word2complex}}</nowiki>
 
For now, when using the transclusion method, each page to be transcluded needs to include the following snippet:
 
<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''''


Go to ''''open in wiki to pdf'''' to view the resulting html page and access the PDF.
Go to ''''open in wiki to pdf'''' to view the resulting html page and access the PDF.
[[File:Wikitopdf.png]]


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


'''Publication URLs''' are constructed as follows: http://titipi.org/pub/NAMEOFPUBLICATION
'''Publication URLs''' are constructed as follows: http://titipi.org/pub/NAMEOFPUBLICATION
=== Editing wiki-to-pdf ===
When the automated pageheader overflows, you can add the preferred shorter title to the wiki page:
<nowiki><h2 class="runningtitle">When governments move fast and break things</h2></nowiki>
This would replace the longer title, "EU Digital COVID Certificates: When governments move fast and break things"


=== Server setup ===
=== Server setup ===

Latest revision as of 16:58, 2 December 2021

wiki-to-pdf manual

wiki-to-pdf

For more informations on wiki-to-pdf, see Wiki-to-pdf

working with titipi's 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.

{{TT|Peripheral politics}}
{{TT|The politics of listening}}
{{TT|word2complex}}

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

Editing wiki-to-pdf

When the automated pageheader overflows, you can add the preferred shorter title to the wiki page:

<h2 class="runningtitle">When governments move fast and break things</h2>

This would replace the longer title, "EU Digital COVID Certificates: When governments move fast and break things"

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