[mapserver-dev] Upgrading Sphinx/Docs to 1.3.1

[Jeff McKenna]

Thanks for the tips Thomas and Tom.  In the end all I needed was a 
"requirements.txt" file in the root, containing one line of "sphinx==1.3.1"

Will add this to the Documentation Guide.

Thanks!

-jeff



On 2015-05-06 1:49 PM, Jeff McKenna wrote:
> 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
>>>>>
>>>>>
>>>>>