Re: [Maxima-discuss] A question on maxima-index-html.lisp

[Raymond T. <toy...@gm...>]

On Sun, Aug 7, 2022 at 1:19 PM Eduardo Ochs <edu...@gm...> wrote:

> Hi list,
>
> a few days ago I tried to make the htmlized version of my messy notes
> on Maxima -
>
>   http://angg.twu.net/e/maxima.e.html
>
> a bit better, and I started to work on a way to make sexp hyperlinks
> like these
>
>   (info "(Maxima)funmake")
>   (find-maximanode "funmake")
>
> point to:
>
>   https://maxima.sourceforge.io/docs/manual/maxima_164.html#index-funmake
>
> My first prototype parsed the file
>
>   /usr/local/share/info/maxima-index-html.lisp
>
> and sort of did the right thing. But then I tried to compile other
> versions of Maxima - with "git checkout 5.46.0" and "git checkout
> HEAD" - and I saw that the file maxima-index-html.lisp didn't exist in
> those versions.
>

The ability to display help using the html version of the manual is
relatively new-maybe a couple of months old.

Note also that the maxima-index-html.lisp file is closely tied to the
build.  It may not quite work with the version on maxima.sourceforge.io
because the links may have changed or because the link is in a different
file.

Once we make a release with the html help support, this should work better
as long as you use the maxima-index-html.lisp file from the release along
with the html files made from the release.

>
> It seems that the code that used to generate and use
> maxima-index-html.lisp is changing. Which files of the current version
> of Maxima should I read to understand how it works now and where it is
> heading to?
>

The code that creates maxima-index-html.lisp is in
doc/info/build-html-index.lisp.  Perhaps not the best solution because it
uses regexps to search each html file to find things that would be entries
or sections that we can find in the text help.

I think there probably won't be any more major changes. I think it's
working now and so far everything that I've tried with ? and ?? has worked
with html.  If something fails, we'll have to fix this up.

If there's something I can do to help you out, let me know.

>
>   Thanks in advance!
>     Eduardo Ochs
>     http://angg.twu.net/eev-maxima.html
>
> _______________________________________________
> Maxima-discuss mailing list
> Max...@li...
> https://lists.sourceforge.net/lists/listinfo/maxima-discuss
>


-- 
Ray