infotexture // Information Architecture & Content Strategy


DITA

DITA Users September Meetup

DITA Users Berlin meetup Join our next DITA Users Berlin meetup on September 27 to learn how HERE Technologies tests and validates DITA docs with their own open-sourced plugins for DITA Open Toolkit.

Read more » – ‘DITA Users September Meetup’
DITA Open Toolkit Docs Process
At this year's DITA Europe conference in Munich, I'll be speaking about how the DITA Open Toolkit project uses DITA features 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. Read more » – ‘DITA Open Toolkit Docs Process’
API docs in DITA and Markdown
Write The Docs I was recently invited to speak in London at the Write The Docs mini-conference on Documenting APIs hosted by the UK’s Government Digital Service, the team behind the GOV.UK website. Read more » – ‘API docs in DITA and Markdown’
DITA Users Berlin meetup

DITA Users Berlin meetup Join our first meetup on using Markdown in DITA workflows to learn how Markdown can help you to simplify the authoring process and gather input from other contributors who are less familiar with DITA.

Read more » – ‘DITA Users Berlin meetup’
Roundtripping DITA–XLIFF Conversions
At the XLIFF Symposium in Berlin this week, I showed how Bryan Schnabel’s DITA-XLIFF Roundtrip plugins for the DITA Open Toolkit can be used to transform XML source files from the Darwin Information Typing Architecture to a single XLIFF file and back. Read more » – ‘Roundtripping DITA–XLIFF Conversions’
Marking Down DITA
There’s been a lot of buzz recently on Markdown & DITA, with the announcement of oXygen’s “DITA Glass” approach for URL-based conversions & Lightweight DITA’s use of Markdown & JSON. These approaches look promising, but another recent development — Jarno Elovirta’s DITA-OT Markdown plugin for the DITA Open Toolkit — allows you to use Markdown in your DITA projects right now without any new tools or processing paradigms. Read more » – ‘Marking Down DITA’
Contributing to the Toolkit via GitHub
Now that the DITA Open Toolkit is hosted on GitHub, it's easier than ever to contribute changes to the DITA-OT source code or the documentation. At DITA-OT Day in Munich, I demonstrated how to fork the docs submodule, create a new branch, change the necessary files and submit a pull request — all from the comfort of your web browser. Read more » – ‘Contributing to the Toolkit via GitHub’
DITA-OT Documentation Repository
At the DITA Europe conference in Munich, the DITA Open Toolkit contributors decided to split the toolkit documentation into a dedicated GitHub repository to make it easier for users to contribute. We hope this step will encourage more people to get involved in the project. Read more » – ‘DITA-OT Documentation Repository’
Using Icon Fonts in DITA Projects
This year at DITA Europe in Munich, I presented several options for integrating icon fonts in DITA projects with markup examples and renderer configurations that show how to include icon glyphs in multiple output formats. Read more » – ‘Using Icon Fonts in DITA Projects’
Best Practices Newsletter Article — Automating DITA Builds
After speaking at DITA Europe 2013 in Munich, I was invited to expand my presentation on “Automating DITA Builds” to an article for the Best Practices Newsletter published by the Center for Information-Development Management. The article served as the basis for my presentation at the Content Management Strategies / DITA North America conference in Seattle. […] Read more » – ‘Best Practices Newsletter Article — Automating DITA Builds’
Automating DITA Builds (Seattle Edition)
After presenting at the DITA Europe 2013 conference in Munich last year, I was invited to give the talk at the Content Management Strategies/DITA North America conference in Seattle. I'll be speaking again later today on “Automating DITA Builds — Lightweight Continuous Integration for Documentation Projects”. Read more » – ‘Automating DITA Builds (Seattle Edition)’
Automating DITA Builds
At the DITA Europe 2012 conference in Frankfurt on Main, many participants expressed interest in integrating software development methodologies with DITA authoring. At the 2013 conference in Munich, I’ll be speaking on “Automating DITA Builds — Lightweight Continuous Integration for Documentation Projects” Read more » – ‘Automating DITA Builds’
DITA-OT: Scaling Images in PDF Output
When generating PDF output via the DITA Open Toolkit, users often stumble over image scaling issues. While smaller graphics are typically rendered without problems, large images may extend beyond the page dimensions, throw errors in the log file or not appear at all. So we need a way to downscale larger images. There are basically […] Read more » – ‘DITA-OT: Scaling Images in PDF Output’
PDF2: Removing Page Numbers from Cross References and Customizing Cover Pages
Dan Ochs of Wrycan Inc. has posted several nice tutorials on customizing the output produced by the DITA Open Toolkit PDF2 Plugin: one covers removing page numbers from cross references, and another explains how to modify PDF2 cover pages to include a company logo. Nice job Dan! Read more » – ‘PDF2: Removing Page Numbers from Cross References and Customizing Cover Pages’
DITA-OT 1.5 Milestone 10
Today Robert Anderson announced the availability of Milestone 10 of the DITA Open Toolkit version 1.5. This test build provides insight into development progress toward the next toolkit release, which is scheduled to support the upcoming DITA 1.2 specification. For details, see the wiki page titled “Plans for DITA Open Toolkit version 1.5.” Among the […] Read more » – ‘DITA-OT 1.5 Milestone 10’
Customizing PDF2 Output
When customizing the output of the Idiom PDF2 plugin for the DITA Open Toolkit to display product-specific headers and footers, or different fonts and logos for different clients, customizations can be stored in separate folders and referenced in the Ant build file using the customization.dir property. To store customizations for Project A and Project B, […] Read more » – ‘Customizing PDF2 Output’
DITA for WordPress
Claude Vedovini has released a set of plugins for the DITA Open Toolkit and WordPress that allow you to publish DITA content to a WordPress site. According to the announcement, the OT plugin can be used to transform a DITA map into a single file, and send the result to the blog via the XML-RPC […] Read more » – ‘DITA for WordPress’
RenderX XEP Setup in oXygen
Recently, a client asked for assistance in setting up the RenderX XEP processor for use with the oXygen XML editor on Mac OS X. XEP is an XSL FO processor that can be integrated with oXygen to transform DITA maps to PDF via the PDF2 transformation scenario. The steps below describe the basic setup, and […] Read more » – ‘RenderX XEP Setup in oXygen’
oXygen 9.2 Improves DITA Support
Syncro Soft has released version 9.2 of its <oXygen/> XML Editor, a cross-platform XML authoring tool. The new version includes a new XML Author mode, which provides a streamlined interface tailored to the needs of writers who need to focus on document content and don’t need immediate access to the Schema Editor, XSLT or DTD […] Read more » – ‘oXygen 9.2 Improves DITA Support’
Sharing DITA-OT in OS X & Boot Camp
How to use a single installation of the DITA Open Toolkit on your Windows partition to generate output from either operating system environment. Read more » – ‘Sharing DITA-OT in OS X & Boot Camp’
DITA-OT 1.4.1 Released
An updated version of the DITA Open Toolkit was released last week with several patches, bugfixes and minor enhancements to provide greater control over the output directory and improve error reporting (see the announcement for the full list). One very useful patch included in this version finally permits styling of the Table of Contents file […] Read more » – ‘DITA-OT 1.4.1 Released’
DITA-OT Plug-in for FrameMaker 8
The FrameMaker 8 Plug-in for DITA Open Toolkit is now available from Adobe. The package restores the Generate Output command that was introduced with the FrameMaker 7.2 Application Pack for DITA and unfortunately missing from the released version of FrameMaker 8. Read more » – ‘DITA-OT Plug-in for FrameMaker 8’
DITA-FMx Plug-in for FrameMaker
Leximation and Silicon Publishing have announced the release of DITA-FMx, a new plugin for Adobe FrameMaker that provides extended DITA support and corrects a number of bugs in the Application Pack for DITA. DITA-FMx is a plugin and set of structure applications that let you create and edit DITA XML files in FrameMaker. The version […] Read more » – ‘DITA-FMx Plug-in for FrameMaker’
DITA Open Toolkit 1.4
Version 1.4 of the DITA Open Toolkit is now available for download from SourceForge, including processing support for the new elements in DITA 1.1 such as bookmaps, index-see and index-see-also entries. The announcement contains the full list of improvements and bug fixes. Read more » – ‘DITA Open Toolkit 1.4’
OASIS Approves DITA 1.1
The DITA Technical Committee at OASIS, the international open standards consortium, has announced the approval of DITA version 1.1 as an OASIS Standard. Version 1.1 of DITA provides enhanced print publishing capabilities with new DITA Bookmap specialization, including extended book metadata. The standard offers more indexing capabilities with new elements for “see” and “see-also” references. […] Read more » – ‘OASIS Approves DITA 1.1’
FrameMaker 8: No DITA-OT Support
The DITA application pack that was previously available from Adobe Labs for use with FrameMaker 7.2 has now been rolled in to FrameMaker 8, enhanced to support Unicode and extended to generate a single compound FrameMaker document from a DITA map file. This latter bit allows you to roll a DITA project into a standalone […] Read more » – ‘FrameMaker 8: No DITA-OT Support’
Adobe Announces FrameMaker 8
Adobe has announced that FrameMaker 8.0 will be available by the end of July. The new features are quite close to the list published earlier and include enhanced XML roundtripping and out-of-the-box DITA support—though it remains to be seen if the DITA features add anything beyond those previously included in the FM 7.2 Application Pack […] Read more » – ‘Adobe Announces FrameMaker 8’