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.

• Constitution
• Bylaws
• Code of Conduct

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)