1
0
Fork 0
Go to file
Daniele Tricoli 5cd47e9e99 Added chagelog entry 2012-11-24 22:05:12 +01:00
microcms Added css to fix ckeditor in the admin app 2012-11-24 21:05:55 +01:00
.hgignore Initial import 2009-10-27 00:28:00 +01:00
AUTHORS Added AUTHORS 2010-08-18 00:01:54 +02:00
CHANGELOG Added chagelog entry 2012-11-24 22:05:12 +01:00
LICENSE Added license 2010-11-16 00:36:59 +01:00
MANIFEST.in Added README 2010-11-16 15:01:44 +01:00
README Fixed direct installation url of packaged version for pip 2010-11-29 20:40:27 +01:00
setup.py Changed name 2010-11-26 06:08:32 +01:00

README

===============
django-microcms
===============

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

Installation
============

Assuming that you want to install ``microcms`` version 0.1.2:

From a packaged version::

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

From source repository::

    $ pip install -e hg+http://hg.mornie.org/django/microcms/@0.1.2#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
``MEDIA_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 MEDIA_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.
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 MEDIA_URL.



Thanks for downloading django-microcms.