[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [docbook-apps] Docbook toolchain tips
it does the same with xi:include parse=text there is a workaround involving chaining two xi:includes, but it is cumbersome On 5/6/06, Bob Stayton <bobs@sagehill.net> wrote: > One caveat: > If you need to use text entities, then you will have to pass on XXE. If > you open a document that has text entity references with XXE, then it will > replace each entity reference with the entity text. When you save the > file, you no longer have an entity reference, just the replacement text. > It will warn you when you open the document, but there is nothing you can > do about it. Apparently the XML parser they use doen't have an option to > preserve entity references. > > Bob Stayton > Sagehill Enterprises > DocBook Consulting > bobs@sagehill.net > > > ----- Original Message ----- > From: "Denis Bradford" <denis.bradford@verizon.net> > To: "Luciano Scavizzi" <feanorelf@gmail.com> > Cc: <docbook-apps@lists.oasis-open.org> > Sent: Saturday, May 06, 2006 7:42 AM > Subject: Re: [docbook-apps] Docbook toolchain tips > > > > I've been going down a similar road with my company. As in your case, > > I think reuse and single-source were the most compelling arguments, even > > though I'm careful not to oversell these buzzwords. I had less luck with > > some of the other best-practices arguments. > > > > Since you asked about an editor, I suggest you check out XML Mind. It's > > powerful, completely standards-based, does DocBook out of the box, and is > > well-supported. IMHO, it compares favorably with Arbortext Epic > > (which I've used for years). We use it on Linux and Windows. > > > > In fact, as we start to implement it seems to me that people seem to > > appreciate working with a good XML editor, as compared to working with > > DTP tools or HTML editors. Yes, there's a learning curve, and XML Mind is > > not exactly WYSYWIG, but it really does hide the tagging, and validation > > on the fly pretty much eliminates coding errors. > > > > > > Luciano Scavizzi wrote: > >> I am pushing my company to adopt Docbook as a "documentation > >> standard", but, of course, my (questionable) personal charme is not a > >> point good enough to convince my colleagues and our senior > >> management. > >> > >> As speaking of semantics precision and separation of content from > >> format is not that a involving subject, the basic point I am making > >> out is the advantage of single-source documents. > >> > >> On the other hand, I usually write my XML docs with a plain text > >> editor, I do not think many employees of ours are confident with > >> markup languages and would switch happily from MS Word to inputing > >> tagged text in an editor. I wonder if you can suggest some esy-to-use > >> authoring tool (I've already tried Sydoc) for Win32. > >> > >> Furthermore, as a FO formatter, I am realizing FOP, while being more > >> than enough form my personal use, is far from flawless. > >> I have tested XSL Formatter and XEP, and I must say I like very much > >> the former for its speed and its neat output (I also understood it has > >> a very good standard compliance). I have also found on the web many > >> more tools I haven't tested yet, and I could not find any > >> comprehensive fo-support comparison chart, but one at > >> http://www.antennahouse.com/xslfo/comparison-fo.htm. Which of the > >> processors around are worth a try in your opinion? > >> My minimum requirements are good SVG support and a "predictable" > >> behavior (i.e. adhere quite strictly to w3c recommendations). > >> > >> Thanks, > >> Luciano > >> > >> --------------------------------------------------------------------- > >> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org > >> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org > >> > >> > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org > > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org > > > > > > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org > > -- http://chris.chiasson.name/
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]