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.
The contents of the repository
There are three directories at the top level of the repository:
context-beginnerscontains the code for ConTeXt: an excursion, the beginners' manual.
context-referencecontains the code for the ConTeXt reference manual.
context-commandscontains 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/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
Non-anonymous checkout, for development
- Register an account on foundry.supelec.fr.
- Request to join the
- 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.
Next, create the required files.
- Create a subdirectory LANG.
- Copy all English files here:
cp en/* LANG/.
- In the file names, change any
ensegments 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.
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.