bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Small document and sample HTML and DocBook


From: Noah Slater
Subject: Re: Small document and sample HTML and DocBook
Date: Tue, 6 Jan 2009 13:25:38 +0000
User-agent: Mutt/1.5.18 (2008-05-17)

On Tue, Jan 06, 2009 at 02:10:31PM +0100, Patrice Dumas wrote:
> On Tue, Jan 06, 2009 at 12:22:36PM +0000, Noah Slater wrote:
> >
> >   http://hsivonen.iki.fi/doctype/ (Activating Browser Modes with Doctype)
> >
> > The most commonly applicable DOCTYPE from that list is:
> >
> >   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 
> > "http://www.w3.org/TR/html4/strict.dtd";>
>
> I found that it was hard to have valid html with the strict dtd, instead
> in texi2html Transitional is used:
> $DOCTYPE = '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
> "http://www.w3.org/TR/html401/loose.dtd";>';
>
> In texi2html had a plan to do an init file for strict xhtml (or maybe
> strict html) but never got around to do it.

I think we should avoid XHTML because it causes more trouble than it's worth. If
this is a controversial opinion on this list I am happy to spend some time
digging out citations for you. (but I'd rather not, obviously)

If it's not too hard, I would aim for full HTML strict output. If this is an
insurmountable task, anyone who wants strict can use HTMLTidy. Whatever the
case, I would choose one and stick with it.

> It would need much more css.

What would need more CSS?

> That being said this would certainly be trivial to do on a coding point of
> view, but a css knowledge is needed.

I have been working on a default stylesheet for my GNU manual that balances
æsthetics with readability and I would love to contribute this to texi2html and
work with you on getting it broadly useful for distribution.

My current draft is available at:

  http://periplum.org/dev/gnu/publish/trunk/doc/publish.html

This is currently produced with:

  makeinfo --enable-encoding --html --no-split --css-ref=style.css

I am also working on similar CSS for my O'Reilly book:

  http://books.couchdb.org/relax/

Is this something that interests you?

> Also I would like to rework the css support in texi2html, to be more
> compatible with what makeinfo currently do, and to enhance (and fix) css, but
> after the merge. Currently info output is way higher on my list (and
> progressing rather neatly).

Not sure what this means. How can I help out?

-- 
Noah Slater, http://tumbolia.org/nslater




reply via email to

[Prev in Thread] Current Thread [Next in Thread]