This repository has been archived by the owner. It is now read-only.
Markdown parser and output for DITA-OT
Branch: master
Clone or download
Latest commit 9078866 Oct 8, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Add Gradlew scripts to repo and build section to README Mar 6, 2015
licenses
src Fix plugin configuration and license notices Oct 1, 2017
.gitignore Add missing HTML entity class Sep 28, 2017
LICENSE
NOTICES Fix plugin configuration and license notices Oct 1, 2017
README.md Add deprecation note Oct 8, 2017
build.gradle
gradlew Add Gradlew scripts to repo and build section to README Mar 6, 2015
gradlew.bat Add Gradlew scripts to repo and build section to README Mar 6, 2015
settings.gradle Initial code Feb 6, 2015

README.md

Deprecation Note

This repository has been deprecated and all further development has been moved to https://github.com/jelovirt/com.elovirta.lwdita.


Lightweight DITA for DITA-OT

DITA-OT LwDITA plug-in contains

  • a custom parser for Markdown and HTML to allow using MDITA and HDITA as a source document format,
  • and a transtype to generate Markdown from DITA source.

The Markdown DITA files need to use a subset of Markdown constructs for compatibility with DITA content models.

Usage

Using LwDITA files as input

Markdown DITA or HTML DITA topics can only be used by linking to them in map files.

<map>
  <topicref href="test.md" format="mdita"/>
  <topicref href="test.html" format="hdita"/>
</map>

The format attribute value must be set to mdita or hdita in order to recognize files as Markdown DITA or HTML DITA, respectively; the file extension is not used to recognize format.

See Syntax reference for XML and Markdown DITA correspondence.

Generating Markdown output

The DITA-OT LwDITA plug-in extends the DITA Open Toolkit with additional output formats (transformation types) that can be used to publish DITA content as Markdown.

  • To publish Markdown DITA files, use the markdown transtype.

  • To generate GitHub Flavored Markdown files, use the markdown_github transtype.

  • To publish GitHub Flavored Markdown and generate a SUMMARY.md table of contents file for publication via GitBook, use the markdown_gitbook transtype.

Requirements

DITA-OT 2.2 is required. Earlier versions of DITA-OT do not have the required extension points.

Install

  1. Run the plug-in installation command:

    dita -install https://github.com/jelovirt/dita-ot-markdown/releases/download/1.3.0/com.elovirta.dita.markdown_1.3.0.zip
    

The dita command line tool requires no additional configuration; running DITA-OT using Ant requires adding plug-in contributed JAR files to CLASSPATH with e.g. -lib plugins/com.elovirta.dita.markdown.

Build

To build the DITA-OT Markdown plug-in from source:

  1. Install the DITA-OT distribution JAR file dependencies by running gradle install from your clone of the DITA-OT repository. The required dependencies are installed to a local Maven repository in your home directory under .m2/repository/org/dita-ot/dost/.

  2. Run the Gradle distribution task to generate the plug-in distribution package:

    ./gradlew dist
    

    The distribution ZIP file is generated under build/distributions.

Donating

Support this project and others by @jelovirt via Paypal.

License

DITA-OT LwDITA is licensed for use under the Apache License 2.0.