Date: Mon, 14 Apr 2003 19:44:09 +0100 From: Nik Clayton <nik@FreeBSD.org> To: Hiroki Sato <hrs@eos.ocn.ne.jp> Cc: doc@FreeBSD.org Subject: Re: suggestion for adding a l10n-capable doc-format navi Message-ID: <20030414184409.GE95802@clan.nothing-going-on.org> In-Reply-To: <20030414.053436.95910003.hrs@eos.ocn.ne.jp>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
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 --- .\._/_)
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)
iD8DBQE+mwF4k6gHZCw343URAl+IAJ90vuwziMRtt3sB32GqRY7Vdc3JigCdFBU8
3jl8jHbgltGROe5I9+3Or2o=
=T2MH
-----END PGP SIGNATURE-----
home |
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030414184409.GE95802>