The rulebook is written in LaTeX and version controlled with git. Find out more about the Technology.
We also have some Working Guidelines.
An overview about the current state:
- The old 2012 Rulebook: https://unicycling.org/files/IUF_Rules_2012_english.pdf
- The 2012 Rulebook in the new format: https://unicycling.org/files/iuf-rulebook-2012-new.pdf
- Passed proposals for the 2013 Rulebook: http://rulebook.unicycling.org/proposals/passed
- The current 2013 Rulebook with applied proposals: https://unicycling.org/files/iuf-rulebook-2013.pdf
- A document highlighting the changes: https://unicycling.org/files/iuf-rulebook-diff-2012-2013.pdf
If you find an issue or have an idea for improvement, you can directly report it here on GitHub. Here is what you need to do:
- Get a GitHub Account and sign in (https://github.com/)
- Browse to the IUF rulebook repository (https://github.com/iuf/rulebook)
- Click on “Issues” (https://github.com/iuf/rulebook/issues)
- For every issue you want to report, click “New Issue” (https://github.com/iuf/rulebook/issues/new)
- Enter a title and a description and click “Submit new issue”
- A latex distribution supporting pdflatex with the following packages installed (for example texlive with texlive-latex-extra on debian based systems like Ubuntu.):
- inputenc
- fontenc
- lmodern
- minitoc
- hyperref
- enumitem
- graphicx
- wrapfig
- longtable
- gitinfo
- To produce a PDF highlighting the changes: latexdiff and rcs-latexdiff
Open a terminal in the repository root and type make. This will generate out/iuf-rulebook.pdf. Or use your favourite LaTeX editor.
To include git revision information in the document, you need to install git hooks to extract the information from git. Do this with ./install_hooks. Build the document again and the information should appear.
To produce a PDF highlighting the changes, type make diff OLDCOMMIT=2012 NEWCOMMIT=master. OLDCOMMIT and NEWCOMMIT can be any git references. This will generate out/diff.pdf.