On Mon, Dec 02, 2024 at 06:06:54PM +0100, 'Ralf Hemmecke' via FriCAS - computer
algebra system wrote:
> On 12/2/24 00:38, Waldek Hebisch wrote:
> > http://wiki.fricas.org/public/api2.spad
>
> I'd like to wait with my feedback until I see others (especially those that
> USE https://fricas.github.io/api) say an opinion about the produced output
> from api2.spad.
ATM api2.spad output can not serve as a replacement for output of
api.spad+sphinx, it still needs implementation of few essential features.
Concerning api.spad+sphinx markup, it seem to me that 'edit on github'
link is somewhat out of place for 'localdoc' (I personally do not use
it at all, but maybe other people use it). Actually, I do not see
it in Firefox (it shows up in Lynx), so it is not clear to me how
it is supposed to work (I do not think that Lynx is main browser
for viewing API pages).
I also noticed that when translating something like '\spad{reduce(f, x, r)}'
current output seem to be
<code class="docutils literal notranslate"><span class="pre">reduce(f,</span>
<span class="pre">x,</span> <span class="pre">r)</span></code>
that is we get 3 separate 'span'-s. I think it would be better to
have
<code class="docutils literal notranslate">
<span class="pre">reduce(f, x, r)</span></code>
or possibly even
<code>reduce(f, x, r)</code>
Another things are self-links, do they serve any useful purpose?
Currently each generated page contains 3 sets of navigations links,
one in header, one at start of the page (IIUC this one is to generate
access keys) and one at the end. Second and third set contain self-link.
Another thing is 'permalinks'. IIUC a 'permalink' is supposed to
be a stable link, reliably giving "the same page". But as api
site is unversioned any link to it is really not a 'permalink'.
So, do they make any sense on generated pages?
Another things is estetics versus usability. Currently in
Firefox main part of a page is divided into 3 strips. Left
strip shows essentially the same thing on all pages, right is
empty (IIUC main strip has limited width and the third strip
only shows up when window is wide enough) and actual information
is in the middle strip. When there is not much information and
one has big screen, then this layout looks nice. But it wastes
about 30% of screen area, which makes it much less usable on small
screens.
--
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/Z0-uXLB5FGl64g_L%40fricas.org.
