OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] WYSIWYG Editor for docbook

I don't understand this xinclude problem with oxygen. Oxygen has been handling my xincludes, and nested xincludes, seamlessly from versions around 7 or 8 at least. There was a base problem with the earlier versions (back to v.2 in my experience) - see this list about 5 or 6 years ago which gave trouble with xinclude nesting, but as far as I know that has been sorted out. I don't use any 'tricks'. I just loaded v.14 on a new machine and it all worked straight out of the box on nested xincludes.

On 13/08/2012 12:42, Johan Persson wrote:
Kind of.

If you like me use a master file with XInclude:s it takes a "trick" to
get Oxygens to resolve all references and then it works
really well. This "trick" has been available for quite some
time/versions - but it is not obvious.

You have to add all includes as files in the validation schema. Then
assign the validation schema to all included modules.

Having done that it will be possible to handle XML includes as expected,
all ref:s in all moduels can be
resolved by auto-completion. Unfortunately the recenet addition
of master file in Oxygen (which I thought would handle this)
does not seem to work this way for plain XML files (at least I didn't
get it to work). It works fine for XSLT stylesheets though.

In regards to the comments about price for Oxygen I would say that it is
very reasonable priced given
its capabilities and  the speed up it will make in the writing of XML
(and XSLT stylesheets). It would be very easy to motivate
its cost in a business setting. Of course, for a hobbyist it would be
harder but I believe Oxygen also has a very cheap
"hobbyist not-for-profit" license that is less than US $100

Just my 2c


On 2012-08-13 19:11, Warren Young wrote:

On 8/12/2012 4:41 PM, Richard Hamilton wrote:
There are a bunch of very good visual editors out there that will
handle DocBook. The one I know best is Oxygen
(http://www.oxygenxml.com/), which works very well with DocBook.
The last time I tried opening one of my DocBook manuals with it (version
9, maybe?) it didn't handle XML Includes gracefully.

I like to have a top-level document that simply includes all the chapter
files, which lets me edit the chapters individually.  This keeps file
sizes reasonable and (much more important) localizes VCS comments to the
relevant section of the document.

As I recall, oXygen sort of kind of attempted to open the top-level
document, but didn't give me the seamless WYSIWYG view I expected: an
editable version of the final PDF output.  If instead I opened an
individual chapter file, it got confused by the cross-references, since
it didn't understand that it was looking at a tree in a forest.

Have they fixed this limitation, or does it still push you toward
putting the entire document in a single file?

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


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]