Bro Qiang 博客

示例： broqiang.com （正在使用）

需求

go 语言为主的博客
博客放在我自己服务器上
博客展示的是 markdown 文档
博客的原始文件（ *.md 文件）放在 github 上，直接 github 直接更新文件，博客同步更新

按照上面的需求，最终就是一个静态动态结合的博客，完成后就是本博客了。大体的思路是这样的，在 github 上创建一个专门用来保存 .md 文件的仓库 blog-docs，将这个仓库 clone 到本博客项目的一个目录下（可以通过配置放在任意目录）。然后启动本博客系统，来解析 markdown 文本文件，用来展示。当 blog-docs 文件仓库更新时，博客系统运行的内容自动更新。

依赖

Go 语言的依赖

go 版本是 go1.12 linux/amd64 ，其他版本未测试。
golang/dep 用来管理 go 中的依赖
gin-gonic/gin 引擎及路由
BurntSushi/toml 用来处理 toml 格式的配置文件
russross/blackfriday 用来将 markdown 文本转换成 HTML 使用的是 1.5.2 版本。
microcosm-cc/bluemonday HTML清理程序，配合 blackfriday 来处理 markdown 的转换。

前端的依赖

nodejs 因为前端 scss 和 js 的编译是依赖于这个
laravel-mix 相当于一个 webpack 的包装器，用来管理前端静态资源，以前用 Laravel 框架的时候觉得这个用来管理前端的内容很顺手，试了下，原来可以单独使用，就用了。
jquery 因为 Bootstrap 依赖它。
bootstrap 前端框架，用于页面展示。
sindresorhus/github-markdown-css markdown 文档的样式使用的这个 css
highlightjs/highlight.js markdown 代码块高亮使用的此插件

环境

开发环境 Ubuntu 18.04
服务器环境 CentOS 7.6

其他环境没有测试过，不确定是否兼容（如 Windows、MAC），后面的所有步骤都假定是在 Linux（上面两种系统）下完成。

编译

编译需要编译两部分的内容，前端（webpack）和 Go 。

Go 编译

编译前要保证已经正确安装了 Go 环境，并配置好环境变量， GOROOT 和 GOPATH

安装 dep

这个是一个官方的依赖管理工作，见 https://github.com/golang/dep ，有详细的介绍和安装步骤。

安装

go get -u github.com/golang/dep/cmd/dep

然后执行下面命令，查看结果，如果有下面类似的结果证明安装成功

$ dep version
dep:
 version     : devel
 build date  :
 git hash    :
 go version  : go1.12
 go compiler : gc
 platform    : linux/amd64
 features    : ImportDuringSolve=false

安装博客

这是要指定目录，因为 GOPATH 的引入着这样做的，如果想要换成其他目录，需要同时修改包的导入路径。

# 创建项目保存的目录
mkdir $GOPATH/src/github.com/broqiang

# 进入到目录
cd $GOPATH/src/github.com/broqiang

# 下载项目
git clone https://github.com/BroQiang/mdblog.git

# 初始化项目（恢复依赖）
dep ensure

修改配置文件

需要将项目 mdblog 目录下的 config/config.example.toml 复制一份

cd yourpath/config
cp config.example.toml config.toml

然后根据需要修改下配置，在配置文件中有详细的注释，说明每一个配置是用来做什么的。

启动服务

go run 方式：

这种方式一般就是开发时候使用，编译后的文件会生成在临时目录，所以一些静态文件会找不到，所以这里要传入一个参数，告诉程序项目根目录在哪里。

# 可以指定目录（要绝对路径），$(pwd) 就是当前所在目录的绝对路径
go build -root=$(pwd)

此时就可以访问了，如配置文件默认的 8091 端口，在浏览器访问 http://localhost:8091

go build 编译方式:

# 编译
go build blog.go

# 运行
./blog

# 或通过绝对路径运行
/yourpath/blog

使用编译后的二进制文件启动服务的话，默认的项目根目录就是可执行文件所在的目录，如果目录结构没有改变的话可以不用传入 -root 参数，如果改变了，静态文件和可执行文件不在相同的目录，仍然需要在启动的时候传入 -root= 参数。

前端资源编译

如果只是使用本博客，不需要自定义 css 和 js 等，可以略过此步骤。

编译前要保证已经安装了 npm 环境，因为 npm 有些慢，我使用的 yarn 来初始化前端依赖（npm 仍然需要安装）

这里使用了个 laravel-mix 来统一管理静态资源（个人觉得比较方便，不喜欢的可以随意替换）。

配置文件：

config/webpack.mix.js

这里也没做什么特殊的事情，就是将所有的 scss 和 js 分别打包成一个单一的文件

打包前的文件保存在 resources/assets ，分别存放了 scss 文件和 js 文件

编译后的文件存放在 resources/static 中，这个是项目真实使用的静态文件目录，对应的 http 方式的访问路径是 /public