Python Django Personal Blog 个人博客系统.zip

# Blog_Django_Project <HR> - [Blog_Django_Project](#blog-django-project) * [Projekt Description](#projekt-description) * [System Dependency](#system-dependency) * [Depolyment process](#depolyment-process) * [Main View](#main-view) * [Database](#database) + [blog_app](#blog-app) - [Table: Post](#table--post) - [Table: Tag](#table--tag) - [Table: Category](#table--category) + [blog_comment](#blog-comment) * [Table: Comment](#table--comment) * [Usage](#usage) + [Login and Register](#login-and-register) - [Authentication](#authentication) + [Blog System](#blog-system) - [Home Page](#home-page) - [Post Detail Page and Comment](#post-detail-page-and-comment) - [Blog List](#blog-list) - [About me](#about-me) - [Contact me](#contact-me) - [Post New](#post-new) - [Search and Logout](#search-and-logout) * [Administration System](#administration-system) * [Static Content and Template](#static-content-and-template) + [Template in setting.py](#template-in-settingpy) + [Static Content in setting.py](#static-content-in-settingpy) * [Restful API](#restful-api) * [Other](#other) ## Projekt Description Through this Django project we can deploy a personal blog. It is a pure Django project without frontend and backend separation. SQLite is used as Database ## System Dependency Python3, Django and Third Party Dependency ( written in requirements.txt) ## Depolyment process 1. Install the thrid-party Library according to requirements.txt: `pip install -r requirements.txt` 2. run Django Project through execute `python manage.py runserver 8000` ## Main View - admin - [admin page](http://127.0.0.1:8000/admin): http://127.0.0.1:8000/admin - blog_auth - [login](http://127.0.0.1:8000/auth/login): http://127.0.0.1:8000/auth/login - [register](http://127.0.0.1:8000/auth/register): http://127.0.0.1:8000/auth/register - [logout](http://127.0.0.1:8000/auth/logout): http://127.0.0.1:8000/auth/logout, logout the current user and redirect to the login page auotmatically - blog_app - [Home Page](http://127.0.0.1:8000/blog/home): http://127.0.0.1:8000/blog/home - [Blog List](http://127.0.0.1:8000/blog/full): http://127.0.0.1:8000/blog/full - [About me](http://127.0.0.1:8000/blog/about/): http://127.0.0.1:8000/blog/about/ - [Contact me](http://127.0.0.1:8000/blog/contact/): http://127.0.0.1:8000/blog/contact/ - [Post new ](http://127.0.0.1:8000/blog/post/new/): http://127.0.0.1:8000/blog/post/new/ - blog_comment - [comment](http://127.0.0.1:8000/blog/comment/post/<post_pk>): http://127.0.0.1:8000/blog/comment/post/<post_pk>, show all comments of the post with the post_pk - blog_api - [api list](http://127.0.0.1:8000/api/): http://127.0.0.1:8000/api/, show all api - [posts](http://127.0.0.1:8000/api/posts/): http://127.0.0.1:8000/api/posts/, show all posts - [categories](http://127.0.0.1:8000/api/categories/): http://127.0.0.1:8000/api/categories/, show all categories - [tags](http://127.0.0.1:8000/api/tags/): http://127.0.0.1:8000/api/tags/), show all tags - [users](http://127.0.0.1:8000/api/users/): http://127.0.0.1:8000/api/users/, show all users View map  ## Database Only in the Application blog_app, blog_comment, the new Data class are registered in the models.py. The tables are created in the database through the migration. The migration is done by the command `python manage.py makemigrations` and `python manage.py migrate`. Once they are executed, the tables are created in the database. ### blog_app #### Table: Post The Post in the Blog System Attributes - title: title of the post - body: content of the post - create_time: create time of the post - modified_time: modified time of the post - excerpt: if empty, the first 50 characters of body is used - views: how many times this post is viewed - category: As ForeignKey to table Category - tags: mapping to the name in the table Tag - author = As ForeignKey to table User #### Table: Tag Tag of post Attributes - name: name of tag #### Table: Category Category of post Attributes - name: name of category ### blog_comment ##### Table: Comment Comment of post Attributes - author: ForeignKey to User - email: email of the author - url: url of the author - text: content of the comment - create_time: create time of the comment - post: ForeignKey to Post ## Usage ### Login and Register There are two page: login and register. In the login mode, you can choose remember me or not. If you choose remember me, the session will be saved for 14 days. Otherwise, the session will expire after the browser is closed.  In the register mode, you need to set the username, the password and the email. The username and the email should be unique. The password should be at least 8 characters long. After you have registered, you will be redirected to the login page. you have to login with the username and the password you have just set.  Moreover, you can also enter to the Home page and The Page for creating new post directly through the main bar. Enter the Home page you don't need to login. But if you want to create a new post, you need to login first. Otherwise, you will be redirected to the login page. #### Authentication Once you register a new user through Register page, this new created user will be registered into the Built-in User table of Django. The password of the user is hashed by the Django built-in hash function. The password is not stored in the database directly. The User below are available in the system. You can login with the username and the password below. Or you can also create a new user through the Register page. | username | password | email | permission | |----------|-----------|------------------------|-------------| | admin | django123 | bigberlin100@gmail.com | superuser | | Thomas | django123 | bigberlin200@gmail.com | normal user | | Dylan | django123 | bigberlin300@gmail.com | normal user | | Jens | django123 | bigberlin400@gmail.com | normal user | | Florian | django123 | bigberlin500@gmail.com | normal user | ### Blog System There are five main pages in the blog system: Home Page, Blog List and About me, Contact me and Post new. They are all accessible through the main bar. The welcome word "Hello, \<Username of current session\>" will be shown in the main bar if you have logged in. #### Home Page The Blog are display in the link part of the Home Page. The first 3 posts are shown in the Home Page. You can click the title of the post to see the detail of the post. The navigation bar is shown in the right side of the Home Page. The option blow are listed in the navigation bar: - The latest 5 posts - Archive: The posts are grouped by year - category: The posts are grouped by category. you can click the category to see the posts in this category - tag: The posts are grouped by tag. you can click the tag to see the posts in this tag  #### Post Detail Page and Comment The detail of the post is shown in the Detail Page of one Post. You can see the title, the author, the create time, the modified time, the category, the tags and the content of the post. The view number of the post is shown blow the title of the post. The view number will be increased by 1 every time you enter the detail page of the post. The comments of the post are shown below the post. You can add a comment to the post if you have logged in. The comments are paginated by 10 comments per page. In order to add a comment, you have to login first. Otherwise, you will be redirected to the login page.  #### Blog List All Blog are shown in the Blog List. You can click the title of the post to see the detail of the post. The blogs are pa