Re: [docbook] Re: XML Editors SOMETHING ELSE I FORGOT!

[Bob Stayton <bobs at sco dot com>]

Well, that's progress.  And here is my contribution.

I have a version of the DTD that is totally flattened (all
parameter entities resolved), and it loads very quick into
Flat Layout.  And now I'm able to drag and drop elements
from the list to my document. When I assign the DTD to
my document and do Refresh Entry Helpers,
the popup list of elements in context works (when you type "<").

If you want to try the flattened DTD, I checked it into
the DocBook Sourceforge CVS tree under:

  contrib/tools/xmlwriter/docbook42.flat.dtd

With that DTD and the Flat Layout option, XMLWriter is usable.

And the XSL preview feature works with the html/docbook.xsl
stylesheet too.  Pretty nice.

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com

On Thu, May 01, 2003 at 02:02:26PM -0500, Jeff Biss wrote:
>   Bob,
> 
> I just checked a support email from the Wattle crew and see that you can 
> get the tagbar to successfully load the DocBook DTD as a flat layout. 
> Set this in Tools/Options:
> 
> 1. Select Tools in the tree at the left in the Options window
> 2. Seect Flat Layout in Tagbar Mode
> 3. Click OK
> 
> This will take a while, I just did it and it does take a while. You can 
> then drag and drop the elements into your XML file. Here is their 
> explanation regarding the Tagbar and the DocBook DTD:
> 
> "
> 
> You do not see the entire tree in TagBar because the default level of
> recursion in TagBar's Tree Layout is set to 16. This level can be
> changed:
> 
> * On the Tools menu, select Options
> * In the left pane of the Options dialogue box, select Tools
> * Under the option "TagBar mode", change the level of recursion under
> "Tree layout with up to XX levels".
> 
> Please be aware that increasing the level of recursion may result in an
> "out of memory" error. Loosely structured or recursive DTD/Schemas such
> as the DocBook DTD contain a large number of nodes. That is, elements
> contain dozens of other elements which in turn contain dozens of other
> elements, and so on. TagBar's Tree Layout is not designed to load files
> that contain excessive levels of recursion."
> 
> I just want to be fair and accurate.
> 
> Jeff
> 
> Bob Stayton wrote:
> 
> >On Thu, May 01, 2003 at 09:33:15AM -0500, Jeff Biss wrote:
> >
> >>I hate to keep harping about it but XMLWriter is a fine tool and well 
> >>worth the approximately $50 it costs. It is a text based editor but 
> >>makes it obvious when you are not using a DTD's elements properly.
> >>
> >
> >XMLWriter doesn't seem to be usable with DocBook 4.2.
> >I just downloaded XMLWriter 2.12 demo and tried to use
> >it with DocBook.  It took several *minutes* to load the
> >DocBook DTD into the TagBar.  And after it did, the TagBar
> >and the popup Entry Helper don't show all the allowable
> >DocBook elements for a given context.
> >
> It is usable. I've been through this with them regarding this problem. 
> The complexity of the DocBook DTD (it is recursive) causes it to display 
> this way. I don't use the tagbar, I just type in the tags. It properly 
> validates the structure and will produce the correct output of an XSL 
> stylesheet.
> 
> Hopefully they will fix this problem so that the tagbar can be used as 
> intended and show the correct DTD structure. It would be far better if 
> it did show the DocBook hierarchy.

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org