bobtemplates.kotti 0.2a1
mr.bob templates for Kotti development
License: BSD

Introduction
============

``bobtemplates.kotti`` provides `mr.bob`_ templates to generate packages for
the `Kotti CMS`_

Available templates are:

    -   ``addon``: a template for a full featured Kotti add-on, including

        -   a content type class

        -   add / edit forms and two selectable default views for the content
            type

        -   fanstatic resources specific to these views

        -   i18n infrastructure

        -   test suite with 100% test coverage for the autogenerated code

    -   ``theme``: a simple template for a Kotti theme package.

Global settings
---------------

Some variables are used with every template.  These should be added to the
mr.bob user config in ``~/.mrbob``, e.g.::

    [variables]

    author.name = Andreas Kaiser
    author.email = disko@binary-punks.com
    author.github.user = disko

Creating a add-on package
-------------------------

To create a Kotti add-on run::

    mrbob -O kotti_mycontent bobtemplates.kotti:addon

and answer the questions::

    Welcome to mr.bob interactive mode. Before we generate directory structure,
    some questions need to be answered.

    Answer with a question mark to display help.
    Value in square brackets at the end of the questions present default value
    if there is no answer.


    --> Name of the package: kotti_mycontent

    --> Version of the package [0.1]:

    --> License of the package [BSD]:

    --> Class name for the content type: MyContent

    --> Human readable name of the content type: My Content

    --> Addable to [['Document', ]]:

Customize your content type class, the add/edit schema, views and templates.
Optionally add some CSS, JS and images.

Setup the package and run the CSS/JS minifier::

    python setup.py develop
    python setup.py dev
    python setup.py minify

Create the 18n files::

    python setup.py extract_messages
    python setup.py init_catalog -l de
    python setup.py compile_catalog

Run the demo::

    pserve development.ini

Point your browser to ``http://127.0.0.1:5000`` and test Kotti with your new
content type.

Creating a theme package
------------------------

To create a Kotti theme run::

    mrbob -O kotti_theme_spacelab bobtemplates.kotti:theme

and answer the questions::

    Welcome to mr.bob interactive mode. Before we generate directory structure,
    some questions need to be answered.

    Answer with a question mark to display help.
    Value in square brackets at the end of the questions present default value
    if there is no answer.


    --> Name of the package: kotti_theme_spacelab

    --> Version of the package [0.1]:

    --> License of the package [BSD]:

    --> Name of the theme: Spacelab

    --> Original URL of the wrapped theme: http://bootswatch.com/spacelab/

Add a Bootstrap CSS file::

    cd kotti_theme_spacelab/kotti_theme_spacelab/static/css/
    wget http://bootswatch.com/spacelab/bootstrap.css

Setup the package and run the CSS/JS minifier::

    cd ../../../
    python setup.py develop
    python setup.py dev
    python setup.py minify

Run the demo::

    pserve development.ini

Point your browser to ``http://127.0.0.1:5000`` and enjoy your themed Kotti
site.

.. _mr.bob: http://mrbob.readthedocs.org/en/latest/
.. _Kotti CMS: http://kotti.readthedocs.org/en/latest/

Changelog
=========

0.2a1
-----

-   Add a basic ``addon`` template.

-   Add ``kotti.asset_overrides`` with overridden ``foter.pt`` as example to
    ``theme`` template.

0.1-2
-----

-   Simplify setup.py.

-   Fix wrong dev alias in setup.cfg.

0.1-1
-----

-   Fix packaging.

0.1
---

-   Initial release.