As a big fan of the current API docs I think it should be possible to speed
up the sphinx build ("sphinx speed up build"@duckduckgo gives a lot of
hints):
https://stackoverflow.com/questions/51986357/how-can-i-make-sphinx-build-build-faster
https://get-started-with-sphinx-and-rst.readthedocs.io/improve-building/
https://frankwiles.com/posts/automatically-rebuild-sphinx-docs/
Of course, nobody will hardly object to alternatives, however, for me and
maybe others it's practical and indispensable. To drop a clue: coexistence
;)
On Tuesday, 17 December 2024 at 22:54:38 UTC+1 [email protected] wrote:
> >> So one question, on API level: "is not writing 1000 lines of
> >> Spad worth learning Sphinx, writing configuration files,
> >> handling dependencies, etc.". IMO, no. And if we used
> >> possiblity of adding hooks or extending Sphinx we easily
> >> could end up adding similar amount of code.
> >
> > This can be done by someone without much understanding of FriCAS,
> > that's why Sphinx is a good thing.
>
> Standing on the shoulders of giants ... vs. reinventing the wheel...
>
> Hi Dima,
>
> >> 1) Build time
> > incremental builds are fast, so if you work on changing docs it's not
> really
> > a log wait.
>
> Can you share the commands to achieve incremental builds?
>
> Currently the problem certainly is that all .rst files for the API are
> overridden so if 'make html' checks the time stamps then I would have to
> take more care not to override identical .rst files.
>
> Do you happen to have any idea how I can simply generate
> <code>reduce(f, a, r)</code> blocks from ``reduce(f, a, r)``
> instead of
>
> <code class="code docutils literal notranslate"><span
> class="pre">reduce(f,</span> <span class="pre">a,</span> <span
> class="pre">r)</span></code>
>
> My suspicion is that it is connected to pygments (although I have
>
> highlight_language = 'none'
>
> set in conf.py) or perhaps I could set another HTML generator for code
> blocs. Unfortunately I've not yet found where and how. :-(
> Do you have any hints/links?
>
> Thanks
>
> Ralf
>
--
You received this message because you are subscribed to the Google Groups
"FriCAS - computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/fricas-devel/d2ce4dc6-92ac-4bcb-882d-d7c765a01dean%40googlegroups.com.
