[docbook] the proper markup for displaying a file snippet?

2011-07-07 Thread Robert P. J. Day
(apologies for such trivial questions -- i'm only just getting back to docbook after quite some time away.) if i wanted to display the contents (or an excerpt thereof) of a simple text file such as, say, a config file, what is the semantically proper element? i don't want to use

[docbook] any semantic diff between a file name and directory name?

2011-07-06 Thread Robert P. J. Day
(not strictly a docbook question but i'm interested in the opinion of the gurus here.) i'm perusing the semantic markup of someone who has created their own XML language which, in all, looks fairly similar to docbook, but this person has explicitly defined two elements -- file-name and

Re: [docbook] docbook definition still based on DTD?

2010-01-07 Thread Robert P. J. Day
On Thu, 7 Jan 2010, Jirka Kosek wrote: Robert P. J. Day wrote: perhaps a silly question, but at the moment (as i read it), the definition of docbook is generally presented as the official DTD. however, there is also a schema for docbook and, given that schemas can represent things non

[docbook-apps] revisit: putting together a docbook 5.0 toolchain for linux

2010-01-07 Thread Robert P. J. Day
-- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http

Re: [docbook-apps] revisit: putting together a docbook 5.0 toolchain for linux

2010-01-07 Thread Robert P. J. Day
replacing fop. xep is not open source, is it? last i looked, it was still commercial with trial versions. ideally, i'd like to keep my entire toolchain OSS. rday -- Robert P. J. Day Waterloo

Re: [docbook-apps] revisit: putting together a docbook 5.0 toolchain for linux

2010-01-07 Thread Robert P. J. Day
-- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday

Re: [docbook-apps] sample docbook5 files to stress test XSL processors?

2009-11-24 Thread Robert P. J. Day
to do is just set up a minimal f12 toolchain. thoughts and a couple questions on that shortly. rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training

[docbook-apps] validating and transforming a simple docbook5 file in fedora linux

2009-11-24 Thread Robert P. J. Day
. for no good reason, i want to clarify these steps so i can write a one-page wiki entry on how to get started playing with docbook5 on fedora linux. -- Robert P. J. Day Waterloo, Ontario, CANADA

Re: [docbook-apps] sample docbook5 files to stress test XSL processors?

2009-11-24 Thread Robert P. J. Day
of a 5.0 directory under that one: http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/testdocs/tests/5.0/ i'm assuming that's where a collection of equivalent 5.0 docs are slowly being collected? rday -- Robert P. J. Day

[docbook-apps] sample docbook5 files to stress test XSL processors?

2009-11-23 Thread Robert P. J. Day
. is there a canonical test suite for this? thanks. rday -- Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page

[docbook-apps] updating the docbook packages page?

2009-06-25 Thread Robert P. J. Day
some of the content here could stand to be updated: http://wiki.docbook.org/topic/DocBookPackages where's the right forum to make some suggestions? rday -- Robert P. J. Day Waterloo

DOCBOOK-APPS: two issues with XSLT processors -- xsltproc and xalan

2003-03-17 Thread Robert P. J. Day
to follow up bob stayton's recent posting on adding xsl:output indent=yes to get indented, hierarchical output: 1) works great with xalan. xsltproc, on the other hand, doesn't seem to recognize this attribute although, in all fairness, no XSLT processor is *required* to do so 2) xalan

DOCBOOK-APPS: docbook - FO via xsltproc

2003-03-16 Thread Robert P. J. Day
a couple of quick questions regarding docbook - FO and beyond. first, i'm experimenting with FOP for the eventual FO - PDF conversion, so i'm using xsltproc to generate the intermediate FO for the time being. is there an option with xsltproc to generate tidy FO? or some kind of tidy utility

Re: DOCBOOK: Re: marking up keycaps according to their semantics

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Steinar Bang wrote: Robert P. J. Day [EMAIL PROTECTED]: the problem is that something like the escape key can be used in two different ways: 1) it can be a modifier, if you want to call it that, in that it can be pressed just before pressing another key

Re: DOCBOOK: Re: marking up keycaps according to their semantics

2003-03-12 Thread Robert P. J. Day
i didn't mean to make a big issue out of this; i'm satisfied with the current proposal, but let me just try to explain what i was talking about -- it might make sense, it might not. currently, a key cap is written as keycapx/keycap. this seems to suggest that a keycap is, by default, of

