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] 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]