From c23e4449cf3d70ab5da78a9be3c9300bb61d101f Mon Sep 17 00:00:00 2001 From: Peter Novotnak Date: Fri, 7 Nov 2014 10:45:03 -0800 Subject: [PATCH] additional readme conversion, converted setext-style headers to atx-style for better nesting --- docs/INSTALL.md | 11 +++++------ docs/USAGE.md | 35 +++++++++++++++++------------------ 2 files changed, 22 insertions(+), 24 deletions(-) diff --git a/docs/INSTALL.md b/docs/INSTALL.md index d29a552..e52a060 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -1,8 +1,7 @@ -Installation Guide ------------------- +# Installation Guide + +## Required -Required -~~~~~~~~ 1. Install or add django-ckeditor to your python path. 2. Add ``ckeditor`` to your ``INSTALLED_APPS`` setting. @@ -34,8 +33,8 @@ Required CKEDITOR_JQUERY_URL = '//ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js' -Optional -~~~~~~~~ +## Optional + 1. All uploaded files are slugified by defaults, to disable this feature set ``CKEDITOR_UPLOAD_SLUGIFY_FILENAME`` to ``False`` 2. Set the CKEDITOR_RESTRICT_BY_USER setting to ``True`` in the project's ``settings.py`` file (default ``False``). This restricts access to uploaded images to the uploading user (e.g. each user only sees and uploads their own images). Superusers can still see all images. **NOTE**: This restriction is only enforced within the CKEditor media browser. diff --git a/docs/USAGE.md b/docs/USAGE.md index 5a28152..9e23645 100644 --- a/docs/USAGE.md +++ b/docs/USAGE.md @@ -1,8 +1,7 @@ -Usage Guide ------------ +# Usage Guide + +## Field -Field -~~~~~ The quickest way to add rich text editing capabilities to your models is to use the included ``RichTextField`` model field type. A CKEditor widget is rendered as the form field but in all other regards the field behaves as the standard Django ``TextField``. For example:: from django.db import models @@ -12,8 +11,8 @@ The quickest way to add rich text editing capabilities to your models is to use content = RichTextField() -Widget -~~~~~~ +## Widget + Alernatively you can use the included ``CKEditorWidget`` as the widget for a formfield. For example:: from django import forms @@ -43,21 +42,21 @@ Note that when using outside of admin panel you will have to make sure all form -Management Commands -~~~~~~~~~~~~~~~~~~~ +## Management Commands + Included is a management command to create thumbnails for images already contained in ``CKEDITOR_UPLOAD_PATH``. This is useful to create thumbnails when starting to use django-ckeditor with existing images. Issue the command as follows:: $ ./manage.py generateckeditorthumbnails **NOTE**: If you're using custom views remember to include ckeditor.js in your form's media either through ``{{ form.media }}`` or through a ``