Merge pull request doxygen#12236 from albert-github/feature/bug_translations_2

Correcting problems in translated configuration files

Author: doxygen

src/configgen.py

@@ -19,6 +19,7 @@
 from xml.dom import Node
 import io
 import glob
+import os
 
 messages = {}
 
@@ -1108,9 +1109,14 @@ def main():
         print(" * python configgen.py -doc %s to regenerate this file!" % configFile)
         print(" */")
         # process header
+        foundHeader = False
+        foundFooter = False
         for n in elem.childNodes:
             if n.nodeType == Node.ELEMENT_NODE and n.nodeName == "header":
+                foundHeader = True
                 parseHeaderDoc(n, mode)
+        if not foundHeader:
+            print("/*! \\page %s"%re.sub(".xml",'',os.path.basename(configFile)))
         # generate list with all commands
         commandsList = ()
         for n in elem.childNodes:
@@ -1127,7 +1133,10 @@ def main():
         # process footers
         for n in elem.childNodes:
             if n.nodeType == Node.ELEMENT_NODE and n.nodeName == "footer":
+                foundFooter = True
                 parseFooterDoc(n, mode)
+        if not foundFooter:
+            print("*/")
     elif sys.argv[1] == "-maph":
         print("/* WARNING: This file is generated!")
         print(" * Do not edit this file, but edit %s instead and run" % configFile)

src/i18n/config_de.xml

@@ -199,7 +199,7 @@
     </option>
     <option type="list" id="ALIASES" format="string">
       <docs>
