suggestion for adding a l10n-capable doc-format navi

[Nik Clayton]

On Mon, Apr 14, 2003 at 05:34:36AM +0900, Hiroki Sato wrote:
>  I think I would like to commit the attached patch.
>  The changes are:
> 
>   1) Generate a link which can be used for readers to choose split and
>      single HTML version of a document easily.  This is enabled for docs
>      under articles/ and books/ if WITH_DOCFORMAT_NAVI_LINK=YES is
>      specified in the Makefile.  In the patch it is enabled in
>      en_US.ISO8859-1/articles/pam only, but I am planning to add it
>      into all of docs in articles/ and books/.

I like it.

>   2) Add an entity-set for l10n purpose.  When WITH_DOCFORMAT_NAVI_LINK=YES
>      &docnavi.split-html; and &docnavi.single-html; are used,
>      but they should be translatable.  I added l10n.ent to
>      share/sgml, en_US.ISO8859-1/share/sgml, and ja_JP.eucJP/share/sgml,
>      and defined FPIs respectively.  During build process, the two of l10n.ent
>      are read in ${LANGCODE}/share/sgml/l10n.ent -> share/sgml/l10n.ent order,
>      so when &docnavi.split-html; is defined in a language-specific directory
>      it is used, otherwise share/sgml/l10n.ent is used.  Since l10n.ent is
>      included in share/sgml/freebsd.dsl, it can also be used for general
>      purpose.

I like it.

>   3) Add `margin-left' into PROGRAMLISTING and SCREEN class in docbook.css, and
>      remove %indent-{programlisting,screen}-lines% in freebsd.dsl.
>      This resolves a indentation problem of <programlisting><inlinegraphic
>      fileref="foo" format="linespecific"></programlisting>.
> 
>  Any comments or objections?  These are not small changes,
>  so I would like your advice.

All of those look good from here.

N
-- 
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \ ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/_)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030414/603a2eaf/attachment.sig>