From owner-freebsd-doc Sun Aug 18 12:32: 0 2002 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 0583E37B400 for ; Sun, 18 Aug 2002 12:31:58 -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 3D9BE43E6A for ; Sun, 18 Aug 2002 12:31:57 -0700 (PDT) (envelope-from hrs@jp.FreeBSD.org) Received: from mail.allbsd.org (p17010-adsao04hon-acca.tokyo.ocn.ne.jp [61.199.22.10]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id AEB221843; Mon, 19 Aug 2002 04:31:55 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by mail.allbsd.org (8.12.3/3.7W/DomainMaster) with ESMTP id g7IJVKLu043229; Mon, 19 Aug 2002 04:31:20 +0900 (JST) (envelope-from hrs@jp.FreeBSD.org) Date: Mon, 19 Aug 2002 04:31:14 +0900 (JST) Message-Id: <20020819.043114.94603141.hrs@eos.ocn.ne.jp> To: absinthe@pobox.com Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Please review: new Java Project docs From: Hiroki Sato In-Reply-To: <200208171607.12234.absinthe@pobox.com> References: <200208171607.12234.absinthe@pobox.com> X-Mailer: Mew version 2.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Hi, Dylan Carlson wrote in <200208171607.12234.absinthe@pobox.com>: absinthe> 1. &man.command.section doesn't build links, it just builds plaintext. Here absinthe> is what I have set in book.sgml: Did you use freebsd.dsl? If so, references to man pages should be rendered as elements. freebsd.dsl has slightly different customizing layer from original nwalsh's DSSSL stylesheet (the latest version of nwalsh's uses %citerefentry-link% knob to realize it). absinthe> 2. I haven't figured out how to include a footer with a "Last modified" absinthe> date/time stamp based on the source .sgml mtime. Hmmm, it is not impossible, but is a little bit difficult. Any other docs maintained by FDP do not use the feature. If you think to add the docs as FDP's ones, I personally think that to keep the style consistency is better. absinthe> 3. I couldn't get tags to work with id's set inside of . Could you show a sgml source in question? absinthe> 4. There were a few places I would have liked to insert a
on the output. absinthe> It looks that DocBook doesn't support this, however I am curious if there are absinthe> solutions. DSSSL stylesheet supports some object rules by default. For detail, see also . If you want to put rules that cannot be done in this way, you have to write a DSSSL code, or modify docbook.css. In either case, stylesheets are responsible for appearance, not DocBook itself. absinthe> 5. numbers and bullets format strange on absinthe> Konqueror browsers (the number/bullet is shifted up slightly from the absinthe> ) ... otherwise everything else on Konqueror looks better vs. absinthe> Mozilla 1.0. This problem can be relieved by customizing a CSS stylesheet. absinthe> 6. I wanted some more control over how get laid out. absinthe> I wanted to have 's build as separate pages with indexes of absinthe> and 's nested underneath but was unsure how to do this ... so I was absinthe> forced to flatten the document structure out at whenever possible. This sort of customization needs to modify a DSSSL stylesheet (for example, redefining $section-title$ and so on). -- Hiroki SATO To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message