-<![CDATA[Dieses Tag kann verwendet werden, um eine Reihe von Aliasnamen anzugeben, die als Befehle in der Dokumentation fungieren. Ein Alias hat die Form: \verbatim name=wert\endverbatim Zum Beispiel wurde das Hinzufügen von \verbatim "sideeffect=@par Nebeneffekte:^^"\endverbatim es Ihnen ermöglichen, den Befehl \c \sideeffect (oder \c \@sideeffect) in der Dokumentation zu platzieren, was einen benutzerdefinierten Absatz mit der Überschrift "Nebeneffekte:" erzeugt. Beachten Sie, dass Sie im Werteteil eines Alias kein \ref cmdn "\n" einfügen können, um einen Zeilenumbruch einzufügen (in der resultierenden Ausgabe). Sie können `^^` im Werteteil eines Alias einfügen, um einen Zeilenumbruch einzufügen, als ob ein physikalischer Zeilenumbruch in der Originaldatei vorhanden wäre.]]>
+<![CDATA[Dieses Tag kann verwendet werden, um eine Reihe von Aliasnamen anzugeben, die als Befehle in der Dokumentation fungieren. Ein Alias hat die Form: \verbatim name=wert\endverbatim Zum Beispiel wurde das Hinzufügen von \verbatim "sideeffect=@par Nebeneffekte:^^"\endverbatim es Ihnen ermöglichen, den Befehl \c \\sideeffect (oder \c \@sideeffect) in der Dokumentation zu platzieren, was einen benutzerdefinierten Absatz mit der Überschrift "Nebeneffekte:" erzeugt. Beachten Sie, dass Sie im Werteteil eines Alias kein \ref cmdn "\\n" einfügen können, um einen Zeilenumbruch einzufügen (in der resultierenden Ausgabe). Sie können `^^` im Werteteil eines Alias einfügen, um einen Zeilenumbruch einzufügen, als ob ein physikalischer Zeilenumbruch in der Originaldatei vorhanden wäre.]]>
       </docs>
       <docs>
 <![CDATA[
@@ -832,7 +832,12 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="bool" id="USE_HTAGS" defval="0" depends="SOURCE_BROWSER">
       <docs>
-<![CDATA[Wenn das \c USE_HTAGS-Tag auf \c YES gesetzt ist, verweisen die Referenzen auf den Quellcode auf das vom \c htags(1)-Tool generierte HTML anstelle des integrierten Quellcode-Browsers von Doxygen. Das \c htags-Tool ist Teil des globalen Quellcode-Tagging-Systems von GNU (siehe https://www.gnu.org/software/global/global.html). Sie benötigen Version 4.8.6 oder höher. <br>Um es zu verwenden, tun Sie Folgendes: -# Installieren Sie die neueste Version von \c global -# Aktivieren Sie \ref cfg_source_browser "SOURCE_BROWSER" und \c USE_HTAGS in der Konfigurationsdatei -# Stellen Sie sicher, dass \ref cfg_input "INPUT" auf die Wurzel des Quellbaums zeigt -# Führen Sie \c doxygen wie gewohnt aus <br>Doxygen ruft \c htags auf (und das wiederum ruft \c gtags auf), daher müssen diese Tools über die Befehlszeile verfügbar sein (d.h. im Suchpfad). <br>Das Ergebnis: Anstelle des von Doxygen generierten Quellcode-Browsers zeigen die Links zum Quellcode jetzt auf die Ausgabe von \c htags.]]>
+<![CDATA[Wenn das \c USE_HTAGS-Tag auf \c YES gesetzt ist, verweisen die Referenzen auf den Quellcode auf das vom \c htags(1)-Tool generierte HTML anstelle des integrierten Quellcode-Browsers von Doxygen. Das \c htags-Tool ist Teil des globalen Quellcode-Tagging-Systems von GNU (siehe https://www.gnu.org/software/global/global.html). Sie benötigen Version 4.8.6 oder höher. <br>Um es zu verwenden, tun Sie Folgendes:
+-# Installieren Sie die neueste Version von \c global
+-# Aktivieren Sie \ref cfg_source_browser "SOURCE_BROWSER" und \c USE_HTAGS in der Konfigurationsdatei
+-# Stellen Sie sicher, dass \ref cfg_input "INPUT" auf die Wurzel des Quellbaums zeigt
+-# Führen Sie \c doxygen wie gewohnt aus
+<br>Doxygen ruft \c htags auf (und das wiederum ruft \c gtags auf), daher müssen diese Tools über die Befehlszeile verfügbar sein (d.h. im Suchpfad). <br>Das Ergebnis: Anstelle des von Doxygen generierten Quellcode-Browsers zeigen die Links zum Quellcode jetzt auf die Ausgabe von \c htags.]]>
       </docs>
     </option>
     <option type="bool" id="VERBATIM_HEADERS" defval="1">
@@ -1210,7 +1215,10 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="string" id="MATHJAX_CODEFILE" format="string" depends="USE_MATHJAX">
       <docs>
-<![CDATA[Das \c MATHJAX_CODEFILE-Tag kann verwendet werden, um eine Datei mit JavaScript-Code-Stucken anzugeben, die beim Start des MathJax-Codes verwendet werden. Siehe die MathJax-Website für weitere Details: - <a href="https://docs.mathjax.org/en/v2.7/">MathJax version 2</a> - <a href="https://docs.mathjax.org/en/v3.2/">MathJax version 3</a> - <a href="https://docs.mathjax.org/en/v4.0/">MathJax version 4</a>]]>
+<![CDATA[Das \c MATHJAX_CODEFILE-Tag kann verwendet werden, um eine Datei mit JavaScript-Code-Stucken anzugeben, die beim Start des MathJax-Codes verwendet werden. Siehe die MathJax-Website für weitere Details:
+ - <a href="https://docs.mathjax.org/en/v2.7/">MathJax version 2</a>
+ - <a href="https://docs.mathjax.org/en/v3.2/">MathJax version 3</a>
+ - <a href="https://docs.mathjax.org/en/v4.0/">MathJax version 4</a>]]>
       </docs>
       <docs filter="doxyfile,doxywizard">
 <![CDATA[
@@ -1817,7 +1825,14 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="string" id="MERMAID_JS_URL" format="string" defval="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs">
       <docs>
-<![CDATA[Das \c MERMAID_JS_URL-Tag gibt die URL an, von der \c mermaid.js geladen werden soll, wenn clientseitiges Rendering verwendet wird (\c MERMAID_RENDER_MODE ist \c CLIENT_SIDE oder \c AUTO). Der Standardwert verweist auf die neueste Mermaid v11-Version auf dem jsDelivr CDN. \par Beispiele: - Neueste v11 (Standard): <code>https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs</code> - Angeheftete Version: <code>https://cdn.jsdelivr.net/npm/mermaid@11.3.0/dist/mermaid.esm.min.mjs</code> - Lokale Kopie: <code>./mermaid.esm.min.mjs</code> (Benutzer muss Datei im HTML-Ausgabeverzeichnis platzieren) \par Die Standard-CDN-URL erfordert Internetzugang beim Anzeigen der generierten Dokumentation. Für die Offline-Verwendung laden Sie \c mermaid.esm.min.mjs herunter und setzen Sie dies auf einen relativen Pfad, oder verwenden Sie \c MERMAID_RENDER_MODE=CLI, um stattdessen Bilder vorab zu generieren.]]>
+<![CDATA[Das \c MERMAID_JS_URL-Tag gibt die URL an, von der \c mermaid.js geladen werden soll, wenn clientseitiges Rendering verwendet wird (\c MERMAID_RENDER_MODE ist \c CLIENT_SIDE oder \c AUTO). Der Standardwert verweist auf die neueste Mermaid v11-Version auf dem jsDelivr CDN.
+<br>
+Die Standard-CDN-URL erfordert Internetzugang beim Anzeigen der generierten Dokumentation. Für die Offline-Verwendung laden Sie \c mermaid.esm.min.mjs herunter und setzen Sie dies auf einen relativen Pfad, oder verwenden Sie \c MERMAID_RENDER_MODE=CLI, um stattdessen Bilder vorab zu generieren.
+\par Beispiele:
+ - Neueste v11 (Standard): <code>https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs</code>
+ - Angeheftete Version: <code>https://cdn.jsdelivr.net/npm/mermaid@11.3.0/dist/mermaid.esm.min.mjs</code>
+ - Lokale Kopie: <code>./mermaid.esm.min.mjs</code> (Benutzer muss Datei im HTML-Ausgabeverzeichnis platzieren)
+]]>
       </docs>
     </option>
     <option type="list" id="MERMAIDFILE_DIRS" format="dir">