Skip to main content

XML-Director DITA conversion

Project description

xmldirector.dita

DITA conversion support for XML Director

This module packages the

  • DITA Open Toolkit

  • XMLMind DITA Converter

as Python module.

API

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

License

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

Source code

See https://github.com/xml-director/xmldirector.dita

Bugtracker

See https://github.com/xml-director/xmldirector.dita/issues

Author

Andreas Jung/ZOPYX
Hundskapfklinge 33
D-72074 Tuebingen, Germany
www.zopyx.com

Changelog

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.

Source Distribution

xmldirector.dita-0.1.0.zip (30.9 kB view details)

Uploaded Source

File details

Details for the file xmldirector.dita-0.1.0.zip.

File metadata

File hashes

Hashes for xmldirector.dita-0.1.0.zip
Algorithm Hash digest
SHA256 7b008e00ea4dce157108f8e2a34870ff77e3a334f492a9a60c119cc6f2d96181
MD5 71a3f3a588558931761a181522053ce5
BLAKE2b-256 b61ab62bb2ca63bfdf6d1423a488404b759988cce1ab79541baa010585a1ec4e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page