On Fri, Jun 30, 2023 at 03:03:27PM +0200, Ralf Hemmecke wrote:
> On 30.06.23 00:20, Ralf Hemmecke wrote:
> > From my side I only see fixing of download.rst and install.rst
> > (INSTALL) (ImageMagick) and removing the problem with a failing sphinx
> > build of fricas.github.io. I'm afraid that I might not be able to do
> > this tomorrow. Let's see how I can manage.
>
> Failing sphinx.
>
> This is somewhat of a bad thing that I don't seem to be able to fix quickly.
> All I can say is that with verion 4.4.0 of Sphinx, the build of the fricas
> html pages goes well. My failing build was with the current version of
> sphinx 7.0.1 or something.
>
> No idea what they have changed, but it seems that they are stricter with
> testing the content and our ++ docstrings are not in rst format, so I will
> probably have to either do lots of changes in the ++ docstrings or do that
> automatically via api.spad. But first I would have the cause for the issue.
I must admit that I do not see why are you using sphinx at all. Looking
at api pages AFACS the actual work done by sphinx look kind of trivial:
it is adding headers and footers and performing bunch of string
substitutions. It looks that we could generate .html essentially
with the same effort that we spent on generating .rst.
> Anyway. sphinx 4.4.0 still works and that is good for now.
Yes.
> So... download.rst and install.rst and order minor docfixes have to be done.
--
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 [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/fricas-devel/ZJ7qu4mY7L4Lo0rE%40fricas.math.uni.wroc.pl.
