Link https://wiki.gnucash.org/wiki/Documentation_Translation#The_Proc…

…edure

in recent gnc-gui-*.dtd files

docbook/gnc-gui-C.dtd

@@ -12,7 +12,11 @@
      the accelerator as keyboard shortcut in the translation too.
 
      As an example, compare this file with the German localization
-     gnc-gui-de.dtd. -->
+     gnc-gui-de.dtd.
+
+     Some ideas to do it faster are documented in step
+     4. Create a localized dtd of
+     https://wiki.gnucash.org/wiki/Documentation_Translation#The_Procedure -->
 
 <!-- guimenu/guisubmenu/guimenuitem to be used as names in text -->
 <!-- <!ENTITY % gmi.xxx "<guimenuitem><accel></accel></guimenuitem>"> -->

docbook/gnc-gui-de.dtd

@@ -12,7 +12,11 @@
      the accelerator as keyboard shortcut in the translation too.
 
      As an example, compare this file with the German localization
-     gnc-gui-de.dtd. -->
+     gnc-gui-de.dtd.
+
+     Some ideas to do it faster are documented in step
+     4. Create a localized dtd of
+     https://wiki.gnucash.org/wiki/Documentation_Translation#The_Procedure -->
 
 <!-- guimenu/guisubmenu/guimenuitem to be used as names in text -->
 <!-- <!ENTITY % gmi.xxx "<guimenuitem><accel></accel></guimenuitem>"> -->
@@ -307,7 +311,7 @@
 <!ENTITY % gmi.ed.emp.edit "<guimenuitem><accel>M</accel>itarbeiter bearbeiten</guimenuitem>">
 <!ENTITY % gmi.ed.emp.new "<guimenuitem><accel>N</accel>euer Mitarbeiter…</guimenuitem>">
 
-<!-- Business Editor (Customer, Vendor and Employee); Reports-Menu -->
+<!-- Business (Customer, Vendor and Employee); Reports-Menu -->
 <!ENTITY % gmi.rep.cus-list "<guimenuitem>Liste der Kunden</guimenuitem>">
 <!ENTITY % gmi.rep.cus-rep "<guimenuitem>Kundenbericht</guimenuitem>">
 <!ENTITY % gmi.rep.ven-list "<guimenuitem>Liste der Lieferanten</guimenuitem>">
@@ -412,8 +416,8 @@
 <!ENTITY % kc.ctrl '<keycap function="control">Strg</keycap>'>
 <!ENTITY % kc.del '<keycap function="delete">Entfernen</keycap>'>
 <!ENTITY % kc.end '<keycap function="end">Ende</keycap>'>
-<!ENTITY % kc.esc '<keycap function="escape">Esc</keycap>'>
 <!ENTITY % kc.enter '<keycap function="enter">Eingabe</keycap>'>
+<!ENTITY % kc.esc '<keycap function="escape">Esc</keycap>'>
 <!ENTITY % kc.home '<keycap function="home">Pos1</keycap>'>
 <!ENTITY % kc.pgdown '<keycap function="pagedown">Seite Abwärts</keycap>'>
 <!ENTITY % kc.shift '<keycap function="shift">Umschalt</keycap>'>

docbook/gnc-gui-zh.dtd

@@ -1,6 +1,30 @@
-<!-- Add translated entities below. The master entities are in gnc-gui-C.dtd.
-     Only parameter entities (% entities) should be translated.
-     See htps://www.w3.org/TR/REC-xml/#sec-physical-struct. -->
+<!-- Explanation for translators:
+     In this file all entries of the menus are offered for translation.
+     With this magic, we have only one place to maintain menu items
+     and other user interface controls and it is consistent for the
+     user throughout the document - without typos.
+
+     Task:
+     For editing, start Gnucash in your language and update this list
+     with the menu entries.
+     Please note that the entities are not changed and the translated
+     menu entry is entered inside the angle brackets >xxx<. Please mark
+     the accelerator as keyboard shortcut in the translation too.
+
+     As an example, compare this file with the German localization
+     gnc-gui-de.dtd.
+
+     Some ideas to do it faster are documented in step
+     4. Create a localized dtd of
+     https://wiki.gnucash.org/wiki/Documentation_Translation#The_Procedure -->
+
+<!-- guimenu/guisubmenu/guimenuitem to be used as names in text -->
+<!-- <!ENTITY % gmi.xxx "<guimenuitem><accel></accel></guimenuitem>"> -->
+
+<!-- Description: 
+     gm:  short for <guimenu>…</guimenu>, the entries in the menubar;
+     gsm: short for <guisubmenu>…</guisubmenu>, the submenus;
+     gmi: short for <guimenuitem>…<guimenuitem>, the leaves of the menu tree. -->
 
 <!-- File-Menu -->
 <!ENTITY % gm.file "<guimenu>文件(<accel>F</accel>)</guimenu>">