RE: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, David Cramer wrote: Nested procedures, procedures inside of tables, etc. would be messy--not sure how you'd number them. substeps allows you to nest procedures without that problem. I think no procedures in paras is a good thing. i don't follow this logic. in a way, a

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Jeff Biss wrote: Here's my 2 cents: I see no reason that a procedure should be a child of a paragraph. The paragraph immediately preceding a procedure would reference that procedure. Why would one need to put a procdure inside a paragraph? for exactly the same reason

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Tim Waugh wrote: I think you're confusing para with simpara. A para is not a single textual paragraph, but a grouping of elements that constitute an idea. It's typically used in the same way that simpara is, but it's very often used like this: paraIt's very often

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Jeff Biss wrote: So what are you proposing? That an inline procedure element be a child of the paragraph element? only that a para be allowed to have a procedure as a child, that's all. i think this has gotten blown way out of proportion here. rday

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Steven Cogorno wrote: Robert P. J. Day said: consider a possible para: paraIf you want to start writing in DocBook, here are the steps you'll need to do: procedure /procedure /para this makes perfect sense, and it's clear

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Carlos Araya wrote: Robert: Semantically iot makes perfect sense but it's when converting the docbook to other formats that a problem is caused. How owuld translate the: procedure step.../step /procedure Into HTML or PDF? I tend to agree with a previous

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Jeff Biss wrote: As I see it now you have a point in seeing that the procedure element be included as a child of the paragraph element. It does make sense, especially in context of the other child elements. Why not put in an RFE at:

Re: DOCBOOK: Re: any reason why a procedure is not a child of para?

2003-03-12 Thread Robert P. J. Day
On Wed, 12 Mar 2003, Jeff Biss wrote: If I may inquire, what ever happened to your RFE? I assume it wasn't implemented, any reason why? well, i submitted it this morning. i guess norm is slacking again. :-) rday

DOCBOOK-APPS: generating PDF using FOP?

2003-03-11 Thread Robert P. J. Day
? and if anyone wants to play along, i can email them my sample DB file showing the various markup elements and they can see what they get out of it. rday -- Robert P. J. Day, RHCE Eno River Technologies, Inc. Unix, Linux and Open Source training

DOCBOOK-APPS: curious about xerces parser and endorsed classes

2003-03-08 Thread Robert P. J. Day
since this involves parsing potentially docbook files, i figured i'd throw it out here. i'm trying to clarify how one properly installs the xerces-j parser for use by, for instance, saxon, and i've read conflicting explanations. the xerces-j distribution comes with three jar files:

DOCBOOK: any reason why a procedure is not a child of para?

2003-03-07 Thread Robert P. J. Day
i just noticed that the procedure element cannot be a child of a para, as can other lists. any reason for this? it seems like this would be useful if a procedure should be considered part of its enclosing paragraph. just curious. rday

DOCBOOK-APPS: missing some java classes running FOP

2003-03-06 Thread Robert P. J. Day
i downloaded the latest FOP from xml.apache.org, and installed what i thought was everything i needed around it (Jimi, the newer xalan in the endorsed/ directory and so on), but when i run FOP to convert a .fo file to .pdf, i get: [INFO] Using org.apache.xerces.parsers.SAXParser as SAX2 Parser

DOCBOOK-APPS: how to upgrade docbook XSL stylesheets?

2003-03-06 Thread Robert P. J. Day
is there anything to upgrading to a newer set of docbook XSL stylesheets besides just downloading the tarball and installing it in the right place? it seems fairly obvious, but one never knows. i have a RH 8.0 system with the salient directories /usr/share/sgml/docbook/

Re: DOCBOOK-APPS: trying to use xmlto in red hat to customize PDFoutput

2003-03-04 Thread Robert P. J. Day
On Tue, 4 Mar 2003, Tim Waugh wrote: On Tue, Mar 04, 2003 at 05:48:11AM -0500, Robert P. J. Day wrote: and add it to the xmlto command with -m, it has no effect. is this because it's not an xsl:param, but an xsl:attribute-set? The xmlto program doesn't interpret the fragments at all

Re: DOCBOOK-APPS: Re: needing clarification about XSL transformation

