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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.