Komodo and DITA support

Posted by penguy on 2007-03-12 10:50
Forums: Komodo discussion | OS: All / Any

Wanted to find out if anyone in the Komodo(v3.5/4.x) user community is working with the DITA format, and how you're using Komodo to work with DITA docs? Are there any plugins or other tools available for Komodo/DITA yet?

Thanks

Dan

toddw
ActiveState Staff
Mon, 2007-03-12 11:49

DITA, you are refering to Darwin Information Typing Architecture (DITA) correct?

I am quite sure Komodo would support DITA as far as XML file editing goes, which is done in the Komodo the preferences section by adding an XML Catalog to Komodo's known XML languages.

It depends upon what you need/require Komodo to do with DITA. At present Komodo does not provide a WYSISYG editor, so converting your document into something viewable will require a "run command" (running an external program outside of Komodo) to produce this output.

It would help us (the Komodo team) if you could better describe what you are looking for in regards to DITA support.

Thanks,
Todd

penguy | Mon, 2007-03-12 12:01

Hi Todd,

Yes, that's what DITA stands for.

I would recommend that you check out XMETAL AUTHOR v5.0 with DITA support to see how another commercial editor is supporting the DITA format. DITA is a growing doc format that is gaining speed as more and more companies are begining to see it's advantages,etc.

I guess I would need Komodo to provide the topology that DITA uses and that it could generate a DITA-based document.

I've been using Komodo IDE for many years and would like to see this feature be either a part of the IDE, or as a plugin/addon in the future.

Thanks for the quick reply.

Dan

PS> Check out IBM's site about general information on DITA at:

http://www-128.ibm.com/developerworks/xml/library/x-dita1/

troyt
ActiveState Staff
Mon, 2007-03-12 13:14

Dan,

It's fairly easy to enable DITA autocompletion in Komodo.

If you have a local copy of the DITA Open Toolkit, you'll find an XML catalog file called catalog-dita.xml in the base directory.

  1. In Komodo's preferences, select Languages -> XML Catalogs.
  2. In the XML Catalogs panel, click the "Add..." and browse to your copy of catalog-dita.xml
  3. Click "Open".

This should give you standard DITA completion in files with a DITA doctype declaration (e.g. <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" ....)

Though there are no DITA build or validation tools in Komodo, they're fairly simple to set up using Run Commands and Macros. You can also create your own DITA templates based on those in the Open Toolkit.

I looked at XMetaL Author a few months ago and it does have fairly extensive DITA support out of the box. However, putting together a Komodo toolbox with DITA templates, macros, and run commands to tie in to the Apache Ant build system would be fairly easy to do in Komodo. This would be a great idea for the Komodo Extensibility Challenge. I'm not allowed to enter, but you could. ;)

penguy | Mon, 2007-03-12 13:34

Great! Got the Toolkit. Thanks.

Dan

troyt
ActiveState Staff
Tue, 2007-07-31 14:44

I've created a macro that uses xmllint to validate XML documents in Komodo.

http://community.activestate.com/forum-topic/macro-to-validate-xml-fil

troyt
ActiveState Staff
Mon, 2008-03-24 11:54

Just a note about using RelaxNG schemas: Komodo currently only supports XML syntax (.rng files), not Compact Syntax (.rnc files).

If you have a compact syntax file, you may be able to convert it using David Mertz's rnc2rng tool, available here:

http://gnosis.cx/download/relax/

k.lodner | Fri, 2008-04-18 15:12

@troyt | Mon, 2007-03-12 13:14

So in fact I need to create a blank XML document with the < ! DOCTYPE task PUBLIC " - / / OASIS / / DTD DITA Task / / EN" header to get Dita auto-completion working? Thats not quite handy. The XXE ( http://www.xmlmind.com/xmleditor/ ) provides a New File > Ditamap etc. file dialog to create a new Dita file. Anyway, the Komodo Edit search inside dita files facility its nice to get your dita files filtered to create ditamaps via drag and drop the open dita file tab to XMLmindEditor's ditamap buckets.

Furthermore, I published your Komodo 4.0 Extensibility Challenge request at http://tech.groups.yahoo.com/group/dita-users/message/10258

cheers,

Karl

troyt
ActiveState Staff
Tue, 2008-06-10 10:50

Reposting in this thread in case people are missing it:

I've put up a DITA extension which provides autocompletion on DITA files. It also adds a few templates:

Under "All Languages" and "Common:
- DITA-map
- DITA-Topic

Under Samples|DITA
- DITA-Concept
- DITA-Reference
- DITA-Task