Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / fpc-devel / 2008-05

Too big documentation images

14 messages · 8 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Michael Van Canneyt
to Felipe Monteiro de Carvalho
Felipe Monteiro de Carvalho wrote 11 lines
Hello, The following images: http://www.freepascal.org/docs-html/ref/refsu5.html#x25-240003.1.1 Are too big, in the sense that there are huge white spaces in the height. Are they supposed to be so big? Are the images somehow generated?

Yes, they are, by the latex->html converter.

It's just one of the many problems.

Anyway, unless someone else starts providing a good set, the next releases will no have html manuals any more. Only PDF.

(unit references will of course still be in HTML).

Michael.

Reply by email

Felipe Monteiro de Carvalho
to Michael Van Canneyt
Michael Van Canneyt wrote
Anyway, unless someone else starts providing a good set, the next releases will no have html manuals any more. Only PDF.

No, please =)

What do you mean by good set? A good set of pictures?

My idea would be just taking the current ones and cutting the white area. Shouldn't that be enougth?

Felipe Monteiro de Carvalho

Reply by email

Michael Van Canneyt
to Felipe Monteiro de Carvalho
Felipe Monteiro de Carvalho wrote 8 lines
On Sat, May 24, 2008 at 1:42 PM, Michael Van Canneyt wrote: > Anyway, unless someone else starts providing a good set, the next > releases will no have html manuals any more. Only PDF. No, please =) What do you mean by good set? A good set of pictures?

No. A good set of complete HTML docs. The pictures are not the only issues. Ligatures are also an issue, special characters also, links are often wrong. The converter (tex4ht) is no longer maintained or supported by some big distros.

My idea would be just taking the current ones and cutting the white area. Shouldn't that be enougth?

No, because they would be overwritten the next time the docs are built.

Michael.

Reply by email

Mattias Gaertner
to Michael Van Canneyt
Show quoted text 10 lines
On Sat, 24 May 2008, Felipe Monteiro de Carvalho wrote: > On Sat, May 24, 2008 at 1:42 PM, Michael Van Canneyt > wrote: > > Anyway, unless someone else starts providing a good set, the next > > releases will no have html manuals any more. Only PDF. > > No, please =)

I second that.

Show quoted text 13 lines
> > What do you mean by good set? A good set of pictures? No. A good set of complete HTML docs. The pictures are not the only issues. Ligatures are also an issue, special characters also, links are often wrong. The converter (tex4ht) is no longer maintained or supported by some big distros. > My idea would be just taking the current ones and cutting the white > area. Shouldn't that be enougth? No, because they would be overwritten the next time the docs are built.

So, the biggest issue is to find a latex to html converter?

Mattias

Reply by email

Marco van de Voort
to Mattias Gaertner
Show quoted text 9 lines
On Sun, 25 May 2008 10:31:23 +0200 (CEST) Michael Van Canneyt wrote: > > My idea would be just taking the current ones and cutting the white > > area. Shouldn't that be enougth? > > No, because they would be overwritten the next time the docs are > built. So, the biggest issue is to find a latex to html converter?

It has been an issue for 10 years now.

Reply by email

Michael Van Canneyt
to Marco van de Voort
Marco van de Voort wrote 11 lines
> On Sun, 25 May 2008 10:31:23 +0200 (CEST) > Michael Van Canneyt wrote: > > > My idea would be just taking the current ones and cutting the white > > > area. Shouldn't that be enougth? > > > > No, because they would be overwritten the next time the docs are > > built. > > So, the biggest issue is to find a latex to html converter? It has been an issue for 10 years now.

Exactly. There are 4 converters:

Latex2html - a huge perl script which needs more time and memory than God needed to create the earth, to convert the docs. We dumped it because it simply takes too long. It's good for small documents (articles), but not for books.

tex4ht - Was very good, but has some issues. Problem is that it's no longer maintained, and is no longer included in e.g. SuSE.

Hevea - also good, but is written in objective caml (and I thought Pascal was considered obscure) so it also doesn't install easily on a SuSE system.

tex2rtf - Very good, fast. But only supports a subset of latex, not enough for the documentation.

We once toyed with the idea of writing our own, but this is a monumental task. I can barely find the time to maintain fpdoc, let alone a full-blown latex parser. Although if someone writes one, I'll certainly put my shoulders under that...

