User's guide and html

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

User's guide and html

hans_d
Administrator
Does anyone has experience with transforming LaTeX to html?

Of course there are tools we are using them (we are using htlatex): http://www.gradle.org/userguide/release/master.html

But I'm not happy with the layout at all. The layout of the pdf is much nicer and much easier to read. The biggest problem is that the frames and labels from the fancyvrb package are not transformed at all. 

- Hans

--
Hans Dockter
Gradle Project lead




Reply | Threaded
Open this post in threaded view
|

Re: User's guide and html

Russel Winder-2

On Fri, 2008-04-25 at 11:10 +0200, Hans Dockter wrote:
> Does anyone has experience with transforming LaTeX to html?

The last LaTeX -> HTML converter I used was LaTeX2HTML.   With PDF files
having hyperlinks, is there really a need to force an HTML version?

--
Russel.
====================================================
Dr Russel Winder                 Partner

Concertant LLP                   t: +44 20 7585 2200, +44 20 7193 9203
41 Buckmaster Road,              f: +44 8700 516 084
London SW11 1EN, UK.             m: +44 7770 465 077

signature.asc (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: User's guide and html

hans_d
Administrator
Hi Russel,

On Apr 28, 2008, at 4:34 PM, Russel Winder wrote:

On Fri, 2008-04-25 at 11:10 +0200, Hans Dockter wrote:
Does anyone has experience with transforming LaTeX to html?

The last LaTeX -> HTML converter I used was LaTeX2HTML.   With PDF files
having hyperlinks, is there really a need to force an HTML version?

LaTeX2HTML is not part of my Mac OS X tex distribution. I read somewhere that htlatex is supposed to be better anyway. 

There is one neat thing about a html version. You can have an external link to a particular section. The user clicks this and sees immediately the relevant content. With a pdf the user has to scroll there. If it were not for this, I would not bother. On the other hand its probably not worth putting too much resources into this. I guess that it is also better to remove the html version instead of having one with a bad layout.

- Hans


-- 
Russel.
====================================================
Dr Russel Winder                 Partner

Concertant LLP                   t: +44 20 7585 2200, +44 20 7193 9203
41 Buckmaster Road,              f: +44 8700 516 084
London SW11 1EN, UK.             m: +44 7770 465 077

--
Hans Dockter
Gradle Project lead




Reply | Threaded
Open this post in threaded view
|

Re: User's guide and html

Russel Winder-2
Hans,

> LaTeX2HTML is not part of my Mac OS X tex distribution. I read
> somewhere that htlatex is supposed to be better anyway.

I'm afraid I am not up on either.  I guess I should have a play with
htlatex which comes as standard with the TeX Live distribution which is
what is on Ubuntu.

> There is one neat thing about a html version. You can have an external
> link to a particular section. The user clicks this and sees
> immediately the relevant content. With a pdf the user has to scroll
> there. If it were not for this, I would not bother. On the other hand
> its probably not worth putting too much resources into this. I guess
> that it is also better to remove the html version instead of having
> one with a bad layout.

If the standard system is not up to the job then the alternative is to
write a specialized transformer.  LaTeX2HTML and htlatex will have
constraints because they are trying to be general, for a specific
document, large number sof assumptions can be made, leading to the
possibility of doing a lot better by using a specific rather than
generic system.

--
Russel.
====================================================
Dr Russel Winder                 Partner

Concertant LLP                   t: +44 20 7585 2200, +44 20 7193 9203
41 Buckmaster Road,              f: +44 8700 516 084
London SW11 1EN, UK.             m: +44 7770 465 077

signature.asc (196 bytes) Download Attachment