[latexila] Use ITS Tool for the Mallard documentation

From: SÃbastien Wilmet <swilmet src gnome org>
To: commits-list gnome org
Cc:
Subject: [latexila] Use ITS Tool for the Mallard documentation
Date: Sun, 17 Jul 2011 20:21:20 +0000 (UTC)
commit 8b68dac5de09df3aa18e6692e01314d918adacf1
Author: SÃbastien Wilmet <swilmet src gnome org>
Date:   Sun Jul 17 22:09:21 2011 +0200

    Use ITS Tool for the Mallard documentation
    
    ITS Tool: http://itstool.org/
    
    There is also a little clean-up of CMake files.

 TODO                                               |    1 -
 data/CMakeLists.txt                                |    4 +-
 ...cmake-compile-schemas => compile-schemas.cmake} |    0
 help/C/build_tools.page                            |   21 +-
 help/CMakeLists.txt                                |   48 ++++-
 help/de.po                                         |  270 ++++++++++++++++++++
 help/{de/de.po => help.pot}                        |  210 +++++-----------
 help/update_help_pot.sh                            |    7 +
 8 files changed, 394 insertions(+), 167 deletions(-)
---
diff --git a/TODO b/TODO
index 1750ff9..df3d25a 100644
--- a/TODO
+++ b/TODO
@@ -7,7 +7,6 @@ LaTeXila 2.2
 ============
 
 - use ITS tool (http://itstool.org/):
-	- for the Mallard doc
 	- for the build tools
 	- for the templates
 	- ...?
diff --git a/data/CMakeLists.txt b/data/CMakeLists.txt
index 9197bd8..75fff25 100644
--- a/data/CMakeLists.txt
+++ b/data/CMakeLists.txt
@@ -1,6 +1,6 @@
 install (FILES "org.gnome.latexila.gschema.xml"
-	DESTINATION "${CMAKE_INSTALL_PREFIX}/share/glib-2.0/schemas/")
-install (SCRIPT "cmake-compile-schemas")
+	DESTINATION "share/glib-2.0/schemas")
+install (SCRIPT "compile-schemas.cmake")
 
 install (FILES "latexhelp.html" DESTINATION ${DATA_DIR})
 install (FILES "completion.xml" DESTINATION ${DATA_DIR})
diff --git a/data/cmake-compile-schemas b/data/compile-schemas.cmake
similarity index 100%
rename from data/cmake-compile-schemas
rename to data/compile-schemas.cmake
diff --git a/help/C/build_tools.page b/help/C/build_tools.page
index 1580370..4671b07 100644
--- a/help/C/build_tools.page
+++ b/help/C/build_tools.page
@@ -1,4 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic"
       id="build_tools">
 
@@ -29,7 +30,7 @@
         <td><p>Command</p></td>
       </tr>
     </thead>
-    <tbody>
+    <tbody its:translate="no">
       <tr>
         <td><p>LaTeX â DVI</p></td>
         <td><p><cmd>latex</cmd></p></td>
@@ -39,7 +40,7 @@
         <td><p><cmd>pdflatex</cmd></p></td>
       </tr>
     </tbody>
-    <tbody>
+    <tbody its:translate="no">
       <tr>
         <td><p>DVI â PDF</p></td>
         <td><p><cmd>dvipdf</cmd></p></td>
@@ -56,18 +57,18 @@
     <tbody>
       <tr>
         <td><p>Bibliography</p></td>
-        <td><p><cmd>bibtex</cmd></p></td>
+        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
       </tr>
       <tr>
         <td><p>Index</p></td>
-        <td><p><cmd>makeindex</cmd></p></td>
+        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
       </tr>
     </tbody>
   </table>
 
   <p>Compiling a LaTeX document can involve to execute several low-level commands, in a
   certain order and a certain number of times. Here is an example:</p>
-  <screen>
+  <screen its:translate="no">
 $ latex document.tex
 $ bibtex document.aux
 $ latex document.tex
@@ -176,22 +177,22 @@ $ ps2pdf document.ps</screen>
 
   <terms>
     <item>
