On Mon, Dec 02, 2024 at 12:38:14AM +0100, Waldek Hebisch wrote:
> I have tried to modify Ralf's code
> to directly generate HTML, skipping the .rst stage. You
> can see proof of concept code at:
>
> http://wiki.fricas.org/public/api2.spad
At the same place there is now new, better version. Docstrings,
condition and navgation links to defining place are there.
I added also some escaping of special HTML characters.
Even without escaping the characters appeared fine in Lynx,
but possibly without escaping other browsers could fail or
show wrong thing.
Checking of docstrings is quite picky, it will signal error
on anything unexpected. In a sense main addition is hopefully
reasonably general parser for TeX/LaTeX files. However, it
has table of known TeX macros an currently reject any unknown
macro. It the trunk I have corrected errors and irregulrities
discoverd by docstring checks, so it should work with the trunk.
But older version are likely to fail.
This version has much less formatting HTML and navigation
links than output from sphinx+api.spad (on my machine total
size from sphinx+api.spad is 45834587 characters while size
from api2.spad is 15390243). However, adding extra stuff now
should be much easier than what is already done.
> If you want to try this, first generate 'abbrev-lines.list'
> (you can take it from documentation build), then compile
> 'api.spad' from 'src/doc', then compile 'api2.spad' and
> at FriCAS prompt issue
>
> documentAll("abbrev-lines.list")
The same with this version.
--
Waldek Hebisch
--
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/Z2uQ2yot6eqQtb12%40fricas.org.
