The manual is stored in Github repository (https://github.com/jelix/jelix-manual-en ), and its content is readed directly by our application on http://docs.jelix.org. The content is some pages written in a wiki language, inherited from the dokuwiki syntax.

To create a manual in an other language, create a new repository somewhere (github is a good idea). And create some files following same hierarchy as the original manual, and with translated contents and following the Dokuwiki syntax.

However, there are few things to know, in order to produce a good manual and to respect conventions.

First, there is an important page of the manual: the table of content. The goal of this page is to list all wiki pages which are parts of the manual, the hierarchy and the order of these pages. For that, we use specific tags: <bookcontents>

Why this plugin? It saved the list of these pages in a file, and it then allows:

• to generate automatically a navigation bar for the manual, on each wiki page of the manual
• to generate a PDF version each night. On our server, we have a script which look at this list, read all wiki pages, and include all of their contents in a PDF file. Later, we will have other scripts to generate static HTML pages etc..

In this main page of the manual, you have others tags: <bookinfo>, <booklegalnotice>,<bookpagelegalnotice>, which contain informations used for the PDF manual or the navigation bar.

The first thing to do to translate the manual, is to create a main page. In the following example, we take the translation of the manual for jelix 1.1 to Italian language as an example.

• use your language code for the URL of the pages. If you are an italian, the international code is “it”. In the url, you should use also the title of the manual: “manuale-1.1” for example. So you will create all pages of the manual with an url begining by “it/manuale-1.1/” (or, in the dokuwiki syntax : “it:manuale-1.1:”).
• create the main page at the url http://jelix.org/articles/it/manuale-1.1
• copy the wiki content of manual-1.1 in this new page
• translate all titles of the pages
• replace in all links containing “en:manual-1.1:”, the “en:manual-1.1:” string by “it:manuale-1.1:”
• you can translate the name of the page (the part after “it:manuale-1.1”), but it is recommended to do it each time you begin to translate a page.
• you can translate other part of this page, the content inside the tags <bookinfo>, <booklegalnotice>,<bookpagelegalnotice>.