Вячеслав Тихановский > Bootylicious > Bootylicious

Download:
Bootylicious-0.910102.tar.gz

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Source  

NAME ^

Bootylicious -- one-file blog on Mojo steroids!

SYNOPSIS ^

    $ bootylicious daemon

DESCRIPTION ^

Bootylicious is a minimalistic blogging application built on top of Mojolicious::Lite. You start with just one file, but it is easily extendable when you add new plugins, templates, css files etc.

FEATURES ^

    * filesystem-based storage
    * tags
    * RSS (articles and by tag)
    * paging
    * static pages
    * drafts
    * themes
    * multi-parser support
    * plugins

CONFIGURATION ^

Bootylicious can be configured through config file that is placed in the same directory as bootylicious (or set via BOOTYLICIOUS_HOME env variable) file and is called bootylicious.conf. It is in JSON format.

    {
        "title" : "my blog title",
        "descr" : "my blog description",
        "author" : "myname",
        "menu" : [
            "item1", "link1",
            "item2", "link2",
            ...
        ],
        ...
    }

If you are using Bootylicious' default templates, there are a number of configuration options you can set to customize them without ever having to touch html or template files:

Also, the following options can be set to change the way bootylicious behaves:

FILESYSTEM ^

ARTICLES

All the articles must be placed under the articlesdir with a name like 20090730-my-new-article.EXTENSION. Based on EXTENSION they are parsed by different parsers. See parsers section for more information.

The filename format must comply with either of the following:

The title may contain dots (".") or dashes ("-") freely.

PAGES

These are static pages that don't appear on articles page and can be used to show some static information like documentation, download are, author info etc.

DRAFTS

These are future articles that you are working on. Just place your drafts under the draftsdir and keep working. You can look at the preview by pointing your browser to the draft url. Noone is going to see it, because only you know the article's title.

PLUGINS ^

Bootylicious can be extended by using Mojolicious::Plugin derived third party plugins.

CONFIGURATION

Configuration is done in bootylicious config file. Parameters are passed when loading a plugin.

    # Without params (or with default ones)
    "plugins" : [
        "search",
        "gallery"
    ]

    # With params
    "plugins" : [
        "search", {
            "before_context" : 10
        },
        "gallery", {
            "columns" : 3
        }
    ]

See Mojolicious::Plugin documentation for more details and Bootylicious::Plugin::Search as an example plugin.

TEMPLATES ^

Embedded templates will work just fine, but when you want to have something more advanced just create a template in templates/ directory with the same name but optionally with a different extension.

For example there is index.html.ep, thus templates/index.html.ep should be created with a new content. If you want to use a different base directory for the templates, set the templatesdir config option as explained above.

SUPPORT ^

Web

    http://getbootylicious.org/

DEVELOPMENT ^

Repository

    http://github.com/vti/bootylicious/commits/master

SEE ALSO ^

Mojo Mojolicious Mojolicious::Lite

CREDITS ^

Breno G. de Oliveira

Johannes 'fish' Ziemke

Konstantin Kapitanov

Mirko Westermeier

Sebastian Riedel

Slavik Komarov

AUTHOR ^

Viacheslav Tykhanovskyi, viacheslav.t@gmail.com.

COPYRIGHT ^

Copyright (C) 2008-2009, Viacheslav Tykhanovskyi.

This program is free software, you can redistribute it and/or modify it under the same terms as Perl 5.10.

syntax highlighting: