Re: texi2html status

[Reinhold Kainhofer]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am Samstag, 24. Mai 2008 schrieb Graham Percival:
> What's the status of the texi2html output?
>
> 1)  Are there any remaining bugs or missing features in texi2html
> that we'd like to see?  

Not that I'm aware of. Of course, there remain some issues with Lilypond's doc 
system, so we might still stumble upon unexpected issues.

> 2)  Are there any remaining technical issues with our build system
> (ie translations)?

The main problem, already explained by John: Since we will have multiple 
subsections in one file, the links won't be that easy, because you can no 
longer defer the file name from the link name. So I suppose, there would need 
to be a first run with our own script, extracting the docs hierarchy and 
maybe already generating file names for each section (some unnumbered 
sections will have the same file name). After this has been done for all our 
documentation, we can then run texi2html on the files and use the section <=> 
filename map from the first run to determine the file name for each of the 
sections of the texinfo document, as well as the target file names for links.

One thing, which we need to change in the current texi2html build is the text 
of cross-manual links. Currently they are:
"The \figuremode mode simply stores the numbers and  FiguredBass 
section ‘FiguredBass’ in Internals Reference context prints them as entered."
i.e. the IR link to FiguredBass is formatted as "<a href=..>FiguredBass</a> 
section 'FiguredBass' in Internals Reference". I suppose we only want "<a 
href=...>FiguredBass</a>" in all cases, right? Should be easy to change....

The other thing that is still missing is proper support for IE (since 
Microsoft completely messed up support for the position: absolute CSS 
property...). In the worst case (which I hope to prevent, of course), in IE 
the yellow area will scroll with the page and not be fixed. 
But if you do the announcement / RFC on the -user list, please tell them that 
support for IE is not there yet, but will be implemented before the release. 
Currently, users should use a different browser for their comments.

> 3)  If the answer to the previous two is `no', when is a good time
> to start discussing the silly aesthetic issues on -user?  (ie "I
> don't like that color" or "the fonts are too small")

Or: "I don't like the general page layout" etc.

I think we can do that any time. There will be lots of more or less 
usefull/useless comments, of which we have to pick out the productive ones 
and apply them.

> - we need to have at least one CSS person with git access with
> free time when this happens, so if everybody is finishing their
> operas or publishing or classes or whatever, we should wait a few
> weeks even if there's no technical issues.

Will there ever be a good time when people have more than enough time? I don't 
think so. 

Cheers,
Reinhold

PS: Right now I'm merging master into the dev/texi2html branch and updating 
the copy on http://kainhofer.com/~lilypond/texi2html-out/. I'll also run the 
linkchecker once this is done, so we have a current list of dangling links in 
the texi2html branch (which is more or less the same as master).

- -- 
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: address@hidden, http://reinhold.kainhofer.com/
 * Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at/
 * K Desktop Environment, http://www.kde.org, KOrganizer maintainer
 * Chorvereinigung "Jung-Wien", http://www.jung-wien.at/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFIQBoTTqjEwhXvPN0RAq6oAKDRzsLviavFr5l/6K0wZhH2kHLPDACeMkau
TUx4S6nJv9qDGWOCtb/Uydk=
=cwfL
-----END PGP SIGNATURE-----