2003-03-03 Thread Robert P. J. Day
On Mon, 3 Mar 2003, Vitaly Ostanin wrote: On Sun, 02 Mar 2003 14:51:41 -0500 (EST) Robert P. J. Day [EMAIL PROTECTED] wrote: i spent the last hour trying to figure out why i was losing my PIs and comments in transforming my original XML source file to another XML format. my

Re: DOCBOOK-APPS: Re: needing clarification about XSL transformation

2003-03-03 Thread Robert P. J. Day
On Mon, 3 Mar 2003, Vitaly Ostanin wrote: With this style xslt-processor must not copy comments and PI. This style not overriding built-in templates, so saxon is incorrect. ah, so as i read this, the conflict resolution is that, even if i have a template that matches node(), that will be

Re: DOCBOOK-APPS: Re: needing clarification about XSL transformation

2003-03-03 Thread Robert P. J. Day
On Mon, 3 Mar 2003, Jirka Kosek wrote: Vitaly Ostanin wrote: node() is not a comment, not PI, not attribute - it just node like node/ With respect, you are wrong. Exact behaviour of node() is defined in XPath recommendation and you can read in section 2.3: A node test node() is

Re: DOCBOOK-APPS: Re: needing clarification about XSL transformation

2003-03-03 Thread Robert P. J. Day
On Mon, 3 Mar 2003, Jirka Kosek wrote: But this discussion should be probably moved to some xsl specific or processor specific list. It drifted far away from DocBook processing. i agree. i've already posted on the mulberrytech list, so i'll see what i get back there. rday

DOCBOOK-APPS: needing clarification about XSL transformation

2003-03-02 Thread Robert P. J. Day
i spent the last hour trying to figure out why i was losing my PIs and comments in transforming my original XML source file to another XML format. my stripped-down stylesheet to isolate the problem was ?xml version=1.0 encoding=utf-8? xsl:stylesheet

DOCBOOK-APPS: no wonder i'm confused about the node() function

2003-03-02 Thread Robert P. J. Day
XSLT, Doug Tidwell, p. 51 * The node() node test, which selects all nodes in the current context, regardless of type. This includes elements, text, comments processing instuctions, attributes, and namespace nodes. XSLT Programmer's Reference, 2nd ed., Michael Kay, p. 432 Since root

DOCBOOK-APPS: xslt mailing list?

2003-02-27 Thread Robert P. J. Day
i'm about to sit down with kay's 1000-page XSLT book and a keg of coffee. is there an XSLT-specific mailing list somewhere that i can antagonize on occasion? rday

DOCBOOK: what is a qandaset supposed to generate?

2003-02-26 Thread Robert P. J. Day
for the first time, i'm incorporating a qandaset into a document, and when generating the chunked HTML, what i'm getting doesn't match what is in the latest TDG online documentation. what i get is, first, the list of questions (which are links), followed by the question and answer pairs.

DOCBOOK: figure, graphic and mediaobject

2003-02-26 Thread Robert P. J. Day
is the figure element still endorsed despite the fact that there is a mediaobject element that can contain an imageobject? i notice that, in docbook 5.0, mediaobject will replace graphic. will figure also be deprecated in deference to mediaobject as well? rday p.s. and did anything ever

Re: DOCBOOK-APPS: how to insert page breaks after sections in PDF?

2003-02-25 Thread Robert P. J. Day
On Tue, 25 Feb 2003, Bob Stayton wrote: On Tue, Feb 25, 2003 at 11:31:52AM -0500, Robert P. J. Day wrote: almost certainly a trivial question, but i've looked through the entire FO Parameter Reference and i don't see how i can force a page break before particular section headers when

Re: DOCBOOK-APPS: how to insert page breaks after sections in PDF?

2003-02-25 Thread Robert P. J. Day
On Tue, 25 Feb 2003, Bob Stayton wrote: On Tue, Feb 25, 2003 at 11:31:52AM -0500, Robert P. J. Day wrote: almost certainly a trivial question, but i've looked through the entire FO Parameter Reference and i don't see how i can force a page break before particular section headers when

DOCBOOK-APPS: whoops, sorry about that last post

2003-02-25 Thread Robert P. J. Day
pulled it out of dead.letter but forgot to clean it up. sorry. rday

Re: DOCBOOK-APPS: how to terminate XML tags in emacs