Add to all that the fact that I never intended the docs to be converted to HTML in the first place - and I still don't - and you end up with the situation as it is now.

Note that this only concerns the manuals, not the unit references. fpdoc creates good HTML, and this will definitely be maintained.

Michael.

Reply by email

Florian Klaempfl
to Michael Van Canneyt
Show quoted text 21 lines
On Sun, 25 May 2008, Marco van de Voort wrote: >> On Sun, 25 May 2008 10:31:23 +0200 (CEST) >> Michael Van Canneyt wrote: >>>> My idea would be just taking the current ones and cutting the white >>>> area. Shouldn't that be enougth? >>> No, because they would be overwritten the next time the docs are >>> built. >> So, the biggest issue is to find a latex to html converter? > It has been an issue for 10 years now. Exactly. There are 4 converters: Latex2html - a huge perl script which needs more time and memory than God needed to create the earth, to convert the docs. We dumped it because it simply takes too long. It's good for small documents (articles), but not for books. tex4ht - Was very good, but has some issues. Problem is that it's no longer maintained, and is no longer included in e.g. SuSE.

Last version is from 2007 and ubuntu (I checked 8.04 too) has it.

apt-get install tex4ht
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
tex4ht-common
Suggested packages:
libxml2-utils
Recommended packages:
dvipng
The following NEW packages will be installed:
tex4ht tex4ht-common
0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded. Need to get 1526kB of archives.
After unpacking 22.1MB of additional disk space will be used. Do you want to continue [Y/n]?
Get:1 http://be.archive.ubuntu.com gutsy/main tex4ht-common 20070717-2 [1339kB]
Get:2 http://be.archive.ubuntu.com gutsy/main tex4ht 20070717-2 [187kB] Fetched 1526kB in 16s (94.5kB/s)
Selecting previously deselected package tex4ht-common. (Reading database ... 97036 files and directories currently installed.) Unpacking tex4ht-common (from .../tex4ht-common_20070717-2_all.deb) ... Selecting previously deselected package tex4ht.
Unpacking tex4ht (from .../tex4ht_20070717-2_amd64.deb) ... Setting up tex4ht-common (20070717-2) ...
texhash: Updating /var/lib/texmf/ls-R-TEXMFMAIN... texhash: Updating /var/lib/texmf/ls-R-TEXLIVE...
texhash: Updating /var/lib/texmf/ls-R...
texhash: Done.
Replacing config file /etc/texmf/texmf.cnf with new version

Setting up tex4ht (20070717-2) ...

Reply by email

Florian Klaempfl
to Florian Klaempfl
Show quoted text 26 lines
Michael Van Canneyt schrieb: > > On Sun, 25 May 2008, Marco van de Voort wrote: > >>> On Sun, 25 May 2008 10:31:23 +0200 (CEST) >>> Michael Van Canneyt wrote: >>>>> My idea would be just taking the current ones and cutting the white >>>>> area. Shouldn't that be enougth? >>>> No, because they would be overwritten the next time the docs are >>>> built. >>> So, the biggest issue is to find a latex to html converter? >> It has been an issue for 10 years now. > > Exactly. There are 4 converters: > > Latex2html - a huge perl script which needs more time and memory than > God needed to create the earth, to convert the docs. We dumped > it because it simply takes too long. It's good for small > documents (articles), but > not for books. > > tex4ht - Was very good, but has some issues. Problem is that it's no > longer > maintained, and is no longer included in e.g. SuSE. Last version is from 2007

Actually, last changes are from 2008-05-10:
http://www.cse.ohio-state.edu/~gurari/TeX4ht/bugfixes.html

Reply by email

