<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="dev-translate-build" xml:lang="ru">

  <info>

    <link type="next" xref="dev-translate-tools"/>

    <revision version="0.1" date="2013-06-19" status="review"/>

    <credit type="author">

      <name>Ekaterina Gerasimova</name>

      <email its:translate="no">kittykat3756@gmail.com</email>

      <years>2013</years>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="cc-by-sa-3-0.xml"/>

    <desc/>

  </info>

  <title>Set up your build system for translation</title>

  <links type="series" style="floatend">

    <title>Set up translations</title>

  </links> 

  
You will need to set up your project and build system to work with

  translations.

  
Create a <file>po/</file> subdirectory in your project directory and list

  the files which have translatable strings in <file>po/POTFILES.in</file>.

  List files without translatable strings in

  <file>po/POTFILES.skip</file>.

  
Add the following lines to your <file>configure.ac</file>:

IT_PROG_INTLTOOL([0.50.0])

AC_SUBST([GETTEXT_PACKAGE], [$PACKAGE_TARNAME])

AC_DEFINE_UNQUOTED([GETTEXT_PACKAGE], ["$GETTEXT_PACKAGE"], [Package name for gettext])

  
Add the following lines to your <file>Makefile.am</file>:

SUBDIRS = po

AM_CPPFLAGS = -DPACKAGE_LOCALEDIR=\""$(datadir)/locale"\"

@INTLTOOL_DESKTOP_RULE@

desktopdir = $(datadir)/applications

desktop_in_files = data/<input>applicationname</input>.desktop.in

desktop_DATA = $(desktop_in_files:.desktop.in=.desktop)

  
Run <cmd>intltoolize</cmd> to copy the intltool build infrastructure to

  the build tree before running <cmd>autoreconf</cmd>.

  
Now that your build system and your source strings are ready for

  translation, you need to tell <app>gettext</app> three things:

  <list>

    <item>
the translation domain, generally the same as the

    application name
</item>

    <item>
the location where the built translations are installed
</item>

    <item>
the character encoding of the translations, generally

    UTF-8
</item>

  </list>

  <example>

  <note>

    
This example assumes that your application is written in C. It will be

    slightly different for other programming languages.

  </note>

  
Add the following line to the source file which contains your

  main() function:

  #include "config.h"

  
Then, add the following lines to your main() function:

bindtextdomain (GETTEXT_PACKAGE, PACKAGE_LOCALEDIR);

bind_textdomain_codeset (PACKAGE_TARNAME, "UTF-8");

textdomain (GETTEXT_PACKAGE);

  </example>

  
Run <cmd>make <input>projectname</input>.pot</cmd> in the <file>po</file>

  directory. This runs <cmd>intltool-extract</cmd> to extract the translatable

  strings and put them in a po template (POT) file.

</page>