Skip to main content

A simple Django Blog app.

Project description


Blog is a simple Django Blog app.

Blogs can have tags, title, image, short description and a rich text blog.

Tags are created in Admin and Users can then add as many as they like.

Detailed documentation is needs writing.

Quick start

1. pip install hexia-blog

2. Add "blog" and dependencies to your INSTALLED_APPS setting like this::


3. Add "blog.context_processors.hexia_blog" to your context_processors::

'context_processors': [

4. Include the blog URLconf in your project like this::

path('blog/', include('blog.urls')),

5. Run `python migrate` to create the blog models.

6. Start the development server and visit
to create a Tag (you'll need the Admin app enabled).

7. There are 5 URLs provided.

<a href="{% url 'blog:blog-detail' object.slug %}">Blog Detail</a> provides the detail of a specific blog.
Template: blog/blog_detail.html

<a href="{% url 'blog:blog-list' %}">Blog List</a> will list all blogs.
Template: blog/blog_list.html

There is a special case of list where 'tag' and/or 'search_string' get be set. When set, only blogs matching
these criteria will be returned. See blog/blog_list.html to see it implemented.

<a href="{% url 'blog:blog-tag-list' tag.slug %}">Tag List</a> provides a list of blogs with the associated Tag.

<a href="{% url 'blog:blog-month-list' month=xx year=yyyy %}">Month List</a> provides a list of blogs within the associated Month.

<a href="{% url 'blog:blog-create' %}">Blog Create</a> will allow you to create a new blog (or you can via admin)
Template: blog/blog_form.html

When using create you must set the blog auther to the user who it is associated with.

7b. There aprev and next blog functions provided

For a given `blog` object you can access the previous and next blog with `blog.prev_blog` and `blog.next_blog`

8. Visit


Blog uses AUTH_USER_MODEL as the default user model. It will default to
the Django User model if AUTH_USER_MODEL is not set in

The number of blogs shown on a single page when using listing.
Default = 20

Context Processors
There is a single context_processor provided, 'hexia_blog_tags', which provides a list of all Tags.
It is used in blog_list.html.

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

hexia-blog-1.0.12.tar.gz (8.5 kB view hashes)

Uploaded source

Built Distribution

hexia_blog-1.0.12-py3-none-any.whl (12.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page