← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/xiphos/oneiric

« back to all changes in this revision

Viewing changes to help/translating/xiphospo.xml

  • Committer: Bazaar Package Importer
  • Author(s): Dmitrijs Ledkovs, Jonathan Marsden, Dmitrijs Ledkovs
  • Date: 2010-11-25 21:26:48 UTC
  • mfrom: (2.1.1 experimental)
  • Revision ID: james.westby@ubuntu.com-20101125212648-mc64wvs0nw3xp7bx
Tags: 3.1.4-1
[ Jonathan Marsden ]
* New upstream release 3.1.4
* Removed debian/patch/* since the one patch was included upstream.
* Bumped Standards-Version to 3.9.1 (no changes required).
* debian/README.Debian: Corrected spelling and reworded for clarity.
* debian/control: Add Jonathan Marsden back into Uploaders.

[ Dmitrijs Ledkovs ]
* Added local options dpkg-source to unapply patches and fail on
  upstream source changes (ignoring false positives).
* Added bzr-builddeb hook to generate source-format before build. If you
  are not using bzr-builddeb, you must run "./debian/rules clean" before
  building.
* patches/xul-2.0.patch: bump UPPER_RANGE to allow running against xul20.

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/translating/xiphospo.xml
 
1
<!-- ============= Translating Xiphos from a PO  ============-->
 
2
 
 
3
<para>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.</para>
 
4
 
 
5
<sect2 id="po-file-structure">
 
6
  <title>PO File Structure</title>
 
7
  <para>PO files are essentially text files with an entry for each string which requires translation.</para>
 
8
  <para>Each entry consists of three or four parts:</para>
 
9
  <itemizedlist>
 
10
    <listitem>
 
11
      #: ../xiphos.desktop.in.in.h:1
 
12
    </listitem>
 
13
    <listitem>
 
14
      msgid "Xiphos Bible Guide"
 
15
    </listitem>
 
16
    <listitem>
 
17
      msgstr "زیفوس-نرم·افزار·مطالعه·کتابمقدس"
 
18
    </listitem>
 
19
  </itemizedlist>
 
20
 
 
21
    <para>A comment line pointing towards the exact origin of the particular string within the source code</para>
 
22
    <para>A msgid line which quotes the original string</para>
 
23
    <para>A msgstr line which contains the relevant translation.</para>
 
24
    <para>
 
25
      A translation which is doubtful can carry a second comment line, declaring it as "fuzzy":
 
26
    </para>
 
27
    <itemizedlist>
 
28
      <listitem>
 
29
        #: ../ui/prefs.glade.h:21
 
30
      </listitem>
 
31
      <listitem>
 
32
        #, fuzzy
 
33
      </listitem>
 
34
      <listitem>
 
35
        msgid "Base text size"
 
36
      </listitem>
 
37
      <listitem>
 
38
        msgstr "سایز قلم بنیادی"  
 
39
      </listitem>
 
40
    </itemizedlist>
 
41
</sect2>
 
42
 
 
43
<sect2 id="po-do-translation">
 
44
 <title>Editing the PO</title> 
 
45
 <para>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.
 
46
  </para>
 
47
</sect2>
 
48
 
 
49
<sect2 id="po-programs">
 
50
  <title>Translation Editors</title>
 
51
  <para>Besides a simple text editor, there are two programs that can make translation easier to do.</para>
 
52
  <itemizedlist>
 
53
    <listitem>
 
54
      gtranslator: This program is available for linux (and other *nixes) only.
 
55
    </listitem>
 
56
    <listitem>
 
57
      poedit: This program is available on Windows and linux.
 
58
    </listitem>
 
59
  </itemizedlist>
 
60
</sect2>