< L10N
Updated for
This page has been updated for Fedora 23.
Context
While reviewing translation on Zanata, the reviewer may find some repetitive faults the translator has made. This kind of situation may result from various reasons such as:
- Lack of attention by the translator to some aspects that are not always very visible while editing (e.g. double spaces)
- Ignorance by the translator of a grammar or punctuation rule that leads to repetition of the error (e.g. in French double punctuation – :,;,!,? – should be preceded by a fine non breakable space contrarily to the English language)
- Pure translation error for a repetitive word
- Any other unknown rule
In such a situation, Zanata's search and replace functionality is not of great help. To be able to search and replace repetitive faults, the reviewer has to pull the translated files from Zanata, use some OS tools to do so and, eventually, push back the modified files to Zanata.
The present page explains the different stages to accomplish this efficiently.
Setting up the Pull an Push Tool
Installing the Zanata Command Line Client
The necessary command line tool to pull and push from Zanata is the Zanata command line client (CLI) available in the zanata-client package. Please install it with:
su -c 'dnf -y install zanata-client'
Configuring the Zanata Client
User Configuration
To allow the user to be authenticated by the Zanata server, the zanata-cli presents the user's credentials it finds in the ~/.config/zanata.ini file to the server. Thus, the first thing to do is to create this ~/.config/zanata.ini file and add the user's credential in it. Fortunately, the Zanata server provides a very convenient way of doing so.
To create you configuration file:
- Use your favorite text editor to create the ~/.config/zanata.ini file.
- Login into the Zanata server and navigate to the user's Settings page – click on the user's avatar in the top-right corner and, in the drop down menu that opens, chose Settings.
- Click the <> Client link.
- Ensure an API key is displayed. If not, click on the Generate API Key button to create one.
- Copy the content of the Configuration[zanata.ini] text-box.
- Past the copied lines into the ~/.ini/zanata.ini file and save it.
Project Version Configuration
Project configuration stores information specific to a project-version in the ~/<project dir path>/zanata.xml file – where <project dir path> should be replaced by the name of the project version's local directory . It helps the user to shorten the zanata-cli commands by providing default values for options to these commands.
Downloading the Configuration File
The ~/<project dir path>/zanata.xml can be customized after a base for it has been downloaded from the Zanata server. To download this configuration base, please, once connected to the server, do the followings:
- Navigate the project version page – the one that presents a list of languages for the project version.
- Click on the v … link just below the user's avatar in the top-right part of the page.
- Click on the Download Configuration File link and save the file into your ~/<project dir path> folder.
The downloaded file should look like the following:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <config xmlns="http://zanata.org/namespace/config/"> <url>https://fedora.zanata.org/</url> <project>fedora-installation-guide</project> <project-version>f23</project-version> <project-type>podir</project-type> </config>
Customizing the Configuration File
Locale
While using the Zanata CLI, if no further indication about the locale is provided with the command, the po and pot files of every Zanata recognized language will be downloaded. In order to systematically add a locale indication to the command, the zanata.xml file of the project version can be customized. To limit the download to your locale, please add the following lines into the <config> xml element in your zanata.xml file:
<locales>
<locale><YOURLOCALE><locale>
<locales>
where <YOURLOCALE> has to be replaced with your language code (e.g. fr).