preparation for document translations

.gitignore

@@ -38,6 +38,7 @@ config.h
 doc/Doxyfile
 doc/html/
 doc/docbuild/
+doc/locale/pot
 
 MYMETA.*
 pm_to_blib

doc/conf.py

@@ -76,6 +76,25 @@
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #language = None
+locale_dirs = ['locale/']
+gettext_compact = False
+
+## HACK for Read-the-Docs
+##  Generate .mo files just in time
+if os.environ.get('READTHEDOCS') == 'True':
+  import polib
+  print "Generating .mo files",
+  for locale_dir in locale_dirs:
+    for path, dummy, filenames in os.walk(locale_dir):
+      for filename in filenames:
+        po_file = os.path.join(path, filename)
+        base, ext = os.path.splitext(po_file)
+        if ext == ".po":
+          mo_file = base + ".mo"
+          po = polib.pofile(po_file)
+          po.save_as_mofile(fpath=mo_file)
+  print "done"
+## End of HACK
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

doc/pip_requirements.txt

@@ -0,0 +1,2 @@
+polib>=1.0.3
+