搭建一个属于自己的免费个人博客

前言

  近些年,随着 Markdown 的蓬勃发展,越来越多地支持 Markdown 语法的在线编辑器和托管服务提供商出现。比如国外的 Read the DocsGitbook 等等,国内的 看云 等等。这种方式的好处主要有几点:

当然,这种方式也会有一定的缺点:

  个人觉得比起搭建博客这类方式更适合搭建文档,比如说写产品文档、API 文档等等,而且其导出 PDF 的特点更加适合需求。

体验与评价

Read the Docs

登录

访问 Read the Docs 点击登录按钮,这里支持直接使用 Github 登录(推荐)。

vgy.me

vgy.me

导入项目

由于是 Github 方式登录,可以直接从 Github 中导入项目,如下图所示。

vgy.me

点击右侧加号按钮完成导入。

vgy.me

vgy.me

预览项目

  由于这里导入的项目是 Jekyll,所以 Read the Docs 无法对其进行编译并显示预览页面。事实上,如果将 Jekylll 换成 Mkdocs,会发现能够通过编译并在线预览成功,但是 PDF 生成还是会有问题。所以最好的就是在 Github 建一个空的项目,将空的项目导入到 Read the Docs 中即可。

  其实,Read the Docs 还不能算得上是完整的在线编辑平台,毕竟它不提供所谓的 Online Editor。我们仍然需要使用 Github 自身提供的在线编辑功能,或者利用本地编辑器 Typora 这样的编辑然后上传更新到 Github。当然,如果 Github 的内容发生了更新,Read the Docs 将会拉取最新的内容进行编译并激活预览。

Gitbook

登录

访问 Gitbook ,可以选择 Sign Up With Github 进行快速注册。

vgy.me

创建项目

点击 create a new space 按钮,输入项目名称完成创建。

vgy.me

导入内容

  如下图所示,可以直接导入 Markdown 文件。由于本站是采用 Jekyll 静态生成器的,所有只需将 _posts 目录下的 Markdown 文件全部拖拽到这里导入即可完成 Gitbook 的转换。

vgy.me

vgy.me

预览项目

Gitbook 采用的是 https://用户名.gitbook.io/项目名/ 的方式预览,当然也支持自定义域名。

评价

  Read the Docs 与 Gitbook 相比,后者支持完整的在线编辑功能和自定义主题功能,操作也略显复杂,前者则只负责编译生成和托管页面,不具有编辑能力。从笔者个人角度来看, Read the Docs 的方式更加方便快捷,操作性强,而 Gitbook 复杂的操作让本来编辑内容的时间都花在了一步一步的操作上了。虽然两者都支持 PDF 导出功能,但是 Read the Docs 导出的 PDF 格式更加像是一本电子书,排版精美,而 Gitbook 则是普通的格式。另外,在网页预览上,Gitbook 则更加大方、美观,比 Read the Docs 更具现代感,两者优势各异。当然也可以同时使用两种,取长而用。