At the most basic level, all you need to do to create a new translation is edit a "po" file in a text editor or a translation editor. If you are unable to create this file yourself (described in the next section), someone from the &app; team will assist you in creating the po file for you to edit.

# PO File Structure

PO files are essentially text files with an entry for each string which requires translation.

Each entry consists of three or four parts:

- #: ../xiphos.desktop.in.in.h:1
- msgid "Xiphos Bible Guide"
- msgstr "زیفوس-نرم·افزار·مطالعه·کتابمقدس"

A comment line pointing towards the exact origin of the particular string within the source code

A msgid line which quotes the original string

A msgstr line which contains the relevant translation.

A translation which is doubtful can carry a second comment line, declaring it as "fuzzy":

- #: ../ui/prefs.glade.h:21
- #, fuzzy
- msgid "Base text size"
- msgstr "سایز قلم بنیادی"

# Editing the PO

To edit the po, simply open it in a text editor or one of the translation editors. Then, edit the msgstr line for all of the untranslated terms to the relevant term in your target language. It is helpful to have Xiphos running while doing this so you can see where the terms are being used.

# Translation Editors

Besides a simple text editor, there are two programs that can make translation easier to do.

- gtranslator: This program is available for linux (and other *nixes) only.
- poedit: This program is available on Windows and linux.