Wiki to print: Difference between revisions
Andre Castro (talk | contribs) (Created page with "= Wiki To Print Workflow = == required sofware == * [https://github.com/mwclient/mwclient mwclient] * [https://pandoc.org/ pandoc] * [https://weasyprint.org/ WeasyPrint] ==...") |
Andre Castro (talk | contribs) No edit summary |
||
| Line 18: | Line 18: | ||
== Pandoc == | == Pandoc == | ||
[[File:pandoc_diagram.jpg|400px|right]] | |||
A universal document converter - | A universal document converter - converts from one markup language onto another | ||
https://pandoc.org/ | https://pandoc.org/ | ||
| Line 25: | Line 26: | ||
Use: convert downloaded wiki pages onto HTML files | Use: convert downloaded wiki pages onto HTML files | ||
extensive documentation in [https://pandoc.org/MANUAL.html Pandoc’s Manual] or <code>man pandoc</code> | |||
=== pandoc example1: convert HTML string to markdown === | |||
<pre>echo "<h1>Hello Pandoc</h1><p>from html to markdown</p>" | pandoc -f html -t markdown</pre> | |||
=== pandoc example2: mediawiki file to HTML=== | |||
===Pandoc common arguments=== | |||
'''-f''' - option standing for “from”, is followed by the input format; | |||
'''-t''' - option standing for “to”, is followed by the output format; | |||
'''-s''' - option standing for “standalone”, produces output with an appropriate header and footer; | |||
'''-o''' - option for file output; | |||
'''mediawiki''' - mediawiki input filename - you need to replace it by its actual name | |||
== WeasyPrint == | == WeasyPrint == | ||
Revision as of 15:03, 14 October 2018
Wiki To Print Workflow
required sofware
mwclient
Python library to interface with the MediaWiki API.
https://github.com/mwclient/mwclient
Use: to download content from wiki pages, through the wiki-download.py script ./wiki-download.py -h
Pandoc
A universal document converter - converts from one markup language onto another
Use: convert downloaded wiki pages onto HTML files
extensive documentation in Pandoc’s Manual or man pandoc
pandoc example1: convert HTML string to markdown
echo "<h1>Hello Pandoc</h1><p>from html to markdown</p>" | pandoc -f html -t markdown
pandoc example2: mediawiki file to HTML
Pandoc common arguments
-f - option standing for “from”, is followed by the input format;
-t - option standing for “to”, is followed by the output format;
-s - option standing for “standalone”, produces output with an appropriate header and footer;
-o - option for file output;
mediawiki - mediawiki input filename - you need to replace it by its actual name
WeasyPrint
A visual rendering engine for HTML and CSS that can export to PDF. It aims to support web standards for printing. . The CSS layout engine is written in Python, designed for pagination, and meant to be easy to hack on.
https://weasyprint.org/, WeadyPrint documentation
Use: to convert HTML + CSS onto a PDF