[Qgis-community-team] QGIS Documentation translate procedure

[Rudi Thiede]

Hi all,

I'm following the procedure to set up translation of the readme for
https://github.com/qgis/QGIS-Documentation

But as soon as I run the command:

> sphinx-build -b gettext -c source source/introduction/ source/translated/pot

or the same command for any other chapter of the docs, I get an error.
It gets to the stage of "writing output..." and then the error occurs.
The traceback:

===============================
# Sphinx version: 1.1.3
# Python version: 2.7.2+
# Docutils version: 0.8.1 release
# Jinja2 version: 2.6
Traceback (most recent call last):
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/cmdline.py",
line 189, in main
    app.build(force_all, filenames)
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/application.py",
line 204, in build
    self.builder.build_update()
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/builders/__init__.py",
line 196, in build_update
    'out of date' % len(to_build))
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/builders/__init__.py",
line 252, in build
    self.write(docnames, list(updated_docnames), method)
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/builders/__init__.py",
line 291, in write
    doctree = self.env.get_and_resolve_doctree(docname, self)
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/environment.py",
line 1230, in get_and_resolve_doctree
    doctree = self.get_doctree(docname)
  File "/home/rudi/Documents/QGIS-Documentation/qgis-doc-env/lib/python2.7/site-packages/sphinx/environment.py",
line 1213, in get_doctree
    f = open(doctree_filename, 'rb')
IOError: [Errno 2] No such file or directory:
'/home/rudi/Documents/QGIS-Documentation/source/translated/pot/.doctrees/index.doctree'
===============================

This is with the current version of QGIS-Documentation, and all the
dependencies installed in a virtual environment, exactly following the
readme. It's a bit confusing, because isn't sphinx supposed to build
the ".doctrees"? Am I missing something?

Thanks in advance for any help on this!

Rudi