Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

XML-Director DITA conversion

Project description


DITA conversion support for XML Director

This module packages the

  • DITA Open Toolkit
  • XMLMind DITA Converter

as Python module.


The module provides the following API:

result = xmldirector.dita.converter.dita2html(ditamap, output_dir_or_file, converter)
  • ditamap - path to DITA map file

  • output_dir_or_file - output directory (DITA) or output filename (DITAC)

  • converter - name of the converter to be used (dita for DITA OT or ditac for

    XMLMind Dita converter)

    output_filename = xmldirector.dita.html2dita.html2dita(html_filename, infotype, output_filename)

  • html_filename - name of HTML input file

  • output_filename - name of generated DITA file (a temporary file will be generated if omitted)

  • infotype - DITA content type (topic, task, reference, concept)

Commandline usage

You can start a DITA conversion from the commandline:

> bin/dita2html -d some.ditamap -o output_directory -c dita|ditac
  • -d - path to DITA map file
  • -o - name of output directory (for DITA-OT) or the HTML output file (XMLMind DITAC)
  • -c - name of the converter to be used (dita for DITA OT or ditac for
    XMLMind Dita converter)

You can convert a HTML file to DITA through the commandline:

bin/html2dita -h
usage: html2dita [-h] [-i HTML_FILENAME] [-f topic] [-o None]

optional arguments:
  -h, --help            show this help message and exit
  -i HTML_FILENAME, --html-filename HTML_FILENAME
                        Input HTML filename
  -f topic, --infotype topic
                        DITA type (topic, concept, reference, task)
  -o None, --output-filename None
                        Output DITA filename


This package is published under the GNU Public License V2 (GPL 2)


Andreas Jung/ZOPYX
Hundskapfklinge 33
D-72074 Tuebingen, Germany


0.1.0 (2016/06/22)

  • HTML -> DITA conversion using Saxon or LXML

0.0.12 (2016/06/21)

  • tidy HTML document internally

0.0.11 (2016/06/21)

  • added html2dita()

0.0.10 (2016/06/21)

  • updated to DITA OT 2.3.1
  • updated to DITAC 2.6.1

0.0.1 (03/01/2016)

  • initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (30.9 kB) Copy SHA256 hash SHA256 Source None Jun 22, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page