Merge pull request #4 from Ghini/ghini-1.0-dev

Ghini 1.0 dev

.gitignore

@@ -1,2 +1,3 @@
 *~
 *.mo
+doc/_build/

doc/runme

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# configure languages
+LANGUAGES='ar cs da de es fr hi it pl pt_BR ru sv uk zh jp'
+SOURCEDOCDIR=~/Local/github/Ghini/ghini.desktop/doc
+CHECKOUTDIR=~/Local/github/Ghini/ghini.desktop-docs.i18n
+
+echo "press enter to start"
+read
+
+echo "all remaining actions must be run from the doc dir"
+cd $CHECKOUTDIR/doc
+
+echo "copy/update files from the documentation"
+echo "press enter to start this."
+read
+cp -pu $SOURCEDOCDIR/*.rst .
+rm api.rst
+
+echo "update the centralised doc.pot (two steps, first all pot, then merge them)"
+echo "press enter to start this"
+read
+make gettext
+msgcat -o _build/locale-merged/doc.pot _build/locale/*.pot
+
+echo "update all LANGUAGE/doc.po files in CHECKOUTDIR/local/"
+sphinx-intl update -p _build/locale-merged $(for i in $LANGUAGES; do printf -- '-l %s ' $i; done)
+
+echo "make sure we have all the symbolic links for po files"
+echo "press enter to start this."
+read
+for l in $LANGUAGES
+do
+    cd $CHECKOUTDIR/locale/$l/LC_MESSAGES/
+    for i in $(find $CHECKOUTDIR/doc -maxdepth 1 -type f -name "*rst")
+    do
+        ln -s doc.po $(basename $i .rst).po 2>/dev/null
+    done
+done
+
+echo "this is enough as far as weblate and readthedocs are concerned"
+#################################################################
+echo press enter to continue
+read
+
+#################################################################
+# build translated documentation for all configured languages
+
+# 1) update mo files from symlinks to doc.po.
+sphinx-intl build
+
+# 2) use the updated mo files to build the local html files
+for i in $LANGUAGES
+do
+    make -e SPHINXOPTS="-D language='"$i"'" html
+    mkdir -p ../translated/$i
+    cp -a _build/html ../translated/$i
+done

locale/ar/LC_MESSAGES/doc.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2017-06-22 16:15-0500\n"
+"POT-Creation-Date: 2017-06-23 11:34-0500\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -110,120 +110,6 @@ msgstr ""
 msgid "Ghini development site can be accessed via the Help menu."
 msgstr ""
 
-#: ../../api.rst:2
-msgid "API Documentation"
-msgstr ""
-
-#: ../../api.rst:5
-msgid ":mod:`bauble`"
-msgstr ""
-
-#: ../../api.rst:17
-msgid ":mod:`bauble.db`"
-msgstr ""
-
-#: ../../api.rst:24
-msgid ""
-"All tables/mappers in Ghini which use the SQLAlchemy declarative plugin "
-"for declaring tables and mappers should derive from this class."
-msgstr ""
-
-#: ../../api.rst:28
-msgid "An instance of :class:`sqlalchemy.ext.declarative.Base`"
-msgstr ""
-
-#: ../../api.rst:33
-msgid "The default metadata for all Ghini tables."
-msgstr ""
-
-#: ../../api.rst:35
-msgid "An instance of :class:`sqlalchemy.schema.MetaData`"
-msgstr ""
-
-#: ../../api.rst:49
-msgid ":mod:`bauble.connmgr`"
-msgstr ""
-
-#: ../../api.rst:57
-msgid ":mod:`bauble.editor`"
-msgstr ""
-
-#: ../../api.rst:78
-msgid ":mod:`bauble.i18n`"
-msgstr ""
-
-#: ../../api.rst:83
-msgid ":mod:`bauble.ui`"
-msgstr ""
-
-#: ../../api.rst:91
-msgid ":mod:`bauble.meta`"
-msgstr ""
-
-#: ../../api.rst:99
-msgid ":mod:`bauble.paths`"
-msgstr ""
-
-#: ../../api.rst:108
-msgid ":mod:`bauble.pluginmgr`"
-msgstr ""
-
-#: ../../api.rst:122
-msgid ":mod:`bauble.prefs`"
-msgstr ""
-
-#: ../../api.rst:133
-msgid ":mod:`bauble.task`"
-msgstr ""
-
-#: ../../api.rst:141
-msgid ":mod:`bauble.types`"
-msgstr ""
-
-#: ../../api.rst:154
-msgid ":mod:`bauble.utils`"
-msgstr ""
-
-#: ../../api.rst:204
-msgid ":mod:`bauble.view`"
-msgstr ""
-
-#: ../../api.rst:230
-msgid ":mod:`bauble.search`"
-msgstr ""
-
-#: ../../api.rst:243
-msgid ":mod:`bauble.plugins.plants`"
-msgstr ""
-
-#: ../../api.rst:278
-msgid ":mod:`bauble.plugins.garden`"
-msgstr ""
-
-#: ../../api.rst:316
-msgid ":mod:`bauble.plugins.abcd`"
-msgstr ""
-
-#: ../../api.rst:325
-msgid ":mod:`bauble.plugins.imex`"
-msgstr ""
-
-#: ../../api.rst:329
-msgid ":mod:`bauble.plugins.report`"
-msgstr ""
-
-#: ../../api.rst:333
-msgid ":mod:`bauble.plugins.report.xsl`"
-msgstr ""
-
-#: ../../api.rst:337
-msgid ":mod:`bauble.plugins.report.mako`"
-msgstr ""
-
-#: ../../api.rst:341
-msgid ":mod:`bauble.plugins.tag`"
-msgstr ""
-
 #: ../../building.rst:2
 msgid "Developer's Manual"
 msgstr ""
@@ -3867,3 +3753,91 @@ msgstr ""
 msgid "engraving labels"
 msgstr ""
 
+#~ msgid "API Documentation"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.db`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "All tables/mappers in Ghini which use"
+#~ " the SQLAlchemy declarative plugin for "
+#~ "declaring tables and mappers should "
+#~ "derive from this class."
+#~ msgstr ""
+
+#~ msgid "An instance of :class:`sqlalchemy.ext.declarative.Base`"
+#~ msgstr ""
+
+#~ msgid "The default metadata for all Ghini tables."
+#~ msgstr ""
+
+#~ msgid "An instance of :class:`sqlalchemy.schema.MetaData`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.connmgr`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.editor`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.i18n`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.ui`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.meta`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.paths`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.pluginmgr`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.prefs`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.task`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.types`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.utils`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.view`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.search`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.plants`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.garden`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.abcd`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.imex`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.report`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.report.xsl`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.report.mako`"
+#~ msgstr ""
+
+#~ msgid ":mod:`bauble.plugins.tag`"
+#~ msgstr ""
+