2023-09-07 10:16:21
# markdown静态博客搭建综述
# 一 说明
使用markdown写文档，搭建自己的个人博客。纯前端展示，不需数据库，不需后端编程交互。
选择市场上比较知名的静态博客搭建程序，对照比较，综合评价。
# 二 软件
# 2.1 docsify
docsify 可以快速帮你生成文档网站。不同于GitBook、Hexo的地方是它不会生成静态的 .html 文件，所有转换工作都是在运行时。
布署文档：git平台docsify布署markdown文件 (opens new window)
| 名称 | 仓库 | 备注 |
|---|---|---|
| plain-docsify | gitlab plain-docsify (opens new window) 网页 (opens new window) github plain-docsify (opens new window) 网页 (opens new window) | 笔记docsify |
| myblog-docsify | gitlab myblog-docsify (opens new window) 网页 (opens new window) github docsify-blog (opens new window) 网页 (opens new window) | 笔记与博客docsify |
# 2.2 mkdocs
在git平台创建mkdocs主题仓库，自动将markdown文件生成静态网页。
布署文档：gitlab、github、gitee布署mkdocs主题仓库 (opens new window)
| 仓库 | 地址 | 备注 |
|---|---|---|
| gitlab | plain-mkdocs (opens new window) 网页 (opens new window) plain-pip-mkdocs (opens new window) 网页 (opens new window) plain-mkdocs-gitbook (opens new window) 网页 (opens new window) | gitlab布署mkdocs：配置文件.gitlab-ci.yml。 |
| github | plain-mkdocs (opens new window) 网页 (opens new window) plain-pip-mkdocs (opens new window) 网页 (opens new window) plain-mkdocs-serve (opens new window) 网页 (opens new window) | github布署mkdocs：命令mkdocs gh-deploy 。 |
| gitee | plain-mkdocs (opens new window) 网页1 (opens new window) 网页2 (opens new window) 网页3 (opens new window) | gitee布署mkdocs：mkdocs build 布署目录。 |
| note-mkdocs | gitlab note-mkdocs (opens new window) 网页1 (opens new window) 网页2 (opens new window) github note-mkdocs (opens new window) 网页 (opens new window) gitee plain-mkdocs (opens new window) 网页 (opens new window) | 个人笔记，含书法练习及java笔记。 |
| myblog-mkdocs | gitlab mkdocs-blog (opens new window) 网页 (opens new window) gitee myblog-mkdocs (opens new window) |
# 2.3 gitbook
GitBook可以看作个人的一本电子书。它用MarkDown编写，可以自动生成网页或者PDF等，生成网页可以通过插件配置目录和搜索功能等。
布署文档：gitbook部署博客 (opens new window)
应用：
https://scott180.github.io/gitbook-blog/
https://github.com/scott180/gitbook-blog
# 2.4 vuepress
Vue 驱动的静态网站生成器
官网： vuepress (opens new window) vuepress-next (opens new window)
应用： github (opens new window) vuepress-blog (opens new window)
布署文档：vuepress构建项目 (opens new window)
# 2.5 vuepress-theme-reco
一款简洁而优雅的 vuepress 博客 & 文档 主题。
官网：vuepress-theme-reco (opens new window) vuepress-reco (opens new window)
应用：github (opens new window) reco-blog (opens new window)
布署文档：vuepress构建项目：vuepress-theme-reco (opens new window)
# 2.6 others
Github Pages
GitHub Pages 是 GitHub 提供的一项免费服务，它可以让用户轻松地创建自己的静态网站。
地址： https://github.com/scott180/calligraphy
应用： https://scott180.github.io/calligraphy
使用方法：Settings -- Pages -- Branch - Master -- Save
gitlab/gitee 也有类似的静态页面功能。 gitlab_pages (opens new window) gitee_pages (opens new window)
netlify
Netlify 是一家位于旧金山的云计算公司，为用户提供Web 应用程序和动态网站构建、部署和无服务器后端服务。
地址： netlify (opens new window) netlify-calligraphy-nextjs (opens new window)
应用： nextjs (opens new window) artisan (opens new window)
Netlify Next.js Blog Template designed by Bejamas
Vercel
Vercel是一个专注于静态站点部署和服务器端渲染的云平台。
地址： vercel (opens new window)
应用： docusaurus2 (opens new window) portfolio (opens new window)
另外有 Hexo (opens new window)/Hugo (opens new window)/Jekyll (opens new window) 也可建站。
# 三 综述
操作感受
Hexo (opens new window)/Hugo (opens new window)/Jekyll (opens new window) 功能很强大，但是操作不太简单，上手难度有点高。
netlify (opens new window) / vercel (opens new window) 国外网站，不是太稳定。常常访问不了网站。
docsify/mkdocs/gitbook 这三个比较类似，布署简单，但是主题也单调简约，插件不是很多。
vuepress (opens new window)/vuepres-theme-reco 非常优秀的静态博客搭建方法，界面美观，功能齐全。就是安装布署的时候可能会有版本兼容问题。
另外在github/gitlab/gitee 的平台上搭建好静态博客，如要绑定域名，可查看文档：gitlab、github绑定自定义域名 (opens new window) 。
我的网站
生活随笔-编程笔记-书法练习轨迹
| 徐书法 | 地址 | 备注 |
|---|---|---|
| 1 | xushufa (opens new window) | vuepress-theme-reco构建的博客网站。 |
| 2 | vuepress-blog (opens new window) | vuepress构建的博客网站。 |
| 3 | mkdocs-blog (opens new window) | mkdocs构建的博客网站。 |