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 最终版本中实现的一些功能:
- 招聘一个 新的代码贡献者,帮助实现 主题对 i18n (翻译) 的支持。