<!-- <chapter id="translators-level3"><title>Translating &d-i; - Level 3</title> -->

<sect1 id="translators-level3">
<title>
Level 3
</title>

<sect2>
<title>
Contents
</title>

<para>
The level 3 of translations contains packages which provide general infrastructure for
dialogs.
</para>

<para>This includes a few other Debian packages:
</para>

	    <itemizedlist>
	      <listitem>
		<para>
		  debconf
		</para>
	      </listitem>
	    <listitem>
	      <para>
		newt
	      </para>
	    </listitem>
	    </itemizedlist>

</sect2>

<sect2 id="level3_debconf">
<title>
Debconf
</title>

<sect3 id="level3_debconf_description">
<title>
Package description
</title>

<para>
The <classname>debconf</classname> Debian package is the program which
handles all configuration steps of other packages when these packages
need some user interaction while they are configured.
</para>

<para>
This package is installed on all Debian systems. Its installation
process usually inputs the user about the default priority of
questions. However, when installed in a normal &d-i; installation
process, these answers are pre-filled with the priority settings of
the installation process. As a consequence, the questions are usually
hidden from users.
</para>

<para>
However, as the package is a <quote>key</quote> Debian package, its
translation is important for a properly localized system.
</para>

</sect3>

<sect3 id="level3_debconf_files">
<title>
Files location and access methods
</title>

<para>
The package uses a <acronym>GIT</acronym> repository. Commit access may be requested to
the &i18n-coords;. However, as the translatable parts do not change
very often, getting commit access is not highly useful.
</para>

<itemizedlist>
<listitem>
<acronym>GIT</acronym> access: <command>&git-debconf;</command>
<para>
The debconf translation lies in the <filename>debian/po</filename> directory, while
the programs translation is in <filename>po/</filename>.
</para>
</listitem>
<listitem>
<para>
<acronym>HTTP</acronym> access: 
</para>
<itemizedlist>
<listitem>
<para>
          <ulink url="&url-level3-pot;/debconf_debian_po.pot">&url-level3-pot;/debconf_debian_po.pot</ulink>
</para>
</listitem>
<listitem>
<para>
&url-level3-po;/debconf_debian_po_&language;.po
</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

</sect3>


<sect3 id="level3_debconf_updates">
<title>
Updating/adding translations
</title>

<para>
Translations should be reported as bugs against the
<classname>debconf</classname> package.
</para>

</sect3>

<sect3 id="level3_debconf_recommendations">
<title>
Specific recommendations
</title>

<para>
The translations are very similar to the questions asked by the
<classname>cdebconf</classname> package, which is part of the level1
of &d-i; translations.
</para>

<para>
Translators should then be careful about using the same terminology in
both packages, especially for questions priorities. This can be done
by merging the translations from &d-i; level1 into
<classname>debconf</classname> translations.
</para>

</sect3>

</sect2>

<sect2 id="level3_newt">
<title>
Newt
</title>

<sect3 id="level3_newt_description">
<title>
Package description
</title>

<para>
The newt package is a library (whiptail) which includes widgets used by
the most popular interface to the debconf software, the software
involved in packages configuration steps. These widgets include the
<guibutton>Yes</guibutton> or  <guibutton>No</guibutton> widgets used by
boolean templates, as well as the  <guibutton>OK</guibutton> or
<guibutton>Abort</guibutton> buttons text.
</para>

</sect3>

<sect3 id="level3_newt_files">
<title>
Files location and access methods
</title>

<para>
The package uses a <acronym>GIT</acronym> repository.
As the translatable parts do not change very often, getting commit access is not
highly useful.
</para>

<itemizedlist>
  <listitem>
      <acronym>GIT</acronym> access: <command>&git-newt;</command>
         <para>
            ...
         </para>
  </listitem>
  <listitem>
    <para>
      <acronym>HTTP</acronym> access: 
    </para>
    <itemizedlist>
      <listitem>
        <para>
          <ulink url="&url-level3-pot;/newt_po.pot">&url-level3-pot;/newt_po.pot</ulink>
        </para>
      </listitem>
      <listitem>
        <para>
          &url-level3-po;/newt_po_&language;.po
        </para>
      </listitem>
    </itemizedlist>
  </listitem>
</itemizedlist>

</sect3>

<sect3 id="level3_newt_updates">
<title>
Updating/adding translations
</title>

<para>
Translations should be reported as bugs against the <classname>newt</classname> package.
</para>

</sect3>

<sect3 id="level3_newt_recommendations">
<title>
Specific recommendations
</title>

<para>
none
</para>

</sect3>

</sect2>

</sect1>


<!-- </chapter> -->