2003-02-25 Thread Robert P. J. Day
On Tue, 25 Feb 2003, Martin Stemplinger wrote: On So Feb 23 2003 at 18:29, Robert P. J. Day [EMAIL PROTECTED] wrote: as a final efficiency for typing in my XML, i'd like to add an emacs function to auto-terminate tags, as one can do in emacs+psgml. (i don't know enough about psgml

RE: DOCBOOK-APPS: how to insert page breaks after sections in PDF ?

2003-02-25 Thread Robert P. J. Day
On Tue, 25 Feb 2003, Jeff Beal wrote: I have the following template in my customization layer that forces a page break and places the section on an odd-numbered page, based on the existence of a role attribute: xsl:template match=[EMAIL PROTECTED]'rightpagestart'] fo:block

RE: DOCBOOK-APPS: how to insert page breaks after sections in PDF ?

2003-02-25 Thread Robert P. J. Day
On Tue, 25 Feb 2003, Jeff Beal wrote: XSL customization can be quite complicated in many ways. Basically, you need to be the master of the source language (DocBook), the target language (XSL-FO or HTML+CSS), the transformation language (XSLT), and the stylesheet base (The XSLT stylesheets

DOCBOOK-APPS: how to terminate XML tags in emacs

2003-02-23 Thread Robert P. J. Day
as a final efficiency for typing in my XML, i'd like to add an emacs function to auto-terminate tags, as one can do in emacs+psgml. (i don't know enough about psgml to see how it does it, but i don't need all of psgml -- just this one feature.) all i want to be able to do is, with a control

DOCBOOK-APPS: designing an XSL stylesheet for pidgin docbook

2003-02-18 Thread Robert P. J. Day
i'm following the advice of one of the posters here and designing an XSL stylesheet that will allow me to write in what i'm calling pidgin docbook, with shortcuts for all of the elements i use, like p for para, em for emphasis, and so on. what i'm not clear on is how to write a template for

Re: DOCBOOK-APPS: designing an XSL stylesheet for pidgin docbook

2003-02-18 Thread Robert P. J. Day
On Tue, 18 Feb 2003, Bob Stayton wrote: On Tue, Feb 18, 2003 at 11:41:32AM -0500, Robert P. J. Day wrote: i'm following the advice of one of the posters here and designing an XSL stylesheet that will allow me to write in what i'm calling pidgin docbook, with shortcuts for all

RE: DOCBOOK-APPS: designing an XSL stylesheet for pidgin docboo k

2003-02-18 Thread Robert P. J. Day
On Tue, 18 Feb 2003, Jeff Beal wrote: I would include the xsl:apply-templates select=@*|node()/ in all of your templates. If you just use xsl:apply-templates/, you will discard all text, comments, processing-instructions, and attributes in that element. ah, gotcha. so, other than that, it

DOCBOOK-APPS: how to create an .xsl file to transform pidgin docbook

2003-02-18 Thread Robert P. J. Day
just in case anyone was interested, i threw together a script that accepts pairs of element names and generates the appropriate .xsl file that i use to tranform pidgin docbook to the real thing. it *appears* to work, and you can see how easy it is to add more transformations. rday

DOCBOOK-APPS: couple more questions about transforming pidgin docbook

2003-02-18 Thread Robert P. J. Day
i'm still working my way thru the literature on XSLT, and i'm having a couple of transformation issues with my current .xsl file. to be brief, here's the opening part of the pidgin.xsl file: ?xml version=1.0 ? xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform;

RE: DOCBOOK-APPS: couple more questions about transforming pidgindocbook

2003-02-18 Thread Robert P. J. Day
On Tue, 18 Feb 2003, David Cramer wrote: Using Saxon and your stylesheet, I get ?xml version=1.0 encoding=utf-8? and comments are copied through. ok, so apparently, xsltproc is not behaving nicely. thanks. rday

DOCBOOK-APPS: writing a condensed form of docbook

2003-02-17 Thread Robert P. J. Day
while i know there are numerous XML editors to make one's life easier, one of my issues is that, in the end, the docbook that is produced is virtually impossible to scan (although i'm sure numerous people will tell me that that's not the point, you're not *supposed* to be able to scan it, just

Re: DOCBOOK-APPS: writing a condensed form of docbook

2003-02-17 Thread Robert P. J. Day
On Mon, 17 Feb 2003, Markus Spath wrote: Robert P. J. Day wrote: i like to write my documents and manuals in condensed form, and it would be nice to quickly to go from that to final docbook. Since you stay with the xml-syntax anyway I'd say XSLT would be a convenient way; all

DOCBOOK-APPS: selecting a toolchain

2003-02-11 Thread Robert P. J. Day
since i'm just about to start transforming some of my docbook files into PDF, i was looking at the possible toolchains and have a couple questions: first, since my docs are not that complicated, i was going to try saxon 7.3.1, just for the fun of it, but this leads to two issues: 1) is

Re: DOCBOOK-APPS: selecting a toolchain

2003-02-11 Thread Robert P. J. Day
On Tue, 11 Feb 2003, Jirka Kosek wrote: Robert P. J. Day wrote: first, since my docs are not that complicated, i was going to try saxon 7.3.1, just for the fun of it, but this leads to two issues: Saxon 7.x is _experimental_ implementation of XSLT 2.0. It is not recommended

DOCBOOK-APPS: how to generate TOC listings in every section?

2003-02-09 Thread Robert P. J. Day
what XSL param would i use to generate a single-level TOC in every section, regardless of that section's level? that is, at the chapter level, i want to open with a TOC that contains only the section level 1 entries. if i go to a level 1 section, it should start with a TOC listing its

Re: DOCBOOK-APPS: i can't seem to chunk more than level 2

2003-02-04 Thread Robert P. J. Day
On Tue, 4 Feb 2003, Bob Stayton wrote: On Mon, Feb 03, 2003 at 06:14:17PM -0500, Robert P. J. Day wrote: i have a docbook file that, for the first time, is using three levels of sectioning, but even when i set the chunking level to 3, it refuses to go beyond two. here's my

DOCBOOK-APPS: i can't seem to chunk more than level 2

2003-02-03 Thread Robert P. J. Day
i have a docbook file that, for the first time, is using three levels of sectioning, but even when i set the chunking level to 3, it refuses to go beyond two. here's my chunk.xsl file: ?xml version='1.0'? xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform;

DOCBOOK: OT -- need more info on website.dtd

2003-01-26 Thread Robert P. J. Day
a while back, i got some pointers from people on this list for websites that used the website DTD -- some very nice examples there. any pointers to tutorials on starting to use the website DTD? mailing list? examples? any pointers gratefully accepted. rday Robert P. J. Day, RHCE Eno

Re: AW: DOCBOOK: OT -- need more info on website.dtd

2003-01-26 Thread Robert P. J. Day
On Sun, 26 Jan 2003, Daniel S. Haischt wrote: i can send my ant build.xml file and the corresponding website stylesheets to the list if you are interested ... btw - shouldn't this mail go to docbook-apps instead of docbook ;-) probably. or it would be even better if it went to

Re: DOCBOOK: how to represent key sequence Ctrl Alt Fn??

2002-12-16 Thread Robert P. J. Day
On Sun, 15 Dec 2002, Adam DiCarlo wrote: Robert P. J. Day [EMAIL PROTECTED] writes: but what if i wanted to similarly represent Ctrl Alt Fn, where the n part was replaceable? is there any way to add parameters to regular entity definitions? Not really. An entity can use another

DOCBOOK: how to represent key sequence Ctrl Alt Fn??

2002-12-14 Thread Robert P. J. Day
from what i've read, it appears that the officially sanctioned to represent something like the simultaneous key combination Ctrl Alt Del would be keycombo action=simul keycapCtrl/keycap keycapAlt/keycap keycapDel/keycap /keycombo and if i was planning on needing it frequently,

DOCBOOK-APPS: editing XML in outline mode??

2002-12-14 Thread Robert P. J. Day
for the longest time, i've designed manuals using emacs outline mode, given the invaluable ability to expand and collapse any part of the document. given that i'm just about to start learning the psgml package to use with emacs, can i still set it up to use outline mode while retaining psgml

Re: DOCBOOK: Re: Request for comments: adding a Fileoutput element(RFE 613293)

2002-12-06 Thread Robert P. J. Day
On Fri, 6 Dec 2002, Norman Walsh wrote: How does this sound: 1. Add 'verbatim'. !ELEMENT verbatim (...) !ATTLIST verbatim class(normal|monospaced) monospaced contents CDATA #IMPLIED Contents is where you can say it's a configfile or a cprogram or whatever

DOCBOOK-APPS: XSL versus DSSSL

2002-11-28 Thread Robert P. J. Day
given that i've concentrated exclusively on docbook and XSL stylesheets, am i correct in assuming that DSSSL stylesheets are an alternative to XSL? (which, AFAICT, i have no interest in since i'm restricting myself to XSL). which leads to a related question -- as i read it, the jade

