<div dir="ltr">Hi Richard,<div><br></div><div>Instead of travis, maybe we can try to use github actions instead?</div><div><br></div><div>Alex</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Mar 15, 2020 at 8:43 AM Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net">rdmailings@duif.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 3/15/20 8:57 AM, matteo wrote:<br>
> That's what comes into my mind:<br>
> <br>
> * verify Transifex pulling/pushing<br>
> * apache on the server to publish the docs<br>
> * ... what else?<br>
<br>
@Raymond thanks for organising the hackfest! Sorry for not being<br>
there... But the 'doc-team' did some things related to documentations<br>
because there WAS a hackfest \o/<br>
<br>
There are 2 things I want to discuss here.<br>
<br>
First our main goal: "KISS".<br>
Everybody on windows or linux should be able to build at least the<br>
english docs.<br>
<br>
Second: stick to Sphinx and it's tools as much as possible (e.g. instead<br>
of custom scripts: use sphinx-intl to create transifex stuff).<br>
<br>
My main 2 questions, I would like to discuss:<br>
<br>
-1- CAN we use Travis to build the translated site (daily) (technically:<br>
yes, I know, but...)<br>
<br>
-2- WHICH process should be responsible for the pulling of the transifex<br>
translations into the build process<br>
<br>
Ad -1-<br>
"Make doctest" will use the qgis/qgis docker container to build and run<br>
the tests. Travis is happy with that [4]<br>
<br>
So we could update or base a new image on it containing all language<br>
related stuff, and use travis to build all languages. Current 3.4 builds<br>
pull fresh from transifex (making a language build lasts for half an<br>
hour now sometimes...) If we push the po files into github, it will only<br>
be 10 minutes.<br>
But my main question is: can/should we 'misuse' travis to build all<br>
those (currently 18) languages daily.<br>
<br>
Ad -2-<br>
Several options:<br>
- during our main build, the build pulls (tx pull) from transifex. Is<br>
what we do now: Transifex is main repo for translations. IF an<br>
individual wants to build a translated doc, she/he needs to pull the<br>
translations from transifex itself (which is a disadvantage, as pulling<br>
translations from tx is SLOW...)<br>
- we run a daily script which pulls the translations from tx and commits<br>
those po files (for ALL languages to be build) in git-repo.<br>
Main advantage: we keep being boss over the po files ourselves, AND<br>
everybody can build translated docs, because the po files are (well 1<br>
day old...) in git<br>
- use the Transifex Github integration (I played with it one year ago,<br>
and then it could not handle our long resource handles at that time...)<br>
<br>
I think I prefer the second or third option, will push nl, it and fr<br>
translations into git later today (by just pulling the 3.4 translations<br>
from build server), so everybody can try to build translated sites too.<br>
Als together with maybe building it on travis, it is probably the best<br>
way..<br>
<br>
Want to see current status?<br>
<br>
- vanilla Sphinx local ( EVERYBODY can try to build branch qgisdoc2020<br>
NOW on windows and linux, see README [0] )<br>
<br>
- vanilla Sphinx remote ('make site' works if you can like me rsync to<br>
qgis2 [1]) (NOTE: a lot has to be done there....)<br>
<br>
- everybody should now be able to 'just edit' on github [2]<br>
<br>
- 'make doctest' (== building in te qgis/qgis docker image) is also<br>
working, see travis [4] qgisdoc2020 branch there<br>
<br>
<br>
Sorry for being rather long, and while writing maybe answering my own<br>
questions :-)<br>
<br>
But I really really hope we can keep stuff as simple as possible and<br>
encourage everybody to JOIN. Please contact us via documentation list<br>
<br>
About PDF's: maybe later... but I'm OK without those...<br>
So if you want them: join us<br>
<br>
Regards,<br>
<br>
Richard Duivenvoorde<br>
<br>
<br>
[0] <a href="https://github.com/qgis/QGIS-Documentation/tree/qgisdoc2020" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/tree/qgisdoc2020</a><br>
[1] <a href="https://docs.qgis.org/3.10/" rel="noreferrer" target="_blank">https://docs.qgis.org/3.10/</a><br>
[3]<br>
<a href="https://github.com/qgis/QGIS-Documentation/blob/qgisdoc2020/docs/user_manual/introduction/getting_started.rst" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/blob/qgisdoc2020/docs/user_manual/introduction/getting_started.rst</a><br>
[4] <a href="https://travis-ci.org/github/qgis/QGIS-Documentation" rel="noreferrer" target="_blank">https://travis-ci.org/github/qgis/QGIS-Documentation</a><br>
[5] <a href="https://docs.transifex.com/transifex-github-integrations/github-tx-ui" rel="noreferrer" target="_blank">https://docs.transifex.com/transifex-github-integrations/github-tx-ui</a><br>
_______________________________________________<br>
QGIS-Developer mailing list<br>
<a href="mailto:QGIS-Developer@lists.osgeo.org" target="_blank">QGIS-Developer@lists.osgeo.org</a><br>
List info: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
Unsubscribe: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a></blockquote></div>