Skip to content

Commit

Permalink
Merge pull request #172 from robander/dita13
Browse files Browse the repository at this point in the history 
Clean up topics on DITA 1.2 and DITA 1.3
  • Loading branch information
@infotexture
infotexture authored Oct 19, 2017
2 parents 50dc060 + 818fe0c commit a1dcce9
Show file tree
Hide file tree
Showing 3 changed files with 166 additions and 158 deletions.
132 changes: 105 additions & 27 deletions resources/external-links.ditamap
View file
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,13 @@
<linktext>documentation contributions</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-issues"
href="https://github.com/dita-ot/dita-ot/issues?q=label%3A%22DITA+1.3%22" scope="external"
format="html">
<topicmeta>
<linktext>GitHub issues tagged with DITA 1.3</linktext>
</topicmeta>
</keydef>
</topicset>

<topicset
Expand Down Expand Up @@ -211,33 +218,91 @@
<topicset
id="specs"
navtitle="Specs and RFC links">
<keydef
keys="dita-ot-spec"
href="http://docs.oasis-open.org/dita/dita/v1.3/dita-v1.3-part0-overview.html"
scope="external"
format="html">
<topicmeta>
<linktext>DITA 1.3 specification</linktext>
</topicmeta>
</keydef>
<keydef
keys="dita-ot-spec-metadata-cascade"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/cascading-in-a-ditamap.html#cascading-in-a-ditamap"
scope="external"
format="html">
<topicmeta>
<linktext>DITA 1.3 specification: Cascading of metadata attributes in a DITA map</linktext>
</topicmeta>
</keydef>
<keydef
keys="dita-ot-spec-metadata-cascade-example"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/example-how-cascade-att-functions.html"
scope="external"
format="html">
<topicmeta>
<linktext>Example: How the @cascade attribute functions</linktext>
</topicmeta>
</keydef>
<topicset id="dita13spec">
<keydef keys="dita-ot-spec"
href="http://docs.oasis-open.org/dita/dita/v1.3/dita-v1.3-part0-overview.html" scope="external"
format="html">
<topicmeta>
<linktext>DITA 1.3 specification</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-all-inclusive"
href="http://docs.oasis-open.org/dita/dita/v1.3/dita-v1.3-part3-all-inclusive.html" scope="external"
format="html">
<topicmeta>
<linktext>DITA 1.3 Part 3 latest errata version: All-Inclusive Edition (HTML)</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-all-inclusive-pdf"
href="http://docs.oasis-open.org/dita/dita/v1.3/dita-v1.3-part3-all-inclusive.pdf" scope="external"
format="pdf">
<topicmeta>
<linktext>DITA 1.3 Part 3 latest errata version: All-Inclusive Edition (PDF)</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-source"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part3-all-inclusive/dita-v1.3-errata01-os-part3-all-inclusive-complete-dita.zip"
scope="external" format="zip">
<topicmeta>
<linktext>DITA Version 1.3 Errata 01 (Distribution ZIP of the DITA source)</linktext>
</topicmeta>
</keydef>
<keydef keys="dita-ot-spec-metadata-cascade"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/cascading-in-a-ditamap.html#cascading-in-a-ditamap"
scope="external" format="html">
<topicmeta>
<linktext>DITA 1.3 specification: Cascading of metadata attributes in a DITA map</linktext>
</topicmeta>
</keydef>
<keydef keys="dita-ot-spec-metadata-cascade-example"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/example-how-cascade-att-functions.html"
scope="external" format="html">
<topicmeta>
<linktext>Example: How the @cascade attribute functions</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-keyscopes"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/keyScopes.html"
format="html" scope="external">
<topicmeta>
<linktext>DITA 1.3 specification: Scoped keys</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-branch-filter"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/branch-filtering.html"
format="html" scope="external">
<topicmeta>
<linktext>DITA 1.3 specification: Branch filtering</linktext>
</topicmeta>
</keydef>
<keydef keys="dita13-spec-profile-groups"
href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/usage-of-conditional-processing-attributes.html"
format="html" scope="external">
<topicmeta>
<linktext>DITA 1.3 specification: Branch filtering</linktext>
</topicmeta>
</keydef>
</topicset>
<topicset id="dita12">
<keydef keys="dita12-xhtml" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.html"
scope="external" format="html">
<topicmeta>
<linktext>DITA 1.2 Specification (XHTML)</linktext>
</topicmeta>
</keydef>
<keydef keys="dita12-pdf" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.pdf"
scope="external" format="pdf">
<topicmeta>
<linktext>DITA 1.2 Specification (PDF)</linktext>
</topicmeta>
</keydef>
<keydef keys="dita12-source" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.zip"
scope="external" format="zip">
<topicmeta>
<linktext>DITA 1.2 Specification (DITA source)</linktext>
</topicmeta>
</keydef>
</topicset>
<keydef
keys="fo-spec"
scope="external"
Expand Down Expand Up @@ -352,6 +417,19 @@
<topicset
id="websites"
navtitle="Other Websites">
<keydef keys="dita-tc" href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita"
format="html" scope="external">
<topicmeta>
<linktext>OASIS DITA Technical Committee</linktext>
</topicmeta>
</keydef>
<keydef keys="dita-adoption-tc"
href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption" scope="external"
format="html">
<topicmeta>
<linktext>OASIS DITA Adoption Technical Committee</linktext>
</topicmeta>
</keydef>
<keydef
keys="sass-lang"
href="http://sass-lang.com"
Expand Down
66 changes: 21 additions & 45 deletions user-guide/DITA_v1-2-support.dita
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,28 +4,21 @@

