<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hi,</div><div dir="ltr"></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le sam. 23 mars 2019 à 16:54, Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net" target="_blank">rdmailings@duif.net</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Thanks Alexandre,<br>
<br>
So now we can start theming :-) ...<br>
<br>
BUT BUT... what if we make it our goals to<br></blockquote><div> <br></div><div>
[...]
</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
-4- use common images (in static/common) folder with relative paths.<br>
This would make that we do not need to (cannot) use the search-replace<br>
script, and as can use sources/static/common as img folder, git*.com<br>
will show them. I 'think' this makes it easier for writers.<br>
If they add a common img, they just drop it in the source/static/common<br>
folder (no copying/linking needed) and try out the right relative link.<br>
Disadvantages: we have to instruct to use the width/height attribute (in<br>
em units) and use common images as much as possible.<br>
<br></blockquote><div>Maybe do I misunderstand the point 4 but isn't it already the case (at least from a goal perspective - for technical details I don't know)?</div><div>Common images (icons) as well as screenshots are available in source file preview in github [0]</div><div>See also [1] [2] for the implementation details.</div><div><br></div><div>[0] <a href="https://github.com/qgis/QGIS-Documentation/blob/master/source/docs/user_manual/working_with_vector/vector_properties.rst" target="_blank">https://github.com/qgis/QGIS-Documentation/blob/master/source/docs/user_manual/working_with_vector/vector_properties.rst</a><br></div><div>[1] <a href="https://github.com/qgis/QGIS-Documentation/pull/2301">https://github.com/qgis/QGIS-Documentation/pull/2301</a> <br></div><div>[2] <a href="https://docs.qgis.org/3.4/en/docs/documentation_guidelines/writing.html#figures-and-images" target="_blank">https://docs.qgis.org/3.4/en/docs/documentation_guidelines/writing.html#figures-and-images</a></div><div><br></div><div>Regards,</div><div>Harrissou</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Please have a look at github pages and gitlab pages below, and build<br>
yourself to see what it looks now. Also play with source.conf options if<br>
you want.<br>
Also feel free to disagree :-)<br>
<br>
Regards,<br>
<br>
Richard Duivenvoorde<br>
<br>
[0] <a href="https://github.com/rduivenvoorde/qgisdoc/" rel="noreferrer" target="_blank">https://github.com/rduivenvoorde/qgisdoc/</a><br>
[1] <a href="https://gitlab.com/rduivenvoorde/qgisdoc/" rel="noreferrer" target="_blank">https://gitlab.com/rduivenvoorde/qgisdoc/</a><br>
[3]<br>
<a href="https://gitlab.com/rduivenvoorde/qgisdoc/blob/master/source/docs/user_manual/trans.rst" rel="noreferrer" target="_blank">https://gitlab.com/rduivenvoorde/qgisdoc/blob/master/source/docs/user_manual/trans.rst</a><br>
[4]<br>
<a href="https://gitub.com/rduivenvoorde/qgisdoc/blob/master/source/docs/user_manual/trans.rst" rel="noreferrer" target="_blank">https://gitub.com/rduivenvoorde/qgisdoc/blob/master/source/docs/user_manual/trans.rst</a><br>
<br>
<br>
On 23/03/2019 01.39, Alexandre Neto wrote:<br>
> Hi all,<br>
> <br>
> I just created a rtd_qgis theme based Read the Docs and used it in the<br>
> conf.py. I believe this is the way we should customize RTD themes<br>
> without disrupting it. I haven't done it, but we can also replace HTML<br>
> files to add stuff like the language selector somewhere.<br>
> <br>
> <a href="https://github.com/rduivenvoorde/qgisdoc/pull/3" rel="noreferrer" target="_blank">https://github.com/rduivenvoorde/qgisdoc/pull/3</a><br>
> <br>
> This is what I have used for inspiration:<br>
> <br>
> <a href="https://www.sphinx-doc.org/en/master/theming.html" rel="noreferrer" target="_blank">https://www.sphinx-doc.org/en/master/theming.html</a><br>
> <a href="https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options" rel="noreferrer" target="_blank">https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options</a><br>
> <br>
> Cheers,<br>
> <br>
> Alex Neto<br>
> <br>
> <br>
> <br>
> Alexandre Neto <<a href="mailto:senhor.neto@gmail.com" target="_blank">senhor.neto@gmail.com</a> <mailto:<a href="mailto:senhor.neto@gmail.com" target="_blank">senhor.neto@gmail.com</a>>><br>
> escreveu no dia sexta, 22/03/2019 às 20:01:<br>
> <br>
> Hi! <br>
> <br>
> Sorry for such a short presence, I though the meeting was set to GMT... <br>
> <br>
> I would like to follow up the sphinx-theme customization. I will<br>
> study the sphinx way of nesting theme so we can alway update the<br>
> read the docs theme and put our customization on top of it. <br>
> <br>
> Best regards, <br>
> <br>
> Alex<br>
> <br>
> <br>
> A sex, 22/03/2019, 16:35, matteo <<a href="mailto:matteo.ghetta@gmail.com" target="_blank">matteo.ghetta@gmail.com</a><br>
> <mailto:<a href="mailto:matteo.ghetta@gmail.com" target="_blank">matteo.ghetta@gmail.com</a>>> escreveu:<br>
> <br>
> Hi all,<br>
> <br>
> here a brief summary of the meeting we had:<br>
> <br>
> * we will wait another week to push the translated resources of the<br>
> documentation of 3.4. We are waiting for the new transifex-github<br>
> integration method that should make things easier, but it seems<br>
> hard to<br>
> put it in production<br>
> <br>
> * get rid of the pdf documents but still provide downloadable<br>
> resources<br>
> for online use as html zip file (for every language). Reasons: pdf<br>
> builder is not easy to maintain, heavy resources asking while<br>
> with html<br>
> we have the same builder (we just need to create the zip files)<br>
> and html<br>
> are usable offline together with QGIS (interactive links and<br>
> help buttons)<br>
> <br>
> * change doc theme to vanilla-rdt. There are still some issues<br>
> and fix<br>
> to make, but we (thanks Richard) have already something online<br>
> [0]. We<br>
> will work from time to time to fix all the issues and then<br>
> publish it<br>
> <br>
> * splitting the main repository into different ones (static vs<br>
> dynamic)<br>
> is not a priority for now. There seems not to be blockers with the<br>
> current environment that works fine<br>
> <br>
> * we still have some redirection issues of the main website (3.0 and<br>
> 3.4). If someone is wiling to help Richard with apache and/or<br>
> Tudor with<br>
> nginx is more than welcome<br>
> <br>
> * this meeting was a great success: I think it is the first<br>
> documentation meeting of the QGIS history (?) so we thought that<br>
> it is a<br>
> good habit to do this "often" (every 2 months or of course every<br>
> time is<br>
> needed)<br>
> <br>
> Thanks to all the participants!<br>
> <br>
> Cheers<br>
> <br>
> Matteo<br>
> <br>
> <br>
> <br>
> [0] <a href="https://qgis.org/test/en/docs/index.html" rel="noreferrer" target="_blank">https://qgis.org/test/en/docs/index.html</a><br>
> _______________________________________________<br>
> Qgis-community-team mailing list for organizing community<br>
> resources such as documentation, translation etc..<br>
> <a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
> <mailto:<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a>><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
> <br>
> -- <br>
> Alexandre Neto<br>
> ---------------------<br>
> @AlexNetoGeo<br>
> <a href="http://sigsemgrilhetas.wordpress.com" rel="noreferrer" target="_blank">http://sigsemgrilhetas.wordpress.com</a><br>
> <a href="http://gisunchained.wordpress.com" rel="noreferrer" target="_blank">http://gisunchained.wordpress.com</a><br>
> <br>
> -- <br>
> Alexandre Neto<br>
> ---------------------<br>
> @AlexNetoGeo<br>
> <a href="http://sigsemgrilhetas.wordpress.com" rel="noreferrer" target="_blank">http://sigsemgrilhetas.wordpress.com</a><br>
> <a href="http://gisunchained.wordpress.com" rel="noreferrer" target="_blank">http://gisunchained.wordpress.com</a><br>
> <br>
> _______________________________________________<br>
> Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
> <a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
> <br>
<br>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></blockquote></div></div></div></div></div>