You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
438 lines
17 KiB
438 lines
17 KiB
<chapter id="dictionaries">
|
|
<title>Hiztegiak</title>
|
|
|
|
<para>&kbabel;-ek 3 modu ditu itzulitako <acronym>PO</acronym> mezuen kateak bilatzeko erabil daitezkeenak:</para>
|
|
|
|
<itemizedlist> <listitem> <para>Itzulpena bilatzen, itzulpen datu-base bat erabiltzen </para> </listitem> <listitem> <para>Itzulpen-zirriborroa </para> </listitem> <listitem> <para>&kbabeldict; </para> </listitem> </itemizedlist>
|
|
|
|
<sect1 id="database">
|
|
<!-- FIXME: settings -->
|
|
<title>Itzulpen datu-basea</title>
|
|
|
|
<para>Itzulpen datu-baseak Berkeley Database IIan oinarritutako datu-base batean itzulpenak biltegiratzeko aukera ematen dizu &ie; zure diskoko fitxategi bitar batean biltegiratzen da. Datu-baseak bilaketa azkarra bermatzen du itzulpen-kopuru handi batean.</para>
|
|
|
|
<para>Modu hau &kbabel;-ekin ondoen integratzen denetako bat da. Bilaketaz eta itzulpen-zirriborroaz gain, ondoko gailuak onartzen ditu:</para>
|
|
|
|
<itemizedlist> <listitem> <para>&kbabel;-en editorean idatzitako itzulpen berri guztiak automatikoki biltegiratu daitezke datu-basean.</para> </listitem> <listitem> <para>Datu-base hau <acronym>msgid</acronym> <quote>parekatzeko (Diff)</quote> erabil daiteke.</para> </listitem> </itemizedlist>
|
|
|
|
<para>Jakina, datu-basean zenbat eta itzulpen gehiago biltegiratu, orduan eta produktiboa izan zaitezke. Datu-basea betetzeko, <guilabel>Datu-basea</guilabel> tabulatzailea erabil dezakezu hobespenen elkarrizketan edo itzulitako mezu guztien gehikuntza automatikoa tabulatzaile berean piztu dezakezu.</para>
|
|
|
|
<sect2 id="database-settings">
|
|
<title>Ezarpenak</title>
|
|
<para> Bilatzeko modu hau konfiguratu eta nola erabili behar den jakin dezakezu <menuchoice> <guisubmenu>Konfigurazioa</guisubmenu> <guisubmenu>Konfiguratu hiztegia</guisubmenu> <guimenuitem>Itzulpen datu-basea</guimenuitem> </menuchoice> &kbabel;-en menuan hautatuz. </para>
|
|
<para> <guilabel>Generikoa</guilabel> tabulatzaileak datu-basean bilatzeko ezarpen orokorrak biltzen ditu. </para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Search in whole database (slow)</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Do not use <quote>good keys</quote>, search in the whole database.
|
|
This is slow, but will return the most precise results.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Search in list of "good keys" (best)</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Use <quote>good keys</quote> strategy. This option will give you the
|
|
best tradeoff between speed and exact matching.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Return the list of "good keys" (fast)</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Just return <quote>good keys</quote>, do not try to eliminate any more
|
|
texts. This is the fastest provided method, but can lead to a quite large
|
|
number of imprecise matches.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Case sensitive</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Distinguish case of letters when searching the text.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Normalize white space</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Skip unnecessary white space in the texts, so the searching will ignore small
|
|
differences of white space, ⪚ number of spaces in the text.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Remove context comment</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Do not include context comments in search. You will want this to be turned on.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Character to be ignored</guilabel></term>
|
|
<listitem>
|
|
<para>Hemen bilaketan zehar ezikusi beharreko karaktereak sar
|
|
ditzakezu. Adibide tipikoa azeleratzailearen marka hau litzateke, &ie;
|
|
& &kde; testuetarako.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para>
|
|
The <guilabel>Search</guilabel> tab contains finer specification for searching the text.
|
|
You can define how to search and also allows to use another special way of searching
|
|
called <emphasis><guilabel>Word substitution</guilabel></emphasis>. By substituting
|
|
one or two words the approximate text can be found as well. For example, assume you
|
|
are trying to find the text <userinput>My name is Andrea</userinput>.
|
|
</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Equal</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Text from database matches if it is the same as the searched string. In our example it can
|
|
be <emphasis>My name is !amp-internal!Andrea</emphasis> (if !amp-internal! is set as ignored character
|
|
in <guilabel>Characters to be ignored</guilabel> on <guilabel>Generic</guilabel> tab).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Query is contained</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Text from database matches if the searched string is contained in it. For our example it can
|
|
be <emphasis>My name is Andrea, you know?</emphasis>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Query contains</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Text from database matches if the searched string contains it. For our example it can
|
|
be <emphasis>Andrea</emphasis>. You can use this for enumerating the possibilities to
|
|
be found.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Regular Expression</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Consider searched text as a regular expression. This is mainly used for
|
|
&kbabeldict;. You can hardly expect regular expressions in PO files.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Use one word substitution</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
If the query text contains less words than specified below, it also
|
|
tries to replace one of the words in the query. In our example it will
|
|
find <emphasis>Your name is Andrea</emphasis> as well.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guibutton>Max number of words in the query</guibutton></term>
|
|
<listitem>
|
|
<para>
|
|
Maximal number of words in a query to enable one word substitution.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Local characters for regular expressions</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
Characters to be considered part of regular expressions.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<note>
|
|
<para>
|
|
Two-word substitution is not implemented yet.
|
|
</para>
|
|
</note>
|
|
</sect2>
|
|
|
|
<sect2 id="database-fill">
|
|
<title>Filling the database</title>
|
|
<para>
|
|
The <guilabel>Database</guilabel> tab allows to define where is the database stored on
|
|
disk (<guilabel>Database directory</guilabel>) and if it should be used for automatic
|
|
storing of the new translations (<guibutton>Auto add entry to database</guibutton>).
|
|
In this case you should specify the author of the new translation in <guilabel>Auto added
|
|
entry author</guilabel>.
|
|
</para>
|
|
<para>
|
|
The rest of the tab allows you to fill the database from already existent PO files. Use one
|
|
of the buttons in the middle of the dialog box. The progress of the file loading will be
|
|
shown by progress bars below the buttons. The <guilabel>Repeated strings</guilabel>
|
|
button should be used in special case when one translated string is repeated many
|
|
times, so you do not want to store too many of them. Here you can limit the stored strings.
|
|
</para>
|
|
<screenshot>
|
|
<screeninfo>Filling the database</screeninfo>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="dbcan.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject><phrase>Filling the database by existing PO-files</phrase></textobject>
|
|
</mediaobject>
|
|
</screenshot></sect2>
|
|
|
|
<sect2 id="database-goodkeys">
|
|
<title>Defining good keys</title>
|
|
<para>
|
|
On the <guilabel>Good keys</guilabel> tab are the thresholds to specify how to fill
|
|
the list of good keys.
|
|
<guilabel>Minimum number of query words in the key (%)</guilabel> specifies exactly that.
|
|
Text will need to contain only this per cent of the words to qualify as good key. Opposite can
|
|
be specified via <guilabel>Minimum number of words of the key also in the query (%)</guilabel>.
|
|
The length of the words can be set by <guilabel>Max length</guilabel> spinbox.
|
|
</para>
|
|
<para>Searched text typically contains number of generic words, ⪚ articles. You can
|
|
eliminate the words based on the frequency. You can discard them by
|
|
<guilabel>Discard words more frequent than</guilabel> or consider as always present by
|
|
<guilabel>frequent words are considered as in every key</guilabel>. This way the
|
|
frequent words will be almost invisible for queries.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="auxiliary">
|
|
<title>Auxiliary PO file</title>
|
|
|
|
<para>This searching mode is based on matching the same original
|
|
English string (the msgid) translated in some other language in an
|
|
auxillary <acronym>PO</acronym> file. It is very common for romanic
|
|
languages to have similar words, similarly for for anglosaxon and
|
|
slavonic ones.</para>
|
|
|
|
<para>For example, say I wanted to translate the word
|
|
<quote>on</quote>, from <filename>tdelibs.po</filename>, into Romanian
|
|
but have no clue. I look in the same file for French and find
|
|
<quote>actif</quote>, and in the Spanish one find
|
|
<quote>activado</quote>. So, I conclude that the best one in Romanian
|
|
will be <quote>activ</quote>. &kbabel; automates this task.
|
|
Currently you can define only one auxiliary file to search.</para>
|
|
|
|
<sect2 id="auxiliary-settings">
|
|
<title>Settings</title>
|
|
<para>
|
|
You can configure this searching mode by selecting
|
|
<menuchoice>
|
|
<guisubmenu>Settings</guisubmenu>
|
|
<guisubmenu>Configure Dictionary</guisubmenu>
|
|
<guimenuitem>PO Auxiliary</guimenuitem>
|
|
</menuchoice>
|
|
from the &kbabel; menu.</para>
|
|
|
|
<para>In the <guilabel>Configure Dictionary PO Auxiliary</guilabel>
|
|
dialog you can select the path to the auxiliary <acronym>PO</acronym>
|
|
file. To automate <acronym>PO</acronym>-file switching when you
|
|
change current edited file there are many variables delimited by
|
|
<literal>@</literal> char that are replaced by appropriate
|
|
values:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>@PACKAGE@</term>
|
|
<listitem><para>
|
|
The name of application or package currently being translated.
|
|
For example, it can expand to kbabel, tdelibs, konqueror
|
|
and so on.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>@LANG@</term>
|
|
<listitem><para>
|
|
The language code.
|
|
For example can expand to: de, ro, fr etc.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>@DIRn@</term>
|
|
<listitem><para>
|
|
where <quote>n</quote> is a positive integer. This expands to
|
|
the <quote>n</quote>-th directory counted from the filename (right to
|
|
left).
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>In the edit line the actual path to the auxiliary
|
|
<acronym>PO</acronym> file is displayed. While it is best to use the
|
|
provided variables in a path it is possible to choose an absolute,
|
|
real path to an existing <acronym>PO</acronym> file. Let's take an
|
|
example.</para>
|
|
|
|
<para>I'm Romanian and I have some knowledge about French language and
|
|
I work on &kde; translation.</para>
|
|
|
|
<para>First step is to download a very fresh
|
|
<filename>tde-i18n-fr.tar.bz2</filename> from the <ulink
|
|
url="ftp://ftp.kde.org/pub/kde/snapshots/current/tde-i18n">&kde; &FTP;
|
|
site</ulink> or to use the <acronym>CVS</acronym> system to put on my
|
|
hard-disk a French translation tree. I do this into
|
|
<filename>/home/clau/cvs-cvs.kde.org/tde-i18n/fr</filename>.</para>
|
|
|
|
<para>My <acronym>PO</acronym> sources directory is in
|
|
<filename>/home/clau/cvs-cvs.kde.org/tde-i18n/ro</filename>. Don't
|
|
forget to select <guilabel>PO Auxiliary</guilabel> as the default
|
|
dictionary and check <guilabel>Automatically start search</guilabel>
|
|
on the <guilabel>Search</guilabel> tab from &kbabel;'s
|
|
<guilabel>Preferences</guilabel> dialog.</para>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<sect1 id="compendium">
|
|
<!-- FIXME: examples -->
|
|
<title>PO compendium</title>
|
|
|
|
<para>A compendium is a file containing a collection of all
|
|
translation messages (pairs of <acronym>msgid</acronym> and
|
|
<acronym>msgstr</acronym>) in a project, ⪚ in &kde;. Typically,
|
|
compendium for a given language is created by concatenating all
|
|
<acronym>PO</acronym> files of the project for the
|
|
language. Compendium can contain translated, untranslated and fuzzy
|
|
messages. Untranslated ones are ignored by this module. </para>
|
|
|
|
<para>Similarly to Auxiliary <acronym>PO</acronym>, this searching
|
|
mode is based on matching the <quote>same</quote> original string
|
|
(<acronym>msgid</acronym>) in a compendium. Currently you can define
|
|
only one compendium file to search. </para>
|
|
|
|
<para>This mode is very useful if you are not using the translation
|
|
database and you want to achieve consistent translation with other
|
|
translations. By the way, compendium files are much easier to share
|
|
with other translators and even other translation projects because
|
|
they can be generated for them as well. </para>
|
|
|
|
<sect2 id="compendium-settings">
|
|
<title>Settings</title>
|
|
|
|
<para>
|
|
You can configure this searching mode by selecting
|
|
<menuchoice>
|
|
<guisubmenu>Settings</guisubmenu>
|
|
<guisubmenu>Configure Dictionary</guisubmenu>
|
|
<guimenuitem>PO Compedium</guimenuitem>
|
|
</menuchoice>
|
|
in &kbabel;'s menu.
|
|
</para>
|
|
|
|
<para>In <guilabel>Configure Dictionary PO Compendium</guilabel>
|
|
dialog you can select the path to a compendium file. To automate
|
|
compendium file switching when you change the translation language,
|
|
there is a variable delimited by <literal>@</literal> char which si
|
|
replaced by appropriate value:</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>@LANG@</term>
|
|
<listitem><para>
|
|
The language code.
|
|
For example can expand to: de, ro, fr etc.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>In the edit line is displayed the actual path to compendium
|
|
<acronym>PO</acronym> file. While you had best use provided variables in
|
|
path, it's possible to choose an absolute, real path to an existing
|
|
<acronym>PO</acronym> file to be used as a compendium.</para>
|
|
|
|
<para>A very fresh compendium for &kde; translation into ⪚ French
|
|
you can download <filename>fr.messages.bz2</filename> from the <ulink
|
|
url="ftp://ftp.kde.org/pub/kde/snapshots/current/tde-i18n">&kde; &FTP;
|
|
site</ulink>. </para>
|
|
|
|
<para>You can define how to search in the compendium using options
|
|
below the path. They are divided into two groups: text-matching
|
|
options, where you can specify how the text is compared and whether to
|
|
ignore fuzzy translations, and message-matching options, which
|
|
determine if the translation from compendium should be a substring of
|
|
searching message or vice versa.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Case sensitive</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
If the matching of message in compendium should distinguish between uppercase and lowercase letters.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Ignore fuzzy string</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
If the fuzzy messages in the compendium should be ignored for searching. The compendium can contain fuzzy messages, since it is typically created by concatenating the <acronym>PO</acronym> files of the project which can include fuzzy messages. Untranslated ones are ignored always (You can't search for translation in untranslated messages, right?)</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Only whole words</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
If the matching text should start and end at the boundaries of words.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>A text matches if it <guilabel>is equal to search text</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
A text in compendium matches the search text only if it is exactly the same (of course using the options above).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>A text matches if it <guilabel>is similar to search text</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
A text in compendium matches the search text only if it is <quote>similar</quote>. Both texts are compared by short chunks of letters (<quote>3-grams</quote>) and at least half of the chunks has to be same.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>A text matches if it <guilabel>contains search text</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
A text in compendium matches the search text if it contains the search text.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>A text matches if it <guilabel>is contained in search text</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
A text in compendium matches the search text if it is contained the search text.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>A text matches if it <guilabel>contains a word of search text</guilabel></term>
|
|
<listitem>
|
|
<para>
|
|
The texts are divided to words and a text in compendium matches the search text only if it contains some word from the search text.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|
|
|