django-simple-blog 0.3.0

An easy way to start writing blog posts.

==========================
django-simple-blog
==========================

What is it?
===========

django-simple-blog is a simple Django app for fast integrating your
current project with a blog-system

You can easily write blog posts, let users comment the posts if you'd like to.

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

You can do any of the following to install ``django-simple-blog``

- Run ``pip install django-simple-blog``.
- Run ``easy_install django-simple-blog``.
- Download or "git clone" the package and run ``setup.py``.
- Download or "git clone" the package and add ``simpleblog`` to your PYTHONPATH.


Usage
=====

1. Add ``simpleblog`` and `django.contrib.sites` to your INSTALLED_APPS setting like this::

INSTALLED_APPS = (
...
'django.contrib.sites',
'simpleblog',
)


Note: if you want to customize the templates, please add ``el_pagination`` ``markdown_deux`` ``pagedown`` to your INSTALLED_APPS setting.

INSTALLED_APPS = (
...
'django.contrib.sites',
'el_pagination',
'markdown_deux',
'pagedown',
'simpleblog',
)
2. Add `SITE_ID = 1` in your settings.py.
3. Run ``python manage.py migrate``
4. Include the ``simpleblog urls`` like this to have your "home page" as the blog index::

...

urlpatterns =[
path('admin/', admin.site.urls),
path('blog/', include('simpleblog.urls')),
]

Settings
========
``django-simple-blog`` has one setting at the moment::

# How long the length of the textarea should be.

MAX_LENGTH_TEXTAREA = 120 (defaults to None)


Templatetags
===========

``django-simple-blog`` comes with one templatetag for getting
the latest desired number of posts. Just do this in any template::
{% load blog_tags %}

{% latest_blog_posts 5 %}


Translation
===========

``django-simple-blog`` is available in ``english``, ``swedish`` and ``french``
at the moment, feel free to translate the application in another
language.

Admin
=====
For writing posts we will use django's admin application.

The templates
=============

The templates is just there as examples for how your templates
could look like, but they work excellent as well, but if you don't
like them, just override them with your own templates simply.

Requirements
============

`Django>=1.8
<https://github.com/django/django/>`_

`django-el-paginatio>=2.0
<https://github.com/shtalinberg/django-el-pagination>`_

`simplemathcaptcha>=1.0.3
<https://github.com/alsoicode/django-simple-math-captcha/>`_

`django-markdown-deux>=1.0.4
<https://github.com/trentm/django-markdown-deux>`_

`django-pagedown>=0.0.5
<https://github.com/timmyomahony/django-pagedown>`_

If you have problem getting the right versions of these packages,
clone them from their github repository.