Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

A simple Django Blog app.

Project description

=====
Blog
=====

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::

INSTALLED_APPS = [
...
'ckeditor',
'ckeditor_uploader',
'blog',
]

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

'OPTIONS': {
'context_processors': [
...
'blog.context_processors.hexia_blog',
],
},


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

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

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

6. Start the development server and visit http://127.0.0.1:8000/admin/
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 http://127.0.0.1:8000/.


Settings
--------

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 settings.py

BLOG_PAGINATION:
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.

Filename, size & hash SHA256 hash help File type Python version Upload date
hexia_blog-1.0.12-py3-none-any.whl (12.7 kB) Copy SHA256 hash SHA256 Wheel py3
hexia-blog-1.0.12.tar.gz (8.5 kB) Copy SHA256 hash SHA256 Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page