Starting a New Translation
Starting a new language translation comes down to
the following simple steps:
Consult the phpdoc mailing
list to see if the translation is already in progress.
If it is, read our tips
for that case, disregard the following and coordinate
with the other translators on the translation mailing list.
Let the php doc mailing list (email@example.com) know that you are
interested in starting a new translation.
Once approved, ask for a SVN account.
Mention that you would like to start a new translation and be sure to
include the name of the translation in this request.
The PHP documentation group will then ask
to create a new translation. This involves setting up a new mailing
list (doc-LANGCODE@lists.php.net), a newsgroup
(php.doc.LANGCODE), and a SVN module
(phpdoc-LANGCODE). At this point the LANGCODE
should also be added to the docweb system.
Check out the modules named phpdoc
and phpdoc-LANGCODE (using the
phpdoc-LANGCODE-dir alias) as
described in the SVN chapter
of this HOWTO.
Copy en/language-defs.ent and
en/language-snippets.ent to the
new directory (visible as phpdoc/LANGCODE
in your file system) and translate the contents of them.
Copy over files from the English tree and start to
work on them, (do not check in untranslated files)
and rerun configure each time you add a file.
See the section about
tracking for help about
how can you ease your work of tracking the English
version and your language's version.
After the translation makes a good start, its LANGCODE is added
to the other PHP SVN modules like phpweb,
livedocs, and to this
howto. After doing so
the new translation will be online!
Some important issues to consider when building
a new translation:
Can you set up and translate the whole manual
yourself? If not, can you set up a team to
work on the language (recommended!)?
Have you made sure that your language or glyph
(lettering, font, or characters) is supported
by the DocBook stylesheets? Please ask on the
if you don't know.