----
 [[Translations/CZ|česky]] | '''english''' | [[Translations/HU|magyar]]
----
= Translate CAcert.org =

This page describes a few important things about translating the CAcert website. How to translate CATS is described [[Brain/Study/EducationTraining/CATSTranslation|elsewhere]].

The place to go to start translating is [[https://translations.cacert.org]]

If you do some translation work please also subscribe to the [[https://lists.cacert.org/wws/info/cacert-translations|translations mailing list (low volume)]] because important notifications such as broken translations get posted there. If you change some string and thereby the translation gets broken it is your primary responsibility to correct it (if you don't know what's wrong just ask us, we will be glad to help). Other translators may not understand the language you are translating and therefore are unable to make informed decisions how to correct the problem. '''So you should really subscribe to that mailing list''', it's only very few posts.

If you translate into a language with '''very few translations''' until now or you start a '''new language''', read [[Translations/WhatFirst]], it may be helpful for you.

== How to use the system ==

There is a [[https://svn.cacert.org/CAcert/HowTo/How%20to%20translations%20for%20CAcert%20applications.pdf|short introduction on how to use the web application]]. The translation server is actually just an instance of [[http://translate.sourceforge.net/wiki/pootle/index|Pootle]] so if there is an issue not described there or below you can have a look at their documentation. If that also doesn't help just ask at the [[https://lists.cacert.org/wws/info/cacert-translations|translations mailing list]], don't be shy.

=== Strings Containing Variable Parts ===

If a string contains some strange sequence starting with a percent sign ("`%<only_special_characters_or_numbers><exactly_one_letter>`" – most often "`%s`" but things like "`%2$*1$d`" would also be possible) special attention is needed because those are quite fragile and tend to break the translation files. These sequences will be replaced with variable strings or HTML markup when the user displays the page. For example "`The email address %s was successfully added to your account`" could become "''The email address alice``@example.com was successfully added to your account''" and "`Further information can be found in %sthe wiki%s.`" can become "''Further information can be found in [[CAcert|the wiki]].''"

Note that the sequence only runs from the percent sign to the first letter, the "t" is again part of the fixed text that you probably need to translate. E.g. for German I would translate the string as following "`Im %sWiki%s finden Sie weitere Informationen.`" which would show as "''Im [[CAcert|Wiki]] finden Sie weitere Informationen.''" Notice that the link text as well as the position in the sentence was varied.

{{{#!wiki caution
'''Important:

You need to keep exactly as many special sequences in your translation as there were in the original string. Otherwise the translation file breaks.'''
}}}

=== Special Characters ===

You don't need to worry about special characters, just enter the characters as they are. If you see remaining HTML-Entity encoded stuff ("`&something;`") then just replace it with the native variant.

=== HTML ===

You can't have HTML tags ("`<something>foo</something>`") in the translated string as they will be escaped to make the browser ignore the special meaning and display them literally. If you see places where HTML tags are used directly in the string to be translated and they should clearly keep their special meaning then file a bug report on [[https://bugs.cacert.org|our bug tracker]].

== See also ==
 * The '''Local Language Translation Project''' ([[Brain/Study/Translations]]) with
  * an overview (all CAcert languages)
  * translator's library with glossaries etc. in many languages

 * '''[[Translations/WhatFirst]]''' Which part is more important to translate? Where should I start?
 * [[Translations]] tells you how to use the system.

 * [[translationFAQ]] FAQ (deutsch, english, português) 
 * [[Brain/Study/EducationTraining/CATSTranslation]] CATS Translation 

----
CategoryTranslation