-      <title>no-output</title>
+      <title its:translate="no">no-output</title>
       <p>The output is simply not displayed.</p>
     </item>
     <item>
-      <title>all-output</title>
+      <title its:translate="no">all-output</title>
       <p>All the output is displayed, without filter.</p>
     </item>
     <item>
-      <title>latex</title>
+      <title its:translate="no">latex</title>
       <p>Filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> commands.
       There can be three types of errors: critical errors, warnings, or bad-boxes. There
       are also some other useful information: the size of the document, the number of
       pages, and the number of errors.</p>
     </item>
     <item>
-      <title>latexmk</title>
+      <title its:translate="no">latexmk</title>
       <p>Used for the <cmd>latexmk</cmd> command. Internally, this post processor uses
       other ones: <em>latex</em> and <em>all-output</em>.</p>
 
@@ -204,7 +205,7 @@ $ ps2pdf document.ps</screen>
       output.</p>
     </item>
     <item>
-      <title>rubber</title>
+      <title its:translate="no">rubber</title>
       <p>This is the post-processor used for the <cmd>rubber</cmd> command. The errors are
       categorized into two types: bad-boxes, and the others. So, unlike the <em>latex</em>
       post processor, there is no distinction between critical errors and simple
diff --git a/help/CMakeLists.txt b/help/CMakeLists.txt
index d9733ab..0d8e913 100644
--- a/help/CMakeLists.txt
+++ b/help/CMakeLists.txt
@@ -1,4 +1,44 @@
-install (
-	DIRECTORY "C"
-	DESTINATION "${CMAKE_INSTALL_PREFIX}/share/gnome/help/latexila"
-)
+set (help_dir "share/gnome/help/latexila")
+set (tmp_help_dir "${latexila_BINARY_DIR}/help")
+
+install (DIRECTORY "C" DESTINATION ${help_dir})
+
+# Get list of pages
+file (GLOB path_pages "C/*.page")
+set (list_pages)
+foreach (path_page ${path_pages})
+	get_filename_component (page ${path_page} NAME)
+	set (list_pages ${list_pages} ${page})
+endforeach ()
+
+set (all_new_pages)
+
+# Foreach language
+file (GLOB po_files *.po)
+foreach (po_file ${po_files})
+	# Get the language name
+	get_filename_component (lang ${po_file} NAME_WE)
+
+	# Get the paths of the new pages
+	set (lang_pages)
+	foreach (page ${list_pages})
+		set (lang_pages ${lang_pages} "${tmp_help_dir}/${lang}/${page}")
+	endforeach ()
+
+	# Generate the new pages from the .po
+	set (mo_file "${tmp_help_dir}/${lang}.mo")
+	add_custom_command (
+		OUTPUT ${lang_pages}
+		COMMAND ${GETTEXT_MSGFMT_EXECUTABLE} -o ${mo_file} ${po_file}
+		COMMAND mkdir ${tmp_help_dir}/${lang}
+		COMMAND itstool -m ${mo_file} -o ${tmp_help_dir}/${lang}/ ${latexila_SOURCE_DIR}/help/C/*.page
+		DEPENDS ${po_file}
+	)
+
+	# Install the directory (which contains only the pages)
+	install (DIRECTORY ${tmp_help_dir}/${lang} DESTINATION ${help_dir})
+
+	set (all_new_pages ${all_new_pages} ${lang_pages})
+endforeach ()
+
+add_custom_target (documentation ALL DEPENDS ${all_new_pages})
diff --git a/help/de.po b/help/de.po
new file mode 100644
index 0000000..1b8c2f5
--- /dev/null
+++ b/help/de.po
@@ -0,0 +1,270 @@
+# German translation of the latexila documentation.
+# Mario BlÃttermann <mariobl freenet de>, 2011.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: latexila master\n"
+"POT-Creation-Date: 2011-07-17 18:49+0200\n"
+"PO-Revision-Date: 2011-07-15 23:55+0100\n"
+"Last-Translator: Mario BlÃttermann <mariobl freenet de>\n"
+"Language-Team: German <gnome-de gnome org>\n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Poedit-Language: German\n"
+"X-Poedit-Country: GERMANY\n"
+
+#. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
+msgctxt "_"
+msgid "translator-credits"
+msgstr "Mario BlÃttermann <mariobl freenet de>, 2011"
+
+#: C/build_tools.page:10(page/title)
+msgid "Build Tools"
+msgstr "Erstellungswerkzeuge"
+
+#: C/build_tools.page:13(synopsis/p)
+msgid ""
+"The purpose of the build tools is to generate a document in the PDF, DVI or "
+"PS format."
+msgstr ""
+
+#: C/build_tools.page:20(section/title)
+msgid "Overview"
+msgstr "Ãbersicht"
+
+#: C/build_tools.page:22(section/p)
+msgid ""
+"Several different tools can be used for a document compilation. There are "
+"some low-level commands, and two higher-level tools: Latexmk and Rubber."
+msgstr ""
+
+#: C/build_tools.page:26(table/title)
+msgid "Low-level commands"
+msgstr ""
+
+#: C/build_tools.page:29(td/p)
+msgid "Label"
+msgstr ""
+
+#: C/build_tools.page:30(td/p)
+msgid "Command"
+msgstr "Befehl"
+
+#: C/build_tools.page:59(td/p)
+msgid "Bibliography"
+msgstr "Bibliografie"
+
+#: C/build_tools.page:63(td/p)
+msgid "Index"
+msgstr "Index"
+
+#: C/build_tools.page:69(section/p)
+msgid ""
+"Compiling a LaTeX document can involve to execute several low-level "
+"commands, in a certain order and a certain number of times. Here is an "
+"example:"
+msgstr ""
+
+#: C/build_tools.page:78(section/p)
+msgid ""
+"Using a higher-level tool such as Latexmk or Rubber simplify a lot all this "
+"process, since only one command is required. Indeed, these tools can detect "
+"how many times the <cmd>latex</cmd> or <cmd>pdflatex</cmd> command must be "
+"called, and whether <cmd>bibtex</cmd> or <cmd>makeindex</cmd> is required. "
+"By default, LaTeXila uses Latexmk."
+msgstr ""
+
+#: C/build_tools.page:86(section/title)
+msgid "Differences Between Latexmk and Rubber"
+msgstr "Unterschiede zwischen Latexmk und Rubber"
+
+#: C/build_tools.page:87(section/p)
+msgid ""
+"<link href=\"http://www.phys.psu.edu/~collins/software/latexmk-jcc/";
+"\">Latexmk</link> and <link href=\"https://launchpad.net/rubber/\";>Rubber</"
+"link> have the same purpose: simplify the compilation process of a LaTeX "
+"document. Latexmk is written in Perl, while Rubber is written in Python."
+msgstr ""
+
+#: C/build_tools.page:92(section/p)
+msgid ""
+"The output of Latexmk contains more information: which commands are "
+"executed, how many times, their output, and the reasons why Latexmk executes "
+"(or doesn't execute) these commands. The output of Rubber, on the other "
+"hand, doesn't contain a lot of information. When an error occurs, it can be "
+"more difficult to diagnose."
+msgstr ""
+
+#: C/build_tools.page:97(section/p)
+msgid ""
+"Also, Rubber filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</"
+"cmd> command. As a consequence, when Rubber prints an error, it's more "
+"difficult to know which type of error it is. If you use Latexmk, errors are "
+"categorized into three types: critical errors, simple warnings and bad-boxes "
+"(for example when a word exceed the margin). With Rubber, there is no "
+"distinction between critical errors and simple warnings. See <link xref="
+"\"#post-processors\"/> for more information."
+msgstr ""
+
+#: C/build_tools.page:104(section/p)
+msgid ""
+"Latexmk is more flexible. Each low-level command can be customized, for "
+"example for adding a parameter, or use a completely other tool. This can be "
+"done both from the command line and in configuration files (see the <cmd>-e</"
+"cmd> and <cmd>-r</cmd> options). Rubber is also configurable, but less than "
+"Latexmk."
+msgstr ""
+
+#: C/build_tools.page:109(section/p)
+msgid ""
+"Last, but not least: Rubber seems to have more bugs and is less actively "
+"maintained than Latexmk."
+msgstr ""
+
+#: C/build_tools.page:114(section/title)
+msgid "Execute a Build Tool"
+msgstr ""
+
+#: C/build_tools.page:116(section/p)
+msgid "There are several means to execute a build tool:"
+msgstr ""
+
+#: C/build_tools.page:118(item/p)
+msgid "Open the <gui style=\"menu\">Build</gui> menu (first part)."
+msgstr ""
+
+#: C/build_tools.page:119(item/p)
+msgid "Use the buttons in the main toolbar (last part)."
+msgstr ""
+
+#: C/build_tools.page:120(item/p)
+msgid "Use the shortcut: <key>F2</key> â <key>F11</key>."
+msgstr ""
+
+#: C/build_tools.page:123(section/p)
+msgid ""
+"The build tool is executed on the currently opened file. If the file belongs "
+"to a project, it is executed on the project's main file."
+msgstr ""
+
+#: C/build_tools.page:127(note/title)
+msgid "Hidden Build Tools"
+msgstr ""
+
+#: C/build_tools.page:128(note/p)
+msgid ""
+"By default, a lot of build tools are hidden, so they can't be executed. To "
+"view the full list of build tools, activate or configure them, read the "
+"<link xref=\"#general_configuration\"/> section."
+msgstr ""
+
+#: C/build_tools.page:135(section/title)
+msgid "General Configuration"
+msgstr "Allgemeine Konfiguration"
+
+#: C/build_tools.page:137(section/p)
+msgid ""
+"To configure the build tools, open the preferences dialog: <guiseq> <gui "
+"style=\"menu\">Edit</gui> <gui style=\"menu\">Preferences</gui> <gui style="
+"\"tab\">LaTeX</gui> </guiseq>"
+msgstr ""
+
+#: C/build_tools.page:146(section/p)
+msgid ""
+"You will see a list with all the build tools. There are check buttons to "
+"show or hide them. When a build tool is hidden, it's not possible to execute "
+"it. You can perform some actions, like moving a tool up or down, open its "
+"properties, delete or copy it, create a new one, etc."
+msgstr ""
+
+#: C/build_tools.page:152(note/p)
+msgid "Double-click on a build tool will open its properties."
+msgstr ""
+
+#: C/build_tools.page:155(section/p)
+msgid ""
+"For an explanation of the option about the Latexmk post processor, see <link "
+"xref=\"#post-processors\"/>."
+msgstr ""
+
+#: C/build_tools.page:160(section/title)
+msgid "Jobs of a Build Tool"
+msgstr "Aufgaben eines Erstellungswerkzeuges"
+
+#: C/build_tools.page:162(section/p)
+msgid ""
+"In the properties of a build tool, the tricky part is to configure the jobs. "
+"A build tool can execute several jobs. Each job contains three pieces of "
+"information:"
+msgstr ""
+
+#: C/build_tools.page:166(item/p)
+msgid "The command, which can use placeholders."
+msgstr "Der Befehl, welcher Platzhalter enthalten kann."
+
+#: C/build_tools.page:167(item/p)
+msgid ""
+"Whether the job must succeed. If this option is enabled, when an error "
+"occurs during the job execution, the next job is not executed."
+msgstr ""
+
+#: C/build_tools.page:169(item/p)
+msgid "The post processor (see <link xref=\"#post-processors\"/>)."
+msgstr ""
+
+#: C/build_tools.page:174(section/title)
+msgid "Post Processors"
+msgstr ""
+
+#: C/build_tools.page:175(section/p)
+msgid ""
+"The purpose of a post processor is to filter the command output and extract "
+"the useful information. Five post processors are available:"
+msgstr ""
+
+#: C/build_tools.page:181(item/p)
+msgid "The output is simply not displayed."
+msgstr ""
+
+#: C/build_tools.page:185(item/p)
+msgid "All the output is displayed, without filter."
+msgstr ""
+
+#: C/build_tools.page:189(item/p)
+msgid ""
+"Filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> commands. "
+"There can be three types of errors: critical errors, warnings, or bad-boxes. "
+"There are also some other useful information: the size of the document, the "
+"number of pages, and the number of errors."
+msgstr ""
+
+#: C/build_tools.page:196(item/p)
+msgid ""
+"Used for the <cmd>latexmk</cmd> command. Internally, this post processor "
+"uses other ones: <em>latex</em> and <em>all-output</em>."
+msgstr ""
+
+#: C/build_tools.page:199(item/p)
+msgid ""
+"In the <link xref=\"#general_configuration\"/>, there is an option for "
+"always showing all information of this post processor. If this option is "
+"disabled (which is the case by default), only the output of the last "
+"<cmd>latex</cmd> or <cmd>pdflatex</cmd> command is displayed, if no error "
+"occurred in another command. This allows to reduce the output showed in the "
+"bottom panel. But even if there are no errors, it can be useful to see "
+"exactly which commands are executed, with their output."
+msgstr ""
+
+#: C/build_tools.page:209(item/p)
+msgid ""
+"This is the post-processor used for the <cmd>rubber</cmd> command. The "
+"errors are categorized into two types: bad-boxes, and the others. So, unlike "
+"the <em>latex</em> post processor, there is no distinction between critical "
+"errors and simple warnings."
+msgstr ""
+
+#: C/index.page:4(page/title)
+msgid "LaTeXila Help"
+msgstr "Hilfe zu LaTeXila"
diff --git a/help/de/de.po b/help/help.pot
similarity index 61%
rename from help/de/de.po
rename to help/help.pot
index 170551b..04c39ed 100644
--- a/help/de/de.po
+++ b/help/help.pot
@@ -1,282 +1,192 @@
-# German translation of the latexila documentation.
-# Mario BlÃttermann <mariobl freenet de>, 2011.
-#
 msgid ""
 msgstr ""
-"Project-Id-Version: latexila master\n"
-"POT-Creation-Date: 2011-07-15 23:29+0200\n"
-"PO-Revision-Date: 2011-07-15 23:55+0100\n"
-"Last-Translator: Mario BlÃttermann <mariobl freenet de>\n"
-"Language-Team: German <gnome-de gnome org>\n"
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2011-07-17 18:49+0200\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL ADDRESS>\n"
+"Language-Team: LANGUAGE <LL li org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"X-Poedit-Language: German\n"
-"X-Poedit-Country: GERMANY\n"
 
 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
 msgctxt "_"
 msgid "translator-credits"
-msgstr "Mario BlÃttermann <mariobl freenet de>, 2011"
+msgstr ""
 
-#: build_tools.page:9(page/title)
+#: C/build_tools.page:10(page/title)
 msgid "Build Tools"
-msgstr "Erstellungswerkzeuge"
+msgstr ""
 
-#: build_tools.page:12(synopsis/p)
+#: C/build_tools.page:13(synopsis/p)
 msgid "The purpose of the build tools is to generate a document in the PDF, DVI or PS format."
 msgstr ""
 
-#: build_tools.page:19(section/title)
+#: C/build_tools.page:20(section/title)
 msgid "Overview"
-msgstr "Ãbersicht"
+msgstr ""
 
-#: build_tools.page:21(section/p)
+#: C/build_tools.page:22(section/p)
 msgid "Several different tools can be used for a document compilation. There are some low-level commands, and two higher-level tools: Latexmk and Rubber."
 msgstr ""
 
-#: build_tools.page:25(table/title)
+#: C/build_tools.page:26(table/title)
 msgid "Low-level commands"
 msgstr ""
 
-#: build_tools.page:28(td/p)
+#: C/build_tools.page:29(td/p)
 msgid "Label"
 msgstr ""
 
-#: build_tools.page:29(td/p)
+#: C/build_tools.page:30(td/p)
 msgid "Command"
-msgstr "Befehl"
-
-#: build_tools.page:34(td/p)
-msgid "LaTeX â DVI"
-msgstr "LaTeX â DVI"
-
-#: build_tools.page:35(td/p)
-msgid "<cmd>latex</cmd>"
-msgstr "<cmd>latex</cmd>"
-
-#: build_tools.page:38(td/p)
-msgid "LaTeX â PDF"
-msgstr "LaTeX â PDF"
-
-#: build_tools.page:39(td/p)
-msgid "<cmd>pdflatex</cmd>"
-msgstr "<cmd>pdflatex</cmd>"
-
-#: build_tools.page:44(td/p)
-msgid "DVI â PDF"
-msgstr "DVI â PDF"
-
-#: build_tools.page:45(td/p)
-msgid "<cmd>dvipdf</cmd>"
-msgstr "<cmd>dvipdf</cmd>"
-
-#: build_tools.page:48(td/p)
-msgid "DVI â PS"
-msgstr "DVI â PS"
-
-#: build_tools.page:49(td/p)
-msgid "<cmd>dvips</cmd>"
-msgstr "<cmd>dvips</cmd>"
-
-#: build_tools.page:52(td/p)
-msgid "PS â PDF"
-msgstr "PS â PDF"
-
-#: build_tools.page:53(td/p)
-msgid "<cmd>ps2pdf</cmd>"
-msgstr "<cmd>ps2pdf</cmd>"
+msgstr ""
 
-#: build_tools.page:58(td/p)
+#: C/build_tools.page:59(td/p)
 msgid "Bibliography"
-msgstr "Bibliografie"
-
-#: build_tools.page:59(td/p)
-msgid "<cmd>bibtex</cmd>"
-msgstr "<cmd>bibtex</cmd>"
+msgstr ""
 
-#: build_tools.page:62(td/p)
+#: C/build_tools.page:63(td/p)
 msgid "Index"
-msgstr "Index"
-
-#: build_tools.page:63(td/p)
-msgid "<cmd>makeindex</cmd>"
-msgstr "<cmd>makeindex</cmd>"
+msgstr ""
 
-#: build_tools.page:68(section/p)
+#: C/build_tools.page:69(section/p)
 msgid "Compiling a LaTeX document can involve to execute several low-level commands, in a certain order and a certain number of times. Here is an example:"
 msgstr ""
 
-#: build_tools.page:70(section/screen)
-#, no-wrap
-msgid ""
-"\n"
-"$ latex document.tex\n"
-"$ bibtex document.aux\n"
-"$ latex document.tex\n"
-"$ dvips -t a4 document.dvi\n"
-"$ ps2pdf document.ps"
-msgstr ""
-"\n"
-"$ latex document.tex\n"
-"$ bibtex document.aux\n"
-"$ latex document.tex\n"
-"$ dvips -t a4 document.dvi\n"
-"$ ps2pdf document.ps"
-
-#: build_tools.page:77(section/p)
+#: C/build_tools.page:78(section/p)
 msgid "Using a higher-level tool such as Latexmk or Rubber simplify a lot all this process, since only one command is required. Indeed, these tools can detect how many times the <cmd>latex</cmd> or <cmd>pdflatex</cmd> command must be called, and whether <cmd>bibtex</cmd> or <cmd>makeindex</cmd> is required. By default, LaTeXila uses Latexmk."
 msgstr ""
 
-#: build_tools.page:85(section/title)
+#: C/build_tools.page:86(section/title)
 msgid "Differences Between Latexmk and Rubber"
-msgstr "Unterschiede zwischen Latexmk und Rubber"
+msgstr ""
 
-#: build_tools.page:86(section/p)
+#: C/build_tools.page:87(section/p)
 msgid "<link href=\"http://www.phys.psu.edu/~collins/software/latexmk-jcc/\";>Latexmk</link> and <link href=\"https://launchpad.net/rubber/\";>Rubber</link> have the same purpose: simplify the compilation process of a LaTeX document. Latexmk is written in Perl, while Rubber is written in Python."
 msgstr ""
 
-#: build_tools.page:91(section/p)
+#: C/build_tools.page:92(section/p)
 msgid "The output of Latexmk contains more information: which commands are executed, how many times, their output, and the reasons why Latexmk executes (or doesn't execute) these commands. The output of Rubber, on the other hand, doesn't contain a lot of information. When an error occurs, it can be more difficult to diagnose."
 msgstr ""
 
-#: build_tools.page:96(section/p)
+#: C/build_tools.page:97(section/p)
 msgid "Also, Rubber filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> command. As a consequence, when Rubber prints an error, it's more difficult to know which type of error it is. If you use Latexmk, errors are categorized into three types: critical errors, simple warnings and bad-boxes (for example when a word exceed the margin). With Rubber, there is no distinction between critical errors and simple warnings. See <link xref=\"#post-processors\"/> for more information."
 msgstr ""
 
-#: build_tools.page:103(section/p)
+#: C/build_tools.page:104(section/p)
 msgid "Latexmk is more flexible. Each low-level command can be customized, for example for adding a parameter, or use a completely other tool. This can be done both from the command line and in configuration files (see the <cmd>-e</cmd> and <cmd>-r</cmd> options). Rubber is also configurable, but less than Latexmk."
 msgstr ""
 
-#: build_tools.page:108(section/p)
+#: C/build_tools.page:109(section/p)
 msgid "Last, but not least: Rubber seems to have more bugs and is less actively maintained than Latexmk."
 msgstr ""
 
-#: build_tools.page:113(section/title)
+#: C/build_tools.page:114(section/title)
 msgid "Execute a Build Tool"
 msgstr ""
 
-#: build_tools.page:115(section/p)
+#: C/build_tools.page:116(section/p)
 msgid "There are several means to execute a build tool:"
 msgstr ""
 
-#: build_tools.page:117(item/p)
+#: C/build_tools.page:118(item/p)
 msgid "Open the <gui style=\"menu\">Build</gui> menu (first part)."
 msgstr ""
 
-#: build_tools.page:118(item/p)
+#: C/build_tools.page:119(item/p)
 msgid "Use the buttons in the main toolbar (last part)."
 msgstr ""
 
-#: build_tools.page:119(item/p)
+#: C/build_tools.page:120(item/p)
 msgid "Use the shortcut: <key>F2</key> â <key>F11</key>."
 msgstr ""
 
-#: build_tools.page:122(section/p)
+#: C/build_tools.page:123(section/p)
 msgid "The build tool is executed on the currently opened file. If the file belongs to a project, it is executed on the project's main file."
 msgstr ""
 
-#: build_tools.page:126(note/title)
+#: C/build_tools.page:127(note/title)
 msgid "Hidden Build Tools"
 msgstr ""
 
-#: build_tools.page:127(note/p)
+#: C/build_tools.page:128(note/p)
 msgid "By default, a lot of build tools are hidden, so they can't be executed. To view the full list of build tools, activate or configure them, read the <link xref=\"#general_configuration\"/> section."
 msgstr ""
 
-#: build_tools.page:134(section/title)
+#: C/build_tools.page:135(section/title)
 msgid "General Configuration"
-msgstr "Allgemeine Konfiguration"
+msgstr ""
 
-#: build_tools.page:136(section/p)
+#: C/build_tools.page:137(section/p)
 msgid "To configure the build tools, open the preferences dialog: <guiseq> <gui style=\"menu\">Edit</gui> <gui style=\"menu\">Preferences</gui> <gui style=\"tab\">LaTeX</gui> </guiseq>"
 msgstr ""
 
-#: build_tools.page:145(section/p)
+#: C/build_tools.page:146(section/p)
 msgid "You will see a list with all the build tools. There are check buttons to show or hide them. When a build tool is hidden, it's not possible to execute it. You can perform some actions, like moving a tool up or down, open its properties, delete or copy it, create a new one, etc."
 msgstr ""
 
-#: build_tools.page:151(note/p)
+#: C/build_tools.page:152(note/p)
 msgid "Double-click on a build tool will open its properties."
 msgstr ""
 
-#: build_tools.page:154(section/p)
+#: C/build_tools.page:155(section/p)
 msgid "For an explanation of the option about the Latexmk post processor, see <link xref=\"#post-processors\"/>."
 msgstr ""
 
-#: build_tools.page:159(section/title)
+#: C/build_tools.page:160(section/title)
 msgid "Jobs of a Build Tool"
-msgstr "Aufgaben eines Erstellungswerkzeuges"
+msgstr ""
 
-#: build_tools.page:161(section/p)
+#: C/build_tools.page:162(section/p)
 msgid "In the properties of a build tool, the tricky part is to configure the jobs. A build tool can execute several jobs. Each job contains three pieces of information:"
 msgstr ""
 
-#: build_tools.page:165(item/p)
+#: C/build_tools.page:166(item/p)
 msgid "The command, which can use placeholders."
-msgstr "Der Befehl, welcher Platzhalter enthalten kann."
+msgstr ""
 
-#: build_tools.page:166(item/p)
+#: C/build_tools.page:167(item/p)
 msgid "Whether the job must succeed. If this option is enabled, when an error occurs during the job execution, the next job is not executed."
 msgstr ""
 
-#: build_tools.page:168(item/p)
+#: C/build_tools.page:169(item/p)
 msgid "The post processor (see <link xref=\"#post-processors\"/>)."
 msgstr ""
 
-#: build_tools.page:173(section/title)
+#: C/build_tools.page:174(section/title)
 msgid "Post Processors"
 msgstr ""
 
-#: build_tools.page:174(section/p)
+#: C/build_tools.page:175(section/p)
 msgid "The purpose of a post processor is to filter the command output and extract the useful information. Five post processors are available:"
 msgstr ""
 
-#: build_tools.page:179(item/title)
-msgid "no-output"
-msgstr "no-output"
-
-#: build_tools.page:180(item/p)
+#: C/build_tools.page:181(item/p)
 msgid "The output is simply not displayed."
 msgstr ""
 
-#: build_tools.page:183(item/title)
-msgid "all-output"
-msgstr "all-output"
-
-#: build_tools.page:184(item/p)
+#: C/build_tools.page:185(item/p)
 msgid "All the output is displayed, without filter."
 msgstr ""
 
-#: build_tools.page:187(item/title)
-msgid "latex"
-msgstr "latex"
-
-#: build_tools.page:188(item/p)
+#: C/build_tools.page:189(item/p)
 msgid "Filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> commands. There can be three types of errors: critical errors, warnings, or bad-boxes. There are also some other useful information: the size of the document, the number of pages, and the number of errors."
 msgstr ""
 
-#: build_tools.page:194(item/title)
-msgid "latexmk"
-msgstr "latexmk"
-
-#: build_tools.page:195(item/p)
+#: C/build_tools.page:196(item/p)
 msgid "Used for the <cmd>latexmk</cmd> command. Internally, this post processor uses other ones: <em>latex</em> and <em>all-output</em>."
 msgstr ""
 
-#: build_tools.page:198(item/p)
+#: C/build_tools.page:199(item/p)
 msgid "In the <link xref=\"#general_configuration\"/>, there is an option for always showing all information of this post processor. If this option is disabled (which is the case by default), only the output of the last <cmd>latex</cmd> or <cmd>pdflatex</cmd> command is displayed, if no error occurred in another command. This allows to reduce the output showed in the bottom panel. But even if there are no errors, it can be useful to see exactly which commands are executed, with their output."
 msgstr ""
 
-#: build_tools.page:207(item/title)
-msgid "rubber"
-msgstr "rubber"
-
-#: build_tools.page:208(item/p)
+#: C/build_tools.page:209(item/p)
 msgid "This is the post-processor used for the <cmd>rubber</cmd> command. The errors are categorized into two types: bad-boxes, and the others. So, unlike the <em>latex</em> post processor, there is no distinction between critical errors and simple warnings."
 msgstr ""
 
-#: index.page:4(page/title)
+#: C/index.page:4(page/title)
 msgid "LaTeXila Help"
-msgstr "Hilfe zu LaTeXila"
+msgstr ""
 
diff --git a/help/update_help_pot.sh b/help/update_help_pot.sh
new file mode 100755
index 0000000..c07c9d9
--- /dev/null
+++ b/help/update_help_pot.sh
@@ -0,0 +1,7 @@
+#!/bin/sh
+
+itstool -o help.pot C/*.page
+
+for po_file in *.po; do
+	msgmerge --update --quiet --backup=none $po_file help.pot
+done
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]