[Qgis-community-team] Report of QGIS documentation meeting

[Alexandre Neto]

Hi all,

I just created a rtd_qgis theme based Read the Docs and used it in the
conf.py. I believe this is the way we should customize RTD themes without
disrupting it. I haven't done it, but we can also replace HTML files to add
stuff like the language selector somewhere.

https://github.com/rduivenvoorde/qgisdoc/pull/3

This is what I have used for inspiration:

https://www.sphinx-doc.org/en/master/theming.html
https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options

Cheers,

Alex Neto



Alexandre Neto <senhor.neto at gmail.com> escreveu no dia sexta, 22/03/2019 às
20:01:

> Hi!
>
> Sorry for such a short presence, I though the meeting was set to GMT...
>
> I would like to follow up the sphinx-theme customization. I will study the
> sphinx way of nesting theme so we can alway update the read the docs theme
> and put our customization on top of it.
>
> Best regards,
>
> Alex
>
>
> A sex, 22/03/2019, 16:35, matteo <matteo.ghetta at gmail.com> escreveu:
>
>> Hi all,
>>
>> here a brief summary of the meeting we had:
>>
>> * we will wait another week to push the translated resources of the
>> documentation of 3.4. We are waiting for the new transifex-github
>> integration method that should make things easier, but it seems hard to
>> put it in production
>>
>> * get rid of the pdf documents but still provide downloadable resources
>> for online use as html zip file (for every language). Reasons: pdf
>> builder is not easy to maintain, heavy resources asking while with html
>> we have the same builder (we just need to create the zip files) and html
>> are usable offline together with QGIS (interactive links and help buttons)
>>
>> * change doc theme to vanilla-rdt. There are still some issues and fix
>> to make, but we (thanks Richard) have already something online [0]. We
>> will work from time to time to fix all the issues and then publish it
>>
>> * splitting the main repository into different ones (static vs dynamic)
>> is not a priority for now. There seems not to be blockers with the
>> current environment that works fine
>>
>> * we still have some redirection issues of the main website (3.0 and
>> 3.4). If someone is wiling to help Richard with apache and/or Tudor with
>> nginx is more than welcome
>>
>> * this meeting was a great success: I think it is the first
>> documentation meeting of the QGIS history (?) so we thought that it is a
>> good habit to do this "often" (every 2 months or of course every time is
>> needed)
>>
>> Thanks to all the participants!
>>
>> Cheers
>>
>> Matteo
>>
>>
>>
>> [0] https://qgis.org/test/en/docs/index.html
>> _______________________________________________
>> Qgis-community-team mailing list for organizing community resources such
>> as documentation, translation etc..
>> Qgis-community-team at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/qgis-community-team
>
> --
> Alexandre Neto
> ---------------------
> @AlexNetoGeo
> http://sigsemgrilhetas.wordpress.com
> http://gisunchained.wordpress.com
>
-- 
Alexandre Neto
---------------------
@AlexNetoGeo
http://sigsemgrilhetas.wordpress.com
http://gisunchained.wordpress.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20190323/ab3122a4/attachment.html>