inigo.templer 1.4

Convenience templer templates for Inigo stuff

Contents

• Introduction

• Installation

  • Method 1: Buildout

  • Method 2: Install into system python

• Usage

  • Instantiating template

  • Using localcommands

• Templates

  • inigo_plone

  • inigo_buildout

  • inigo_theme

  • inigo_policy

  • inigo_i18noverride

• Hacking/Contributing

• Contributors

• Changelog

  • 1.4 (2013-10-30)

  • 1.3 (2013-08-19)

  • 1.2 (2013-06-20)

  • 1.1 (2013-04-18)

  • 1.0 (2012-12-19)

Introduction

This package contains templer templates used by Inigo Consulting as our standard package structure.

Installation

Method 1: Buildout

Create a buildout using this configuration:

[buildout]
parts = scripts

[scripts]
recipe = zc.recipe.egg
eggs =
   templer.core
   inigo.templer

Method 2: Install into system python

easy_install inigo.templer

Usage

Instantiating template

templer inigo_plone

This will create a folder with your development package.

Using localcommands

Enter your development package, and you will find a bootstrap.py and buildout.cfg in it. This is a pre-configured buildout which will help you in setting up a development environment for your package. To use localcommand, you will need the paster provided by this buildout. Follow these steps to build the buildout:

python bootstrap.py
./bin/buildout -vvvv

Once buildout is successful, you can use paster to add localcommand templates:

./bin/paster add <localcommand-template-name>

Templates

inigo_plone

This template contains our standardized package structure and several local commands to aid in common tasks related to Plone add-on development for our clients.

The local commands are:

• content_type - This adds a skeleton Dexterity Content Type similar to templer.dexterity, however with a different layout.

• behavior - This adds a skeleton for Dexterity Content Type similar to templer.dexterity.

• basic_portlet - This adds a skeleton for a configurable portlet.

• nonconfigurable_portlet - This adds a skeleton for a nonconfigurable portlet. This skeleton can also add assignment profile to specific content types.

• schemaextender - This adds a skeleton for an archetypes.schemaextender browserlayer aware extender.

• skin_layer - This adds a single FileSystemDirectoryView skin layer into the product

• upgrade_profile - This adds a skeleton for a GenericSetup upgrade profile and handler for the product.

• viewlet - This adds a skeleton for a basic viewlet

• view - This adds a skeleton for a basic View based on grok.View

• css - This adds genericsetup xml settings for inclusion of css

• js - This adds genericsetup xml settings for inclusion of js

• vocabulary - This adds skeleton for a named VocabularyFactory

Todo/Wishlist:

• custom indexer, z3cform widget, catalog index, topic metadata

inigo_buildout

This template provides a skeleton buildout which provides:

• buildout.cfg + deployment.cfg based template (separation between development, deployment buildout)

• OpenShift deployment hooks (outdated at the moment)

• site.cfg for site-specific settings

• releaser script to aid in releasing packages from mr.developer list

• example haproxy.cfg and varnish.vcl

inigo_theme

This template provides an initial Diazo theme package to work with. It includes an rudimentary rules.xml with simple index.html based on sunburst’s actual template, a skin layer, and a z3c.jbot directory for overriding templates.

Local commands usable here:

• css - This adds genericsetup xml settings for inclusion of css

• js - This adds genericsetup xml settings for inclusion of js

inigo_policy

This template provides a basic package which is useful as a site policy package. Its simple a basic package with genericsetup install/upgrade profile, and a browserlayer.

inigo_i18noverride

This template provide a basic package for overriding locales

Hacking/Contributing

Feel free to fork and modify/add functionalities and submit improvements for this package. It is using inigo.* namespace primarily because the template layout is following our internal best practices, of which might not be the same as upstream Plone practices. However, we believe that some of these should be pushed upstream if the community want it.

Contributors

Note: place names and roles of the people who contribute to this package

in this file, one to a line, like so:

• Izhar Firdaus, Original Author

Changelog

1.4 (2013-10-30)

• fix some typo bugs [izhar]

• added better haproxy and varnish configs [izhar]

• content interface should alsoProvides IFormFieldsProvider [izhar]

• update to latest bootstrap.py [izhar]

• z3cform for portlet should be non-default [izhar]

1.3 (2013-08-19)

• enable versioning behavior by default [izhar]

• fix haproxy config to also have a frontend settings block [izhar]

• browser:resourceDirectory plone 4.3 compat [izhar]

• install plone.app.relationfield and plone.formwidget.contenttree by default [izhar]

• use z3cform in portlets [izhar]

• overrideable zodb-cache-size [izhar]

1.2 (2013-06-20)

• added skeleton for inigo_i18noverrides and inigo_policy [izhar]

• added more localcommands (viewlet, view, css, js, vocabulary) [izhar]

1.1 (2013-04-18)

• added code to delegate behavior attributes to context [izhar]

• enable multilingual, exclfromnav, dexteritytextindexer, and referenceable behavior by default [izhar]

• initial skeleton for inigo_buildout and inigo_theme [izhar]

• schemaextender adapter should be named adapter [izhar]

1.0 (2012-12-19)

• Package created using templer [izhar]

• Added initial templates [izhar]

• Initial development of this package was sponsored by World Council of Churches.