Re: DOCBOOK-APPS: chapter numbering

2002-11-26 Thread Robert P. J. Day
On Tue, 26 Nov 2002, Wlodzimierz Skiba wrote: Is chapters supposed to be counted per part ? I mean is this a bug or expected behaviour that chapters are rendered with contignous numbering along whole book without reset at begining of each part. I use following syntax: book

DOCBOOK: confused about callouts

2002-11-25 Thread Robert P. J. Day
i have a section of a much larger docbook document, with the following screen element and co callout marks: screen filename/etc/passwd/filename co id=/etc/passwd/ filename/etc/shadow/filename co id=/etc/shadow/ filename/etc/group/filename

DOCBOOK: ambiguity in xref regarding cross-reference text

2002-11-24 Thread Robert P. J. Day
again, nitpicky, but in the online TDG 2.0.7, in the explanation of xref, we read: ... If the Endterm attribute is specified, the content of the element pointed by by Endterm must be used as the text of the cross-reference ... If the object pointed to has a specified XRefLabel, that

DOCBOOK: semantic difference between symbol and constant?

2002-11-23 Thread Robert P. J. Day
appropriate for some symbols, so is there a compelling example of a value that would be symbol that would clearly *not* be a constant? and, given their similarity, it would probably be useful that each of them refer to the other with See Also. rday Robert P. J. Day, RHCE, RHCI Eno River

