Ghost 开源博客平台

Ghost 是一个简洁、强大的写作平台。你只须专注于用文字表达你的想法就好,其余的事情就让 Ghost 来帮你处理吧。

1.0.0 Beta 版本发布啦!!!

经过 21 个 alpha 版本的迭代,我们终于迎来了第一个 1.0 beta 版本!

请查看先前的博文以了解 1.0 和 LTS 版本之间的差异。 对于 LTS 版本的官方支持将于 2017 年 8 月 31 号结束。

如何安装 beta 版本?

官方推荐通过 Ghost-CLI 安装 Ghost 1.0 beta ,不过,现在还不太适合用于生产环境。

我们在 先前的一篇博文 中已经列举了官方推荐的系统环境。我们也将很快为 CLI 开发能够自动设置 NGINX 和 SSL 的功能,听上去是不是很酷?

我们还撰写了一篇 Ghost CLI 安装指南 ,详细讲解了如何通过 CLI 安装 Ghost。

从 LTS 迁移到 1.0 beta

我们撰写了一份 1.0 版本迁移指南 详细说明如何从 LTS 迁移到 1.0 beta。基本步骤是:通过 CLI 安装 1.0 beta,然后在管理后台导出 LTS 数据库并导入到 1.0 系统中。

非兼容性变化

下面列出的是 最重要的非兼容性变化。

docs.ghost.org

我们删掉了 Github wiki 并禁用 support.ghost.org 网址,所有文档都迁移到 https://docs.ghost.org 了。将所有文档都集中到一个地方非常方便。这些文档针对的是自己托管 Ghost 博客的用户、主题开发者和贡献者,如果您发现任何丢失的内容,请通知我们!

新的文档托管在 readme.io 上,所以如果您发现不正确的或混淆的地方,请通知我们。

新的文档是分版本的,目前有两个版本,一个是 v0.11.9 (LTS) 版本,另一个是 v1.0.0 beta 版本。

一个新的编辑器

Ghost 1.0 目前仍然只提供了一个 markdown 编辑器(虽然为了将来的可扩展性,在内部是保存为 mobiledoc 格式),但是并不意味着编辑器的体验停止不前。

关键改变:

  • 有工具条了!
  • 编辑区直接展示格式化内容,并且不再展示预览区,改善了混乱的编辑体验(别担心,markdown 预览仍然是有的)。
  • 图片上传直接从工具条上就可以实现,或者将图片拖拽到编辑区也可以(当然,多图上传也支持!)。
  • 现在是基于 markdown-it 转换 markdown 了,舍弃了老旧的 Showdown,从而避免了许多烦人的 markdown 转换方面的 bug 。

1.0 的主题

如果你导入的是一个能够在 0.11.9 上正常工作的主题,有可能在 1.0 上不起作用了,因为主题 API 有一些不兼容的改变。好消息是大量主题正在针对 1.0 做适配。

为了改善迁移体验,当你上传主题到 Ghost 1.0 beta 时,如果导入失败,将展示详细的错误信息。

作为一个主题开发者,你可以使用 gscan 来检测你的主题,从而了解需要做哪些修改才能够在 1.0 beta 上正常工作。

下面列出了主要变化:

  • package.json 文件是必须的,并且必须包含有效的名称(name)、版本(version)和作者邮箱(author email address)信息。请参考 (文档)
  • {{image}} 助手被删除了
  • 因此我们添加了 {{img_url}} 助手 (文档在这里)
  • {{pageUrl}} 助手被改名为 {{page_url}} (文档在这里)
  • {{meta_description}} 不允许再放在 <head> 里了
  • 使用 @config.posts_per_page 代替 @blog.posts_per_page
  • 可以在主题的 package.json 中定义 posts_per_page (文档在这里)
  • {{content words="0"}} 不再起作用了,请使用 {{img_url}}
  • 某些 css 类名改名了 (文档在这里)

请参考 1.0 主题开发文档

基于 nconf 的配置文件

老旧的 config.js 文件将不再使用,取而代之的是 nconf 作为配置管理工具。

请参考 配置文档 或者 先前的博文 了解如何使用 nconf 。

存储适配层

存储适配层的存放位置改变了,并且添加了合适的 class 继承。适配层基础类(base adapter)被提取出来并形成一个独立的 npm 模块,源码地址在这里

如果你以前就在使用定制的存储适配层,很不幸,不能用了。请等待维护人员升级到 1.0 版本吧。

详细信息请参考 这里

一个新的迁移工具

在 1.0 之前,数据库填充和迁移都是在 Ghost 内核中实现的。在新版本中,代码逻辑被提取出来 并组织成一个独立的 npm 模块。

将来 Ghost 1.0 正式版发布后,Ghost CLI 将负责所有数据库升级,你将不必执行任何额外命令了。

不过,考虑到用户手动重新初始化数据库或者测试新的迁移工具的情况,请参考这份文档

招 Beta 版本测试员

我们非常欢迎 beta 版本测试员,也欢迎提交任何反馈。如果您发现了 bug,请在 Github 仓库 提交 issue。如果您在安装 1.0 beta 是遇到任何问题或困难,请到 slack 频道 交流。

下一步?

1.0 官方版本的发布依赖于 beta 期间所收到的 bug 和反馈数量。我们会尽快发布正式版,以便集中精力在下一个版本上,因此,如果您有时间的话尽量多帮我们测试!

在 beta 版本中并未被砍掉,并且希望在 1.0 最终版本中实现的一些功能:


原文地址:https://dev.ghost.org/1-0-0-beta/

王赛
关于作者 王赛