kotti_bootswatch 0.1.2

Kotti bootswatch theme / theme generator

Bootswatch theme and theme generator for Kotti.

This theme and the generated themes supersede css files of the js.bootstrap and Kotti via fanstatic’s supersedes and rollup mechanism.

Development happens at https://github.com/mete0r/kotti_bootswatch

Basic usage: predefined bootswatch themes

To enable the extension in your Kotti site, activate the configurator:

[app:kotti]

...

kotti.configurators =
    ...
    kotti_bootswatch.kotti_configure  # enable this extension

# Use predefined `darkly' bootswatch theme
kotti_bootswatch.theme = darkly

...

[filter:fanstatic]
use = egg:fanstatic#fanstatic

# fanstatic rollup should be enabled
rollup = True

...

Advanced usage: generate and use a bootswatch-based themes

You can generate bootswatch-based themes:

pcreate -s kotti_bootswatch mytheme
cd mytheme
sh quickstart.sh amelia  # use `amelia' bootswatch theme as a base theme

Read generated README.rst for more information:

cat mytheme/README.rst

To use the generated theme in your Kotti site:

[app:kotti]

...

kotti.configurators =
    ...
    mytheme.kotti_configure  # enable this extension

[filter:fanstatic]
use = egg:fanstatic#fanstatic

# fanstatic rollup should be enabled
rollup = True

Caveat

Generated themes contains less files (static/kotti/*.less) to override Kotti css files, i.e. base/view/edit/upload.css. These less files are introduced to adapt the Kotti css files to the bootstrap(or bootswatch) variables.

So if the original css files in the Kotti changes, the less files should be changed too.

Development

Contributions to kotti_bootswatch are highly welcome. Just clone its Github repository and submit your contributions as pull requests.

History

0.1.2 (2014-12-31)

• Specify minify as a requirement in the generated README.rst

• Generate separate README files for user/maintainer

0.1.1 (2014-12-31)

• Generate/use minified css files.

0.1.0 (2014-12-29)

• Create package with pcreate -s kotti kotti_bootswatch.