背景
经历过几次 莫名其妙 的被 封号 / 锁文章 之后突然意识到,如果有一天 简书 这个平台倒了,那么这些积累的文章可能就化为乌有了,所以就有了迁文章的想法。
传送门:https://github.com/anyesu/blog/issues
当然,也可以访问这个域名:https://anyesu.github.io
新平台选择
本来,写文章只是记录和分享一些经验,以作为技术博客的,所以也没打算换其他花里胡哨的平台。但是,如果自己搭建一个个人博客还要选框架、选主题、买服务器、买域名,还要自己维护,麻烦的不行。无意间发现还有在GitHub issue 上写博客的操作,试了下真的不错,是个天然的博客系统:
- [x] 一个 issue 就是一篇文章
- [x] 天然的评论系统,方便做技术上的探讨,而且能评论的人或多或少懂一些基础知识
- [x] 支持 Markdown 语法,支持预览效果
- [x] 可重复编辑,可查看版本变更记录
- [x] 可以添加标签对文章分类,可以置顶
- [x] 可以订阅,可以接收到邮件通知
- [x] 文章中涉及到的代码可以直接放到对应的仓库下
- [x] 可以点赞,发 emoji 图标
- [x] 可以使用 GitHub 提供的 API ( v3 / v4 ) 抓取数据,就不用自己再去造数据存储的轮子了
- [x] 简洁
当然,不足之处也有:
- [ ] 没有独立域名,不能自定义样式
- [ ] 不能限制其他人随意发 issue
- [ ] 虽然可以订阅,但是使用不当也会产生很多噪音
- [ ] 不利于推广和分享,不是圈内人估计是看不到了,随缘吧
对于我来说,作为技术博客,更应该关注内容的输出而不是其他花里胡哨的东西,所以权衡之后这个方案还是利大于弊的。
迁移过程
新建一个仓库,在里面添加 issue 就可以开始创作了,这里就不讲这些细节了。
由于 简书 的 Markdown 方言不是很标准,之前为了展示效果做了些特殊处理,直接拷贝内容到 GitHub 上就会发现各种样式错乱,所以需要先重新整理下。这里,我推荐一个编辑器 - typora,把文章内容拷到编辑器上编辑后再发布到 GitHub 上看效果,顺便把 简书 也更新下。
文章同步好,之后就是阅读了,这里推荐一个 Chrome 插件 - 简悦,具体效果自行体会吧。
自定义 UI 界面
上面提到一个样式的问题,这里我就拿别人现成的模版 - Blogsue 先用着,步骤如下:
# 下载项目
git clone --depth=1 https://github.com/coderming/blogsue.git blog
# 进入项目
cd blog
# 自行编辑配置文件 index.js 修改其中的配置
cp src/config/index-example.js src/config/index.js
# 安装依赖
npm install
# 构建
npm run build
# 运行
docker run --name=blog -d -p 8080:8080 -v `pwd`:/app node:alpine sh -c "node /app/scripts/prod-server.js"
这个项目自身提供的 Docker 部署方式是在镜像中 构建 项目的,如果修改了配置又要重头开始 构建 了,考虑到 npm 的速度,还是推荐在容器外 构建,然后用纯粹的 node 镜像来启动:
docker run --name=blog -d -p 8080:8080 -v `pwd`:/app node:alpine sh -c "node /app/scripts/prod-server.js"
如果不想安装 node 可以使用 Docker 的 node 镜像来代替,比如:
docker run -it --rm -v `pwd`:/app node:alpine sh -c 'cd /app && npm config set registry "https://registry.npm.taobao.org/" && npm install'
注意:一些低配服务器可能会出现 IO 卡死的现象
这个项目风格比较简洁,配置起来也比较简单,还接入了 Gitalk 评论系统,算是比较完整了,不过还是有一些问题需要改进,等后面有空了再自己写一个吧。
关于域名
买域名的话还要买服务器,国内的域名还要备案,也没空去折腾,先用着 GitHub 送的免费域名 GitHub Pages。原理的话,可以理解为 GitHub 提供一个 web 服务器 ( 比如 Nginx ),然后将给你的 三级域名 解析到对应的目录下,也就是你的代码仓库。
接着上面 构建 的步骤:
# 进入项目的构建目录,就是把里面的静态文件上传到 GitHub 仓库中
cd build
# 初始化本地 Git 仓库
git init
# 设置用户名 ( 在 git log 中显示)
git config user.name xxx
# 设置邮箱 ( 在 git log 中显示)
git config user.email xxx@email
# 设置换行符转换方式,以 LF 格式保存到仓库中
git config core.autocrlf true
# 将当前目录下所有文件加入到版本控制
git add --all
# 提交文件到本地仓库并备注为 init
git commit -m "init"
# 添加远程仓库 ( 需要在 GitHub 上先新建一个仓库:xxx.github.io )
git remote add origin https://github.com/xxx/xxx.github.io.git
# 将本地仓库推送到远程仓库
git push -u origin master
执行完上面的步骤,浏览器访问 https://xxx.github.io 看下效果。
需要注意的地方:
-
仓库里放静态文件 ( html / js / css / 图片 ),因为不提供额外的服务器去执行代码,所以动态脚本就免了
-
如果你的用户名为 xxx ,你的仓库名为 blog,那么对应的 url 为 https://xxx.github.io/blog,如果想要对应到根路径 / 下,需要新建一个名为 xxx.github.io 的仓库
-
由于使用静态页面,每个文件对应一个 url ,但是由于文章内容不属于仓库文件的一部分,所以每篇文章不能拥有独立的 url ,需要实现 hash 模式 的前端路由,像上面用到的 Blogsue 使用 history 模式 的前端路由,页面跳转是没有问题的,刷新页面就会 404 了
TODO
- [ ] 写个工具来做自动同步,在 简书 上新增编辑文章,然后定期同步到 GitHub
- [ ] 自己写一个 UI 界面
- [ ] 独立的域名和服务器
- [ ] GitHub 的 API 会限流,需要做优化
最后
来 简书 几年了,最初的时候真的是博客界的一股清流,但是现在体验却越来越差了。界面一成不变,反馈没动静,投稿几个月不审核,净弄些花里胡哨的东西,现在还会乱封号,也不说明原因,另外,各种 鸡汤 和 标题党 泛滥。作为内容平台,我对这种运营模式不做评判,但是作为技术博客,显然已经有些脱轨了,也差不多是时候说再见了。
网友评论