
<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi<div class=""><br class=""></div><div class=""><br class=""><div class=""><blockquote type="cite" class="">On 23 Apr 2016, at 16:53, Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net" class="">rdmailings@duif.net</a>> wrote:<br class=""><br class=""><br class="">Hi,<br class=""><br class="">during last hackfest I actually also did this, point was that currently<br class="">there is some 'magic' if I understand correct from Juergen, which would<br class="">be broken if be bring those pages to rst…</blockquote><div class=""><br class=""></div><div class=""><br class=""></div><br class=""><blockquote type="cite" class=""><br class="">I agree with you that rst would be the preferred format, but feel that<br class="">as Juergen is actually keeping those notes up to date, he has to ok with<br class="">that.<br class=""><br class="">@jef: maybe you can elaborate a little more on this?<br class=""></blockquote><div class=""><br class=""></div><div class=""><br class="">I’m popping in here a bit because some of this is my legacy. The INSTALL is built using text2tags (a markup language before markdown became popular). We could probably migrate to using RST sometime but the attraction of t2tags is that it is very light weight (single simple small binary to compile the doc) and the INSTALL docs in the source code means it usually will match whatever version of QGIS you checkout from GIT. If we move the management out of the code tree and into the docs tree then we create a cross dependency on the two repos meaning that when we e.g. do a release we need to be sure to compile the INSTALL docs in the docs tree and copy the generated file over to the code source tree - and be sure we are compiling the right docs sources to match the the version of the code sources. That all sounds a little complicated to me compared to the current system…</div><div class=""><br class=""></div><div class="">What about we maintain a small sphinx project inside the code tree and then do some git submodule magic to include that into the docs repo. Can you use submodules to include only a directory from another repo? I agree it would be nice to be able to have the INSTALL docs translated, though I don’t know if it is worth the effort (i.e. how many people will actually use them).</div><div class=""><br class=""></div><div class="">Regards</div><div class=""><br class=""></div><div class="">Tim</div><br class=""><blockquote type="cite" class=""><br class="">Regards,<br class=""><br class="">Richard<br class=""><br class="">On 22-04-16 17:28, DelazJ wrote:<br class=""><blockquote type="cite" style="font-family: Menlo-Regular; font-size: 11px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">Hi,<br class=""><br class="">Currently, when someone is looking for steps to compile a QGIS release,<br class="">he'll will find them in the QGIS repo [0]<br class=""><br class="">I personally don't like that page and from a non-english speaker and<br class="">non-developer looking for a howto, I didn't like it not being<br class="">translated. And there are pages from the translated website that<br class="">directly link to this page (leaving a fully translated page to a<br class="">specialized page totally in english from within the QGIS project doesn't<br class="">really sound good to me).<br class=""><br class="">Then, reading the introduction of this notice, you'll find assertions<br class="">such as:<br class="">- "You can download this document as part of the QGIS 'User and<br class="">Installation Guide' in HTML and PDF format via <a href="http://qgis.org" class="">http://qgis.org</a>."<br class="">- "Translations of this document can also be downloaded at the<br class="">documentation area of the QGIS project at <a href="http://qgis.org" class="">http://qgis.org</a>."<br class="">AFAICS, this text is available nowhere in the manuals and there's no<br class="">translated version.<br class=""><br class="">SO, does it make sense to move it to somewhere like<br class=""><a href="http://www.qgis.org/en/site/getinvolved/development/index.html?" class="">http://www.qgis.org/en/site/getinvolved/development/index.html?</a><br class="">It'll complete all other chapters on development matters, will be more<br class="">visible, sexy and translatable.<br class=""><br class="">The issues I can't figure out how they can be solved are:<br class="">- what will be the status of the current page, in the QGIS repo?<br class="">- how will update be managed?<br class=""><br class="">Comments are welcome. I'd have loved to show you this chapter in context<br class="">but I'm unable to build the website [1] so you may need to review the PR<br class="">#343 [2](I've RSTed the text)<br class=""><br class=""><<a href="https://github.com/qgis/QGIS-Website/pull/343" class="">https://github.com/qgis/QGIS-Website/pull/343</a>><br class="">Thanks,<br class="">Harrissou<br class=""><br class="">[0]<br class=""><a href="http://htmlpreview.github.io/?https://github.com/qgis/QGIS/blob/master/doc/INSTALL.html" class="">http://htmlpreview.github.io/?https://github.com/qgis/QGIS/blob/master/doc/INSTALL.html</a><br class="">[1]<br class="">http://osgeo-org.1560.x6.nabble.com/Unable-to-build-QGIS-Website-with-Paver-td5262145.html<br class=""><br class="">[2] https://github.com/qgis/QGIS-Website/pull/343<br class=""><br class=""><br class=""><br class="">_______________________________________________<br class="">Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br class="">Qgis-community-team@lists.osgeo.org<br class="">http://lists.osgeo.org/mailman/listinfo/qgis-community-team<br class=""><br class=""></blockquote><br class="">_______________________________________________<br class="">Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br class=""><a href="mailto:Qgis-community-team@lists.osgeo.org" class="">Qgis-community-team@lists.osgeo.org</a><br class=""><a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" class="">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br class=""></blockquote><br class=""><div class=""><span class="">—</span><br class=""><br class=""><br class=""><span class=""><img height="118" width="150" apple-inline="yes" id="6F44C18D-CAA4-42F3-80BC-8D9EACB3868F" apple-width="yes" apple-height="yes" class="" src="cid:1A5DF6DE-E302-4C28-BFBD-29663CBF1351"></span><br class=""><br class=""><br class=""><br class="">Tim Sutton<br class=""><br class="">Co-founder: Kartoza<br class="">Project chair: <a href="http://qgis.org" class="">QGIS.org</a><br class=""><br class="">Visit <a href="http://kartoza.com" class="">http://kartoza.com</a> to find out about open source:<br class=""><br class="">Desktop GIS programming services<br class="">Geospatial web development<br class="">GIS Training<br class="">Consulting Services<br class=""><br class="">Skype: timlinux <br class="">IRC: timlinux on #qgis at <a href="http://freenode.net" class="">freenode.net</a><br class=""><br class=""><br class="">Kartoza is a merger between Linfiniti and Afrispatial<br class=""></div><br class=""></div></div></body></html>