Skip to main content

An easy way to start writing blog posts.

Project description

==========================
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.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-simple-blog-0.3.0.tar.gz (12.5 kB view hashes)

Uploaded Source

Built Distribution

django_simple_blog-0.3.0-py3-none-any.whl (17.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page