Documentation/Improving the manuals

ConTeXt, an excursion

There are several translations underway (Chinese, French, Vietnamese) for ConTeXt, an excursion, as well as several completed translations (Czech, Dutch, English). To start a new translation, follow these instructions. First, the preliminaries:

• follow the instructions above to make a non-anonymous checkout of the source.
• Choose an abbreviation LANG for your language (e.g. it for Italian).

Next, make your own language's files based on the English files.

• Create a subdirectory LANG.
• Copy all English files here: cp en/* LANG/ .
• In the file names, change any en segments to LANG.

Prepare the Makefile, so that anyone can compile your translation in a single step.

• Open the Makefile. Add your own language alongside the existing languages — a simple copy-and-modify strategy should get you there.
• Run make LANG

Then it is time to start working on the translation.

• Comment each paragraph, and add your translation below it.

When you are done, post a message to the mailing list announcing your finished translation. It will be made available in the official download locations.