[mapserver-dev] Upgrading Sphinx/Docs to 1.3.1

[Tom Kralidis]

I think we have to change the Sphinx that gets installed in Travis?

https://github.com/mapserver/docs/blob/branch-6-4/.travis.yml#L28

I think using pip install sphinx==1.3.1 instead of apt will peg to the version properly.

Sent from my iPhone

> On May 6, 2015, at 09:43, Jeff McKenna <jmckenna at gatewaygeomatics.com> wrote:
> 
> Hi Thomas,
> 
> Interesting.  Though that leaves me with the same question: can someone assist me to upgrade to Sphinx 1.3.1 on mapserver.org?
> 
> I explained in previous messages as to why we must not use a Sphinx version from several years ago for our docs (March 2012 in fact).
> 
> -jeff
> 
> 
> 
>> On 2015-05-06 3:32 AM, thomas bonfort wrote:
>> Jeff,
>> the docs are built on travis-ci, and the build result is pushed to
>> mapserver.org.
>> 
>> --
>> thomas
>> 
>>> On 5 May 2015 at 23:25, Jeff McKenna <jmckenna at gatewaygeomatics.com> wrote:
>>> Hi devs,
>>> 
>>> I notice that our Sphinx installation version (the software that we use to
>>> convert from restructured text to html files automagically) on mapserver.org
>>> is a deprecated 1.1.3 . As noted in our Documentation Guide[1], our docs
>>> process (including the translations) requires a minimum Sphinx version of
>>> 1.2b3
>>> 
>>> I'm not running Sphinx 1.3.1 locally.
>>> 
>>> But now how to upgrade the mapserver.org hosted docs to the Sphinx 1.3.1
>>> release, is the challenge.
>>> 
>>> I have logged into the ProjectsVM and upgraded Sphinx on that machine to
>>> 1.3.1 (through the 'easy_install' command)  But I haven't seen any changes
>>> to mapserver.org (you can see the Sphinx version listed at the bottom of
>>> every page).
>>> 
>>> So, question:
>>> 
>>> Can someone assist me to upgrade Sphinx 1.3.1 on mapserver.org ?  I don't
>>> need much of your time, only a few notes on how to upgrade and then I can
>>> run the commands on the server (I will also update the Documentation Guide
>>> with these steps, so people like myself can remember ha!).
>>> 
>>> Thanks!
>>> 
>>> -jeff
>>> 
>>> 
>>> [1]
>>> http://www.mapserver.org/development/documentation.html#installing-and-using-sphinx-for-rst-html-generation
> _______________________________________________
> mapserver-dev mailing list
> mapserver-dev at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/mapserver-dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20150506/44e14f9f/attachment-0001.html>