Lightweight DITA SC

  • 1.  Outline (rough, very) of LwDITA spec

    Posted 07-25-2016 19:08
    Dear all, Attached is the very rough outline of the DITA spec in Markdown format. Michael gave me some feedback and I added sections based on that and his pre/overview presentation. Please send comments and throw tomatoes as needed. Thanks a lot, Carlos - --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201 % LwDITA ## LwDITA intro ## Rationale ## Attributes/capabilities ## Three models for content creation ### XDITA intro ### HDITA intro ### MDITA intro ## Elements ### topic #### title #### shortdesc #### prolog #### body ### Block elements - p - pre - ul - ol - li - dl - dlentry - dt - dd - simpletable - sthead - strow - stentry - fig - title - image - alt - audio - fallback - controls - source - track - video - fallback - controls - poster - source - track - section ### Inline elements - data - xref - ph - image ## Minimal collection model - Map ## Minimal specialization model - Template based specialization - Structural specialization annotations - Attribute and domain specialization annotations


  • 2.  Re: [dita-lightweight-dita] Outline (rough, very) of LwDITA spec

    Posted 09-18-2016 20:06
      |   view attached
    Hi, Carlos. Belated response, but ... I'd start by separating the element topics and the rationale/tutorial/architectural overview topics. Not because I think that is how the final spec should be authored, but because: We have existing element reference topics in the full spec, and we need to align full spec and LWDITA spec. The elements must have the same semantic meaning, whether they are used in full DITA or LWDITA. The proposed elements for LWDITA that do not exist in full DITA should be proposed for DITA 2.0. Thinking how to best group the elements proposed for LWDITA might help the DITA TC consider how to reformulate the full spec for DITA 2.0. Separating the content leaves us with the following: Rationale/tutorial/architectural overview topics ## LwDITA intro ## Rationale ## Attributes/capabilities ## Three models for content creation ### XDITA intro ### HDITA intro ### MDITA intro ## Minimal specialization model - Template based specialization - Structural specialization annotations - Attribute and domain specialization annotations Elements Grouping the elements is always difficult. We struggled with this for DITA 1.2. Some groupings are obvious, but others are not. I built a spreadsheet (attached) and listed the grouping from your list, the DITA 1.3 spec, and my own (not-so-great) attempt at grouping: Audio and video elements Basic content elements  (p, ph, pre, xref) Definition list elements Image elements (alt, fig, image) Metadata elements (data and prolog) Ordered and unordered lists Structural elements (map, section, shortdesc, title, topic) Table elements The basic principle is that an element can only appear in one place. I'd like to see the same short descriptions for full and LWDITA, also examples if possible. I've uploaded CHM and PDF made from existing (full DITA) language ref topics to Kavi: https://www.oasis-open.org/committees/document.php?document_id=58913&wg_abbrev=dita-lightweight-dita Best, Kris . Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 7/25/2016 3:07 PM, Carlos Evia wrote: Dear all, Attached is the very rough outline of the DITA spec in Markdown format. Michael gave me some feedback and I added sections based on that and his pre/overview presentation. Please send comments and throw tomatoes as needed. Thanks a lot, Carlos - --  Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201 Attachment: LWDITA-elements.xlsx Description: Binary data

    Attachment(s)

    xlsx
    LWDITA-elements.xlsx   12 KB 1 version