Hi
Am 5. Sep 2007 um 10:44 schrieb Michael Van Canneyt:
On Wed, 5 Sep 2007, Graeme Geldenhuys wrote:
Hi
Looking at the online documentation at:
http://www.freepascal.org/docs-html/prog/prog.html
The html navigation seems to be broken. I remember a few months back
someone also raised such a issue and was under the impression it was
fixed. Is this a recurring problem or was the original issue never
fixed?
[cut]
No idea.
It seems that the tex4ht conversion is not very good after all :/
hm, as I said. When I tried it locally, the result was perfect.
Maybe, it is simply a question of the tex4ht version. I am too busy
these days, to look further into it, but in about 10 days time, I can
have another look at it.
Michael, I'm not dissing your documentation efforts. :) The content
is great. I just think the LaTeX to HTML conversion has some major
issues? DocBook HTML navigation seems to be much simpler. Isn't
there a LaTeX to DocBook to HTML path we could follow? Or use a
different LaTeX to HTML converter?
In the beginning we used latex2html. The problem is that the
documentation
is simply too big. It takes days to convert (what do you expect
from a perl
program...) so we switched to tex4ht.
Personally, I would drop the HTML support completely and simply
provide
PDF for the manuals. I must spend far too much time on it. And unless
someone takes over the conversion effort, this probably is what will
happen.
Note that I do not propose to drop HTML support for the unit reference
guides; The HTML support of fpdoc is not under question.
Michael.
_______________________________________________
fpc-devel maillist - fpc-devel@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-devel
