[mapserver-dev] Upgrading Sphinx/Docs to 1.3.1

[Jeff McKenna]

Thanks Tom, I was wondering that too...thanks for pointing to this, I'll 
give it a try!

-jeff



On 2015-05-06 1:35 PM, Tom Kralidis wrote:
> 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
> <mailto: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
>> <http://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 <http://mapserver.org>.
>>>
>>> --
>>> thomas
>>>
>>> On 5 May 2015 at 23:25, Jeff McKenna <jmckenna at gatewaygeomatics.com
>>> <mailto: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 <http://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 <http://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 <http://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
>>>> <http://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
>>>>
>>>>