DOCBOOK: shortcut and Emacs key sequence

2002-11-23 Thread Robert P. J. Day
the example for a shortcut seems inappropriate, since it allegedly demonstrates a keycombo for an emacs key sequence, which is presented as C-x-C-c, but the standard representation for an emacs key sequence is (AFAICT) C-x C-c instead. comments? rday

DOCBOOK: picky, pedantic question

2002-11-22 Thread Robert P. J. Day
according to TDG 2.0.7, the table attribute tocentry defines whether the table will appear in the generated List of Tables. is there a reason that attribute is not called lotentry instead? rday

DOCBOOK: refresher on what Default means for an attribute?

2002-11-21 Thread Robert P. J. Day
for something like itemizedlist, what does it mean for the spacing attribute to have no listed default? i'm sure someone explained this to me once before, i've just lost it (the answer, not my mind). rday

DOCBOOK: para versus simpara?

2002-11-20 Thread Robert P. J. Day
i'm not clear on the rationale for the simpara element. since it seems to be a restricted version of para, does it have any benefits? i guess, other than that it can be transformed differently based on a stylesheet. rday Robert P. J. Day, RHCE, RHCI Eno River Technologies, Chapel Hill NC

Re: DOCBOOK-APPS: publisher element

2002-11-19 Thread Robert P. J. Day
On Tue, 19 Nov 2002, Restie Perona wrote: hi guys, can anybody help me about this? My text shows like this: Philadelphia: WB Saunders, with error: publisher address cityPhiladelphia:/city /address publishernameWB Saunders,/publishername /publisher

Re: DOCBOOK-APPS: publisher element

2002-11-19 Thread Robert P. J. Day
On Tue, 19 Nov 2002, Bob Stayton wrote: On Tue, Nov 19, 2002 at 01:30:07PM -0500, Robert P. J. Day wrote: On Tue, 19 Nov 2002, Restie Perona wrote: hi guys, can anybody help me about this? My text shows like this: Philadelphia: WB Saunders, with error: publisher

DOCBOOK-APPS: how to change the displayed style of lineannotation?

2002-11-13 Thread Robert P. J. Day
currently, in a screen element, anything i put in a lineannotation element is displayed in regular, courier font. what's the easiest way to have that italic, times roman instead? is there a specific XSL stylesheet directive for doing this, or should i go through the CSS decoration? and am

RE: DOCBOOK-APPS: Entity defs per XML file?

