RE: [Axiom-developer] hyperlinked algebra

[Page, Bill]

On Tuesday, December 13, 2005 12:27 PM Ralf Hemmecke wrote:
> 
> Bill Page wrote:
> >> Doing the same thing with \n instead of \- would be a bit more 
> >> complicated. But I think for LaTeX-speakers \- is more natural
> >> anyway.
> > 
> > Hmmm ... maybe '\n ' would be better - more compatible with
> > the definition of the "dot" language?
> 
> Well, yes, this may be a good reason to look for something that
> works with \n. But the problem is that \n would be expanded during
> \write so \nGroup would count as one control sequence which is
> usually not defined. I don't know how I can easily achieve a
> similar trick as with \-.

What I had in mind was writing it like this:

  XxxYyy [label="Xxx\n Yyy"];

i.e. with a space character after the \n. That would allow LaTeX
to treat it as a two-character command, right? And the extra
space would not greatly affect the way GraphViz handles multi-line
labels outside of LaTeX.

But I like your solution below better.

> 
> > Why would you say '\-' is more natural in LaTeX?
> 
> TeX has automatic hyphenation, but sometimes one must help. 
> That can be done via the \- control sequence. Then TeX considers
> the place where \- is as an additional place to break lines.
> ...

I think you are right. This is a good choice for LaTeX. Perhaps
we should submit this idea to the GraphViz developers. I can't
seem to locate the original author Derek Rayside of the script:

http://www.graphviz.org/Resources.php
http://web.mit.edu/~drayside/www/graphviz.tex/main.pdf

-------

I have solved the remaining problems with using hyperlinking
with GraphViz in LaTeX so that now the links in the diagram
link directly to the appropriate section of the target. For
example:

http://wiki.axiom-developer.org/book--main--1/Endpaper3

click on 'pdf' and then click on the first heading. This
takes you to the algebra hierarchy diagram. Now click on
the node "SetCategory" and you will jump directly to the
definition of SetCategory in the catdef.spad.pamphlet. And
similarly for the first few other top nodes.

Also I had to update catdef.spad.pamphlet to include a
\hypertarget{NAME}{} specification for each chunk of the
file.

To make this work, I had to upgrade to the most recent GraphViz
version 2.7 and also modify the procedure to create pdf files
to use 'dvips -z' and 'ps2pdf'. This is now implemented for the
pamphlet page type on MathAction.

Please let me know if you have any questions about how to
use this.

Regards,
Bill Page.