Re: Re[2]: Contrib structure
Jacob Kjome <[email protected]>
| Newsgroups | gmane.comp.java.enhydra.barracuda.general |
|---|---|
| Message-ID | <[email protected]> |
Hi Diez, I used XDoc as a generic word. It isn't an actual product. I know that the Jakarta and XML Apache projects use some sort of XSLT transformation to do all their docs. I makes them easy to work because they are clean and free of <img src="spacer.gif"> and <font> tags strewn everywhere (among other things). I am with Diez. I don't want to be forced to use an ugly, bloated, markup-mangling too such as MS Frontpage. Any text edtor should do. The look and feel can be entirely defined via the structure we create via the XSLT transformation and CSS stylesheets. In fact, we can get rid of most of the images. If you don't believe me, look at: http://www.visi.com/~hoju/barracuda/barracuda.html That is an extreme example and I'm not saying we should use that layout specifically. The point is, there are only 3 images on the entire page and 2 of them are the w3c standard images. The other isn't even part of the page, but imported in a stylesheet as a background image (the barracuda fish). Everything else is pure markup and CSS. An, btw, try clicking on the radio buttons near the top of the page and see what you think of using alternate stylesheets. Also, look at this in a Mozilla browser and see how cool CSS can actually be. Look at the source. It is super easy to read and modify with any text editor. This is what we should be doing. That way, talk about changing our layout will be a matter of writing up an alternate CSS stylesheet and/or creating an alternate XSLT stylesheet. No more worry about modifying the markup. Jake At 11:46 PM 1/16/2003 +0100, you wrote: >Hi, > > > I would like to keep the docs as HTML, rather than something else. BUT, > I > > would like to revamp the look and feel so that its very clean markup > which > > uses stylesheets. I can still use FrontPage then (it handles > stylesheets), > > and those who prefer text editors can still do docs that way. > >I prefer Jakes propsal - I'm not familiar with XDoc, but have been using >DocBook and wrote a bunch of XLSTs (btw: Theres a great XSLT mode for >emacs >out there..). > >Think of our bold plans to create a book. Even if these haven't gone any >further beyond "would be nice", having the docs in a transformable format >would be a good start for that. > >And you just said "I would like to revamp the look and feel so that its >very >clean markup which uses stylesheets." > >While this is surely the way to go with html, I would prefer to _generate_ >clean html with stylesheets - and the work has to be done, anyway. > >I have to admit that I'm a text-editor-lover - so I don't use tools like >FP >and my last (kind of ignorant) view of them is "these thingies produce a >lot >of unneccessary <font> and <td> tags". Maybe their better now. > >Diez >______________________________________________________________________________ >VCard - noch nie gehort? Dann schaun Sie mal rein bei WEB.DE FreeMail. >http://freemail.web.de/features/?mc=021155 > >_______________________________________________ >Barracuda mailing list >[email protected] >http://barracudamvc.org/lists/listinfo/barracuda