I've added your modifications (with slight changes)

https://github.com/hemmecke/fricas/blob/wip/rstdoc/src/doc/sphinx/source/install.rst

>> Rendered version is here:

https://hemmecke.github.io/fricas/install.html

> In lynx names have "P:" added, like:
> 
> Installation GuideP:

I do not know what version of lynx and what locale setting you have, but
in my case it shows this:

Installation Guide¶

In firefox the ¶ only appears if you hover with the mouse over the line
with a heading. And seemingly when you right-click on this ¶
(PILCROW SIGN) https://en.wikipedia.org/wiki/Pilcrow
then you can extract a link exactly to that section. I wouldn't want to
remove that feature. Unfortunately, I have no idea whether lynx is
capable of using that information instead of just showing nonsense "P:"
in your case.

> AFAICS this is due to the following in generated html.
> 
> <a class="headerlink" href="#installation-guide" title="Permalink to this 
> headline">P:</a>

Yes, perfectly fine functioning HTML, but it is ¶ instead of P: in the
.html sources.

> More generally, generated html has a lot of Javascript junk.  Is this
> someting you added to configuration or general Github junk?

That is added by Sphinx. Github is only *showing* the generated HTML and
not to be blamed here. However, JavaScript is only used to get the
search field in this page working all the other stuff is working
perfectly fine with JavaScript turned off.

> BTW: In current days Javascript is security problem and it would
> be good if our pages worked without Javascript.

I usually have noscript running in Firefox and only whitelist pages I
trust. You can decide for yourself whether you trust fricas.github.io.
Even though I generally distrust javascript, it is very useful here. And
if you like, use "cd src/doc; make localdoc" to generate a version that
solely lives on your computer, disconnect from the internet and use
javascript locally.


I have now also created a shell/sed script that generates INSTALL
from install.rst.

See
https://github.com/hemmecke/fricas/blob/wip/rstdoc/generate_INSTALL.sh
and the generated result
https://github.com/hemmecke/fricas/blob/wip/rstdoc/INSTALL

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 on the web visit 
https://groups.google.com/d/msgid/fricas-devel/6e50bee6-48cf-e4be-9612-b675efc10628%40hemmecke.org.

Reply via email to