[Qgis-community-team] new site with sphinx documentation

[Paolo Corti]

Hi

I have added a new site in the qgis.org server with the QGIS Sphinx
documentation build:

http://docs.qgis.org

also aliased as:

http://documentation.qgis.org/

the default documentation site is for the English language, other
languages can be reached like this (but they are still in English, as
translations are still not in the git repository):

German: http://documentation.qgis.org/html/user_guide/de/
Italian: http://documentation.qgis.org/html/user_guide/it/
French: http://documentation.qgis.org/html/user_guide/fr/

other languages may be added following the procedures described in the
readme file:
https://github.com/qgis/QGIS-Documentation/blob/master/readme.rst

and adding the language code in the TRANSLATION variable in Makefile.

The documentation is rebuilt every 30 minutes by a job in crontab.
Another possible option could be to add a github service hook [1] or
using the ReadTheDocs service [2].
Unluckily with the latter (RTD) I was not able to add the actual
QGIS-Documentation: build fails for some unidentified reason [3]

According to Eric Holscher the build fails for this reason:

"Looks like your checkout was in a bad state (complaining about SHA
mismatch? Did you force push or something?) I killed the repo and
rebuilt it, and it seems to be happy again."

Unluckily after some time it fails building again (Tim, any suggestion?)

thanks
p

[1] http://help.github.com/post-receive-hooks/
[2] http://readthedocs.org/
[3] http://readthedocs.org/builds/qgis/

-- 
Paolo Corti
Geospatial software developer
web: http://www.paolocorti.net
twitter: @capooti
skype: capooti