On Thu, 2002-03-21 at 21:13, [EMAIL PROTECTED] wrote: > "Andrew C. Oliver" <[EMAIL PROTECTED]> wrote on 22/03/2002 12:13:01 PM: > > > On Thu, 2002-03-21 at 20:10, [EMAIL PROTECTED] wrote: > > > I downloaded Krysalis and Centipede, hoping to find some easy way of > > > building docs, but I was sorely disappointed. You have to know a ton > of > > > stuff about Cocoon, Cocoon's 'book' format (which isn't DocBook), and > the > > > other tools involved to even get your head around it. > > > > > > > Umm... no not really. I just set it up today for work with no prob. > > you just have to have a "book" file in there and change all <a>'s to > > <links> and thats pretty much it. > > Huh? You have to have a book file? What's a book file? What's allowed in > it? >
http://cvs.apache.org/viewcvs/~checkout~/jakarta-poi/src/documentation/xdocs/book.xml?rev=1.9&content-type=text/plain The left nav bar basically. I believe there is an example included. > > > > > If you have to setup and run Cocoon to generate a few HTML files, > what's > > > the point? At least the process with site.vsl and site.xsl is > documented > > > and easy to set up, and requires no special knowledge, for most > commons > > > projects. > > > > > > > Centipede is a bit more than just a fancy way of doing sites. It is a > > project starter template with some pretty nice stuff for separating out > > ant targets and the such. I like it. > > You mean using entities to include files as the targets? That just made it > harder for me to work out what was going on with the existing stuff. > > As a template, it's way lacking on how to use it. For me it was like, > here's a sample project, feel free to hack it. 'Hack' == 'time'. I was > hoping for something with more detail on how to use it. > Perhaps you could contribute to the documentation. Personally, I didn't have such problems. (And I don't even mess with it on POI) > > > If it's just for L&F, I'd much rather tweak the existing stylesheets. > > > > I'm not sure why you had so much trouble. I barely put any effort in it > > at all today and got a project with complex dependencies and some doco > > out in like 0 time flat. And I don't proclaim to be a Cocoon expert or > > even particularly intelligent. :-) > > I'm not claiming either, either. Especially the intelligent part, and it > is Friday :) > > What did you put in the sitemap? I did nothing to the sitemap > What naming convention did you use for your files? Random mood of what I felt like with .xml as the extension (there are files included) > What directory did you put them in? /src/documentation/xdocs? yes > How did you work out what to put in the index.xml file? One example of what I put in the index.xml file (though I use an older version) was this http://www.trilug.org/~acoliver > Where did you put the project specific images/css/js files? I didn't. Javascript is for losers. > How did you include other files into the final directory structure? images. > How did you change the build file so it didn't generate all the Krysalis > stuff? > edit project-info.xml change the name. The doc's and stuff well you already found those. > There's no real explanation/docs on what to do with the directories/files > provided. > Perhaps you should contribute to the project. > Anyway most of this doesn't belong here, but it gives you an idea of the > sort questions that a 'user' might raise. You're preaching to the documentation choir. However build matters do not particularly interest me. I'm most interested in reducing object counts in low level file format ports ( http://developer.java.sun.com/developer/bugParade/bugs/4487555.html ) without sacrificing usability, improving the documentation to Cocoon, and adding application extensions to Lucene. Your message to me suggests that you think I care whether you use centipede or not. You are mistaken. It works for me. If it works for you, cool. If not, use whatever. Be free. <singingChorusEnd title="Born Free"/> -Andy > -- > dIon Gillard, Multitask Consulting > Work: http://www.multitask.com.au > Developers: http://www.multitask.com.au/developers -- http://www.superlinksoftware.com http://jakarta.apache.org/poi - port of Excel/Word/OLE 2 Compound Document format to java http://developer.java.sun.com/developer/bugParade/bugs/4487555.html - fix java generics! The avalanche has already started. It is too late for the pebbles to vote. -Ambassador Kosh -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