Michael Van Canneyt
to Florian Klaempfl: Last version is from 2007 and ubuntu (I checked 8.04 too) has it. apt-get install tex4ht…
Florian Klaempfl wrote 24 lines
Michael Van Canneyt schrieb: > > On Sun, 25 May 2008, Marco van de Voort wrote: > > > > On Sun, 25 May 2008 10:31:23 +0200 (CEST) > > > Michael Van Canneyt wrote: > > > > > My idea would be just taking the current ones and cutting the white > > > > > area. Shouldn't that be enougth? > > > > No, because they would be overwritten the next time the docs are > > > > built. > > > So, the biggest issue is to find a latex to html converter? > > It has been an issue for 10 years now. > > Exactly. There are 4 converters: > > Latex2html - a huge perl script which needs more time and memory than God > needed to create the earth, to convert the docs. We dumped it because > it simply takes too long. It's good for small documents (articles), but > not for books. > > tex4ht - Was very good, but has some issues. Problem is that it's no longer > maintained, and is no longer included in e.g. SuSE. Last version is from 2007 and ubuntu (I checked 8.04 too) has it.

I meant maintained by SuSE.

I checked.
There are open bugreports about it, and it seems SuSE 11.0 will again contain tex4ht. I'll keep observing that, as I plan to upgrade to SuSE 11.0.

Hopefully, they have fixed some of the bugs. It seems there is now also openoffice support in tex4ht, so that would be very good.

So, the HTML afficiniados are in luck.

Michael.

Reply by email

Graeme Geldenhuys
to Michael Van Canneyt: Exactly. There are 4 converters: Latex2html - a huge perl script which needs more time…

2008/5/25 Michael Van Canneyt :

Show quoted text 16 lines
> It has been an issue for 10 years now. Exactly. There are 4 converters: Latex2html - a huge perl script which needs more time and memory than God needed to create the earth, to convert the docs. We dumped it because it simply takes too long. It's good for small documents (articles), but not for books. tex4ht - Was very good, but has some issues. Problem is that it's no longer maintained, and is no longer included in e.g. SuSE. Hevea - also good, but is written in objective caml (and I thought Pascal was considered obscure) so it also doesn't install easily on a SuSE system. tex2rtf - Very good, fast. But only supports a subset of latex, not enough for the documentation.

Is there a good latex to docbook converter? DocBook to HTML seems pretty good (well, the examples I have seen) If so, maybe it can be a two step process. latex -> docbook -> html

Regards,
- Graeme -

_______________________________________________
fpGUI - a cross-platform Free Pascal GUI toolkit
http://opensoft.homeip.net/fpgui/

Reply by email

Michael Van Canneyt
to Graeme Geldenhuys
Graeme Geldenhuys wrote 22 lines
2008/5/25 Michael Van Canneyt : >> It has been an issue for 10 years now. > > Exactly. There are 4 converters: > > Latex2html - a huge perl script which needs more time and memory than God > needed to create the earth, to convert the docs. We dumped it because > it simply takes too long. It's good for small documents (articles), but > not for books. > > tex4ht - Was very good, but has some issues. Problem is that it's no longer > maintained, and is no longer included in e.g. SuSE. > > Hevea - also good, but is written in objective caml (and I thought Pascal was considered obscure) > so it also doesn't install easily on a SuSE system. > > tex2rtf - Very good, fast. But only supports a subset of latex, not enough for the documentation. Is there a good latex to docbook converter? DocBook to HTML seems pretty good (well, the examples I have seen) If so, maybe it can be a two step process. latex -> docbook -> html

The process usually is docbook -> latex, not the other way round...

Michael.

Reply by email

listmember
to Michael Van Canneyt: Exactly. There are 4 converters: Latex2html - a huge perl script which needs more time…
Michael Van Canneyt wrote 15 lines
Exactly. There are 4 converters: Latex2html - a huge perl script which needs more time and memory than God needed to create the earth, to convert the docs. We dumped it because it simply takes too long. It's good for small documents (articles), but not for books. tex4ht - Was very good, but has some issues. Problem is that it's no longer maintained, and is no longer included in e.g. SuSE. Hevea - also good, but is written in objective caml (and I thought Pascal was considered obscure) so it also doesn't install easily on a SuSE system. tex2rtf - Very good, fast. But only supports a subset of latex, not enough for the documentation.

There's also one other converter, namely, Hyperlatex [ http://hyperlatex.sourceforge.net/ ], written in Lisp.

It is mentioned in this page
http://small.dropbear.id.au/docs/latexhtml.html and seems to be actively maintained --the README file in the CVS says the latest version, v2.9, is dated November 2006.

BTW, I know nothing about Lisp or Latex; but I did some googling to help if I can.

Reply by email