[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Using texi2html for the documentation
From: |
John Mandereau |
Subject: |
Re: Using texi2html for the documentation |
Date: |
Sat, 22 Mar 2008 12:23:45 +0100 |
Reinhold Kainhofer wrote:
> Patrice will take a look at implementing access keys in the next few days.
Very cool! Additionnally, we should document access keys for the user
-- I guess only a few people know about access keys in HTML docs
produced with makeinfo. Maybe this can be documented in the page "About
This Document" provided by texi2html.
> Currently that's not possible, because for determining the file name, we have
> only the section name, number and ID available, but not the contents of the
> section. There is also no chance to set some property in a macro, because
> that will only be expanded later on. However, Patrice seems to have an idea
> to move macro evaluation to an earlier place and make this possible.
Mmmh, my suggestion of getting the node name in English via
@translationof macro may be clueless, it might be easier for you Perl
hackers to parse @translationof as a special command in order to make it
available in xrefs formatting. The only thing I'm sure about is that
we'd define @translationof as a dummy macro for Info and PDF output.
> That's exactly the reason, why I'm pointing at improving the appearance of
> the
> web page ;-) Our documentation is really great, the application itself, too,
> only the start page looks a bit bare compared to what gems are hidden behind
> it...
There have already been some proposals on the lists, but it looks like
none has made enough enthusiasm to adopt it.
> About translations: texi2html has full translation support, I've sent Patrice
> the updated German strings, he wrote the French ones, so we might only miss
> some Spanish strings... I have not yet looked at adding the language to the
> file name (i.e. use .de.html as extension for the German docs).
This is done automatically in our build process, see local-WWW target in
make/doclang-targets.make, but it will make no harm if texi2html does it
itself, which might be a good thing for Texinfo manuals other than
LilyPond ones that are not internationalized yet.
> About the automatic language selection: I think inside the manual, we should
> generate links to the full file names (i.e. pointing to Rhythms.html,
> Rhythms.de.html, Rhythms.fr.html) and not leave out the extension (i.e.
> pointing to Rhythms).
This is so in the local docs (left in out-www/offline-root/ after make
web), but keeping extensions disables automatic selection, that's why
extensions are stripped in out-www/inline-root/ HTML pages.
Cheers,
John
- Re: Using texi2html for the documentation, (continued)
- Re: Using texi2html for the documentation, Graham Percival, 2008/03/20
- Re: Using texi2html for the documentation, Han-Wen Nienhuys, 2008/03/21
- Re: Using texi2html for the documentation, John Mandereau, 2008/03/21
- Re: Using texi2html for the documentation, Jan Nieuwenhuizen, 2008/03/22
- Re: Using texi2html for the documentation, John Mandereau, 2008/03/23
- Re: Using texi2html for the documentation, Valentin Villenave, 2008/03/23
- Re: Using texi2html for the documentation, Jan Nieuwenhuizen, 2008/03/25
- Re: Using texi2html for the documentation, Han-Wen Nienhuys, 2008/03/25
- Re: Using texi2html for the documentation, Jan Nieuwenhuizen, 2008/03/26
- Re: Using texi2html for the documentation, Reinhold Kainhofer, 2008/03/26
- Re: Using texi2html for the documentation,
John Mandereau <=
- Re: Using texi2html for the documentation, Graham Percival, 2008/03/22
- Re: Using texi2html for the documentation, John Mandereau, 2008/03/23
- Re: Using texi2html for the documentation, Graham Percival, 2008/03/24
- Re: Using texi2html for the documentation, Reinhold Kainhofer, 2008/03/29
- Re: Using texi2html for the documentation, John Mandereau, 2008/03/30
- Re: Using texi2html for the documentation, John Mandereau, 2008/03/30
- Re: Using texi2html for the documentation, Reinhold Kainhofer, 2008/03/30
Re: Using texi2html for the documentation, Francisco Vila, 2008/03/16
Re: Using texi2html for the documentation, John Mandereau, 2008/03/16