On my new machine building API web pages takes twice as much
real time as normal FriCAS build.  This is due to sphinx
taking a lot of time.  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

ATM this does not handle docstrings and conditions on signatures.
Navigation links are very limited.  But it indicates that
skipping .rst stage we should be able to build API web pages
probably about 100 times faster.

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")

For some reason second second run is much faster than the
first one.  Since this generates thousends of pages in
reasonable time, we should be able to generate pages on
the fly, making this dynamic (a not only having static
pages).

BTW: Sphinx-generated HTML contains a lot of markup.  I wonder
how much of it is useful (for us) and how much is crap added
because in some rare cases (but usually not) it is needed.

-- 
                              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/Z0zzZnpeFhEg7aKr%40fricas.org.

Reply via email to