Ghost 博客升级记录 0.x to 1.x

其实知道 Ghost 已出 1.x 有段时间,可是一直没有时间折腾。毕竟旧版本的也还好。。。

1.x 比较值得去升级的原因主要有两个吧,一是 MD 编辑器的升级,二是配套了 CLI 工具(默认支持后台启动,升级也不再需要手动替换文件)。升级之后,感觉速度方面也明显有提升,建议升级。


升级流程

在升级前先读读这两篇官方文件

具体步骤如下:

  1. 登录原 Ghost 导出所有数据并保存 JSON 到本地

  2. 关闭原 Ghost 服务(如果使用不同的端口,可以不关闭)

  3. 服务器安装 Ghost-CLI

    使用 npm 安装

     npm i -g ghost-cli@latest
    

    使用 yarn 安装

     yarn global add ghost-cli@latest
    
  4. 新建一个新的目录用来存放新版 Ghost

     mkdir newghost
    
  5. 进入该目录并执行自动安装

     cd newghost
     ghost install
     // 如果您的服务器系统不是ubuntu,那我建议使用 local
     // 因为非 ubuntu 不使用 local 可能会出错(本人就是例子),使用 local 也很方便,只是 config 文件需要后面自己修改,相对不够傻瓜而已
     // 如果安装失败了,运行 ghost uninstall 可以回滚
    
  6. 若需配置,请先关闭服务,并修改 config.production.json,请参考:官方说明

     ghost stop
    

    其他环境配置与 Ghost 0.x 相同,不需要做改变

  7. 复制旧版本目录下的 content/images 到新版本目录下

  8. 生产运行

     NODE_ENV=production ghost start
    
  9. 上传主题,新版本使用 zip 文件的方式

    由于我用的是自己的主题,所以需要针对字段名称的变化进行修改(上传时会有非常详细提示)

  10. 导入数据

至此,升级就算完成了


需要注意的坑

  1. 现在主题的package.json用途更广,比如页容量posts_per_page参数就需要在package.json中设置,参考官方文档

  2. 如果你的主题使用{{id}}作为评论的identifier,那么就要注意,新版 Ghost 下{{id}}指的是,非自增ID,所以修改主题,使用{{comment_id}},这样旧版本的评论才能对应回来

参考:https://farer.org/2017/07/29/migrating-to-ghost-1-0/
https://xratzh.com/2017/08/08/Ghost0.11.11%E5%8D%87%E7%BA%A71.0.0%E4%BD%93%E9%AA%8C%E6%8A%A5%E5%91%8A/

若您觉得我的博文对您有帮助,欢迎点击下方按钮对我打赏
打赏