diff --git a/doctypes/dtd/base/commonElements.ent b/doctypes/dtd/base/commonElements.ent index 97f5814a..1fa48573 100644 --- a/doctypes/dtd/base/commonElements.ent +++ b/doctypes/dtd/base/commonElements.ent @@ -34,7 +34,6 @@ - diff --git a/doctypes/dtd/base/commonElements.mod b/doctypes/dtd/base/commonElements.mod index 95328389..6e1873c2 100644 --- a/doctypes/dtd/base/commonElements.mod +++ b/doctypes/dtd/base/commonElements.mod @@ -239,16 +239,12 @@ - @@ -265,7 +261,7 @@ %basic.ph.noxref; | %data.elements.incl; | %draft-comment; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup; | %image;" > @@ -274,7 +270,7 @@ %basic.ph.noxref.nocite; | %data.elements.incl; | %draft-comment; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup;" > @@ -340,7 +336,7 @@ %basic.ph; | %data.elements.incl; | %draft-comment; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup;" > @@ -357,14 +353,14 @@ %basic.block; | %basic.ph; | %data.elements.incl; | - %foreign.unknown.incl; | + %foreign; | %txt.incl;" > @@ -380,7 +376,7 @@ "%basic.block.notbnofg; | %data.elements.incl; | %fn; | - %foreign.unknown.incl; | + %foreign; | %include; | %simpletable; | %xref;" @@ -391,13 +387,13 @@ %data.elements.incl; | %draft-comment; | %fn; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup;" > - - - - - - - - diff --git a/doctypes/dtd/base/emphasisDomain.mod b/doctypes/dtd/base/emphasisDomain.mod index ca58c0d2..825a47a6 100644 --- a/doctypes/dtd/base/emphasisDomain.mod +++ b/doctypes/dtd/base/emphasisDomain.mod @@ -43,7 +43,7 @@ %basic.ph; | %data.elements.incl; | %draft-comment; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup;)*" > @@ -126,7 +126,7 @@ "%basic.block; | %data.elements.incl; | %draft-comment; | - %foreign.unknown.incl; | + %foreign; | %required-cleanup;" > @@ -151,7 +151,7 @@ %basic.block; | %basic.ph; | %data.elements.incl; | - %foreign.unknown.incl; | + %foreign; | %txt.incl;" > - - - @@ -573,12 +570,6 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - - - - - -
Predefined content model groups @@ -588,7 +579,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -598,7 +589,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -609,7 +600,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -620,7 +611,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -630,7 +621,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -640,7 +631,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -650,7 +641,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -660,7 +651,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -670,7 +661,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -681,7 +672,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -690,7 +681,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -702,7 +693,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -712,7 +703,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -723,7 +714,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -732,7 +723,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -742,7 +733,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -752,7 +743,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -765,7 +756,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -773,7 +764,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -786,7 +777,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -800,7 +791,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -1098,26 +1089,6 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" -
-
- LONG NAME: Unknown element - - - - - - - - - - - - - - - - -
LONG NAME: Foreign content element @@ -2198,7 +2169,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -2412,7 +2383,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -2671,7 +2642,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -2700,7 +2671,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -2761,7 +2732,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -2860,7 +2831,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - + @@ -3357,11 +3328,6 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Common Elements//EN" - - - - - diff --git a/doctypes/rng/base/emphasisDomain.rng b/doctypes/rng/base/emphasisDomain.rng index 49b8cf7a..a48e837b 100644 --- a/doctypes/rng/base/emphasisDomain.rng +++ b/doctypes/rng/base/emphasisDomain.rng @@ -81,7 +81,7 @@ - + @@ -112,7 +112,7 @@ - + diff --git a/doctypes/rng/base/highlightDomain.rng b/doctypes/rng/base/highlightDomain.rng index 3fd075fc..e01baa85 100644 --- a/doctypes/rng/base/highlightDomain.rng +++ b/doctypes/rng/base/highlightDomain.rng @@ -105,7 +105,7 @@ - + @@ -136,7 +136,7 @@ - + @@ -167,7 +167,7 @@ - + @@ -197,7 +197,7 @@ - + @@ -228,7 +228,7 @@ - + @@ -259,7 +259,7 @@ - + @@ -290,7 +290,7 @@ - + @@ -321,7 +321,7 @@ - + diff --git a/doctypes/rng/base/mapMod.rng b/doctypes/rng/base/mapMod.rng index 1adee9ca..41402fa2 100644 --- a/doctypes/rng/base/mapMod.rng +++ b/doctypes/rng/base/mapMod.rng @@ -810,7 +810,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Map//EN" - + diff --git a/doctypes/rng/base/metaDeclMod.rng b/doctypes/rng/base/metaDeclMod.rng index 98a6290d..702974a6 100644 --- a/doctypes/rng/base/metaDeclMod.rng +++ b/doctypes/rng/base/metaDeclMod.rng @@ -419,7 +419,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Metadata//EN" - + diff --git a/doctypes/rng/base/topicMod.rng b/doctypes/rng/base/topicMod.rng index 68366f34..a4f1f2af 100644 --- a/doctypes/rng/base/topicMod.rng +++ b/doctypes/rng/base/topicMod.rng @@ -126,7 +126,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + @@ -136,7 +136,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + @@ -147,7 +147,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + @@ -157,7 +157,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + @@ -168,7 +168,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + @@ -461,7 +461,7 @@ PUBLIC "-//OASIS//ELEMENTS DITA 2.0 Topic//EN" - + diff --git a/specification/archSpec/base/adding-an-element-to-the-section-element.dita b/specification/archSpec/base/adding-an-element-to-the-section-element.dita index 0fd38010..e6bee299 100644 --- a/specification/archSpec/base/adding-an-element-to-the-section-element.dita +++ b/specification/archSpec/base/adding-an-element-to-the-section-element.dita @@ -68,9 +68,9 @@ However, the new element is not added to the content model for section.

  • Next, the DITA architect creates an expansion module: - acme-SectionExpansion.mod. This module - adds the sectionDesc element to the - content model of section.<?xml version="1.0" encoding="UTF-8"?> + acme-SectionExpansion.mod. This module adds the + sectionDesc element to the content model of + section.<?xml version="1.0" encoding="UTF-8"?> <!-- Declares the entities referenced in the modified content --> <!-- model. --> @@ -102,7 +102,6 @@ <!ENTITY % state "state"> <!ENTITY % data "data"> <!ENTITY % foreign "foreign"> -<!ENTITY % unknown "unknown"> <!ENTITY % title "title"> <!ENTITY % draft-comment "draft-comment"> <!ENTITY % fn "fn"> @@ -141,7 +140,6 @@ %state; | %data; | %foreign; | - %unknown; | %title; | %draft-comment; | %fn; | @@ -149,15 +147,12 @@ %required-cleanup; | %sectionDesc;)*" > -

    Note that the DITA architect needed to explicitly declare all - the elements, rather than using the - section.cnt parameter - entity that is used in the definition of - section. Because the - element-configuration modules are integrated into the - document-type shell before the base grammar modules, none of - the parameter entities that are used in the base DITA - vocabulary modules are available.

    • +

    Note that the DITA architect needed to explicitly declare all the elements, rather than + using the section.cnt parameter entity that is used + in the definition of section. Because the element-configuration + modules are integrated into the document-type shell before the base grammar modules, + none of the parameter entities that are used in the base DITA vocabulary modules are + available.

  • Finally, the DITA architect integrates the expansion module into the document-type shell:<!-- ============================================================= --> diff --git a/specification/archSpec/base/reconciling-topic-and-map-metadata.dita b/specification/archSpec/base/reconciling-topic-and-map-metadata.dita index 3b4d2652..09ad0766 100644 --- a/specification/archSpec/base/reconciling-topic-and-map-metadata.dita +++ b/specification/archSpec/base/reconciling-topic-and-map-metadata.dita @@ -221,14 +221,6 @@ map No - - unknown - Add to the topic - No, unless specialized for a purpose - that cascades - No stated purpose - No - ux-window diff --git a/specification/archSpec/base/specialization-including-non-dita-content.dita b/specification/archSpec/base/specialization-including-non-dita-content.dita index 9536101f..1d4da410 100644 --- a/specification/archSpec/base/specialization-including-non-dita-content.dita +++ b/specification/archSpec/base/specialization-including-non-dita-content.dita @@ -4,7 +4,7 @@ Specializing to include non-DITA content You can extend DITA to incorporate standard vocabularies for non-textual content, such as MathML and SVG, as markup within DITA documents. This is done by specializing the - foreign or unknown elements. + foreign element. @@ -20,20 +20,17 @@

    There are three methods of incorporating foreign content into DITA.

      -
    • A domain specialization of the foreign or - unknown element. This is the usual implementation.
      • -
    • A structural specialization using the - foreign or - unknown element. This affords more - control over the content model.
      • -
    • Directly embedding the non-DITA content within foreign or - unknown elements. If the non-DITA content has interoperability - or vocabulary naming issues such as those that are addressed by specialization in DITA, - they must be addressed by means that are appropriate to the non-DITA content.
      • +
    • A domain specialization of the foreign element. This is the + usual implementation.
      • +
    • A structural specialization using the foreign element. This + affords more control over the content model.
      • +
    • Directly embedding the non-DITA content within foreign element. + If the non-DITA content has interoperability or vocabulary naming issues such as those + that are addressed by specialization in DITA, they must be addressed by means that are + appropriate to the non-DITA content.
    -

    Do not use foreign or - unknown elements to include textual - content or metadata in DITA +

    Do not use foreign element to include textual content or metadata + in DITA documents.

    diff --git a/specification/archSpec/base/specialization-terminology.dita b/specification/archSpec/base/specialization-terminology.dita index 0874702c..c43dce49 100644 --- a/specification/archSpec/base/specialization-terminology.dita +++ b/specification/archSpec/base/specialization-terminology.dita @@ -44,7 +44,7 @@ - +
    structural type
    A topic type or map type.
    diff --git a/specification/archSpec/base/xsd-coding-element-types.dita b/specification/archSpec/base/xsd-coding-element-types.dita index 0f0cd4ef..b55aa728 100644 --- a/specification/archSpec/base/xsd-coding-element-types.dita +++ b/specification/archSpec/base/xsd-coding-element-types.dita @@ -61,7 +61,7 @@ <xs:group ref="basic.ph.notm"/> <xs:group ref="data.elements.incl"/> <xs:group ref="draft-comment"/> - <xs:group ref="foreign.unknown.incl"/> + <xs:group ref="foreign"/> <xs:group ref="required-cleanup"/> </xs:choice> </xs:sequence> diff --git a/specification/langRef/base/unknown.dita b/specification/langRef/base/unknown.dita deleted file mode 100644 index 18f759f4..00000000 --- a/specification/langRef/base/unknown.dita +++ /dev/null @@ -1,49 +0,0 @@ - - - - -<xmlelement>unknown</xmlelement> -The unknown element is an open - extension that enables information architects to incorporate XML - fragments in DITA topics. - -specialization - elementsunknown - - -
    - Usage information -

    The unknown element is intended primarily - as a base for specialization. It might also be used in - automatically-generated DITA topics or DITA used as a data-exchange - format.

    -
    -
    - Processing expectations -

    Processors ignore the unknown element - unless otherwise instructed.

    -
    -
    - Attributes -

    -

    -Example -

    The following code sample shows a specialized - unknown element that contains non-DITA - content:

    - <body> - <my-unknown class="+ topic/unknown mything/my-unknown "> - <thing value="4"/> - <otherthing value="16"/> - </my-unknown> -</body> - -

    By definition, the content of unknown can - only be understood by DITA processors as unknown XML. This means - that processors generally ignore this content unless they are - configured to recognize the my-unknown - specialization.

     -     -     - diff --git a/specification/langRef/key-definitions-specialization-elements.ditamap b/specification/langRef/key-definitions-specialization-elements.ditamap index 36637333..3be3114c 100644 --- a/specification/langRef/key-definitions-specialization-elements.ditamap +++ b/specification/langRef/key-definitions-specialization-elements.ditamap @@ -6,5 +6,4 @@ - diff --git a/specification/langRef/quick-reference/base-elements-a-to-z.dita b/specification/langRef/quick-reference/base-elements-a-to-z.dita index 72e8f96b..2fce141e 100644 --- a/specification/langRef/quick-reference/base-elements-a-to-z.dita +++ b/specification/langRef/quick-reference/base-elements-a-to-z.dita @@ -161,7 +161,6 @@ - diff --git a/specification/langRef/specialization-elements.ditamap b/specification/langRef/specialization-elements.ditamap index 0878c2a8..718a4591 100644 --- a/specification/langRef/specialization-elements.ditamap +++ b/specification/langRef/specialization-elements.ditamap @@ -7,6 +7,5 @@ - diff --git a/specification/non-normative/elementsMerged.dita b/specification/non-normative/elementsMerged.dita index 855f1c3a..bcf851cb 100644 --- a/specification/non-normative/elementsMerged.dita +++ b/specification/non-normative/elementsMerged.dita @@ -745,13 +745,6 @@ yes - - unknown - - block - no - - video block diff --git a/specification/non-normative/speclimits.dita b/specification/non-normative/speclimits.dita index e3609a7f..bcc38c6b 100644 --- a/specification/non-normative/speclimits.dita +++ b/specification/non-normative/speclimits.dita @@ -32,7 +32,7 @@
  • Providing attributes required by specific processors, such as CMS-defined attributes for maintaining management metadata
  • Embedding tool-imposed markup in places that do not allow the - foreign or unknown elements
    • + foreign element

    Remember that customized document types do not conform to the DITA standard, and thus are not considered DITA. In many of the cases above, it is possible to define document types that @@ -183,15 +183,10 @@

    foreign
    -
    Any content that already has a non-DITA markup standard, but still needs to be +
    Any content that already has a non-DITA markup definition, but still needs to be authored as part of the DITA document. Processors should attempt to render this element, if at all possible.
    - -
    unknown
    -
    Any non-standard markup that does not fit the DITA model, but needs to be managed as - part of a DITA document. Processors should not attempt to render this element.
    -
    bodydiv
    A generic, untitled, nestable container for content within topic bodies