关于¶

茂盛的博客¶

about

目前，我维护着两个博客，分别是doctor_key和茂盛。doctor_key托管在lofter平台上，茂盛托管在腾讯云开发者平台。

博客创建记录¶

腾讯云开发者平台为用户提供coding-pages服务，该服务类似于github的github pages。具体的，用户可以将静态网页打包上传到腾讯云开发者平台，由腾讯云开发者平台将静态网页显示出来，其他人可以通过URL链接访问这些静态网页。

对于用户来说只需要制作静态网页即可。静态网页的制作涉及到html，css等，流程比较繁琐。为了减少我的负担，我采用静态网页生成工具。我只需要写markdown文件和一些简单的配置文件，即可使用静态网页生成工具生成html网页。较流行的静态网页生成工具有jekyll、hexo等等，我采用了MkDocs。这里有一份基于mkdocs-material搭建个人静态博客教程。

MkDocs¶

MkDocs是项目文档工具。允许用户使用mkdown写文档，用该工具生成静态网页。

mkdocs由python实现。

安装mkdocs¶

首先需要安装python。见python的官方网站

打开终端，使用pip安装mkdocs:

$ pip install mkdocs

使用mkdocs¶

新建一个项目，并进入项目目录：

$ mkdocs new my-project
$ cd my-project

启动内置服务器，本地预览文档：

$ mkdocs serve

在浏览器中打开http://127.0.0.1:8000/

生成静态网页：

$ mkdocs build

执行完命令后，会生成site文件夹，里面包含静态网页。

将静态网页提交到git的其他分支。在github中，需要将网页（即site文件夹内的文件）提交到gh-pages分支。在tencent的开发者平台中，需要将其提交到coding-pages分支。这里以tencent的开发者平台为例，执行以下命令：

$ mkdocs gh-deploy -b coding-pages

该命令先会清空site文件夹，然后重新生成该文件夹。命令执行结束后，会将其提交到coding-pages分支，并且push到远程仓库。

material¶

material是mkdocs的一款主题。

安装material¶

同样使用pip安装：

$ pip install mkdocs-material

使用material¶

在mkdocs.yml中添加以下设置：

theme:
    name: 'material'