<div dir="ltr"><div dir="ltr"><div dir="ltr">Hi,<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le mer. 20 févr. 2019 à 16:42, Richard Duivenvoorde <<a href="mailto:rdmailings@duif.net">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">I did the following to get a building environment<br>
Note: I'm on Linux here:<br>
<br>
cd /tmp (or whatever dir you are going to use)<br>
git clone <a href="https://github.com/qgis/QGIS-Documentation.git" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation.git</a><br>
cd QGIS-Documentation<br>
virtualenv -p python3 venv<br>
source venv/bin/activate<br>
pip install -r REQUIREMENTS.txt<br>
make html<br>
<br></blockquote><div>Richard, is the -p python3 a requirement? In which case it could be nice to have the readme (<a href="https://github.com/qgis/QGIS-Documentation/#building-the-documentation-using-make">https://github.com/qgis/QGIS-Documentation/#building-the-documentation-using-make</a>) updated</div><div>And I wonder if sphinx version should not be upgraded (readme shows sphinx==1.2 while requirements.txt is at 1.6.5)</div><div><br></div><div>Regards,</div><div>Harrissou<br></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">
In master I then get:<br>
<br>
writing output... [ 24%]<br>
docs/training_manual/database_concepts/data_model<br>
<br>
Exception occurred:<br>
  File<br>
"/tmp/QGIS-Documentation/venv/lib/python3.7/site-packages/pygments/lexer.py",<br>
line 191, in streamer<br>
    for _, t, v in self.get_tokens_unprocessed(text):<br>
RuntimeError: generator raised StopIteration<br>
The full traceback has been saved in /tmp/sphinx-err-dpwwe5au.log, if<br>
you want to report the issue to the developers.<br>
Please also report this if it was a user error, so that a better error<br>
message can be provided next time.<br>
A bug report can be filed in the tracker at<br>
<<a href="https://github.com/sphinx-doc/sphinx/issues" rel="noreferrer" target="_blank">https://github.com/sphinx-doc/sphinx/issues</a>>. Thanks!<br>
make: *** [Makefile:73: html] Error 1<br>
<br>
I also get this error:<br>
<br>
Warning, treated as error:<br>
intersphinx inventory '<a href="https://qgis.org/pyqgis/3.4/objects.inv" rel="noreferrer" target="_blank">https://qgis.org/pyqgis/3.4/objects.inv</a>' not<br>
fetchable due to <class 'requests.exceptions.ProxyError'>:<br>
HTTPSConnectionPool(host='<a href="http://qgis.org" rel="noreferrer" target="_blank">qgis.org</a>', port=443): Max retries exceeded<br>
with url: /pyqgis/3.4/objects.inv (Caused by ProxyError('Cannot connect<br>
to proxy.',<br>
NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection object<br>
at 0x7ff955a647b8>: Failed to establish a new connection: [Errno -2]<br>
Name or service not known',)))<br>
Makefile:69: recipe for target 'html' failed<br>
<br>
So my feeling is that the intersphinx mapper:<br>
<br>
source/conf.py<br>
line 69:<br>
intersphinx_mapping = {'pyqgis_api': ('<a href="https://qgis.org/pyqgis/3.4/" rel="noreferrer" target="_blank">https://qgis.org/pyqgis/3.4/</a>', None)}<br>
<br>
is not happy: so I would comment out that line for now<br>
<br>
If still to working, let me know<br>
<br>
Regards,<br>
<br>
Richard<br>
<br>
<br>
<br>
<br>
On 20/02/2019 16.18, Richard Duivenvoorde wrote:<br>
> On 20/02/2019 14.43, Larissa Junek wrote:<br>
>> Hello,<br>
>><br>
>> I'm in charge of writing the user manual the next year and wanted to say<br>
>> hello!<br>
>><br>
>> I installed a production branch after the instructions on<br>
>><br>
>> <a href="https://docs.qgis.org/testing/en/docs/documentation_guidelines/first_contribution.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/documentation_guidelines/first_contribution.html</a><br>
>><br>
>><br>
>> I write the documentation using a python virtualenv.<br>
>> My problem is, that using the <pip install -r REQUIREMENTS.txt> command<br>
>> after creating my production branch doesn't build the dependencies<br>
>> correctly.<br>
>> Error message:<br>
>> <Command "python setup.py egg info" failed with error code in<br>
>> /tmp/pip-build- h2lvmza/transiflex-client/><br>
>><br>
>> Is there somebody who can help me?<br>
> <br>
> Hi Larissa,<br>
> <br>
> I'm happy to help you, what about a skype call?<br>
> I'll sent you my skype handle in a private msg<br>
> <br>
> Regards,<br>
> <br>
> Richard Duivenvoorde<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>