[Live-demo] [OSGeo] #1620: Create a Travis continuous integration script for documentation

[OSGeo]

#1620: Create a Travis continuous integration script for documentation
-------------------------+----------------------------
 Reporter:  kalxas       |       Owner:  live-demo@…
     Type:  enhancement  |      Status:  reopened
 Priority:  major        |   Milestone:  OSGeoLive10.5
Component:  LiveDVD      |  Resolution:
 Keywords:  docs         |
-------------------------+----------------------------

Comment (by cvvergara):

 An idea of how this can be done:
 A .travis.yml is needed and the steps:
   - Operative system for the test
   - Install: the necessary packages to generate the documentation
   - Script or after_success: execute the process to make the documentation

 if in "Script" and there are errors then the build fails
 if in "after_success" and there are errors the build pass

 When I added the translation for pgRouting quickstart I saw that making
 the documentation generates a lot of errors, So, my suggestion is first
 make the documentation error free, before putting it in the "script"
 stage.

 When does that get tested:
 if the user has a travis account, it will start the test in his account.
 when a pull request is done it will start the the travis in the account of
 the repository where its requested.

 These lines test the documentation of pgRouting generated with sphinx
 (only the html and in the after_success)
 https://travis-ci.org/cvvergara/pgrouting/jobs/147340825#L1751

--
Ticket URL: <https://trac.osgeo.org/osgeo/ticket/1620#comment:9>
OSGeo <http://www.osgeo.org/>
OSGeo committee and general foundation issue tracker.