summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdesdk/kbabel/catman.docbook
blob: e0e16896d110abebc974d6e19fcff602a354f7d7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
<!-- <?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"
> -->
<!-- Uncomment the previous two lines to validate this document -->
<!-- standalone.  Be sure to recomment them before attempting to -->
<!-- process index.docbook -->

<chapter id="using-catalogmanager">

<chapterinfo>
<!-- Fill in this section if this document has a different author -->
<authorgroup>
<author>
<personname
><firstname
></firstname
><surname
></surname
></personname>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>Malcolm</firstname
><surname
>Hunter</surname
><affiliation
><address
><email
>malcolm.hunter@gmx.co.uk</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</chapterinfo>

<title
>Using &cataloguemanager;</title>
<anchor id="catalogmanager"/>

<screenshot>
<screeninfo
>Screenshot of &cataloguemanager;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="snap_catalogmanager.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Screenshot of &cataloguemanager;</phrase
></textobject>
</mediaobject>
</screenshot>
<para
>The Catalogue Manager merges two folders into one tree and displays all the <acronym
>PO</acronym
> and <acronym
>POT</acronym
> files in these folders. The display allows you to easily see if a new template has been added or an old one has been removed. Some information is shown along with each file name: total number of entries, number of fuzzy entries, number of untranslated entries, the date of the last revision and the last translator of the file. </para>
<para
>To make it easier for you to find files that need work or are missing the status of each file is also displayed using an icon: </para>

<itemizedlist>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_ok.png" format="PNG"/>
</imageobject>
</inlinemediaobject
> All the messages in this file are translated.</para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_needwork.png" format="PNG"/>
</imageobject>
</inlinemediaobject
> Some of the messages in this file are fuzzy or untranslated </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_missing.png" format="PNG"/>
</imageobject>
</inlinemediaobject
> This file does not exist in the folder of the <acronym
>PO</acronym
> files. </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_broken.png" format="PNG"/>
</imageobject>
</inlinemediaobject
> This file contains syntax errors. </para>
   </listitem>
   <listitem>
      <para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="catalogmanager_reload.png" format="PNG"/>
</imageobject>
</inlinemediaobject
> Information about this file is being currently updated. When the update is finished, it will get one of the icons listed above to reflect its state. </para>
   </listitem>
</itemizedlist>

<para
>If an icon is marked with this icon <inlinemediaobject
> <imageobject
> <imagedata fileref="catalogmanager_nopot.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, like <inlinemediaobject
> <imageobject
> <imagedata fileref="catalogmanager_nopot_ok.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, it indicates that this file or folder does not exist in the folder of the <acronym
>POT</acronym
> files.</para>

<para
>You can mark or unmark a file by selecting <guimenuitem
>Toggle Marking</guimenuitem
> in the context menu of a file.</para>

<para
>If you want to toggle or remove all markings in a folder, press the right mouse button over the folder and select <guimenuitem
>Toggle Markings</guimenuitem
> or <guimenuitem
>Remove Markings</guimenuitem
>. The markings are automatically saved when leaving &kbabel;.</para>

<para
>To open a file either double-click on the file, select <menuchoice
><guimenuitem
>Open</guimenuitem
></menuchoice
> from the context menu or press either <keycap
>Return</keycap
> or <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
> </keycombo
>.</para>

<para
>You can configure the &cataloguemanager; by <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
> Configure &cataloguemanager;...</guimenuitem
></menuchoice
>. See section <link linkend="preferences-catalogmanager"
>Preferences</link
> for more details.</para>

<sect1 id="catman-features">
<title
>&cataloguemanager; Features</title>
<para
>Besides the main feature for opening the files in &kbabel; &cataloguemanager; supports number of other features for maintaining a tree of <acronym
>PO</acronym
>-files. </para>

<sect2 id="catman-find">
<title
>Find and replace in multiple files</title>
<para
>One of the most requested features for &kbabel; was a possibility to search and replace in multiple files at once. &cataloguemanager; supports this feature with a tight integration with &kbabel; </para>
</sect2>

<sect2 id="catman-statistics">
<title
>Statistics</title>
<para
>&cataloguemanager; can show you a number of statistics about a single file or about the whole folders. The statistics contain number of files, how many of the files have their templates, how many templates are missing. It also counts number of messages in the files and shows statistics about how large parts of the messages are translated, fuzzy-translated or untranslated. </para>
</sect2>

<sect2 id="catman-syntax">
<title
>Checking the syntax</title>
<para
>This allows you to check the syntax of multiple <acronym
>PO</acronym
>-files using <command
>msgfmt</command
>. If a file fails this check, it cannot be used for generating a <acronym
>MO</acronym
>-file for binary distribution. Such an incorrect file will typically result in failing compilation of the package the <acronym
>PO</acronym
>-file belongs to. </para>
</sect2>

<sect2 id="catman-commands">
<title
>User-defined commands</title>
<para
>Because &cataloguemanager; cannot provide any functionality you would like to use, you can extend it by defining your own commands. </para>
<para
>There are two sets of commands. One for folders and one for single files. You can set them in <link linkend="preferences-catalogmanager"
>configuration dialogue </link
> and access by pressing &RMB; on an entry in the file list.</para>
</sect2>

</sect1>
</chapter>
<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab 
-->