Warning: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"? in /homepages/30/d88601657/htdocs/techright/blog/wp-content/plugins/social-networks-auto-poster-facebook-twitter-g/inc/nxs_functions_engine.php on line 169

Warning: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"? in /homepages/30/d88601657/htdocs/techright/blog/wp-content/plugins/social-networks-auto-poster-facebook-twitter-g/inc/nxs_functions_engine.php on line 176
27 | October | 2013 | Tech-Right Documentation Blog

My Adventures in DITA, part 2

No Comments on My Adventures in DITA, part 2

October 27, 2013 at 11:19 amCategory:Technology | Writing

With the DITA Open Source working at the level I need it, for now, I need to go in and figure out how DITA is structured at a high level.

(I say “for now” because experience has taught me that base configurations never do what you want them to do when you get some experience in the system under examination.)

People will tell you that DITA is just XML, so it’s simple.

<?xml version="1.0" encoding="UTF-8" ?>

<title text="Hi there this is XML!/>

<para>Golly, XML is easy!</para>

That is easy XML. DITA is a wee bit more complex than that, as it is a full-fledged publishing system. Incoporating multiple XML files, multiple transform types, topic maps, other maps, this and that…honestly, I know very little about it, beyond the fact that it’s not easy.

Even if you buy some kind of tool that is supposed to make DITA authoring simple, the fact is that someone in a place using that tool will, from the start, need to understand the possible ways you can build and extend a DITA architecture.

So, as I go through it myself, I will blog my adventures in DITA.