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
0
votes
1 answer

Run DITA OT in Mac OS?

The DITA OT documentation has quite a bit of information about how to run the DITA OT in a Windows environment, but not much at all about running it in Mac OS. What is the procedure for running it in Mac OS (Mountain Lion)? Especially if you need to…
Anders
  • 12,556
  • 24
  • 104
  • 151
0
votes
2 answers

How can you debug a DITA transformation?

I know XSLT in general can be debugged, but how exactly would one go about debugging a DITA transformation, considering its modular XSLT structure and the fact that stylesheets are pointed to by the catalog.xml file? I want to be able to step…
Anders
  • 12,556
  • 24
  • 104
  • 151
0
votes
2 answers

How to specify navtitle for table of contents in web output but NOT in pdf output?

Given that the table-of-contents area for web output is rather narrow I would like to assume smaller navigation titles for web, but continue to present long topic titles in PDF output. The following markup does not seem to work at all (with or…
Lea Hayes
  • 62,536
  • 16
  • 62
  • 111
0
votes
4 answers

Relationships with DITA

I am trying to create a relationship between a selection of concept documents. So given three documents "A", "B" and "C" I would like them to each display something like the following: A ... Related Concepts B C For some reason the following…
Lea Hayes
  • 62,536
  • 16
  • 62
  • 111
0
votes
1 answer

XSL to crawl list of files and compile a definition list from specific elements

I have a set of files that contain definitions that I want to compile into a single list. The list of files is stored in an XML file that looks like this (this is the input file): Balance_fields_selected.htm
Chad Dybdahl
  • 195
  • 2
  • 2
  • 10
0
votes
1 answer

How to combine DITA topics AND have nested topics in HTML output?

This is similar to a previous question that I asked, with one variation. I would like to know how to merge multiple topics into one (using @chunk) and then have other child topics that can be navigated to in the HTML output: Real-world example:…
Lea Hayes
  • 62,536
  • 16
  • 62
  • 111
0
votes
2 answers

Syntax colouring with Ditac (XML Mind Dita Converter)

Is there a way to perform syntax colouring using Ditac (the DITA converter by XML Mind)? Any XSLT1 or XSLT2 based solution would work provided that it supports both XHTML and XSL:FO output. XSLTHL (http://sourceforge.net/projects/xslthl/) has been…
Lea Hayes
  • 62,536
  • 16
  • 62
  • 111
0
votes
3 answers

Generate DITA files from the file names in an Excel sheet

I work as Information Developer. I need to create .dita files with the file names stored in an excel sheet. The .dita files are XML files. The structure of the files should be same. The structure is as follows:
0
votes
1 answer

document() function -- writing out muliple files with grouped content

I am trying to split apart various HTML documents based on the following rules: For any

, create a new document with a file name based on the contents of the

(with some translation to replace undesired characters) For each li that is a…

Chad Dybdahl
  • 195
  • 2
  • 2
  • 10
-1
votes
2 answers

Can i have the PDF revision history or revision number or value in the DITA PDF output?

I need to provide a way for the customers to know the PDF revision numbers or date. I need to have the revision value or timestamp or anything similar at the footnote of the PDF. I tried adding tags in the bookmeta, but they are not picked during…
Shahul Hameed
  • 181
  • 2
  • 5
  • 16
-1
votes
1 answer

Generate footer page number for each p/@outputclass="kingbreak"

Input Dita file If any topic has p/@outputclass="kingbreak", we want to create footer page number with horizontal, I tried with xsl:number/ but it is picking disorder page number, Please help
Kita Ansari
  • 121
  • 7
-1
votes
1 answer

Need to make bold for attribute values in pdf (dita to pdf)

I want to show the different between attribute value and the corresponding element value. so i just need to make the bold for attribute value in dita to pdf using oxygen. I tried xsl for that but its not working: My Input dita xml file…
-2
votes
1 answer

Inserting a new DITA body element

Looking to transform an XML file to a valid DTD topic. To do this I need to insert a body element as shown. My Title ==> Intro text goes here.
==>
mikey
  • 115
  • 8
1 2 3
21
22