cmsplugin-simple-markdown

========================= cmsplugin-simple-markdown

.. contents:: Table of contents

Simple Markdown plugin is just a simple markdown plugin for django-cms. It's brutally simple. Just a text area and you'll enter some markdown text and save it. And the reason why I make this is that, I really couldn't find any simple as stupid plugin for django-cms, all I've found was fancy with a lot of java script stuff.

Requirements

• django-cms
• django-markdown

Installation

PyPi

cmsplugin-simple-markdown is available on PyPi:

http://pypi.python.org/pypi/cmsplugin-simple-markdown ::

$ pip install cmsplugin-simple-markdown

Git

You can get latest stable changes from GitHub server: ::

$ git clone https://github.com/Alir3z4/cmsplugin-simple-markdown.git
$ cd cmsplugin-simple-markdown
$ python setup.py install

Zip, Tarball

You can grab the latest tarball.

*unix

Get the latest tarball & install ::

$ wget https://github.com/Alir3z4/cmsplugin-simple-markdown/archive/master.tar.gz
$ tar xvzf cmsplugin-simple-markdown-master.tar.gz && cd cmsplugin-simple-markdown-master
$ python setup.py install

Windows

Download latest ZIP archive.

https://github.com/Alir3z4/cmsplugin-simple-markdown/archive/master.zip

Extract the archive, and run the following command in root directory of cmsplugin-simple-markdown ::

$ python setup.py install

Configuration

Most people say that installation of cmsplugin-simple-markdown is easy, it seems they're out of space. It's fucking hard to install.

Configuration & Usage

1. Make sure django-markdown is configured as described in their Setup <https://github.com/klen/django_markdown#id5>_ section.

2. Add cmsplugin_simple_markdown to INSTALLED_APPS.

3. If you are using Django 1.7 or higher add 'cmsplugin_simple_markdown': 'cmsplugin_simple_markdown.migrations_django', to MIGRATION_MODULES in settings.

4. Create the database tables::

   $ python manage.py migrate

This is not easy, It's hard, confusing. I doubt, double doubt that those people that keep saying installing this is easy are on something.

Drama story

Since every application won't begins with love, this plugin has been developed to solve a problem. 2 days back, I've been using cms.plugin.text for handling html pages and related content, but when I've tried to use AWS S3/CloudFront for my static files, I got stuck with CORS problem. So I've develop cmsplugin-simple-markdown to be used without any dependencies on JavaScript or CSS files.

Now these days, people all around the world are using it, They are happy with it, They go crazy with cmsplugin-simple-markdown, even they name their child cmsplugin-simple-markdown, at least I did. ;)