美文网首页
关于博客迁移说明

关于博客迁移说明

作者: anyesu | 来源:发表于2019-03-10 01:22 被阅读0次

    背景


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

    传送门: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 会限流,需要做优化

    最后


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

    相关文章

      网友评论

          本文标题:关于博客迁移说明

          本文链接:https://www.haomeiwen.com/subject/yzmypqtx.html