DITA Open Toolkit Docs Process
This presentation shows how the DITA Open Toolkit project uses DITA features, DITA-OT and other open-source tools like Git, Gradle, Jekyll and Travis to build the toolkit documentation included in distribution builds and published on the project website at dita-ot.org.
Learn how the DITA-OT project uses open-source tools and modern development techniques to publish the docs, including:
- Version control & collaboration
- Git for distributed version control
- GitFlow branching strategy _(master, develop, feature, release, hotfix)_
- Collaboration via GitHub _(issues, pull requests, wiki)
- DITA features
- profiling and (branch) filtering _(expert/novice content)_
- keys and key references
- subjectScheme classification for controlling available attributes
- extending topics with conref push
- XML mention domain
- Automatically generating topics from source code with Ant & XSLT
- Continuous integration
- Local testing via Gradle `continuous` builds
- Travis CI builds for each push & pull request
- Building the project website
- Combining source files in DITA & Markdown
- Jekyll static site generator
- Liquid templating
- GitHub Pages for hosting
- Bootstrap for layout & presentation
- Sass for styling
What can attendees expect to learn?
By exploring how the DITA-OT docs are built, participants will see examples of recent DITA features in action, learn more about how the toolkit works, what they need to know to contribute to the project, and consider techniques that may be applicable to their own publishing projects.
Meet the Presenter
Roger is an American-born Information Architect based in Potsdam, Germany. He advises clients on version control and content re-use strategies, XML-based publication processes and authoring environments. He maintains the DITA-OT documentation as a collaborator on the DITA Open Toolkit project.