Dictionaries.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"../../../docbook-xml-4.5/docbookx.dtd">
<chapter id="chapter.dictionaries">
  <title><indexterm class="singular">
      <primary>Dictionaries</primary>
    </indexterm>Dictionaries</title>

  <para/>

  <section>
    <title>How to download and install dictionaries<indexterm class="singular">
        <primary>Dictionaries</primary>

        <secondary>Downloading and installing</secondary>
      </indexterm></title>

    <para>Dictionaries in <application>OmegaT</application> are based on the
    StarDict or on the Lingvo DSL format. To install the necessary files for the StarDict format, proceed as follows:</para>

    <itemizedlist>
      <listitem>
        <para>Search for the required language combination - for instance on
        the <ulink url="http://stardict.sourceforge.net/index.php"><indexterm
            class="singular">
            <primary>Dictionaries</primary>

            <secondary>StarDict</secondary>
          </indexterm>StarDict Platform</ulink> above.</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para>Download the file - it should be a <filename>tarball</filename>
        archive (extension <emphasis>tar.bz</emphasis> or
        <emphasis>tar.bz2</emphasis>).</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para>Use untar utility (or its equivalent, for instance<filename>
        winrar</filename> in Windows) to extract its contents into the project
        folder "Dictionary". There should be three files, with extensions
        <emphasis>dz, idx </emphasis>and <emphasis>ifo</emphasis>.</para>
      </listitem>
    </itemizedlist>

    <para>Note that in addition to "source-target" dictionaries you can, using
    the Dictionary feature, obtain access to information such as:</para>

    <itemizedlist>
      <listitem>
        <para><indexterm class="singular">
            <primary>Dictionaries</primary>

            <secondary>Webster</secondary>
          </indexterm>Webster's Revised Unabridged Dictionary (1913)</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para><indexterm class="singular">
            <primary>Dictionaries</primary>

            <secondary>Longman</secondary>
          </indexterm>Longman Dictionary of Contemporary English</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para><indexterm class="singular">
            <primary>Dictionaries</primary>

            <secondary>Britannica</secondary>
          </indexterm>The Britannica Concise Encyclopedia</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para>etc...</para>
      </listitem>
    </itemizedlist>

    <para>Some of the dictionaries have no strings attached - i.e. are "Free
    to use", and others, like the selection above, are under the GPL license.
    The following example shows Merriam Webster 10th dictionary "in
    action":</para>

    <figure id="Dict.Merriam.Webster">
      <title><indexterm class="singular">
          <primary>Dictionaries</primary>

          <secondary>Merriam Webster</secondary>

          <seealso>Dictionaries</seealso>
        </indexterm>Merriam Webster dictionary - use</title>

      <mediaobject>
        <imageobject role="html">
          <imagedata fileref="images/DictMerriamWebster.png"/>
        </imageobject>

        <imageobject role="fo">
          <imagedata fileref="images/DictMerriamWebster.png" width="60%"/>
        </imageobject>
      </mediaobject>
    </figure>
  </section>

  <section>
    <title><indexterm class="singular">
        <primary>Dictionaries</primary>

        <secondary>Problems with</secondary>
      </indexterm>Problems with dictionaries</title>

    <itemizedlist>
      <listitem>
        <para>Check that your dict files are in the correct folder (or in a
        subfolder below it). Check in <menuchoice>
            <shortcut>
              <keycombo>
                <keycap><indexterm class="singular">
                    <primary>Shortcuts</primary>

                    <secondary>Project properties - Ctrl+E</secondary>
                  </indexterm>Ctrl</keycap>

                <keycap>E</keycap>
              </keycombo>
            </shortcut>

            <guimenu>Project</guimenu>

            <guimenuitem>Properties</guimenuitem>
          </menuchoice>.</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para>Does the folder contain three files of the same name, with
        extensions? If only one file is present, check its extension. If it
        is <emphasis>tar.bz</emphasis>, you have forgotten to unpack (untar)
        it.</para>
      </listitem>
    </itemizedlist>
  </section>
</chapter>