summaryrefslogtreecommitdiffhomepage
path: root/docs/i18n.md
diff options
context:
space:
mode:
authorJo-Philipp Wich <jo@mein.io>2019-11-05 10:27:59 +0100
committerJo-Philipp Wich <jo@mein.io>2019-11-05 10:42:54 +0100
commitbaa727de93db009f90d70a80a9861758a24eae77 (patch)
treefd91ac853abc2feef5496720e5284e911ad1b020 /docs/i18n.md
parent355a48866d1a43df9443a3b559c8ec8642343f3a (diff)
docs: rename documentation folder to docs
Signed-off-by: Jo-Philipp Wich <jo@mein.io>
Diffstat (limited to 'docs/i18n.md')
-rw-r--r--docs/i18n.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/i18n.md b/docs/i18n.md
new file mode 100644
index 000000000..226a406c2
--- /dev/null
+++ b/docs/i18n.md
@@ -0,0 +1,19 @@
+# General
+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/[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)
+
+*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