# Blogin

**Repository Path**: faron-ll/Blogin

## Basic Information

- **Project Name**: Blogin
- **Description**: 基于flask开发的个人博客
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: develop
- **Homepage**: https://2dogz.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2021-09-01
- **Last Updated**: 2022-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Blogin

![python-depend.svg](https://7.dusays.com/2020/12/11/507ca007c94c0.svg)

使用Flask+Bootstrap4开发的个人博客系统。

## 最原始项目及演示地址

> 该项目依据 [Filpped/Blogin](https://gitee.com/weiijang/Blogin)
> [它的在线演示](https://2dogz.cn)

## 功能介绍

> 依赖于Flask Python Web框架开发的个人博客网站，包含有前台与后台两个部分。

### 前台功能介绍

1. 个人博客

    + 主页展示每条博客简短介绍
    + 支持博客分类
    + 支持评论、社交网络分享
    + 支持博客归档

2. 个人相册

    + 支持tag标签
    + 支持评论点赞
    + 支持社交账号分享

3. 在线工具

    + 在线词云图生成工具
    + 多端翻译工具
    + 唐宋诗词查询工具
    + 在线OCR工具
    + 在线IP真实地址查询工具

4. 评论系统

    + 支持评论、删除、举报功能
    + 支持评论子回复功能

5. 用户个人资料

    + 用户个人动态展示
    + 未读消息提醒(有人回复你的评论)
    + 修改个人资料、密码
    + 登录日志记录(包括实际登录地点)

6. 其他

    + 支持个人计划制定
    + 支持近三个月contribute热力图显示
    + 网站更新里程碑记录

### 后台功能介绍

1. 内容管理

    + 新增博客
    + 编辑博客
    + 删除博客(前台屏蔽)

2. 相册管理

    + 新增照片
    + 编辑照片
    + 删除照片(前台屏蔽)

3. 个人计划

    + 新增个人近期计划
    + 修改个人近期计划
    + 完成个人近期计划

4. 交互管理

    + 评论管理

      + 查看评论
      + 删除评论(前台屏蔽)
  
    + 用户管理

      + 查看用户
      + 禁用用户(禁止登录)
      + 权限设置(管理员/用户)

    + 服务器管理

      + 服务器运行状态

        + CPU占用比
        + 内存占用比
        + 网络收发占用

    + 运行日志

      + nginx日志查看
      + app错误日志查看
      + nginx错误日志查看

    + 其他

      + 友链

        + 新增友链
        + 遗弃友链里程碑

      + 里程碑

        + 新增里程碑
        + 遗弃里程碑
  
## 开始

### 本地运行

+ 根据`requirement.txt`安装pip依赖
+ 根据`docker-compose.yml`自定义部署`mysql`,`redis`

+ 配置系统配置

  > 项目中有很多属性属于是私人保密属性，因此我们可以将这些属性的值保存到`.env`文件中，在上传代码的时候，将该文件屏蔽。查看具体的配置项,查看`src/blogin/setting.py`;
  > 在项目的根目录中新建`.env`文件，在文件中输入如下内容

   ```ini
   MAIL_SERVER='your mail server'
   MAIL_USERNAME='your mail username'
   MAIL_PASSWORD='your mail server verify code' # 不是你的邮箱密码,是申请的邮箱秘钥
   SECRET_KEY='your project secret'
   DATABASE_HOST='127.0.0.1'
   DATABASE_USER='your mysql/mariaDB database connect username'
   DATABASE_PWD='your mysql/mariaDB database connect user password'
   # 百度翻译apiid 以及 key
   BAIDU_TRANS_APPID='your app id for baidu trans'
   BAIDU_TRANS_KEY='your app key for baidu trans'
   # github第三方登录id以及key
   GITHUB_CLIENT_ID='your github client id'
   GITHUB_CLIENT_SECRET='your github client secret'
   # baidu ocr key
   OCR_KEY='your key'
   OCR_SECRET='your secret'
   OCR_TOKEN='your token'
   # redis配置
   REDIS_HOST = "127.0.0.1"
   # REDIS_PWD = 'test'
   ```

  > 邮件服务器可以申请QQ邮箱或者163邮箱，具体申请流程请网上冲浪，十分简单，这里不做描述
  > 在项目根目录新建.flaskenv文件，在其中输入以下内容

  ```ini
   FLASK_APP=blogin
   FLASK_ENV=development
  ```

  > 指定当前环境为开发环境，指定当前APP为blogin.

+ 初始化数据库

  >进入项目的根目录，使用如下命令进行数据库初始化

  ```sh
   cd src
   flask admin
  ```

+ 运行

  > 执行启动命令,打开 http://127.0.0.1:5000 就可以看到页面了

  ```sh
   flask run
  ```