>> 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 fricas-devel+unsubscr...@googlegroups.com.
To view this discussion visit 
https://groups.google.com/d/msgid/fricas-devel/82788d63-e84b-4154-8dbd-dce368060f70%40hemmecke.org.

Reply via email to