Add files to translate messages from stylesheets

1 files changed, 43 insertions, 0 deletions

diff --git a/docs/stylesheets/README b/docs/stylesheets/README
new file mode 100644
index 00000000..7cdceaf7
--- /dev/null
+++ b/docs/stylesheets/README
@@ -0,0 +1,43 @@
+The scripts may be useful for those who want to
+organize sustainable translation process of Mageia Documentation Team's .xsl files.
+
+Prerequisites:
+
+Installed python-polib package:
+
+# urpmi python-polib
+
+I xslpo.py:
+
+Usage:
+
+1. Copy the script into any folder with .xsl files.
+2. Run
+  python xslpo.py
+3. Script will create .pot's for all .desktop's in the folder. Translate pot's and
+   rename the translations into <lang_code>.po
+4. Run
+  python xslpo.py
+   once more to add your translations to .desktop files.
+
+If you ever need to update something (.xsl's were updated or you found a typo,
+etc.) just run
+  python xslpo.py
+
+Limitations:
+The script is useful only for Unicode translations.
+
+II transconverter.py is a one-time converter for existing
+translations.
+
+Run it as
+
+python transconverter.py
+
+in any folder with desktop files on any level of the filesystem subtree.
+
+  * Both of these files are free software. They come without any warranty, to
+  * the extent permitted by applicable law. You can redistribute it
+  * and/or modify them under the terms of the Do What The Fuck You Want
+  * To Public License, Version 2, as published by Sam Hocevar. See
+  * http://sam.zoy.org/wtfpl/COPYING for more details.