2002-11-13 Thread Robert P. J. Day
On Wed, 13 Nov 2002, Kraa de Simon wrote: Ehm, not really... (-; I do not want to define all entities in main.xml (where the DOCTYPE is, as you indicated), but divide them over the different XML files where the entities are actually used. The main reason: so I can isolate the

Re: DOCBOOK-APPS: how to change the displayed style oflineannotation?

2002-11-13 Thread Robert P. J. Day
On Wed, 13 Nov 2002, Bob Stayton wrote: On Wed, Nov 13, 2002 at 06:05:26AM -0500, Robert P. J. Day wrote: currently, in a screen element, anything i put in a lineannotation element is displayed in regular, courier font. what's the easiest way to have that italic, times roman instead

DOCBOOK-APPS: errortext is not being recognized as an element

2002-11-12 Thread Robert P. J. Day
i'm writing some fairly simple docbook in red hat 8.0, which has the docbook 4.2 dtd, which allegedly supports the errortext element. i've verified that that DTD directory is there under /usr/share/sgml/docbook, that xmlcatalog properly resolves the public identifier to that location, i've

DOCBOOK-APPS: how to get xsltproc to generate tidy html?

2002-11-12 Thread Robert P. J. Day
i'm sure numerous folks will tell me that this is a silly thing to do, but is there a parameter somewhere that will tell xsltproc to generate tidy html from docbook, so that it's at least remotely humanly readable, rather than one long line? just curious. having it a bit more readable makes

Re: DOCBOOK-APPS: how to get xsltproc to generate tidy html?

2002-11-12 Thread Robert P. J. Day
On Tue, 12 Nov 2002, Jirka Kosek wrote: Robert P. J. Day wrote: i'm sure numerous folks will tell me that this is a silly thing to do, but is there a parameter somewhere that will tell xsltproc to generate tidy html from docbook, so that it's at least remotely humanly readable

DOCBOOK-APPS: how to get the cool outline circles in a calloutlist?

2002-11-11 Thread Robert P. J. Day
what's the trick to getting the neat dark circles with internal numbers in a callout list like norm walsh has in his online docbook TDG? all i get are boring numbers. i'm sure there's an XSL trick somewhere, yes? rday

Re: DOCBOOK-APPS: how to get the cool outline circles in a calloutlist?

2002-11-11 Thread Robert P. J. Day
On Mon, 11 Nov 2002, Bob Stayton wrote: Are you using a customization? The 'callout.graphics' parameter is set to 1 by default in the XSL stylesheets. found the problem -- the callout graphics png files 1.png and so on were not at the default directory location, so a quick fix to

Re: DOCBOOK-APPS: how to get the cool outline circles in a calloutlist?

2002-11-11 Thread Robert P. J. Day
On Mon, 11 Nov 2002, Bob Stayton wrote: On Mon, Nov 11, 2002 at 05:23:09PM -0500, Robert P. J. Day wrote: On Mon, 11 Nov 2002, Bob Stayton wrote: Are you using a customization? The 'callout.graphics' parameter is set to 1 by default in the XSL stylesheets. found the problem

DOCBOOK: how to annotate/callout a list of files

2002-11-09 Thread Robert P. J. Day
i want to list all of the files involved in the linux login process: /etc/passwd /etc/shadow /etc/group /etc/profile ... etc etc ... and would like to assign something like callouts to each file so i can expand on each one underneath the list. but, as i read it, cos can't be

DOCBOOK-APPS: trying to test xerces with java sax.Counter file.xml

2002-11-06 Thread Robert P. J. Day
i can't seem to get java to find the sax.Counter class to play with some of the xerces stuff. first, under red hat 8.0, i've installed sun's jdk 1.4.1, and that seems to work fine, with the full path being /usr/java/j2sdk-1.4.1. according to the docs, i can add some extensions as long as

Re: DOCBOOK-APPS: questions about XML catalogs?

2002-11-02 Thread Robert P. J. Day
On Sat, 2 Nov 2002, Mark Johnson wrote: On Saturday, November 2, Robert P. J. Day wrote: if one has queries about XML catalogs, where's the best place to ask? Since I suspect you're interested in the RedHat implementation, Daniel Veillard is their defacto resident xml catalog policy

DOCBOOK-APPS: looking for docbook/xml/xslt/etc courseware

2002-10-16 Thread Robert P. J. Day
i have a couple clients who are interested in a course in xml/docbook and associated processing. i could write it myself at this point, but it would take some time. does anyone have recent, up-to-date and battle-tested courseware? feel free to drop me a note and we can talk. or point me

Re: DOCBOOK: Re: Markup for exercises

2002-10-10 Thread Robert P. J. Day
On Thu, 10 Oct 2002, Norman Walsh wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 / Joachim Ziegler [EMAIL PROTECTED] was heard to say: | Exercises occur much more frequently as a building block than descriptions of | destructors., I think. That's why I was wondering why there is no

DOCBOOK: broken link

2002-09-29 Thread Robert P. J. Day
www.oasis-open.org/committees/docbook/specs/cs-docbook-docbook-4.2.xml seems to be broken. or is it just me? rday

DOCBOOK: what kind of element is a set of exercises?

2002-09-02 Thread Robert P. J. Day
i'm still grappling with how to categorize a set of exercises that would be found at the end of a section. i'd like the set to have a title, Exercises, but i don't want it to be a section since that doesn't seem appropriate, and i don't want the exercises to show up in the TOC.

curiosity about online alpha version of docbook: TDG

2002-08-27 Thread Robert P. J. Day
(i emailed norm walsh about this already, but assuming that he's generally a busy guy, i thought i'd ask about something here.) for the purpose of being able to peruse the latest (2.0.7) version of docbook: TDG, i wanted to print it off, perhaps using mpage to do it 2 up to save paper.

Re: DOCBOOK: Re: hierarchical element reference list for docbook?

2002-08-02 Thread Robert P. J. Day
On Fri, 2 Aug 2002 [EMAIL PROTECTED] wrote: On Tue, Jul 30, 2002 at 03:55:41PM -0700, Norman Walsh wrote: The see-also lists at the bottom of each reference page are generated from this list: Is this list in tdg cvs, so that we could work and submit patches on latest version ? I have

DOCBOOK: Re: DOCBOOK-APPS: Your version, docbook elements

2002-08-01 Thread Robert P. J. Day
On Thu, 1 Aug 2002, Dave Pawson wrote: !DOCTYPE section PUBLIC -//OASIS//DTD DocBook XML V4.1.2//EN /sgml/oasis/docbook412/docbookx.dtd !ENTITY tdgHome /documentation/tdg/en/html/ snip what about for 4.2 rather than 4.1.2? or is that a silly question? rday

DOCBOOK: simple question about a choice of markup element

2002-07-31 Thread Robert P. J. Day
what's the appropriate inline markup to use for a term that is just being introduced for the first time? for example, before you start the procedure, you must first go out a buy a widget. a widget is insert explanation here...^^ normally, such terms are shown

DOCBOOK: oasis xml docbook page needs to be updated?

2002-07-28 Thread Robert P. J. Day
www.oasis-open.org/docbook/xml while that page says that DocBook XML V4.2 is the current version of DocBook, the most recent link is to DocBook XML V4.2CR3. perhaps the addition of a link with the more obvious name of simply V4.2? rday

DOCBOOK: hierarchical element reference list for docbook?

2002-07-27 Thread Robert P. J. Day
is there a hierarchical reference list for the current docbook elements somewhere? you know, grouped by association or category or something like that. at the moment, google isn't turning up anything like that. thanks. rday

Re: DOCBOOK: hierarchical element reference list for docbook?

2002-07-27 Thread Robert P. J. Day
On Sat, 27 Jul 2002, Dave Pawson wrote: At 07:11 27/07/2002, Robert P. J. Day wrote: is there a hierarchical reference list for the current docbook elements somewhere? you know, grouped by association or category or something like that. I'd suggest the index in docbook

Re: DOCBOOK: hierarchical element reference list for docbook?

2002-07-27 Thread Robert P. J. Day
On Sat, 27 Jul 2002, Dave Pawson wrote: At 08:58 27/07/2002, Robert P. J. Day wrote: actually, i'm in the process of creating a hierarchical list (in emacs outline mode) of all of the elements listed in TDG (updated when i get the chance). when i'm done, i can post it if anyone's

Re: DOCBOOK: Re: hierarchical element reference list for docbook?

2002-07-27 Thread Robert P. J. Day
On Sun, 28 Jul 2002, Tsuguya Sasaki wrote: Robert P. J. Day wrote: is there a hierarchical reference list for the current docbook elements somewhere? you know, grouped by association or category or something like that. Check the section Logical Divisions: The Categories of Elements

  1   2   >