Metadata-Version: 1.0
Name: bobtemplates.kotti
Version: 0.2a1
Summary: mr.bob templates for Kotti development
Home-page: https://github.com/disko/bobtemplates.kotti
Author: Andreas Kaiser
Author-email: disko@binary-punks.com
License: BSD
Description: 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.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
