Blog-project based on Django.

About The Project

The goal of this project is creation of site with base blog functionality.

Frontend-part of this project is based on free open template Dart Blog (by DartThemes.com).

Key Features

• Display a list of added posts;
• Ability to add post to one of the categories;
• Simple comment system;
• Tag system;
• Authorization system: registration, authorization, password change, etc;
• View post, grouped by category, tag or author;
• Search by post title;
• Ability to format post content with Django CKEditor.

Screenshots and demonstaration

Screenshots and demonstration

• A list of posts on main page

• A single post

• A user page

• An authorization form

Built With

• 
• 
• 
• 
• 

DevTools

• 
• 

Usage

Prerequisites

1. Install Python 3.11
2. Install Poetry

Installation

1. Clone the repository

$ git clone <% url %>   

2. Go into the repository

$ cd dartblog

3. Activate virtual environment, install dependencies and go into project folder

$ poetry shell
$ poetry install
$ cd siteblog

4. Change the file ../setenv.sh Parameter values are recommended to be filled in as strings, inserting values between quotes (export PARAM='your_value')

• SECRET_KEY - secret key. Can be generated like this:

$ python manage.py shell

>>> from django.core.management.utils import get_random_secret_key
>>> print(get_random_secret_key())
# Copy and paste the resulting string between '' into SECRET_KEY
>>> exit()

• SMTP_HOST - the host to use for sending email (EMAIL_HOST variable in siteblog/settings.py);
• SMTP_EMAIL - username to use for the SMTP server (EMAIL_HOST_USER variable in siteblog/settings.py);
• SMTP_PASS - password to use for the SMTP server (EMAIL_HOST_PASSWORD variable in siteblog/settings.py); More information about these values can be found in Django docs.

Note You may also need to change the EMAIL_PORT setting to match your host.

5. Activate environment variables

$ . ../setenv.sh

6. Collect static files

$ python manage.py collectstatic  
   

7. Make and apply migrations

$ python manage.py makemigrations
$ python manage.py migrate

8. Run test server

$ python manage.py runserver

Then you can work with the project in the same way as with any other django project: fill the database, create an administrator, and so on.

License

Distributed under the MIT License. See LICENSE.md for more information.

Contact

Dmitry Samsonenko - samsondm97@gmail.com

Acknowledgments

• WebforMyself
• OrdinaryCoders
• DEV
• Диджитализируй!