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
8
votes
4 answers

Keyword vs data metadata in DITA?

There are two "generic" types of metadata tags in DITA, the data element and the keyword element. Of course there's also the othermeta, but apparently that's supposed to be deprecated soon, and the name suggests its sort of a last resort anyhow. So…
Anders
  • 12,556
  • 24
  • 104
  • 151
6
votes
6 answers

Open source alternative to DITA Open Toolkit

I'm working on a web app that will need to process DITA documents from persistent storage (likely a JCR). The DITA Open Toolkit is the only DITA implementation I'm aware of, but it requires all of your documents to exist on the filesystem. Ideally,…
acfoltzer
  • 5,588
  • 31
  • 48
5
votes
2 answers

Can you force os.path.isfile() to use case insensitivity when checking a file on a case-sensitive file system?

If I use os.path.isfile("foo.txt") to check a file named Foo.txt, the function returns True on case-insensitive file systems and Windows. However, it returns False on case-sensitive file systems. Is there a way to force case-insensitive checking for…
dwightjl
  • 1,984
  • 2
  • 13
  • 13
4
votes
1 answer

Can a CSS file be used to generate PDF output?

Does DITA-OT support generation of PDF output with CSS customizations? I think it supports PDF generation using Apache FOP. I generate both HTML and PDF output and want to use CSS. Thanks...
4
votes
4 answers

Confluence Storage Format - Anyone played with anchor and anchor-link macro

I am parsing dita xml and I have to generate Confluence Storage Format. I am facing difficulty with Anchor macro, while dita format have xref who behave the same way as html local link title....
Saloparenator
  • 330
  • 1
  • 13
4
votes
0 answers

DITA-OT plugin can't find JAR file function when transtype=PDF

I'm working on a DITA-OT plugin that calls a function from a JAR file. When I generate XHTML, the plugin finds the function. When I generate a PDF, it doesn't. I've read the DITA-OT docs about creating plugins and making JAR files available to…
R. Hall
  • 41
  • 3
4
votes
1 answer

Extensible framework for context-sensitive help in web application

For the web application we are currently working on, we will have to think in advance on how to roll it out to a number of different user groups. From a functional side it is important to have a documentation system in place that can be used to…
Kariem
  • 4,398
  • 3
  • 44
  • 73
4
votes
4 answers

How can I override an HTML "rules" attribute using CSS?

The DITA Open Toolkit automatically inflicts some inline table attributes when one publishes to HTML, including frame="border" and rules="all". I need to override this "rules" attribute using CSS styles for cells, and while I can get the desired…
user349024
  • 41
  • 1
  • 2
4
votes
1 answer

Converting from Sandcastle to DITA usable format

Novice in DITA or XSL. I am faced with a challange of building documentation for API documentation. Currently I am able to product the HTML and CHM help using Sandcastle on a C# Assembly and an XML. I have a requirement to to produce it in DITA. Any…
4
votes
3 answers

Use of prodname metadata in DITA?

What is the intended usage of the metadata elements inside the prodinfo element in the DITA metadata? Each prodinfo (can be multiple) has only one prodname, and then inside you can have component, brand, series, etc. The prodinfo itself seems to be…
Anders
  • 12,556
  • 24
  • 104
  • 151
3
votes
2 answers

How can I make DITA catalog.xml work in VS Code?

I am using VS Code and the "XML Language Support by Red Hat". I am pointing to the catalog file inside the DITA OT directory dita-ot-3.3.3\catalog-dita.xml. My DITA file looks like this:
3
votes
1 answer

Do I need to run DITA Toolkit in a server? Is Apache Ant/FOP require a server to run?

I'm looking into IBM DITA Open source ToolKit for XML document generation. I was wondering the following: - Does DITA Toolkit require a server to be set up to run? - Does Apache Ant and Apache FOP require a Server to be set up? If so then what kind…
sfkhan
  • 63
  • 10
3
votes
1 answer

XSLT Conversion - INNERHTML

I posted a question yesterday with great success, it did not exactly give me what I needed but certainly more than enough to put me on the right path. I ran into another difficulty and was hoping to find similar guidance. I have a document with…
3
votes
1 answer

XSLT Conversion

I need to perform an XML XSLT conversion. I am new to this and have read a lot of tutorials but have come across one that is a bit challenging for me and hoping someone can point me in the right direction. I have two elements, for example:
3
votes
2 answers

Creating MERGED file from ditamap and then filtering it

I'm a newbie in DITA OT and I am trying to get just the merged file from my ditamap and after upply xsl to it, but I dont need any other output. I was thinking that I could use some part of the dita-ot source code that is doing merging or to make…
Angela
  • 35
  • 5
1
2 3
21 22