关于博客迁移说明

背景


经历过几次 莫名其妙 的被 封号 / 锁文章 之后突然意识到,如果有一天 简书 这个平台倒了,那么这些积累的文章可能就化为乌有了,所以就有了迁文章的想法。

传送门: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 可以使用 Dockernode 镜像来代替,比如:

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,那么对应的 urlhttps://xxx.github.io/blog,如果想要对应到根路径 / 下,需要新建一个名为 xxx.github.io 的仓库

  • 由于使用静态页面,每个文件对应一个 url ,但是由于文章内容不属于仓库文件的一部分,所以每篇文章不能拥有独立的 url ,需要实现 hash 模式 的前端路由,像上面用到的 Blogsue 使用 history 模式 的前端路由,页面跳转是没有问题的,刷新页面就会 404

TODO


  • [ ] 写个工具来做自动同步,在 简书 上新增编辑文章,然后定期同步到 GitHub
  • [ ] 自己写一个 UI 界面
  • [ ] 独立的域名和服务器
  • [ ] GitHubAPI 会限流,需要做优化

最后


简书 几年了,最初的时候真的是博客界的一股清流,但是现在体验却越来越差了。界面一成不变,反馈没动静,投稿几个月不审核,净弄些花里胡哨的东西,现在还会乱封号,也不说明原因,另外,各种 鸡汤标题党 泛滥。作为内容平台,我对这种运营模式不做评判,但是作为技术博客,显然已经有些脱轨了,也差不多是时候说再见了。

推荐阅读更多精彩内容

  • 不知道为什么部分图片上传失败,一直上传不成功,如果有需要大家可以去我的小站观看 背景 作为一个开发者不能没有博客,...
    茉莉儿阅读 808评论 3 8
  • 记得《老友记》里莫妮卡向钱德勒单膝下跪 问了他Will you marry me,当时只觉得浪漫以及适合莫妮卡的人...
    妤和阅读 154评论 1 2
  • 今天偶然看到一篇关于工作的文章,细细数来,这是我工作的第七个年头了。 2010年6月研究生毕业后,在一个做研究的公...
    瓜瓜猫阅读 24评论 0 0
  • 思维分类 Grace在讲课的过程中列举了一系列的优点和缺点,如优点:1.让自已的条理更清晰。2.当你很忙、工作很多...
    AllfeHuang阅读 23评论 0 0
  • 生活之静 修养生息 回归内在 和平喜悦 恬静安详 生活之动 心惊肉跳 山崩地裂 喜怒哀乐 穿越生死 静动之间 成其...
    悠悠思悦阅读 160评论 3 3