#4533 (Move atelier.sphinxconf to rstgen)
by Luc Saffre · in Developers · assigned to Luc Saffre
Kokkuvõte
Children
Kommentaarid
- 4 aastat, 4 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : I found and fixed an old bug: the online link in the footer didn't work when use_dirhtml was False.
- 4 aastat, 4 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : I probably have the solution: reintroduce a wrapper atelier.configure() which calls rstgen.configure() and adds features that work only within atelier. Normal conf.py files call atelier.configure(), but makehelp makes a conf.py file that calls rstgen.configure(). But I am not finished testing it loc...
- 4 aastat, 4 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : For example the public_url of a doctree. Sphinx needs it e.g. for putting the "online link" in the footer of each page. For most code repositories it is stored in the SETUP_INFO. But what about pure doctree repos like lf, ug etc.
- 4 aastat, 5 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : The interdependence is because rstgen needs certain information that atelier knows : project, html_title and copyright. And also public_url, use_dirhtml, and selectable_languages. So rstgen just needs to provide an interface for setting these parameters. And normal doctrees would call rstgen.set_def...
- 4 aastat, 5 kuud ago by Luc Saffre in reply to Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : Oh. Yes, this one is fixed, but there is another interrelationship: rstgen itself still imports atelier. In order to set the current_project during sphinxconf.configure(). And also it needs get_project_from_path() in certain cases. Seems that my move was a mistake. Maybe I should even move sphinxcon...
- 4 aastat, 5 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) (1 reply) : And now the problem in [url gitlab.com/lino-framework/getlino/-/jobs/2498706412 getlino test_prod_mysql_nginx] (ModuleNotFoundError: No module named 'atelier' during the makehelp of a new site) should be fixed.
- 4 aastat, 5 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : The documentation wasn't that minimal, there was a page "Sphinx extendsions" in the atelier doctree. And rstgen has no doctree of its own, only a README file. Instead of giving rstgen yet another doctree, I made for rstgen what we actually do for all the lino packages: I say that the atelier doctree...
- 4 aastat, 5 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : Done.
- 4 aastat, 5 kuud ago by Luc Saffre about #4533 (Move atelier.sphinxconf to rstgen) : The change itself was rather trivial on my machine. Not sure about the documentation, but it seems to bee minimal anyway. The main problem is that it requires another pypi release for rstgen and atelier and is not backwards-compatible. All inv bd will break when the versions don't match.