There is no real reason to change the current package name, but you have to admit that e.g. net.sf.dita-ot or org.xml.dita would have been more suitable.

The version scheme I’d prefer to see is what e.g. OSGi uses. That is, major.minor.micro.qualifier. Thus the current DITA-OT version number would be something like 5.2.0.M6. I naturally wouldn’t change version numbering at this release, but instead of making the next release 1.5.3 I would make that 2.0.0. It would have made sense to do it at this stage to coincide with DITA 1.2 support, but it’s too late now. Anyhow, then the releases could reserve the third version number for bug releases (which DITA-OT doesn’t really ever release), and use the milestone version as the fourth part.

• topic.dtd
• concept.dtd
• task.dtd
• reference.dtd
• glossary.dtd
• ditabase.dtd
• map.dtd
• bookmap.dtd

All in ZIP file.

MIME media type name:

application

MIME subtype name:

dita+xml

Required parameters:

None.

Optional parameters:

charset:

This parameter has identical semantics to the charset parameter of the application/xml media type as specified in [RFC3023].

Encoding considerations:

By virtue of DITA content being XML, it has the same considerations when sent as “application/dita+xml” as does XML. See RFC 3023, section 3.2.

Security considerations:

[Something about conref.]

Interoperability considerations:

[Haven't thought about this yet.]

Additional information:

Magic number(s):

There is no single initial octet sequence that is always present in DITA documents.

File extension(s):

DITA documents are most often identified with the extensions “.dita” or “.ditamap”.

Macintosh File Type Code(s):

TEXT

Intended usage:

COMMON

Author/Change controller:

The DITA specification is a work product of the OASIS’ DITA TC. The OASIS has change control over these specifications.

This would allow us to change the definition of the format attribute e.g. in links into being a MIME Media Type, not a file extension.

Update

Three years later a MIME Type was added in DITA 1.2.

Note: There is a new version of the generator at DITA DTD Generator.

Change History

ISO Schematron schema for DITA 1.1 and 1.2 that handles cases that DTDs or XML Schemas cannot control. The current implementation covers for example:

• nesting links inside links or titles
• deprecated attributes and attributes
• attributes not intended for author use.

Download latest version from GitHub. The schema is released under GNU Lesser General Public License.

Usage

The schema comes in two parts,

• dita-1.1.sch
• dita-1.2.sch

for different DITA versions. The schema has three phases:

specificationMandates

constraints in the DITA language specification prose

recommendations

constraints and recommendations in the DITA language specification prose

authoringRecommendations

recommendations for authors

Change History

See GitHub downloads for latest releases.

Note: W3C has dealt with this in W3C Best Practices for XML Internationalization.

A DITA 1.1 domain specialization of ph element. The element naming and content models follows Ruby Annotation and Internationalization Tag Set, with the exception of

• omission of rbspan attribute from rt element.

See DTD files for details.

Download latest version.

Example

<!DOCTYPE i18n_concept
  PUBLIC "-//ELOVIRTA.COM//DTD DITA I18N Concept//EN"
         "i18n_concept.dtd"><i18n_concept id="ruby">
  <title>Ruby test</title>
  <conbody>
    <p>W3C Associate Chairman, <ruby xml:lang="ja">
        <rbc>
          <rb>斎</rb><rb>藤</rb><rb>信</rb><rb>男</rb>
        </rbc>
        <rtc>
          <rt>さい</rt><rt>とう</rt><rt>のぶ</rt><rt>お</rt>
        </rtc>
      </ruby></p>
  </conbody>
</i18n_concept>

Change History