From owner-freebsd-doc@FreeBSD.ORG Sun Apr 13 13:37:40 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7B87E37B401; Sun, 13 Apr 2003 13:37:40 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id B45AD43F3F; Sun, 13 Apr 2003 13:37:39 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p64146-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.146.146]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id CB3D525CB; Mon, 14 Apr 2003 05:37:38 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h3DKaxtE036817; Mon, 14 Apr 2003 05:37:00 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Mon, 14 Apr 2003 05:34:36 +0900 (JST) Message-Id: <20030414.053436.95910003.hrs@eos.ocn.ne.jp> To: doceng@FreeBSD.org, doc@FreeBSD.ORG From: Hiroki Sato X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 2.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Multipart/Mixed; boundary="--Next_Part(Mon_Apr_14_05:34:36_2003_748)--" Content-Transfer-Encoding: 7bit Subject: suggestion for adding a l10n-capable doc-format navi X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 Apr 2003 20:37:40 -0000 ----Next_Part(Mon_Apr_14_05:34:36_2003_748)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, 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/. 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. 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 . Any comments or objections? These are not small changes, so I would like your advice. -- | Hiroki SATO / ----Next_Part(Mon_Apr_14_05:34:36_2003_748)-- Content-Type: Application/Octet-Stream Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="docnavi.diff.gz" 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 ----Next_Part(Mon_Apr_14_05:34:36_2003_748)----