Skip to main content

Hurdle #1

I have the DITA-OT downloaded onto my machine, which contains a version of the DITA schemas and DTDs.  
First, I downloaded DITA OT 1.4.2.1 from sourceforge and selected the file called DITA-OT1.4.2.1_full_easy_install_bin.zip.  I unzipped it to a project home directory on my machine.

Looking in the newly created directory "DITA-OT1.4.2.1", I notice two licences, the Common Public License - v 1.0  and the Apache License - Version 2.0.  Both are pretty permissive, and allow me to do more or less what I want.  I am not redistributing the code, or packaging it in any way, but if I did, I'd have to also include copies of the licences with the source.  Since I'm just using, there doesn't seem to be any conflict with what I want to do.  I do so love free stuff.

The only problem is it doesn't work right away.  

I tried to build the samples, but the DOTA-OT requires a Java Archive (.jar) called tools.jar and complains bitterly because I don't have it.  It takes a little looking, but it's because I have only the Java Runtime Environment (JRE) which allows me to run Java.  I need the Java Development Kit (JDK), which has the complier (javac) and tools.jar.  So I went ahead to Sun and got the Java SE Development Kit 6u11.   I have no idea if this version of Java will work with that version of the DITA-OT, but I'm going to try it and find out.

Well, Java installed fine, but there's still some complaining about the DITA-OT not finding C:\Program Files\Java\jre6\lib\tools.jar.  There is a tools.jar in C:\Program Files\Java\jdk1.6.0_11\lib, where the default install of Java placed it.

So I'll take the brute force approach and just copy it into the first path so that it's in both places.  Feel free to comment to tell me the "correct" way to do this.

I start the demo and type in "ant all -f build_demo.xml",  a bunch of text later, I have a message saying 
BUILD SUCCESSFUL
Total time: 1 minute 36 seconds
Note:  The DITA-OT use Apache Ant for controlling the build, so if you are familiar with that, this message is no suprise.

I now have the demo built, but I'm not building the demo. I want to make my own stuff.  The easiest way to do this would be to replace the demo source with my own stuff and keep building the "demo", but I'm too stubborn for that.  I want to make my own stuff.  So I'll make a "src" directory to hold my stuff and try to make DITA-OT build from there.


Labels:

Comments

Post a Comment

Popular posts from this blog

KISS me, I'm dorky!

Ok, I give up. I've been trying to make the DITA-OT do what I want it to do. It's a really powerful and flexible tool, and I know that somebody really smart could make it do just about anything. Problem is, I'm just not that damn smart, apparently. When it comes down to it, all I really want is Ant, since I'm writing my own stylesheets and only have one output format. Also, I am not likely to need DITA's transclusion mechanisms. So forget the DITA-OT, I'll just use Ant.
Post a Comment
Read more

A Little Princess

I had to take a break from my amazing project  to feed my little girl.  I have four beautiful girls and a wife (also beautiful). Because my wife would kill me if I put anything up on the web that could actually identify "her" children, let me introduce my baby daughter, who I shall call "Albert".  Albert is a cute little button.  She is 57 years old. Well, Albert was hungry, so I had to feed her, since my wife was away.  I figured I'd give her some cereal. First off, that stuff is nasty. I mixed formula with it until it was the correct consistancy ( wet spackling ).  I got her set up in her little seat and started to feed her. Now, my little Albert is a little .... well dopey.  She's a baby and doesn't understand that she can do more than one thing at a time.  For example, it's sort of funny to watch her open her mouth, wait, close her mouth, and then jam her thumb at her face.  The look is classic, trust me. So imagine my suprise when the little pri...
1 comment
Read more

Furry Feet, Cotton Mouth, and a Big Dorky Smile

Through most of my life, I've had some serious misconceptions about depression. I have long believed that depressed people were just irritating weak-willed whiners who needed a kick in the ass and to shake it off. So naturally, I got a nice dose of the irony of life and wound up with depression myself. The more I read about depression, the more I realize how long I've had it without knowing. Actually, a big sign of depression isn't necessarily crying/sadness or a tendency to listen to emo rock at all. It can often be severe detachment and apathy. I know there's probably a lot of people out there saying "Duh!" right now, but that was news to me. Actually, three of the big symptoms are: - Apathy/Detachment - Lack of Motivation/Drive - Forgetfulness All of these, I've had in spades for some time. A lot of the reading says if these last for more than two weeks at a pop, you could be considered clinically depressed. Now that it's been poi...
1 comment
Read more