view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    underneath the main data directory. Sub-blogs can have their own
    templates, but by default inherit the templates from the main blog.

    (Oh, and another thing - you can stick templates either in the template
    subdirectory or the main directory for your blog/sub-blog. Bryar looks
    in both.)

    If you want your main blog to contain things from sub-blogs, you can
    change the value of the "depth" option, which defaults to one - no
    descent into subblogs.

    You can also export your blog as RSS:

        http://your.blog.com/bryar.cgi/xml

    And combine subblogging with RSS:

        http://your.blog.com/bryar.cgi/otherblog/xml

    These are actually blosxom backwardly-compatible versions of the Bryar:

        http://your.blog.com/bryar.cgi?format=xml

    There's also an Atom feed:

        http://your.blog.com/bryar.cgi?format=atom

    And you can write your own formats; see the renderer class documentation
    for how.

    Each blog post will have a unique ID; you can get to an individual post
    by specifying its ID:

        http://your.blog.com/bryar.cgi/id_1234

    And finally you can retrieve blog entries for a specific period of time:

        http://your.blog.com/bryar.cgi/2003/May/    # All entries in May
        http://your.blog.com/bryar.cgi/2003/May/14/ # All entries on the 14th

    Of course, you can combine all these components:

        http://your.blog.com/bryar.cgi/otherblog/2003/May/xml

METHODS
    Now for the programmer's interface to Bryar.

  new
        $self->new(%params)

    Creates a new Bryar instance. You probably don't need to use this unless
    you're programming your blog to do clever stuff. Use "go" instead.

  go
        $self->go()
        Bryar->go(%params)

    Does all the work of producing the blog. For parameters you might be
    interested in setting, see "Bryar::Config".

  posts_calendar
    TODO: Move this out to something that is more flexible.

    Return a data structure containing the days and weeks of a given month
    and year with blog posts attached. See the "calendar" template for an
    example.

  config
    Returns the Bryar::Config object for this blog. This is useful as the
    blog object is passed into the templates by default.

LICENSE
    This module is free software, and may be distributed under the same
    terms as Perl itself.

THANKS
    Steve Peters provided Atom support. Marco d'Itri contributed the
    calendar, HTTP validators, caching, FastCGI, sitemaps, non-ASCII
    charsets, bug fixes and optimizations.

AUTHOR
    Copyright (C) 2003, Simon Cozens "simon@cpan.org"

    some parts Copyright 2007 David Cantrell "david@cantrell.org.uk"

    some parts Copyright 2009 Marco d'Itri "md@linux.it"