[DOC] TC4 xdocs

["Rob S." <rs...@home.com>]

Anakia is cool! =)  I spent this morning getting familiar with it.  The VTL
looks kind of PERLish, but the sample vsl's I was looking at seem pretty
cool, not too complicated.  There isn't a vsl for the entire set of TC4
docs.  We could always adopt the jakarta-site2 one, but I'd personally
prefer if it looked a little cooler =p

- r

Re: [DOC] TC4 xdocs (tangent)

["Craig R. McClanahan" <cr...@apache.org>]

On Fri, 27 Jul 2001, Christopher Cain wrote:

> 
> Christopher Cain wrote:
> > 
> > [snip]
> > ... someone should really fix the Catalina Configuration  page so that
> > either the background is not black or the links are white or something.
> 
> I'll even tell you the fix.
> 
> categories.html: bgcolor="sky blue" --> bgcolor="skyblue"
> 
> ;-)
> 

Just applied this patch ... will show up in tonight's nightly.

Craig

Re: [DOC] TC4 xdocs (tangent)

[Christopher Cain <cc...@mhsoftware.com>]

Christopher Cain wrote:
> 
> [snip]
> ... someone should really fix the Catalina Configuration  page so that
> either the background is not black or the links are white or something.

I'll even tell you the fix.

categories.html: bgcolor="sky blue" --> bgcolor="skyblue"

;-)

Re: [DOC] TC4 xdocs (tangent)

["Craig R. McClanahan" <cr...@apache.org>]

On Fri, 27 Jul 2001, Christopher Cain wrote:

> Since there is an active discussion about the Tomcat site itself,
> implying that someone may be about to do a little work on it,

That's a correct supposition.  I'm planning on spending quite a bit of
time working on the developer docs (while others have volunteered to focus
on the user stuff).  To that end, I wanted to use Ant's <style> tag with a
global XSLT stylesheet that can be shared across projects (and is now
checked in to jakarta-site2).

> I have a
> simple suggestion. It would be a nice convenience if there were a new
> section on the download page, maybe under a separate one of those
> grayish-blue heading bars (entitled "Software Prerequisites" or
> something), with a list of links to all of the various external packages
> that Tomcat requires ... maybe with subsections of "Common" for packages
> required by both 3.x and 4.0, "Additional for 3.x", "Additional for
> 4.x", and "Optional" for packages required by the optional components of
> the either/both containers.
> 

That's a good idea.  I'm just about to check in some updates to the
instructions for building Tomcat 4 from sources (including all the
dependencies).  I'll make sure it ends up on the web site as well
(eventually).

Craig

Re: [DOC] TC4 xdocs (tangent)

[Christopher Cain <cc...@mhsoftware.com>]

Since there is an active discussion about the Tomcat site itself,
implying that someone may be about to do a little work on it, I have a
simple suggestion. It would be a nice convenience if there were a new
section on the download page, maybe under a separate one of those
grayish-blue heading bars (entitled "Software Prerequisites" or
something), with a list of links to all of the various external packages
that Tomcat requires ... maybe with subsections of "Common" for packages
required by both 3.x and 4.0, "Additional for 3.x", "Additional for
4.x", and "Optional" for packages required by the optional components of
the either/both containers.

It's all in the README files, of course, but it would be incredibly
convenient if I could just start slamming downloads from a list of links
on a single page. I know this because I just installed 4.0 on a machine
for the first time (which me luck, I have almost no experience in the
4.0 branch :-), and I had to keep flipping back and forth between the
README and my browser to grab the ~8 additional packages that I needed.
I've had much worse inconveniences in my life, to be sure, but it would
be a fairly simple add to the site. Just a thought ...

Regards,

Christopher

P.S.  You probably already know this (I think I saw a thread on it last
week maybe), but someone should really fix the Catalina Configuration
page so that either the background is not black or the links are white
or something. It took me a minute or two to figure out that it actually
contained information. If it is awaiting an
Anakia/XSLT/DocBook/HTML/XML/Doxygen/God-Knows-What overhaul, in the
meantime someone should at least fix it so that the links show up ... on
the Jakarta site at the very least, if not in the distro CVS. I almost
just assumed that the doc hadn't been written yet before I checked the
page source on a whim. (Granted I have little knowledge of the 4.0 docs
at this point, but neither do first-time users.)

Re: [DOC] TC4 xdocs

["Craig R. McClanahan" <cr...@apache.org>]

On Fri, 27 Jul 2001, Craig R. McClanahan wrote:

> [snip] 
> Also, I'm about 95% done with an XSLT stylesheet that behaves equivalent
> to the current site.vsl macros ...

I just checked this stylesheet in (xdocs/stylesheets/site.xsl) into the
"jakarta-site2" repository, and modified the build.xml file there to
include an example of using it.  The "relative paths" conundrum is solved
by transforming each directory level independently, rather than in a
single recursive descent.

Craig

RE: [DOC] TC4 xdocs

["Rob S." <rs...@home.com>]

> the same look and feel.  Additions to the overall stylesheet are welcomed,
> and can be discussed on the GENERAL@ mailing list (since they would affect
> all projects that use this).

As well, for the sake of time I should *probably* be spending it on actual
documentation rather than dicussing fonts and colours on the -general list
=)

> Also, I'm about 95% done with an XSLT stylesheet that behaves equivalent
> to the current site.vsl macros -- for those of us (like me) who prefer to

Either way works for me.  I used to hax0r quite a bit of XSL and it was a
pain to get the hang of.  Then there's VTL... either way, the doc authors
shouldn't have to worry about it and can just stick to the xhtml-ish
examples in there, right?  Should we agree on a set of standard tags (e.g.
the ones Alex suggested) so we can keep/start working?

- r

Re: [DOC] TC4 xdocs

["Craig R. McClanahan" <cr...@apache.org>]

On Fri, 27 Jul 2001, Rob S. wrote:

> Anakia is cool! =)  I spent this morning getting familiar with it.  The VTL
> looks kind of PERLish, but the sample vsl's I was looking at seem pretty
> cool, not too complicated.  There isn't a vsl for the entire set of TC4
> docs.  We could always adopt the jakarta-site2 one, but I'd personally
> prefer if it looked a little cooler =p
> 

If we're going to use Anakia, we should share the same stylesheet (which
is also used in several other Jakarta projets) so that the docs all have
the same look and feel.  Additions to the overall stylesheet are welcomed,
and can be discussed on the GENERAL@ mailing list (since they would affect
all projects that use this).

Also, I'm about 95% done with an XSLT stylesheet that behaves equivalent
to the current site.vsl macros -- for those of us (like me) who prefer to
use standard technologies (yes, Jon, the "s" word again :-).  This XSLT
stylesheet runs against the same XML files, and produces essentially
equivalent HTML.  It's executed using the Ant <style> tag (requires
Xerces+Xalan, or the JAXP/1.1 release that also includes Xalan).  I'll be
checking this in to jakarat-site2 shortly.

The only remaining issue I've got is the way that "site.vsl" uses the
"$relativePath" variable without defining it anywhere, in creating
relative URL references.  According to Geir there's nothing in Velocity
itself that predefines this, so it must be something magic Anakia is
doing.

The need for this thing is also questionable (it's an artifact of the way
that Jon wanted to create a multi-directory-level document set with one
stylesheet, and still having the navigation menu generarted correctly,
instead of dealing with each directory level individually).  But that can
be dealt with in a separate conversation.

> - r
> 

Craig McClanahan