RE: [docbook] RE: quote inside code. WAS emphasis inside command isillegal?

[Tim Arnold <Tim.Arnold@sas.com>]

Thanks very much for the suggestions. Since this began I've been thinking of writing a simple-minded DocBook 'Tidy' package; walk through your documentation tree, ask whether the current child element is a legal child of the current parent. 
If not, provide a dictionary (that's very specific to your own docs) to return a reasonable legal substitute child.

That's why I was looking for a function before. I'm currently parsing the xsd file that came with the distribution, but I see now that I'll have to parse the rng/rnc file instead; there's not enough info in the xsd file.

I was able to find (via the webarchive) a version of the TDG from 2005; I could parse that html for the legal children if necessary, but my version of the schema is from 2008, so even that's not the best answer. 2005 is as recent a version I could find on the webarchive.

Somewhere in this thread, someone mentioned that the online doc is generated from the schema--is that opensource code? That would have the necessary logic and would be the best answer I think. Any pointers appreciated, the rng file looks like it will take a while to figure out.

thanks,
--Tim Arnold


> -----Original Message-----
> From: Rowland, Larry [mailto:larry.rowland@hp.com]
> Sent: Tuesday, September 28, 2010 12:50 PM
> To: Bob Stayton; Tim Arnold; docbook@lists.oasis-open.org
> Subject: RE: [docbook] RE: quote inside code. WAS emphasis inside command
> is illegal?
> 
> Another feature in oXygen is the Model pane that displays the content
> model for an element based on the cursor being inside the element.  It is
> a little faster than  the opening triangular brace and doesn't insert
> content into the file.  Many other editors have similar features.
> 
> Regards,
> Larry Rowland
> 
> -----Original Message-----
> From: Bob Stayton [mailto:bobs@sagehill.net]
> Sent: Tuesday, September 28, 2010 10:37 AM
> To: Tim Arnold; docbook@lists.oasis-open.org
> Subject: Re: [docbook] RE: quote inside code. WAS emphasis inside command
> is illegal?
> 
> > Or failing that, is there a tool to query the schema for legal child
> > elements given a parent?
> 
> I don't know of such a query tool, but you can use an RNG schema-aware XML
> editor to see what child elements are available for a given parent.  I
> just open a DocBook 5.0 document with Oxygen, configured to associate the
> DocBook namespace with the DocBook
> 5.0 RNG schema.  When inside an element, when I type "<" it prompts me for
> a child element, listing only those that are valid in that context.  Other
> XML editors have a similar feature.
> 
> I'll add an item to the next DocBook Technical Committee agenda to discuss
> maintaining accessible reference documentation for each version.
> 
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
> 
> 
> ----- Original Message -----
> From: "Tim Arnold" <Tim.Arnold@sas.com>
> To: <docbook@lists.oasis-open.org>
> Sent: Tuesday, September 28, 2010 8:29 AM
> Subject: RE: [docbook] RE: quote inside code. WAS emphasis inside command
> is illegal?
> 
> 
> Missed that before, I see that in the preface now, thanks.
> I should have used the docs that came with the distribution. Now that I
> look there
> though I don't see the reference.
> 
> Where can I find the frozen doc that matches the distribution for 5.0?
> 
> Or failing that, is there a tool to query the schema for legal child
> elements given a
> parent?
> something like this:
> somefunc('varname','inlineequation')# returns False
> somefunc('varname','inlinemediaobject')# returns True
> 
> thanks,
> --Tim
> 
> > -----Original Message-----
> > From: Keith Fahlgren [mailto:abdelazer@gmail.com]
> > Sent: Friday, September 24, 2010 4:24 PM
> > To: Tim Arnold
> > Cc: docbook@lists.oasis-open.org
> > Subject: Re: [docbook] RE: quote inside code. WAS emphasis inside
> command
> > is illegal?
> >
> > Just to be clear, it's not as if the online TDG isn't clear on this:
> >
> > """If you're using DocBook V5.0, you will find some things in this
> online
> > text which are new or different from the OASIS Standard release."""
> > http://www.docbook.org/tdg5/en/html/ch00-online.html
> >
> > ...it's just that that's not what I assumed would be true given the
> title
> > & URL, etc.
> >
> >
> > Keith
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>