Questions tagged [dita]

DITA is an XML architecture for documentation. It stands for Darwin Information Typing Architecture. Viewed by some as a competitor to DocBook, it focuses mainly on modular units of documentation, but it also borrows other principles from programming, such as typing and inheritance.

DITA can be used to write documentation in a standard XML-based structure, then publish that documentation into various output formats such as online help or PDF.

The four letters in DITA stand for its four principles:

  • Darwin: inheritance; the ability of a unit of documentation to inherit style and structure from its parent
  • Information: the focus on transmitting knowledge
  • Typing: the principle of describing the structure of a unit of documentation in a way that can be processed by machines
  • Architecture: rather than being a set of tools, DITA is really a specification for a method of constructing documentation

DITA's reference implementation is the DITA Open Toolkit (DITA-OT), originally developed at IBM and released as open source. https://www.dita-ot.org/

It is now an OASIS standard. http://dita.xml.org/

You can use the DITA tag for questions about installing tools such as the DITA Open Toolkit, or related plugins for IDEs or editors, as well as for technical questions about customization of the DITA XSL stylesheets, or writing your own customizations.

328 questions
2
votes
1 answer

Set top level link in Eclipse InfoCenter TOC using DITA-OT

I am using DITA-OT to convert a set of DITA files into an Eclipse Information Center help system. The map in the input .ditamap file has a list of topicrefs. DITA-OT sets the link of the first topic in this list as the link of the top level TOC…
adawxawx
  • 23
  • 2
2
votes
1 answer

Overriding DITA XSLT to move related links

We are using XSLT to implement the Bootstrap CSS framework, creating a two-column HTML layout for our topic pages. We would like to override the existing DITA XSL (currently DITA-OT 1.8.5) to move the “Related Links/Topics” section from the bottom…
ham on wry
  • 71
  • 1
  • 7
2
votes
0 answers

Can I associate Visual Studio Code snippets with specific file types?

