OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Fwd: [dita-comment] RE: noting a few limitations in my FrameMaker-to-DITA migration effort


Latest e-mail from dita-comment. Thoughts about a response?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



-------- Forwarded Message --------
Subject: [dita-comment] RE: noting a few limitations in my FrameMaker-to-DITA migration effort
Date: Tue, 30 Apr 2019 19:24:43 +0000
From: Chris Papademetrious <Christopher.Papademetrious@synopsys.com>
To: 'dita-comment@lists.oasis-open.org' <dita-comment@lists.oasis-open.org>


As a follow-up to my 12/7/2018 post, it *would* actually be nice to have the <bookmap> content model expanded to allow <part> elements within large <appendix> sets. I officially change my position on that from “no action requested” to “I want it”.  :)

 

Adding the following:

 

*****

Item 3: Please allow <example> elements within <section> elements.

 

I am specializing the <section> element to represent a particular structure within a topic (such as short description, syntax, arguments, return results, and examples). For example,

 

<topic id=”foo”>

  <title>My Topic Title</title>

  <body>

    <description-section>

    </description-section>

    <syntax-section>

    </syntax-section>

    <arguments-section>

    </arguments-section>

   <example-section>

     <example>

       <title>Single-Phase Example</title>

       ...figures, tables, or other content...

     </example>

     <example>

       <title>Multi-Phase Example</title>

       ...figures, tables, or other content...

     </example>

    </example-section>

    <license-section>

    </license-section>

  </body>

  <related-links>...</related-links>

</topic>

 

However, the <section> element doesn’t allow <example> within it, which blocks me from using a proper structure for the examples section. Using nested <topic>s instead of <section>s isn’t an option because then the <related-links> must be first in the topic, then the nested-and-specialized topics which actually contain the information.

 

For specialization purposes, please allow <example> in <section>!

 

-----
Chris Papademetrious

Tech Writer, Implementation Group

(610) 628-9718 home office

(570) 460-6078 cell

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]