Chapter 3. Translating Documentation

3.1. Understanding the Multiple Files Structure
3.2. Creating docbook-locales File
3.3. What to Translate

Current Fedora Documentation material is now maintained in the Fedora Hosted system as git repositories. This includes the latest versions of the common documentation build tools. You do not need to install git to translate these materials. Instead, use Transifex, as described in previous sections, to translate these documentation materials.

3.1. Understanding the Multiple Files Structure

Unlike software, a guide has multiple po files structure. Each file corresponds to each chapter in that guide. The file name usually consists of the chapter name. This structure is very useful as more than one translator can work on certain guide same time.

Like software, go to your language page and select a target release.

The Fedora's Transifex screen for Japanese language is used as an example. The page lists all projects of particular release software packages and documentation along with stats and options.

Any entry begins with Docs indicates documentation. To access multiple files structure, click the file icon in Option.

The Fedora's Transifex screen for Japanese language is used as an example. The page lists multiple files for Japanse release-notes along with stats and options.

Use the down-arrow icon to download the target po file and use the up-arrow icon to submit. Alternatively using the pencil icon allows you to edit the file online. Please notice that the up-arrow icon for submission and the pencil icon for online edit appears only if the user is logged in.