Fork 0
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Daniele Tricoli d1e03bc7a2 Added tag 0.2.0 for changeset 0cc4842358e8 10 years ago
microcms Bumped to 0.2.0 10 years ago
.hgignore Initial import 14 years ago
AUTHORS Added AUTHORS 13 years ago
CHANGELOG Added chagelog entry 10 years ago
LICENSE Updated license years 10 years ago
MANIFEST.in Install and provide in sdist the css fix 10 years ago
README Updated 10 years ago
setup.py Updated license years 10 years ago



``django-microcms`` is a minimalistic enhancement of Django flatpages app. It
provides few additional fields and integrates CKeditor.


Assuming that you want to install ``django-microcms`` version 0.2.0:

From a packaged version::

    $ pip install http://downloads.mornie.org/django-microcms/django-microcms-0.2.0.tar.gz

From source repository::

    $ pip install -e hg+http://hg.mornie.org/django/microcms/@0.2.0#egg=django-microcms

Or download a packaged version from http://downloads.mornie.org/django-microcms/
and and use Python's ``distutils`` to install.

Getting started

Previously you must have correctly set up Django ``flatpages``.

Simply add ``microcms`` to your ``INSTALLED_APPS`` after ``flatpages``.

CKeditor integration

Default settings assumes that CKeditor is available at
``STATIC_URL/ckeditor/ckeditor.js``. You can change it using CKEDITOR_URL in
your settings.py:

    CKEDITOR_URL = "path/to/ckeditor.js"

CKEDITOR_URL will be prepended with STATIC_URL so you can use a relative path.

You can need to add some custom css to fix displaying issues or to customize the
admin page. CKeditor kama theme, for example, doesn't look good without a fix,
but a custom css is provided by django-microcms itself: just use
``django-admin.py collectstatic`` to copy it into STATIC_ROOT.

If you want customize just use MICROCMS_CUSTOM_CSS in your settings.py:

    MICROCMS_CUSTOM_CSS = ('kama-fix.css',)

Don't forget to use a tuple: this is done to give greater flexibility. Again
values inside MICROCMS_CUSTOM_CSS will be prepended with STATIC_URL.

Thanks for downloading django-microcms.