Hi everybody,
I would like to know if it's possible to get (or generate)
an HTML version of the Grass programmer's manual, since the pdf version
is a nightmare when it comes to browse and find function definitions...
a frame based version with a frame for the index and a frame
for the contents would be the best, but something like the grass
manual would be very useful too...
Best regards
Andrea Aime
On Wed, Apr 24, 2002 at 12:40:42PM +0200, Andrea Aime wrote:
Hi everybody,
I would like to know if it's possible to get (or generate)
an HTML version of the Grass programmer's manual, since the pdf version
is a nightmare when it comes to browse and find function definitions...
a frame based version with a frame for the index and a frame
for the contents would be the best, but something like the grass
manual would be very useful too...
Hi Andrea,
that's no problem: Just run
make html
then latex2html is created an HTML version of that book.
If desired, I can add this to the web site.
A hint for PDF: When using acroread, you can click on all
functions (as I have implemented hyperrefs). Enjoy the index
at the end of the PDF book where all functions are listed.
Clicking on them, you reach back the describing text.
Ciao
Markus
On Wed, Apr 24, 2002 at 02:00:39PM +0200, Markus Neteler wrote:
On Wed, Apr 24, 2002 at 12:40:42PM +0200, Andrea Aime wrote:
> Hi everybody,
> I would like to know if it's possible to get (or generate)
> an HTML version of the Grass programmer's manual, since the pdf version
> is a nightmare when it comes to browse and find function definitions...
> a frame based version with a frame for the index and a frame
> for the contents would be the best, but something like the grass
> manual would be very useful too...Hi Andrea,
that's no problem: Just run
make htmlthen latex2html is created an HTML version of that book.
A follow-up:
a major drawback of the HTML conversion is that latex2html does
not know about the \Gfunc{} macro - subsequently all functions
are not visible. If we find someone to add this macro definition
to latex2html, we are ready to publish it online.
An example for this Latex macro:
\Gfunc{char *}{G\_ask\_vector\_in\_mapset (char *prompt, char *name)}{prompt
for an existing vector file}{Asks the user to enter the name of an
existing vector file in the current mapset.}
\Gfunc{return type}{Function}{short description}{long description}
For volunteers:
http://www.latex2html.org/
Maybe it's easy to add this definition, but I don't have time for that
now.
Markus
On Wed, Apr 24, 2002 at 02:00:39PM +0200, Markus Neteler wrote:
On Wed, Apr 24, 2002 at 12:40:42PM +0200, Andrea Aime wrote:
A hint for PDF: When using XXXXX, you can click on all
functions (as I have implemented hyperrefs). Enjoy the index
at the end of the PDF book where all functions are listed.
Clicking on them, you reach back the describing text.
xpdf works quite good on pdfs and hyperrefs
and it is Free Software!
- Acrobat reader doesn't display progmangrass at all (complains about
the inability to load an embedded font, also got warnings about locate
(ISO-8859-1 vs ISO-8859-15)
- xpdf displays it but fonts are a bit ugly (no AA) and I can't
see the table of contents in a separate frame
- ghostview displays nice fonts but not toc nor hyperrefs
Latex2html is still under development as far as I can tell...
did anyone complained about the lack of \Gfunc support?
Could \Gfunc be replaced with something else that is supported
by latex2html?
Best regards
Andrea Aime
Bernhard Reiter wrote:
On Wed, Apr 24, 2002 at 02:00:39PM +0200, Markus Neteler wrote:
> On Wed, Apr 24, 2002 at 12:40:42PM +0200, Andrea Aime wrote:> A hint for PDF: When using XXXXX, you can click on all
> functions (as I have implemented hyperrefs). Enjoy the index
> at the end of the PDF book where all functions are listed.
> Clicking on them, you reach back the describing text.xpdf works quite good on pdfs and hyperrefs
and it is Free Software!--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Part 1.2Type: application/pgp-signature
On Wed, Apr 24, 2002 at 03:38:15PM +0200, Andrea Aime wrote:
- Acrobat reader doesn't display progmangrass at all (complains about
the inability to load an embedded font, also got warnings about locate
(ISO-8859-1 vs ISO-8859-15)
Here it runs well, also for many other people, I assume (never
got that complaint).
- xpdf displays it but fonts are a bit ugly (no AA) and I can't
yes.
see the table of contents in a separate frame
no idea about this feature of xpdf
- ghostview displays nice fonts but not toc nor hyperrefs
yes
Latex2html is still under development as far as I can tell...
yes
did anyone complained about the lack of \Gfunc support?
Could \Gfunc be replaced with something else that is supported
by latex2html?
no 
It's doing a lot and simplifies to describe functions.
However, I was wrong: The functions *are* displayed, but a bit
ugly (missing spaces etc).
So in general the result should be more or less complete, only
the index is not generated (which is also fed by my \Gfunc{} macro).
Best regards
Andrea Aime
Feel free to improve it - it is in CVS. After days of conversion from
the original WinWord format I was happy to have it in this shape.
Maybe you just try
make html
and check if you like it. Or you go here now:
http://mpa.itc.it/markus/progmangrass50/
Best,
Markus
Bernhard Reiter wrote:
>
> On Wed, Apr 24, 2002 at 02:00:39PM +0200, Markus Neteler wrote:
> > On Wed, Apr 24, 2002 at 12:40:42PM +0200, Andrea Aime wrote:
>
> > A hint for PDF: When using XXXXX, you can click on all
> > functions (as I have implemented hyperrefs). Enjoy the index
> > at the end of the PDF book where all functions are listed.
> > Clicking on them, you reach back the describing text.
>
> xpdf works quite good on pdfs and hyperrefs
> and it is Free Software!
>
> --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
> Part 1.2Type: application/pgp-signature
_______________________________________________
grass5 mailing list
grass5@grass.itc.it
http://grass.itc.it/mailman/listinfo/grass5