Kuma:更新后的编辑器体验

我们将从 7 月 5 日开始部署新的 Kuma wiki,其编辑体验与您习惯的体验差别不大,但有一些关键差异我想重点说明。

进入编辑器

首先,让我们看看进入编辑器的方式有哪些不同。使用 BrowserID 登录后,您仍然会在右上角看到您熟悉的老朋友“编辑”按钮,与往常一样。

主编辑按钮的屏幕截图您可以简单地点击那个大大的蓝色“编辑”按钮开始编辑整个页面。很简单!但是,如果您愿意,也可以只编辑单个部分。每个标题行在其右侧都有一个自己的编辑按钮,如下所示

Screenshot of the section editing button.

点击部分标题右侧漂亮的蓝色“编辑”按钮,将打开该部分专用的编辑器。

更改页面信息

进入编辑器后,您可以编辑内容和页面信息。在左上角,您可以看到页面的标题。

Screen shot of the heading box.

点击“i”图标,您可以访问编辑页面元数据的功能。

Screen shot of the metadata editor.

然后,您可以编辑页面的标题(即显示为单个页面标题的文本)和 slug(即父页面下方的 URL 组件(您无法编辑;为此有一个单独的移动功能))。

“TOC”复选框允许您切换页面是否显示其标题的目录。

保存和预览

然后,在编辑器屏幕的右上角,您会看到以下按钮。

Screen shot of the bar of save/discard options.

这些按钮非常直观。第一个按钮允许您在不离开编辑器的情况下保存更改;这是一个我们期待已久的特性,终于实现了。第二个按钮保存您的更改并关闭编辑器。

“预览更改”按钮实际上会打开一个新标签页,显示页面的预览。我们终于,**终于**,能够在保存编辑之前仔细检查脚本模板的使用情况了。这对我们来说意义重大!

最后,“放弃更改”按钮允许您丢弃您的编辑。希望这一点非常明显。

编辑

编辑器本质上与我们一直以来在 MDN 上使用的 CKEditor 相同,尽管它是一个更新的版本。我们的大多数键盘快捷键与之前相同。最显著的区别是,Ctrl-S 不再切换源模式;相反,它执行“保存更改”。

我们所做的一件事是重新设计了工具栏,使其更适合我们所做的工作类型。

Screen shot of the MDN editor's toolbar.

与之前相比,工具栏进行了重新组织,减少了不必要的按钮。工具栏下方是块层次结构栏;它显示了导致您当前光标位置的元素层次结构。例如,这有助于了解您所在的标题级别或列表嵌套的深度等。

我们现在还提供了方便的标题级别按钮,以及一个用于预格式化文本的按钮。在 <pre> 按钮右侧,有一个菜单,当您的光标位于 <pre> 块中时打开,它会显示语法高亮语言选项列表。

Screen shot of the MDN syntax highlighting popup.

此列表比旧列表简单得多,当然也更容易阅读!

样式下拉菜单与旧菜单非常相似,包含我们经常使用的各种样式。

样式下拉菜单的屏幕截图。标记文章

目前,标记文章的唯一方法是在编辑器屏幕内进行。这将在某个时候发生改变,但目前,您可以在编辑页面的底部找到标签编辑器。

Screen shot of the MDN tag editor.

您可以通过点击每个标签框中的“X”删除标签,或者通过简单地点击标签列表右侧并开始输入来添加新标签。

存在一个错误,导致无法输入名称中包含空格的标签。希望在部署 Kuma 之前能修复此问题。

请求审查

我们正在构建一个新的正式审查系统。虽然跟踪审查的所有支持尚未到位,但您可以使用编辑页面底部的复选框来创建审查请求。

Screen shot of the review checkboxes.

对于新文章,技术和编辑审查请求默认情况下都已启用。您可以根据您所做的更改类型和数量(当然还有您对工作的信心!)来设置或清除这些请求。

“模板”审查请求用于指示模板已更改并需要代码审查。这不会影响很多人,因为出于安全原因,模板编辑现在受到比大多数编辑更严格的权限限制。

继续前进

我们将继续改进未来的编辑体验,使其变得更好。我们有很多事情要做,让 Kuma 变得更棒!

在接下来的几天里,我将分享 Kuma 提供的新本地化工具。它们还没有完成,但它们已经比我们旧系统(也就是说:根本没有)好得多。

关于 Eric Shepherd

在我的职业生涯早期,我是一名电脑游戏程序员;如果您搜索由 Interplay/MacPlay、MGM Interactive 和 Logicware 等公司发布的鲜为人知的 Mac 游戏,您会看到我的名字。最终,这项工作变得枯燥,我成为了一名技术作家。现在,我是 Mozilla 的开发者文档团队负责人。

更多 Eric Shepherd 的文章…


4 条评论

  1. ziyunfei

    酷!

    2012 年 7 月 2 日 07:30

  2. Dmitry Pashkevich

    我可以获得 Kuma wiki 的副本吗? :)

    2012 年 7 月 3 日 06:15

    1. John Karahalis

      可以!Kuma 软件完全免费且开源。您可以从 GitHub 克隆您自己的副本。

      https://github.com/mozilla/kuma

      如果您想试用 Kuma,请参阅以下关于在您的计算机上设置 Kuma 的文档。

      https://github.com/mozilla/kuma/blob/mdn/README-vagrant.md

      2012 年 7 月 3 日 10:37

      1. Dmitry Pashkevich

        太棒了,谢谢!

        2012 年 7 月 4 日 04:13

本文评论已关闭。