Improving the manuals
The source code repository for the ConTeXt reference manual and ConTeXt: an excursion is kept at foundry.supelec.fr/projects/contextman. This article explains how to access the source code.
Contents
The contents of the repository
There are three directories at the top level of the repository:
context-beginners
contains the code for ConTeXt: an excursion, the beginners' manual.context-reference
contains the code for the ConTeXt reference manual.context-commands
contains a proof-of-concept for a command reference based on Lua tables. This project is not currently active.
Each manual's directory contains a Makefile; to build the PDF, the following should suffice (mutatis mutandis).
cd context-reference make
ConTeXt: an excursion is available in several languages, stored in context-beginners/en/
, context-beginners/fr/
, etc. A number of extra make
targets are available:
make en # make only the english screen and print versions make fr-screen # make only the french screen version
Getting the source code
The source code is stored and managed using Subversion. For more information, see the Subversion article on this wiki.
Anonymous checkout, for curiosity
(Instructions taken from here.)
If you just want a copy of the manuals' source code, you can get it anonymously. Open a command prompt and enter the following command:
svn checkout --username anonsvn https://foundry.supelec.fr/svn/contextman/
The password is anonsvn
.
Non-anonymous checkout, for development
- Register an account on foundry.supelec.fr.
- Request to join the
contextman
project - Check out the source code using your developer name and password
svn checkout --username developername https://foundry.supelec.fr/svn/contextman/
Translating ConTeXt, an excursion
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, create the required 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 put up in the official download locations.