Draft of DocBook+ITS section

Hi all,

please find attached the first draft of my DocBook section for BP. This
is just very plain HTML rendering for your review. I will send xmlspec
XML sources off-list to editors after I will incorporate your feedback.

I modeled structure (and sometimes also wording, I hope it is OK) mainly
after existing HTML and TEI sections.

During the preparation of this text one question raised my attention. In
DITA section there is the following note:

Note: When you have the choice of using a DITA construct or a ITS
construct to express the same thing, make sure to use the DITA construct
to ensure DITA processors work properly. Use ITS local markup only if
DITA does not provide an equivalent.

My question is -- should the schemas provided in BP include ITS local
markup which have equivalents in the host language?

For example my current DocBook+ITS schema allows both

<para dir="rtl">...</para>

and

<para its:dir="rtl">...</para>

Wouldn't it be better to not add its:dir in this case into DocBook as
DocBook already has support for this ITS category? (The same applies to
many other existing schemas, including HTML.) This way authors will not
be confused which markup to use.

			Jirka

-- 
------------------------------------------------------------------
  Jirka Kosek      e-mail: jirka@kosek.cz      http://xmlguru.cz
------------------------------------------------------------------
       Professional XML consulting and training services
  DocBook customization, custom XSLT/XSL-FO document processing
------------------------------------------------------------------
 OASIS DocBook TC member, W3C Invited Expert, ISO/JTC1/SC34 member
------------------------------------------------------------------
 Want to speak at XML Prague 2007 => http://xmlprague.cz/cfp.html

Received on Tuesday, 1 May 2007 20:22:40 UTC