As a result of our initial output processing implementation effort, we've realized
that we should be requiring the <shortdesc>
element to act as the
required first paragraph of a potentially longer answer. We will also disallow
the <abstract>
element as it's not really relevant to what we're trying to do.
This change also requires us to rethink our element type names. If the short description is going to act as the first paragraph of the answer, then "shortdesc" is probably not the best name. By the same token, the name "faq-answer" is probably not the best name for the topic body. Better names are probably "faq-short-answer" for the short description and "faq-answer-details" for the topic body.
<faq-question id="question-id"> <faq-question-statement>Can I add attributes to specific element types?</faq-question-statement> <faq-short-answer>No, you can only define global attributes, specialized either from @base or @props.</faq-short-answer> <faq-answer-details> <p>As of DITA 1.1, there is no mechanism for defining new attributes for specific element types. The problem is that there is no DITA-defined syntax for declaring a given attribute as being an attribute that should be recognized as such by a DITA-aware processor and not just some random attribute that was allowed in error (as the DITA architecture otherwise does not allow non-DITA-defined attributes.</p> <p>Providing this ability is a booked feature request for DITA.</p> </faq-answer-details> </faq-question>
Verify that the document is no longer valid.
<faq-question>
as follows: <!ENTITY % faq-question.content " ((%faq-question-statement;), (%titlealts;)?, (%faq-short-answer;), (%prolog;)?, (%faq-answer-details;)?, (%related-links;)?, (%faq-question-info-types;)* ) ">
%faq-answer;
parameter entity and change it's name and value to "faq-answer-details"<faq-answer-details>
.<faq-answer>
and change the element type name to "faq-answer-details".<!-- LONG NAME: FAQ answer details --> <!ENTITY % faq-answer-details.content " ((%body.cnt;)*, (%section;|%example;)* ) "> <!ENTITY % faq-answer-details.attributes ' %id-atts; %localization-atts; outputclass CDATA #IMPLIED '> <!ELEMENT faq-answer-details %faq-answer-details.content; > <!ATTLIST faq-answer-details %faq-answer-details.attributes; >
<shortdesc>
. Copy it and paste it after the element type and attribute declaration for <faq-question>
. (I like to list element type declarations more or less in the order they occur in the document's structural hierarchy.)<!-- LONG NAME: FAQ short answer --> <!ENTITY % faq-short-answer.content " (%title.cnt;)* "> <!ENTITY % faq-short-answer.attributes ' %univ-atts; outputclass CDATA #IMPLIED '> <!ELEMENT faq-short-answer %faq-short-answer.content; > <!ATTLIST faq-short-answer %faq-short-answer.attributes; >
@class
attribute declarations at the end of the .mod file and edit them as follows: <faq-answer>
, change both occurrences of "faq-answer" to "faq-answer-details".<faq-answer-details>
and change "faq-answer-details" to "faq-short-answer".@class
attribute declaration for what is now <faq-short-answer>
, change "topic/body" to "topic/shortdesc". Change " concept/conbody " to "concept/shortdesc" (all the levels of the specialization hierarchy must be accounted for in the @class
attributes even if the element type name is not changed). <!ATTLIST faq-question %global-atts; class CDATA "- topic/topic concept/concept faq-question/faq-question "> <!ATTLIST faq-short-answer %global-atts; class CDATA "- topic/shortdesc concept/shortdesc faq-question/faq-short-answer "> <!ATTLIST faq-answer-details %global-atts; class CDATA "- topic/body concept/conbody faq-question/faq-answer-details "> <!ATTLIST question-statement %global-atts; class CDATA "- topic/title concept/title faq-question/faq-question-statement ">
Redeploy the faq-question Toolkit plugin and try validating the updated test document. It should validate.