I want to create code snippets in Visual Studio Code for DITA, an XML data model. I had originally tried the below in my dita.code-snippets file but dita was not a recognized language. { "template": { "scope": "dita", ... …
nsprenkle
  • 191
  • 11
2
votes
2 answers

Dita to pdf partial two-column output

I'd like to create a pdf base don a dita/xml map where one of the topics is formatted in a newspaper style two-column output. I've found the attribute to use in my layout-masters-attr style sheet:
2
votes
0 answers

Is it possible to create toc.js, frameset.html, frameset-nav.html, graphicMap.xml using xhtml base plugin

Is it possible to create the toc.js, frameset.html, frameset-nav.html, graphicMap.xml files dynamically as like html2 base plugin using custom plugin I have created, plugin creation explained in below link custom plugin created I have created the…
User515
  • 186
  • 12
2
votes
1 answer

Can we copy a particular directory and files in the XHTML plugin in DITA OT 1.8.5?

Here is the code what I have tried, To copy the folders and files from the XHTML plugin - reource folder to the output location created by XHTML DITA-OT transformation. plugin.xml
Carol
  • 39
  • 5
2
votes
2 answers

What does " " mean and how is it used?

I'm working on (my first) DITA project using Oxygen, and invoking FOP to generate PDF output. Trying to figure out what everything along the chain does, where the chain is: document -> element -> class -> class template definition in .xsl ->…
M. Rivera
  • 21
  • 1
2
votes
1 answer

How to Create A "Piecemail" Table From A Conref Table

Good morning! I am attempting to create a large table that I can conref bits and pieces in for smaller subsections, but I'm running into a little trouble. Here's what I'm doing, essentially: Data File: …
2
votes
1 answer

Ant xmlproperty task fails due to validation error

I want to extract an application version from a DITA map file. The ditamap file is valid and looks like this: <ph…</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/ant" class="post-tag grid--cell" title="show questions tagged 'ant'" rel="tag">ant</a> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Sep 22 '16 at 13:13">asked Sep 22 '16 at 13:13</time> <a href="../../users/870060/scribblemacher" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/870060.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="Scribblemacher" /> </a> <div class="s-user-card--info"> <a href="../../users/870060/scribblemacher" class="s-user-card--link">Scribblemacher</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">1,518</li> <li class="s-award-bling s-award-bling__gold" title="1 gold badge">1</li> <li class="s-award-bling s-award-bling__silver" title="16 silver badge">16</li> <li class="s-award-bling s-award-bling__bronze" title="31 bronze badge">31</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-37594229"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status answered-accepted"> <strong>1</strong> answer </div> </div> </div> <div class="summary"> <h3><a href="../../questions/37594229/add-space-before-inline-element-with-schematron" class="question-hyperlink">Add space before inline element with Schematron</a></h3> <div class="excerpt">I'd like to add spaces before some specific XML inline elements with Schematron, e.g. <ph>, but only if there isn't a space. I cannot see the issue of my rule. Could you please help? <sch:pattern id="add-space-before-ph"> <sch:rule…</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> <a href="../../questions/tagged/schematron" class="post-tag grid--cell" title="show questions tagged 'schematron'" rel="tag">schematron</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Jun 02 '16 at 14:06">asked Jun 02 '16 at 14:06</time> <a href="../../users/3604444/stefan-jung" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/3604444.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="Stefan Jung" /> </a> <div class="s-user-card--info"> <a href="../../users/3604444/stefan-jung" class="s-user-card--link">Stefan Jung</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">1,209</li> <li class="s-award-bling s-award-bling__silver" title="11 silver badges">11</li> <li class="s-award-bling s-award-bling__bronze" title="20 bronze badges">20</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-36455059"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status "> <strong>0</strong> answers </div> </div> </div> <div class="summary"> <h3><a href="../../questions/36455059/error-message-with-xref-tag-in-oxygen" class="question-hyperlink">Error Message with xref tag in oXygen</a></h3> <div class="excerpt">I'm using oXygen 17.1 on a Windows to create a DITA doc. I'm getting an error for an external link using xref. Here's my code that isn't working: Go to LINK COPY. The code is within in a command within a step. The error msg is vague (DOTJ012F). Any…</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Apr 06 '16 at 15:04">asked Apr 06 '16 at 15:04</time> <a href="../../users/6167492/s-plant" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/6167492.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="S Plant" /> </a> <div class="s-user-card--info"> <a href="../../users/6167492/s-plant" class="s-user-card--link">S Plant</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">21</li> <li class="s-award-bling s-award-bling__bronze" title="1 bronze badges">1</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-36021122"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status "> <strong>2</strong> answers </div> </div> </div> <div class="summary"> <h3><a href="../../questions/36021122/converting-an-xsl-apply-templates-into-a-string-value-to-use-as-an-if-paramete" class="question-hyperlink">Converting an xsl:apply-templates into a string value to use as an if parameter</a></h3> <div class="excerpt">I have this piece of code, modified from the DITA-OT original distribution: <xsl:template match="*[contains(@class, ' topic/topic ')]" mode="in-this-section-chapter-list"> <fo:block margin-left="6em"> <fo:block> …</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/xslt" class="post-tag grid--cell" title="show questions tagged 'xslt'" rel="tag">xslt</a> <a href="../../questions/tagged/xsl-fo" class="post-tag grid--cell" title="show questions tagged 'xsl-fo'" rel="tag">xsl-fo</a> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> <a href="../../questions/tagged/dita-ot" class="post-tag grid--cell" title="show questions tagged 'dita-ot'" rel="tag">dita-ot</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Mar 15 '16 at 20:07">asked Mar 15 '16 at 20:07</time> <a href="../../users/6068246/jose-cotes" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/6068246.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="Jose Cotes" /> </a> <div class="s-user-card--info"> <a href="../../users/6068246/jose-cotes" class="s-user-card--link">Jose Cotes</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">31</li> <li class="s-award-bling s-award-bling__bronze" title="3 bronze badges">3</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-35769269"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status answered-accepted"> <strong>1</strong> answer </div> </div> </div> <div class="summary"> <h3><a href="../../questions/35769269/reuse-temp-directory-in-dita-ot" class="question-hyperlink">Reuse temp directory in DITA-OT?</a></h3> <div class="excerpt">While using DITA OT 2.2.1, I usually have to generate documents in several different output formats. For example, I have to generate output for the same ditamap in pdf2, htmlhelp, and xhtml formats. Question: Is it possible to reduce the generation…</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> <a href="../../questions/tagged/dita-ot" class="post-tag grid--cell" title="show questions tagged 'dita-ot'" rel="tag">dita-ot</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Mar 03 '16 at 10:18">asked Mar 03 '16 at 10:18</time> <a href="../../users/5788960/miguel-lourenco" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/5788960.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="Miguel Lourenço" /> </a> <div class="s-user-card--info"> <a href="../../users/5788960/miguel-lourenco" class="s-user-card--link">Miguel Lourenço</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">23</li> <li class="s-award-bling s-award-bling__bronze" title="3 bronze badges">3</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-35654728"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status answered-accepted"> <strong>2</strong> answers </div> </div> </div> <div class="summary"> <h3><a href="../../questions/35654728/dita-xml-how-can-i-add-a-link-to-the-table-of-contents" class="question-hyperlink">DITA XML: How can I add a link to the table of contents?</a></h3> <div class="excerpt">How can I add a link inside a DITA topic which directs to the complete document's table of contents? The table is automatically generated and I can't figure out how to attach a key to it. </div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/xml" class="post-tag grid--cell" title="show questions tagged 'xml'" rel="tag">xml</a> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> <a href="../../questions/tagged/tableofcontents" class="post-tag grid--cell" title="show questions tagged 'tableofcontents'" rel="tag">tableofcontents</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Feb 26 '16 at 14:47">asked Feb 26 '16 at 14:47</time> <a href="../../users/4185614/plesos" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/4185614.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="Plesos" /> </a> <div class="s-user-card--info"> <a href="../../users/4185614/plesos" class="s-user-card--link">Plesos</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">75</li> <li class="s-award-bling s-award-bling__bronze" title="5 bronze badges">5</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="mln24"> <div class="question-summary" id="question-summary-35578609"> <div class="statscontainer"> <div class="stats"> <div class="vote"> <div class="votes"> <span class="vote-count-post"><strong>2</strong></span> <div class="viewcount">votes</div> </div> </div> <div class="status answered-accepted"> <strong>2</strong> answers </div> </div> </div> <div class="summary"> <h3><a href="../../questions/35578609/xslt-write-to-same-attribute-from-multiple-template-matches" class="question-hyperlink">XSLT write to same attribute from multiple template matches</a></h3> <div class="excerpt">I have XML that uses a number of custom attributes, but when round-tripping to standard output (DITA in this case), I need to push values from multiple custom attributes into the same single output attribute. These values may come from templates…</div> <div class="grid ai-start jc-space-between fw-wrap"> <div class="grid gs4 fw-wrap tags "> <a href="../../questions/tagged/xml" class="post-tag grid--cell" title="show questions tagged 'xml'" rel="tag">xml</a> <a href="../../questions/tagged/xslt" class="post-tag grid--cell" title="show questions tagged 'xslt'" rel="tag">xslt</a> <a href="../../questions/tagged/xslt-2.0" class="post-tag grid--cell" title="show questions tagged 'xslt-2.0'" rel="tag">xslt-2.0</a> <a href="../../questions/tagged/dita" class="post-tag grid--cell" title="show questions tagged 'dita'" rel="tag">dita</a> </div> <div class="started mt0"> <div class="s-user-card s-user-card"> <time class="s-user-card--time" datetime="asked Feb 23 '16 at 13:15">asked Feb 23 '16 at 13:15</time> <a href="../../users/3976747/4everjang" class="s-avatar s-avatar__32 s-user-card--avatar"> <img class="s-avatar--image" src="../../users/profiles/3976747.webp" data-jdenticon-width="32" data-jdenticon-height="32" data-jdenticon-value="4everJang" /> </a> <div class="s-user-card--info"> <a href="../../users/3976747/4everjang" class="s-user-card--link">4everJang</a> <ul class="s-user-card--awards"> <li class="s-user-card--rep" title="reputation score">321</li> <li class="s-award-bling s-award-bling__silver" title="2 silver badges">2</li> <li class="s-award-bling s-award-bling__bronze" title="12 bronze badges">12</li> </ul> </div> </div> </div> </div> </div> </div> </div> <div class="s-pagination pager fr"> <a class="s-pagination--item" href="../../questions/tagged/dita_page=2" rel="prev" title="Go to page 2">Prev </a> <a class="s-pagination--item" href="../../questions/tagged/dita_page=1" rel="" title="Go to page 1">1</a> <a class="s-pagination--item" href="../../questions/tagged/dita_page=2" rel="" title="Go to page 2">2</a> <div class="s-pagination--item is-selected">3</div> <div class="s-pagination--item s-pagination--item__clear">…</div> <a class="s-pagination--item" href="../../questions/tagged/dita_page=21" rel="" title="Go to page 21">21</a> <a class="s-pagination--item" href="../../questions/tagged/dita_page=22" rel="" title="Go to page 22">22</a> <a class="s-pagination--item" href="../../questions/tagged/dita_page=4" rel="next" title="Go to page 4"> Next</a> </div> </div> </div> </div> </div> <script src="../../static/js/stack-icons.js"></script> <script src="../../static/js/fromnow.js"></script> </body> </html>