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

Productivity Pr0n and Self-Revealing Ick

I was looking over some various productivity Pr0n when I came across a nice bit of advice for maintaining focus and productivity: Care . It seems so simple, but for someone who has been going through mild clinical depression, it's really difficult. Oh, yeah, I skipped that part. I've been going through mild clinical depression. No bad thoughts about hurting me or others, no medicine; Just a lot of apathy towards mostly everything. It runs in the family. Thanks, parents. ;P Caught up? Good. Lets continue. So there are some things I do care about. Intensely, as a matter of fact: My family My friends The socio-economic plight of the indigenous tribes of Madagascar. Granted, two of those are pretty far ahead of the third. So, I am trying to figure out what I want to do next, since I'm more or less in a forced reset mode. Self re-invention is an awkward and somewhat overly revealing process. Ever take a long, honest look at yourself without the sugar-coated happy ...
Post a 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