Skip to content

README.md

Latest commit

 

History

History
44 lines (30 loc) · 1.42 KB

README.md

File metadata and controls

44 lines (30 loc) · 1.42 KB

Python New Zealand - Rules

Official rules of Python New Zealand.
This repository holds the authoritative source code of the documents and tracks changes to them.

How to create documents

Constitution

This is Markdown source code to produce HTML (for https://python.nz) and PDF (for printing)
Note: On github.com, bullet points will show in addition to numbering (styling is ignored). Also, clauses following a bullet list wrongly remain at the same indentation level as the bullet list - this seems to be a rendering bug in github. The HTML/PDF results look fine.

Create HTML

Use pandoc:

pandoc -s constitution.md -o constitution.html -c constitution.css -V "pagetitle:Constitution"

(-s standalone = embed external CSS, pagetitle to suppress title warning without inserting another headline)

Table of Contents

Optionally, --toc will also create a table of contents with headline links (handy but not fit for PDF)

pandoc -s constitution.md -o constitution.html -c constitution.css -V "pagetitle:Constitution" --toc

Create PDF

Just print the HTML from your browser to a PDF file.
If you want to use a dedicated conversion tool instead, check that it does the job correctly (the numbering of bullets and sub bullets is where weasyprint failed)