Re: [Axiom-developer] HyperDoc as static HTML

[Kai Kaminski]

Page, Bill wrote:

> Kai,
>
> This is looking great!
>
> Here are some initial questions and suggestions.
>
> On Thursday, July 07, 2005 11:52 AM you wrote:
>
>  
>
> > I converted the old HyperDoc pages to HTML and put them up at 
> > http://kaikaminski.gmxhome.de/hyper/rootpage.html. I use jsMath,
> > a Javascript library, to format mathematical expressions, hence
> > Javascript must be enabled.
> >    
>
> Could you suggest some links to pages that contain jsMath? I quickly
> browsed a bunch of pages and the only math I saw was in "ASCII"
> format. Perhaps you have not loaded the jsMath directory on your
> server? I see a reference to:
>
>  
You are right, of course. I forgot to copy those files. If you want to 
see some math go to 
http://kaikaminski.gmxhome.de/hyper/IntegerNumberTheoryFunctionsXmpPage.html.

> On the page:
>
> http://kaikaminski.gmxhome.de/hyper/ugIntroCalcDerivPage.html
>
> I see some "PATCH NOT FOUND!" messages in RED such as:
>
>  
>
> > ...
> > We use a factorization-free algorithm.
> >
> > PATCH NOT FOUND!
> >    
>
> What is it supposed to be? 
>  
Sometimes HyperDoc pages contain references to external 'patches'. In 
the original HyperDoc you might see an Axiom command and a button next 
to it. If you click the button, the corresponding 'patch' is loaded and 
replaces that portion of the page. Typically the patch would contain the 
Axiom command and the result, but the mechanism is more general, it also 
applies for plots for example. I assume that this mechanism was mostly 
useful for saving screen real estate in the HyperDoc browser. Nowadays 
that's not so much of a problem so I just include the patches in the 
HTML pages directly. If my code can't find a patch it insert a PATCH NOT 
FOUND message. I'll see if I can fix that.

> > The dynamic HyperDoc features, i.e. everything that requires
> > interaction with either Axiom or the OS, doesn't work, of 
> > course.
> >    
>
> I presume these are things like the \lispdownlink{...} ? For
> example
>  
Yes. I would have to call Axiom I guess, and a static HTML page can't do 
that. Besides Axiom isn't running on that server anyway.

>   \lispdownlink{Matrix}{(|bcMatrix|)} Create a matrix
>
> You might try running this command manually or via a pipe in
> Axiom like this:
>
>  echo ')lisp (|bcMatrix|)' | AXIOMsys
>
> and capture any usable output.
>  
I could do that, but:
1) I've only been able to run Axiom since late yesterday.
2) This version of the HyperDoc is just meant to make it easy for 
everyone to read the pages, even if the old browser doesn't work. I'm 
not so much concerned with replicating every bit of functionality right 
now.

> > PS: Don't fix any errors in those files by hand. They are
> > generated automatically.
> >    
>
> How/when (or if?) would you like errors to be reported to you?
>  
If you find a problem with one of the pages, just tell me the 
URL/filename and give a rough description what's wrong with it, e.g. 
"ugIntroGraphicsPage.html contains visible LaTeX-commands".

Kai

PS: The 'About Axiom' page is there and contains the copyright notices, 
I guess. Any other license/copyright information that should be included 
in HTML comments or something?