Yeah, we currently use docbook.
Though Jody wants to port us to wiki, I leave it to dblasby to decide.
We actually don't do complex xsl params and whatnot. We just make a
navigator page - see documents/navigator.xml in the source download/cvs
-
http://svn.refractions.net/geoserver/trunk/geoserver/documents/navigator.xml
And then we just have an index.html page that points at the navigator
and the other page:
http://svn.refractions.net/geoserver/trunk/geoserver/documents/index.html
And a stylesheet to color it appropriately. I imagine you guys are
probably better at such things than I though.
best regards,
Chris
--
Geoserver people,
Do you use docbook to create the documentation at:
http://geoserver.sourceforge.net/documentation/index.html
For the mapbuilder project we want to produce documentation with the
table of contents on the left and contents body on the right similar to
what you have done but we are unsure how to convert docbook into this
format.
What XSL and params do you use?
Shorter, Cameron wrote:
>
>>
>>I wouldn"t mind doing this in docbook, but I really want it
>>to be laid out something like this with a sidebar selecting
>>different sections; I think this makes it much easier to
>>navigate.
>>
>>
>
>Yes, I agree that it looks good.
>
>
>
>>The docbook stylesheet only puts it out into one
>>big long page. This could also be done in PHP (each section
>>is just a bit of HTML), or else a docbook model and set of
>>widgets might not be too hard to implement?
>>
>>
>
>Docbook have a large number of options and stylesheets and it is quite
>likely that one of them will allow putting a sidebar down the side.
>If not, it probably wouldn"t be too difficult to either modify the
>stylesheets ourselves or copy someone else who has.
>I suggest that we ask the geoserver people what they did because I
think
>they wrote their documentation in docbook and they have the sidebar
titles
>you are aiming for.
>
>
>>>--
>>>
>>>I"m a little concerning that you are writing the docs using JSP
>>>because it means that docs can only be displayed on an ISP which
>>>supports java.
>>>(This excludes sourceforge).
>>>Would you consider another format? (My preference is
>>>
>>>
>>docbook, but I"m
>>
>>
>>>open to suggestions).
>>>
>>>
>>>
--
Please make use of this limegroup email address until our openplans
domain returns, apologies for any missed emails.
----------------------------------------------------------
This mail sent through IMP: https://webmail.limegroup.com/