[Qgis-community-team] QGIS docs: Vanilla build & ReadTheDocs theme

[Ian Maddaus]

I've successfully built the new documentation using a Mac. A Mac user would have to install Xcode but that's not a big problem.

‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On Monday, March 18, 2019 7:40 AM, Alexandre Neto <senhor.neto at gmail.com> wrote:

> Sounds good to me.
>
> IIRC, The docs split was not related to the PyCookbook testing. We can run tests on them as they are.
>
> The split would just remove some of the static stuff the guidelines. We don't need guideline for different versions. And even the Gentle introduction to GIS, that could be version, we are not updating it regularly, but we have it replicated for each version of QGIS we release.
>
> On Mon, Mar 18, 2019 at 11:35 AM Richard Duivenvoorde <rdmailings at duif.net> wrote:
>
>> On 2019-03-18 09:13, Alexandre Neto wrote:
>>> Hi, I would refrain to change the looks of it right away.
>>> I also have my list of improvements for that, but I think it would be
>>> better to stabilize the usage of the theme and it's options first, and
>>> then do the improvements on top of that.
>>
>> +1
>>
>>> Besides, you probably know that already, but there's a way to separate
>>> our theme tweaks from the original read the docs theme. We really need
>>> to do it the right way so we can update the theme whenever we need.
>>>
>>> Related subject: we talked about splitting the QGIS docs content. Will
>>> we keep using sphinx for the static content?
>>>
>>> If so, and assuming we are going to use the same theme, it would be
>>> better to share it via submodele, otherwise, any theme tweak must be
>>> replicated twice.
>>
>> Yes, but (to me) one reason to split was because I thought to make the
>> python cookbook testable it would be better.
>> I'm still ok to split (in QGIS version specific and non version specific
>> docs), but the immidiate need to me is over now (as we do it now it is
>> just a rather quick and easy build?).
>> I'd like to:
>> - move to the rtd theme
>> - make translations sync work
>> - handle the windows build to work good with make.bat (so some static
>> copying)
>> But can be done in steps too
>>
>> Richard
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20190318/607da7ee/attachment.html>