Browse Source

documentation: Update i18n advice

Signed-off-by: Hannu Nyman <hannu.nyman@iki.fi>
Hannu Nyman 7 years ago
parent
commit
87ae1242b8
1 changed files with 9 additions and 7 deletions
  1. 9 7
      documentation/i18n.md

+ 9 - 7
documentation/i18n.md

@@ -1,17 +1,19 @@
 # General
-Translations are saved in the folder po/. You find the reference in po/templates/<package>.pot. The actual translation files can be found at po/<lang>/<package>.po .
+Translations are saved in the folder po/ for each module and application. You find the reference in po/templates/<package>.pot. The actual translation files can be found at po/[lang]/[package].po .
 
 In order to use the commands below you need to have the _gettext'' utilities (''msgcat'', ''msgfmt'', ''msgmerge_) installed on your system.
 
 # Rebuild po files
 If you want to rebuild the translations after you made changes to a package this is an easy way:
-
-	
-	./build/i18n-scan.pl applications/[package] > po/templates/[application].pot
-	./build/i18n-update.pl po [application].po
 	
-*Note:* Some packages share translation files, in this case you need to scan through all their folders. The first command from above should then be:
+	./build/i18n-scan.pl applications/[application] > applications/[application]/po/templates/[application_basename].pot
+	./build/i18n-update.pl applications/[application]/po
 
+	Example:
+	./build/i18n-scan.pl applications/luci-app-firewall > applications/luci-app-firewall/po/templates/firewall.pot
+	./build/i18n-update.pl applications/luci-app-firewall/po
+	(note that the directory argument can be omitted for i18n-update.pl to update all apps)
 	
-	./build/i18n-scan.pl applications/[package-1] applications/[package-2] applications/[package-n] > po/templates/[application].pot
+*Note:* Some packages share translation files, in this case you need to scan through all their folders. The first command from above should then be:
 	
+	./build/i18n-scan.pl applications/[package-1] applications/[package-2] applications/[package-n] > [location of shared template]/[application].pot