diff --git a/specification/archSpec/base/cascading-of-attributes-from-map-to-map.dita b/specification/archSpec/base/cascading-of-attributes-from-map-to-map.dita index f8b0e628..1019690e 100644 --- a/specification/archSpec/base/cascading-of-attributes-from-map-to-map.dita +++ b/specification/archSpec/base/cascading-of-attributes-from-map-to-map.dita @@ -23,6 +23,7 @@
  • translate
  • processing-role
  • cascade
  • +
  • subjectrefs
  • As with values that cascade within a map, the cascading is additive if the attribute permits multiple values, diff --git a/specification/archSpec/base/cascading-of-roles-in-specialized-maps.dita b/specification/archSpec/base/cascading-of-roles-in-specialized-maps.dita index 1cb88cef..3a3a0b2c 100644 --- a/specification/archSpec/base/cascading-of-roles-in-specialized-maps.dita +++ b/specification/archSpec/base/cascading-of-roles-in-specialized-maps.dita @@ -16,9 +16,9 @@ - -

    We need to look at the instances of "should" in this topic. Can they be recast? Do we need - to introduce RFC-2119 language?

    + +

    Proposal #670, championed by Robert Anderson, will rework this + content.

    The semantic role reflects the class hierarchy of the referencing topicref elementmapref element references a DITA map (giving it the role of "DITA map").

    - The following paragraph includes the - statement: "the non-default behavior should be clearly specified"

    We do not say how or - where. For mapgroup, I believe it is only specified here in this topic. I think either we - need this as part of every mapgroup element definition, in "Processing expectations", or we - need a clear table here listing every element where this behavior does not - apply.

    +

    Unless otherwise instructed, a specialized topicref element that references a map supplies a role for the referenced content. This means that, in effect, the class attribute of the referencing element cascades to top-level topicref diff --git a/specification/archSpec/base/example-a-subject-scheme-map-used-to-define-taxonomic-subjects.dita b/specification/archSpec/base/example-a-subject-scheme-map-used-to-define-taxonomic-subjects.dita new file mode 100644 index 00000000..2eee5866 --- /dev/null +++ b/specification/archSpec/base/example-a-subject-scheme-map-used-to-define-taxonomic-subjects.dita @@ -0,0 +1,71 @@ + + + + Example: A subject scheme map used to define taxonomic + subjects + A subject scheme map can be used to define taxonomic subjects. + Once defined, the subjects can be referenced by applying a + subjectrefs attribute to a + topicref element. + + + + examplessubject scheme + mapsdefining taxonomic + subjects + + + + +

    The following subject scheme map defines a set of subjects that are + used to classify content:

    + <subjectScheme> + <subjectdef keys="content-types"> + <subjectdef keys="conceptual-material"/> + <subjectdef keys="reference"/> + <subjectdef keys="tutorial"/> + </subjectdef> + <subjectdef keys="operating-systems"> + <subjectdef keys="linux"/> + <subjectdef keys="macosx"/> + <subjectdef keys="windows"/> + </subjectdef> + <subjectdef keys="user-tasks"> + <subjectdef keys="administering"/> + <subjectdef keys="developing"/> + <subjectdef keys="installing"/> + <subjectdef keys="troubleshooting"/> + </subjectdef> +</subjectScheme> +

    The keys assigned to the subject definitions can be referenced by + specifying the subjectrefs attribute on topic + references in a navigation map:

    + <map> +<title>User assistance for the Acme Widget</title> +<!-- ... --> +<topicref keyref="install-overview" subjectrefs="installing"> + <topicref keyref="install-linux"/> + <topicref keyref="install-macosx"/> + <topicref keyref="install-windows"/> + <topicref keyref="install-troubleshooting" subjectrefs="troubleshooting"/> +</topicref> +<!-- ... --> +</map> +

    Because the subjectrefs attribute cascades, the + effective value of the above markup is the same as the following + markup:

    + <map> +<title>User assistance for the Acme Widget</title> +<!-- ... --> +<topicref keyref="install-overview" subjectrefs="installing"> + <topicref keyref="install-linux" subjectrefs="installing"/> + <topicref keyref="install-macosx" subjectrefs="installing"/> + <topicref keyref="install-windows" subjectrefs="installing"/> + <topicref keyref="install-troubleshooting" subjectrefs="installing troubleshooting"/> +</topicref> +<!-- ... --> +</map> + + diff --git a/specification/archSpec/base/example-cascade-map-to-map-attributes.dita b/specification/archSpec/base/example-cascade-map-to-map-attributes.dita index 79713a4a..bf29a9d9 100644 --- a/specification/archSpec/base/example-cascade-map-to-map-attributes.dita +++ b/specification/archSpec/base/example-cascade-map-to-map-attributes.dita @@ -15,12 +15,13 @@

    Assume the following references in - test.ditamap:<map> + test.ditamap:<map> <topicref href="a.ditamap" format="ditamap" toc="no"/> - <mapref href="b.ditamap" audience="developer"/> - <mapref href="c.ditamap#branch2" platform="myPlatform"/> + <mapref href="b.ditamap" audience="developer"/> + <mapref href="c.ditamap#branch2" platform="myPlatform"/> + <mapref> href="d.ditamap" subjectrefs="puzzles"/> </map>

    -
    diff --git a/specification/resources/DITA2.0-spec.ditaval b/specification/resources/DITA2.0-spec.ditaval index db796972..0ba0fa79 100644 --- a/specification/resources/DITA2.0-spec.ditaval +++ b/specification/resources/DITA2.0-spec.ditaval @@ -121,5 +121,13 @@ --> + + +