From owner-freebsd-doc Tue Jul 30 15:34:13 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 9A11A37B400 for ; Tue, 30 Jul 2002 15:34:09 -0700 (PDT) Received: from heaven.gigo.com (heaven.gigo.com [64.57.102.22]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7200443E67 for ; Tue, 30 Jul 2002 15:34:07 -0700 (PDT) (envelope-from lioux@brturbo.com) Received: from 200-193-224-022-bsace7003.dsl.telebrasilia.net.br (200-193-224-022-bsace7003.dsl.telebrasilia.net.br [200.193.224.22]) by heaven.gigo.com (Postfix) with ESMTP id 56ECEB70E for ; Tue, 30 Jul 2002 15:34:01 -0700 (PDT) Received: (qmail 27128 invoked by uid 1001); 30 Jul 2002 22:26:06 -0000 Message-ID: <20020730222606.27127.qmail@exxodus.fedaykin.here> Date: Tue, 30 Jul 2002 19:25:44 -0300 From: Mario Sergio Fujikawa Ferreira To: freebsd-doc@FreeBSD.org Cc: lauri@kde.org Subject: Docbook .dsl help Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4i X-Operating-System: FreeBSD 4.6-STABLE X-Disclaimer: I hope you find what you are looking for... in life :) 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, I am writing some sgml docs to help ppl track what I am doing about bugs in some of my ports. Some of them are pretty nasty. This is good because it will allow ppl to help me track them down as well. I added just one port so that I could define how the template for these pages would be. I wrote some dsl code but I am stuck with some stuff I would like. I am not even sure it is possible to do. I apologize if I plagiarized the FreeBSD style for the pages but I am working on other matters. Besides, this is all FreeBSD work. However, I don't mind placing disclaimers crediting anyone, just let me know. - page currently being generated http://people.freebsd.org/~lioux/pending-ports/ - page with style I want http://people.freebsd.org/~lioux/pending-ports.WANT/ I had a lot of things I wanted to change but I caved for 3 things. Check differences between these 2 pages http://people.freebsd.org/~lioux/pending-ports/chap.id.net.dctc.html http://people.freebsd.org/~lioux/pending-ports.WANT/chap.id.net.dctc.html 1) Instead of "Chapter number_of_chapter", I would like to get "Port". This should affect all "Chapter number_of_chapter" occurences such as header of page http://people.freebsd.org/~lioux/pending-ports.WANT/x40.html 2) In "Table of Contents", I would like to get only "number_of_section" prepended to the section titles instead of getting "number_of_chapter.number_of_section". How does this affect example numbering in book TOC? 3) I would like to know if there is some sort of "don't break here if possible tag". Check the TOC at http://people.freebsd.org/~lioux/pending-ports/chap.id.net.dctc.html http://people.freebsd.org/~lioux/pending-ports.WANT/chap.id.net.dctc.html Although, I am using html-split, the 1st 4 sects are listed in the same page. This is to maintain an even reading flow instead of having to click->next on several pages with one line texts. I want a tag that will delay breaking with the following characteristics: i) since this is break delaying, break normally if we hit a physical limit such as page length (A4). Of course, this probably does not apply to html mode ii) delay page breaking between the tag 1st 4 sections Well, I know that some of these might be too much to ask without writing a complete .dsl file. However, it much be possible by doing some weird combinations of private .dsl and ,
, ... tricks which I am not aware of. I am just fiddling around for ideas. My files http://people.freebsd.org/~lioux/pending-ports/Makefile http://people.freebsd.org/~lioux/pending-ports/book.sgml http://people.freebsd.org/~lioux/pending-ports/bookinfo.ent http://people.freebsd.org/~lioux/pending-ports/chapter.decl http://people.freebsd.org/~lioux/pending-ports/chapters.ent http://people.freebsd.org/~lioux/pending-ports/freebsd.dsl http://people.freebsd.org/~lioux/pending-ports/legalnotice.sgml http://people.freebsd.org/~lioux/pending-ports/local.ent http://people.freebsd.org/~lioux/pending-ports/net.dctc/Makefile http://people.freebsd.org/~lioux/pending-ports/net.dctc/chapter.sgml Let me know if you need any information. I need help so I do not mind providing ANY information. :) Of course, I am open to suggestions regarding diagraming, css, text, grammar... Anything to improve it. Regards, -- Mario S F Ferreira - DF - Brazil - "I guess this is a signature." Computer Science Undergraduate | FreeBSD Committer | CS Developer flames to beloved devnull@someotherworldbeloworabove.org feature, n: a documented bug | bug, n: an undocumented feature To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message