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.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_simple_blog-0.3.0-py3-none-any.whl (17.7 kB) Copy SHA256 hash SHA256 Wheel py3 Sep 9, 2018
django-simple-blog-0.3.0.tar.gz (12.5 kB) Copy SHA256 hash SHA256 Source None Sep 9, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page