<concept id="dita1.2specification" xml:lang="en-US">
<title>DITA 1.2 support</title>
<shortdesc>DITA Open Toolkit <keyword keyref="release"/> supports the DITA 1.2 specification. Initial support for this
specification was added in version 1.5 of the toolkit; versions 1.5.1 and 1.5.2 contain minor modifications to keep
up with the latest drafts. The specification itself was approved at approximately the same time as DITA-OT 1.5.2,
which contained the final versions of the DTD and Schemas. DITA-OT 1.6 updated the DITA 1.2 XSDs to address minor
errata in the standard; the DTDs remain up to date.</shortdesc>
<shortdesc>DITA Open Toolkit <keyword keyref="release"/> supports the DITA 1.2 specification.
While 1.2 is no longer the latest version of DITA, grammar files (DTD and XML Schema), the grammar
files are still included with DITA-OT and content explicitly created for 1.2 continues to work as
intended.</shortdesc>
<conbody>
<p>Earlier versions of the DITA Open Toolkit contained a subset of the specification material, including
descriptions of each DITA element. This material was shipped in source, CHM and PDF format. This was possible in
part because versions 1.0 and 1.1 of the DITA Specification contained two separate specification documents: one
for the architectural specification, and one for the language specification.</p>
<p>In DITA 1.2, each of these has been considerably expanded, and the two have been combined into a single document.
The overall document is much larger, and including the same set of material would double the size of the DITA-OT
package. Rather than include that material in the package, we’ve provided the links below to the latest
specification material.</p>
<p>Highlights of DITA 1.2 support in the toolkit include:<ul>
<li>Processing support for all new elements and attributes</li>
<li>Link redirection and text replacement using keyref</li>
<li>New processing-role attribute in maps to allow references to topics that will not produce output
artifacts</li>
<li>New conref extensions, including the ability to reference a range of elements, to push content into another
topic, and to use keys for resolving a conref attribute.</li>
<li>The ability to filter content with controlled values and taxonomies, using the new Subject Scheme Map</li>
<li>Link redirection and text replacement using <xmlatt>keyref</xmlatt></li>
<li>New <xmlatt>processing-role</xmlatt> attribute in maps to allow references to topics
that will not produce output artifacts</li>
<li>New content reference extensions, including the ability to reference a range of
elements, to push content into another topic, and to use keys for resolving a
<xmlatt>conref</xmlatt> attribute.</li>
<li>The ability to filter content with controlled values and taxonomies using Subject Scheme
Maps</li>
<li>Processing support for both default versions of task (original, limited task, and the general task with
fewer constraints on element order)</li>
<li>Acronym and abbreviation support with the new <xmlelement>abbreviated-form</xmlelement> element</li>
Expand All @@ -34,33 +27,16 @@
toolkit contains only basic processing support for these, but can be extended to produce related artifacts
such as SCORM modules)</li>
</ul></p>
<p>To find detailed information about any of these features, see the specification documents at OASIS. The DITA
Adoption Technical Committee has also produced several papers to describe individual new features. In general, the
white papers are geared more towards DITA users and authors, while the specification is geared more towards tool
implementors, though both may be useful for either audience. The DITA Adoption papers can be found from that TC’s
main web page.</p>
<p>To find detailed information about any of these features, see the specification documents at
OASIS. The DITA Adoption Technical Committee has also produced several papers to describe individual
new features. In general, the white papers are geared more towards DITA users and authors, while the
specification is geared more towards tool implementors, though both may be useful for either
audience. The DITA Adoption papers can be found from that committee's main web page.</p>
</conbody>
<related-links>
<link format="html" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.html" scope="external">
<linktext>DITA 1.2 Specification (XHTML)</linktext>
</link>
<link format="pdf" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.pdf" scope="external">
<linktext>DITA 1.2 Specification (PDF)</linktext>
</link>
<link format="zip" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec.zip" scope="external">
<linktext>DITA 1.2 Specification (zip of the DITA source)</linktext>
</link>
<link format="zip" href="http://docs.oasis-open.org/dita/v1.2/spec/DITA1.2-spec-chm.zip" scope="external">
<linktext>DITA 1.2 Specification (zip of the HTML Help)</linktext>
</link>
<link format="html" href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption" scope="external">
<linktext>DITA Adoption Technical Committee</linktext>
<desc>Contains links to many white papers about using new DITA 1.2 features.</desc>
</link>
<link format="html" href="http://dita.xml.org/wiki/dita-12-specification-building-specification-subsets"
scope="external">
<linktext>Building subsets of the specification</linktext>
<desc>Information about how to build subsets of the specification using the DITA Open Toolkit.</desc>
</link>
<link keyref="dita12-xhtml"/>
<link keyref="dita12-pdf"/>
<link keyref="dita12-source"/>
<link keyref="dita-adoption-tc"/>
</related-links>
</concept>
Loading

0 comments on commit a1dcce9

Please sign in to comment.