Translation
The IUF Rulebook is written in LaTex, which is a typesetting programming language. This allows us to take plain text with some formatting rules which is then automatically compiled into a nice looking pdf document with automatically numbered sections, generated Table of Contents with in-document hyperlinks and other features. It also allows for a nice system of translation through the Transifex website. Volunteers that are only helping with the actual translation can proceed to the "Translation Volunteers" section below.
The translation process proceeds as such:
- The English IUF Rulebook is written in LaTeX
- The English rulebook is committed using git and pushed to the GitHub server.
- The automatic build processes is started using Travis CI
- The build process takes each chapter and produces 'strings' of text to be translated
- These strings are uploaded to the Transifex server for translation
- IUF Volunteers translate these 'strings' into other languages
- Approved IUF Volunteers review and confirm these translations to ensure they are correct and preserve LaTeX formatting
- The build process downloads the translated strings from Transifex
- Anywhere a string has been translated, it is applied to the rulebook for that language
- The build process creates a translated pdf output of the rulebook. For any string that has not yet been translated, the build uses the original English text.
- The translated pdf is uploaded to the IUF server where users can view the draft translated rulebook.
- Possible last step: After complete translation of the rulebook into a language, the IUF Board could vote to accept the translation as the IUF Rulebook for that language.
Transifex is a sophisticated translation platform that the IUF uses for its Rulebook translation.
In order to help with the translation process, you must create an account and join the IUF translation team.
Sign up for a transifex account here: https://www.transifex.com/signup/
- Create a username and password.
- Fill out some additional information. Under Department choose "Localization" and under Job Title choose "Translator".
- Choose "join an existing project".
- Add the languages that you speak. Make sure to choose the base version of the language (e.g. 'fr'). In addition, you can choose the country-specific version of the language if you like (e.g. 'fr_CA'), but the base language is of most importance.
- Click 'get started' and then confirm your email address
The easiest way to Join the IUF Team is to get to the current Rulebook project page here: https://www.transifex.com/iuf/rulebook-2017/
Then click join team.
You can also search for "IUF Rulebook" and join the "Rulebook: 2017" project.
You should now be able to see (upon refreshing) the Rulebook: 2017 project dashboard.
With your account on Transifex now set up, you are ready to begin translating. Before you begin translating, please confirm with the IUF Rulebook Director (Scott Wilton) or your language's coordinator (e.g. François Werner for French) to confirm where your translation efforts should be focused.
Also, read the guide on the Transifex website on how to use the web editor for Translation. Transifex Guide. After reading this page, come back here for some specific notes for our project. The following text assumes that you have already read the Transifex Guide to the web editor.
For the IUF Rulebook, the "list of resources" is divided up by Rulebook Chapter (e.g. urban_jumps, or road_racing). Select the chapter given to you by a translation coordinator to begin translating.
The strings available for translation are shown in the order that they are written in the IUF Rulebook for that chapter. The strings may be headers, chapter names, titles, paragraph text, etc. Really anything that could be translated in the Rulebook, in the order things are displayed in the rulebook. In general, short text is a header or section title of some sort, while longer text is actual rule text.