geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jason Dillon <ja...@planet57.com>
Subject Re: Apache Geronimo Knowledge Base (was: Wiki based FAQ)
Date Fri, 23 Jun 2006 04:08:32 GMT
Done.

--jason


On Jun 22, 2006, at 9:01 PM, Prasad Kashyap wrote:

> Cool Jason. I like it. Can we please have to/fro links from the
> http://cwiki.apache.org/geronimo site to the KB.
>
> Thanx
> Prasad
>
> On 6/22/06, Jason Dillon <jason@planet57.com> wrote:
>> Autoexport is up:
>>
>>      http://cwiki.apache.org/GMOxKB/index.html
>>
>> --jason
>>
>>
>> On Jun 22, 2006, at 12:17 PM, Jason Dillon wrote:
>>
>> > Okay, here ya go:
>> >
>> >     http://cwiki.apache.org/confluence/display/GMOxKB
>> >
>> > I did a few things...
>> >
>> > First, I setup a geronimo team label, and labeled all of our spaces
>> > (so from the dashboard you can see all of the G-related spaces
>> > easily).  New spaces for G should also get this label added (have
>> > add it manually after creation).
>> >
>> > Then I added a {font-size} user-macro to help change font sizes.
>> >
>> > I installed the navigation plugin (which gets us {scrollbar}).
>> >
>> > I installed the footnotes plugin, see this for an example: http://
>> > cwiki.apache.org/confluence/display/GMOxKB/CLI
>> >
>> > And I installed the plugin repository client, which makes it easier
>> > to manage plugin versions.  I need to know how to get the Utilities
>> > plugin installed into WEB-INF/lib before I can enable some of the
>> > other plugins, but that can wait.  If you have admin, you can see
>> > the repository client page here:
>> >
>> >     http://cwiki.apache.org/confluence/admin/repository/ 
>> plugins.action
>> >
>> > Just be careful, cause sometimes installing a plugin will hose the
>> > entire Confluence install, or need it to be bounced before it is
>> > usable.
>> >
>> > Who is the point-man for bouncing/installing stuff for this?
>> >
>> >  * * *
>> >
>> > Basically there are 3 major sections (each of which could really be
>> > its own space if needed, when we get more content, but for now will
>> > work):
>> >
>> >  FAQ - yada yada
>> >  Topics - General KB stuff, not really FAQ
>> >  Glossary - Definitions for terms
>> >
>> > The way it works is that each bit of content is its own page.  That
>> > pages parent page is the section it is under.  The name of the page
>> > is the topic title, or FAQ question, or glossary term.
>> >
>> > Each content page has at the top {scrollbar}, so that it is easy to
>> > navigate between all of the pages in the KB.
>> >
>> > Sub-sections are also just pages, but with the {children:all=true}
>> > macro to allow easy navigation to children.  It is important to add
>> > that, cause the default rendering of children pages at the bottom
>> > is disabled.
>> >
>> > The main indexes are dynamic, so you just have to add a page in the
>> > right place and presto it updates.
>> >
>> > Use the {excerpt} macro to provide a bit more detail that will
>> > compliment the page title in the listing.
>> >
>> >  * * *
>> >
>> > Once we get the Utilities plugin installed into WEB-INF/lib, we can
>> > use the Zones plugin to setup dynamic templates for each of these
>> > sections, and then you don't have to worry about the {scrollbar} or
>> > {children} stuff, just add the content and the zone will render per
>> > the zone template.
>> >
>> > I have not yet set this up to auto-export, should probably do that
>> > soon.
>> >
>> >  * * *
>> >
>> > Comments?  Questions?  Yada yada...
>> >
>> > --jason
>> >
>>
>>


Mime
View raw message