I received the following error when I tried to import the Docbook DTD into Architect. After a bit of research I found some information at http://www.is-thought.co.uk/book/sgml-9.htm#OMITTAG. Do I need to go through and add -0, 0 0, or 0 - to each element?Toavoid doing that, do I need to find the OMITTAG switch and turn it off? If so where.
Dtgen.exe Parser Error:
While parsing file C:\Documents and Settings\All Users\Desktop\HEDocBook\HEDocBook.dtd:
Tag minimization declarations are mandatory when OMITTAG is enabled.
O or - entries must be added to the TITLE element declaration
(err:599 line:37 pos:977)
Compile failed - rc=32
On a more frustrating note. I've been through many of the PTCU courses and they provide lot's of good information about how touse the application but how a lot about how to put it all together to make a document from scratch. Building the document is elusive for me. Granted, I haven't been through every course because I just don't have the time. But I do have to deliver a very small proof of concept by this Friday. I'll upload it so folks can see. I don't want anyone to do the work for me but I do need a shove in the right direction.
I'm uploading two pages. The left (verso - HA! terminology!)page is the technical illustration and the right (recto) page is the parts list. I have to recreate the parts list. I've done that. The template I inherited used tabs to create the table. I don't think that is possible in ArborText so I'm doing it with a table that has split cells to simulate parts that fall under the top assembly. I'll probably fix that with positioning based on context when it comes time to actually create the document. I'll probably alternate white and light gray so users can follow the parts to find what they need.
My problems are the headers and footers. I found the stylesheet references in a book (DocBook XSL, The Complete Guide), I'm just not sure how to implement them. I understand that it is a three-column format for both and I understand that how to configure it to get what I need. The part that is confusing me is thatI cannot finda pageHeader or pageFooter element to insert. And don't even get me started on how to set up a master page. I'll get there eventually.
In replies to my intial post,a couple of people asked me why I didn't choose DITA. When I read through everything for DocBook and DITA, the way that I understood it, DITA is designed to bemore modular than DocBook. We do not have a CMS to use with ArborText, just Windows Explorer and Intralink/Productview to a small extent. In my mind, without a CMS you lose some of the advantage ofmodularizing the information. We will use some entities and file references, just not a lot. This is just my understanding.
I would have prefered to hire a consultant to come in and help with all of these decisions but the perception is that money is tight. It would probably be a better use of my time to work closely and intensely with a consultant for a couple of weeks. I tend to learn some things better when I work with someone more experienced. This is one of them.
Technical Publications Specialist
I've been playing around with importing the DTD to see how that goes when I get frustrated with figuring out the header footer problem. I have taken the stylesheet courses but trying to cram all of this in my head in two weeks is leaving a few holes. Like I said, I have the middle part done, just not the headers and footers.
In Reply to Andy Esslinger:
If you are using SGML instead of XML, the tag minimalization is given in your DTD. The - and o that appears right after the element keyword. The lower case letter "o" (not a zero) stands for "omit end tag". Or, you could just click on "Check Completeness" and it might go ahead and insert all of the end tags for you.
If your parts are in an Excel table (or even a comma separated values) you can copy it and "paste excel" directly into your document IF you use the CALS table model.
I have attached a post from Suzanne Napoleon in March 2001 that includes a DTD and FOSI coding for a parts list if you prefer to generate a table.
If you intend to get results by Friday you are going to have a lot of fun.
Hope this helps. Did any of the "... many of the PCTU courses ..." you've been through include "stylesheet design parts 1 and 2"?
\ / Andy Esslinger LM Aero Tech Order Data
_____-/\-_____ (817) 279-0442 1 Lockheed Blvd, Mail Zone 4285
\_\/_/ (817) 777-3047 Fort Worth, TX 76108