Date: Mon, 14 Apr 2003 05:34:36 +0900 (JST) From: Hiroki Sato <hrs@eos.ocn.ne.jp> To: doceng@FreeBSD.org, doc@FreeBSD.ORG Subject: suggestion for adding a l10n-capable doc-format navi Message-ID: <20030414.053436.95910003.hrs@eos.ocn.ne.jp>
next in thread | raw e-mail | index | archive | help
----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 <programlisting><inlinegraphic
fileref="foo" format="linespecific"></programlisting>.
Any comments or objections? These are not small changes,
so I would like your advice.
--
| Hiroki SATO <hrs@eos.ocn.ne.jp> / <hrs@FreeBSD.org>
----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"
H4sICJm+mT4AA2RvY25hdmkuZGlmZgDtWety2lgS/g1P0dHECQzWjZuNHE9CMHbIYOwCkqmpTIoS
0gE0FhKjIzzxbs0b7Y/d2keYH7O1z7E/9yG2z5EEQohLnNhVW7uKw0WnT3ef7u90fwe1HJN80oA4
g3c9qdW7Oj6u1ERV1j3fMmxC5Zk+lS/1GzKybJI9/fIr2230gCnTQJ64UyKbxi2VTdeQ93Lh8Dbr
Ed+zyK3ljMHDN2q5DqhSJWtaoxGIJohzEFs/PT33CHndO9Okb396ym+0zOXniUfDLx5OhcUCRVHc
LxQZtQrnZAhFRSmBWtYqNa2sgqjglWHOFAqFfRWVoD7zQkXHWrmslY8CRdlXr0CsHVahUDs8glev
spCFH1r9N4N6t99qtJuD/lXj9MdmL7zb6rRbneag3byotztXKNHkgwU+eHbVOL/qXtb7g079fWuA
kt8HU7PQw4ycQuicRMdTG9DBgT6bSQb/ZLjObfhx6ppzFDJwXisdOHSie0RmWmRD93XbHT8uatbt
b4RM8f6QKUK0uDTErPuQKarwdu6wLKuglLTSsaYeLeBSTIVLipYEViolrVxZwUqJYaUaYuX63et2
qwGCKMvhymS52em3+q1mD85c47Xr3iD0LZvFpW1RH5qOb/kWIhTlhCxkhGkwKto4SiXi+EK2kC3s
pbitO+O5PibQmxHDGllGQnshI9iq4gRKd4Mpkv3KaNrHYoCSzl6yDA6ySW5lZ27bGUy6jkirHSmg
KBr/C9O1I+GRvtWM1zQFC0QplnHlUIGCelhjGS+8eILGxW9F4HsYP2QLwK7dGYGR60HbNXTb+pPu
4+6QWJr55GhTPM0WRPE7dpubwa2Hc6a6D45+awEfevGEg+BHNsjuShShYxNx4qM7Qo9/gTf9y7aQ
KjyzLT+QRWH2JZINwfGzPnh7LZG58fb60avMdtsbK0z5/hWmvFJhttvPqArU52OGkiK+aOVjrbSs
LmUOtl0aEjjDjqbGcKYqrA3hK0faF1WWt/VNlQUeorIUFt7u0Fqf+xPcBQlHo0vQ+fDC0+2YfKBi
tctaVKh2yX1OkdqhK6VAlZT/zgL1+9/++u9//LG7Nv3zL3//F5cLMRBEZWpRg5WKIS5EMih92HqU
bvNh6lB8UQw56bYzKmM4dsBw1KJWrmoVJVGDNs1cZTWlmlYpxmtPhfMa9haw4MxQN27Gnjt3TNFw
bdfT4Jtzhf07wUGffPJFkxiux4GiAYoRD2sNwdHfgAFEuu5eXXTrl+1Wr9/qXByC1Gt0m80O/Blr
x1T3xpYj2mTka1Ain06yhd8Sqb5h7kvREqY3j5LrpNGNyT5W75/tYxUSS4tlPOkBS/kicUpNK6qa
WlmkHN2I5Xx97vakF5US6zjsLWg5jAuct+sXvcJpRnwPQ2toW674ySMjEUsEHt3gutvq9LeLYMXC
0CAArBGYePxyiJnbdDzKw7Nn8IRMZ/7dZplsIeHXwZg4BJFHxEUBElkJwT7n3Byg5cADxs6b3fbL
00xGnlNPHlqOPEOU4u3vLwYIxnq/iYN8jPLBm/HA8AgqXsXi41GgzzlYVb/gZFVdIT4pVKWkwpXh
L8gOok5ZnrzR9BJ12xhOsaqV442qyA/a+BpnOJkdDAcrGbFt3SHunEIot36IGuHAkJoPS3IAWxxI
X+VCTaG+JrZHi06ARj7cX18KbKO4mNR+NOjGbG6Eb7V2f/hWaxBfVgLCsaGUH5BKy36JLiRgvDI1
wblKWileO48Zko9DIC+4zAG4c38296WZZzm+9POc+tboLiO0LjpX3SbSmY2i/q8utUwSF41xpIPF
ghke9zsa7AA3UrCDuNITBvAXTz7AQegXY2In8CHmctRZMDxxFzqsAjvwg27TiSxjBX93iRMWfrDi
DT3/ziZ0QojPjUPjrN6vw1mv12vjSj9+/I4HtVpkUa1WDvGsxeK6vE5OAj0MelJ84JtRnkUq+poL
Os7OFrGiucFrfpLNMklOibnhICgv4zOZ6cLSl8h0jsUoaIYzDL/oEcN3RWKTKZYRmo87n2MHM8g5
zCqSbgICnyasCIWiMSE6H0ZyLGpHVY7F0mGlloja+lSbjHXbcX3L2GnFokNHyOdXwrsMlg7Ums5s
wmM15iyQR2xFFhnA9kREBEFaz2Buqt8kJ4HPApaPJyFnE4xgznNdf2xBjv1nW1lkN6Kg59kqYnMg
UA7hMIwtDYSz1nthVSi4dB/L13DuE6rB81xOaLTrvZ6A8pyp1C/7jKgISQOL/Pq4eDz3fAAhXSJl
lTw0EK5ofcXryuGjECxxvyju0B/EhpJf5sQxSCJuhuuYCWdyOXbCfRlqSjrJuZ1IXeqO3LUgRVNz
hu6F8/P7T3Ux8fRuOnQTGvI7p+La9NVJ8JyVO5GfQdeivS0iQVT4ngjiGu5p/ipMkBcjViTZYo2Z
l9QNUImrWyT22frZ+CR1fg53WhCQKKDmMhzp5nYtKukLyBsgvFC2DWb7OLSatM9KG/+J4WvnbUea
VjRRLBLOWNRnMzx7sIQLzE1KxJFrmxiYX50wEnkcDGFwHxwsf0v5HwYCsSlZl0qvf+Ejt1g/pviG
DQkbOyNc+5e+nc0sJRtpPex5bllqIA7ftHRuK2RhE+MSK63sTVfYFI4EN9kWC4akcMexQXjOiczn
b7J7xO2rxC4lfrAhRRuDuLbYBOji/I//ItqfWBTwz58QYD+Sge+CaaG/+h0yCX576Pq+OwV3BEQ3
JsDyICWY2BkZ6XPbp2w2buYJrlEC1E0A+4h1a5mYFaALSk3xDOPObTOhxSNh1n3mlE7BIQahVPfu
JP5TLWfcisrIdqFaVZOkmzPr4IreF+yatTPHF2eeO/b0KdvNwWMGh9CDrBhpEPhLLIiByk3aKJZj
4uypJakkZaNvJN6baff6+fmBnjJse7LwpU8T/v+IM/0R538AW1mGG4YjAAA=
----Next_Part(Mon_Apr_14_05:34:36_2003_748)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030414.053436.95910003.hrs>