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

如果有帮助到你，还请金手Star-Star-Star一下啦，不甚感激~~~

在线演示地址: https://2dogz.cn

English Document

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

• U系Linux、Mac用户可以通过根目录的install.sh脚本文件一键安装，如果出现错误也可以同Windows用户一样按照下面的步骤进行安装。

     cd Blogin
     ./install.sh

1. 安装MySQL 进入MySQL或者mariaDB官网下载对应系统的安装包，进行安装即可。Linux用户可以通过命令进行安装

   sudo apt-get install mysql

2. 安装redis

   进入redis官网下载安装包进行安装，Linux用户可以通过下面的命令安装

   sudo apt-get install redis

   安装成功之后，通过如下命令开启redis服务

   sudo service redis-server start

3. 创建数据库

   打开终端，输入如下命令进入MySQL控制台，具体命令根据你自己的MySQL数据库的设置而定

   sudo mysql -u root -p

   create database blog CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   SHOW DATABASES ;

   如果控制台输出的内容中包含有blog数据库，则说明数据库创建成功了。

1. 克隆仓库代码

   进行这一步本地机器上必须先配置好git环境，具体细节请网上冲浪查询。

   git clone https://github.com/weijiang1994/Blogin.git

2. 配置环境变量

   项目中有很多属性属于是私人保密属性，因此我们可以将这些属性的值保存到.env文件中，在上传代码的时候，将该文件屏蔽。

   在项目的根目录中新建.env文件，在文件中输入如下内容

   MAIL_SERVER='your mail server'
   MAIL_USERNAME='your mail username'
   MAIL_PASSWORD='your mail server verify code' # 不是你的邮箱密码,是申请的邮箱秘钥
   SECRET_KEY='your project secret'
   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'
   # gitee 第三方登录相关配置
   GITEE_CLIENT_ID='your gitee client id'
   GITEE_CLIENT_SECRET='your gitee client secret'

   邮件服务器可以申请QQ邮箱或者163邮箱，具体申请流程请网上冲浪，十分简单，这里不做描述。

   在项目根目录新建.flaskenv文件，在其中输入以下内容

   FLASK_APP=blogin
   FLASK_ENV=development

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

3. 创建并激活虚拟环境

   由于每个项目的依赖都不一样，Python提供了虚拟环境工具来隔离每个项目的依赖，使用如下命令进行虚拟环境创建。

     cd Blogin
     python3 -m venv venv

   然后使用如下命令进行虚拟环境激活。

   source venv/bin/activate

   在Windows下激活

     venv\Scripts\activate

4. 安装Python依赖

   我们进入了虚拟环境以后可以使用如下命令安装第三方依赖

     cd Blogin
     pip install -r requirements.txt -i https://pypi.douban.com/simple

5. 初始化数据库

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

   cd Blogin
   # 初始化数据库以及相关配置
   flask initdb
   # 创建管理员账号
   flask admin

6. 运行

   flask run

   打开 http://127.0.0.1:5000 就可以看到页面了。

7. issue

   如果在运行过程中有任何问题出现，欢迎issue~