Re: docs sample

From: Andrus Adamchik (andru..bjectstyle.org)
Date: Mon Apr 17 2006 - 11:25:03 EDT

  • Next message: Cris Daniluk: "Re: docs"

    Very nice, I like it. Let's not worry about matching the looks with
    the stuff currently produced by Anakia. Confluence theme is nice and
    clean.

    Andrus

    On Apr 17, 2006, at 6:51 PM, Cris Daniluk wrote:

    > Resending this for the nth time after having the attachment
    > rejected as
    > spam...
    >
    > With b2 impending, I thought I'd share the current state of the
    > docs. I've
    > retooled a lot... the attempt to use integrate with the anakia
    > templates wa=
    > s
    > a waste of time. The way it handles the TOC generation is a bit
    > limiting.
    > So, I've just combined a simple velocity template with a whole
    > bunch of
    > regexp loving to get to where we're at now. I'm sure a more elegant
    > solutio=
    > n
    > exists, but being as we have to get this thing done, and being as
    > any Apach=
    > e
    > mandates might change how we do this, I didn't want to go crazy :)
    >
    > There were a lot of interesting issues, as we basically had to post-
    > process
    > the Confluence-rendered HTML to rewrite different types of links. The
    > attached docs still have an issue with cross-linking to other
    > documents (it
    > can link to child docs but not across the tree). There is also a cute
    > rendering bug in IE on the toc (border shows inside the bullets).
    > All quick
    > fixes, but I wanted to get what's done out there for comment.
    >
    > I also put a little hack in to specify page ordering - within an
    > {excerpt}
    > on a page, you can specify the sort order you would like for
    > children. I've
    > already included this on the User Guide page. Confluence doesn't
    > honor it o=
    > f
    > course, but the static export does.
    >
    > Also, I scrapped the existing doc template in favor of something more
    > consistent with the Confluence documentation format. It is all
    > velocity/css
    > styled though, so we can easily move back if anyone objects. Let me
    > know
    > what you guys think.
    >
    > Cris



    This archive was generated by hypermail 2.0.0 : Mon Apr 17 2006 - 11:25:32 EDT