Atom飞行手册中文版.doc

目录

Atom飞行手册中文版 4

1.新手入门 5

1.1为什么选择Atom？ 5

1.2安装Atom 6

1.3Atom基础 17

1.4小结 28

2.使用Atom 28

2.1Atom中的包 28

2.2在Atom中移动 31

2.3文本选择 34

2.4编辑和删除文本 35

2.5查找和替换 41

2.6代码段 43

2.7自动补全 48

2.8折叠 50

2.9面板 51

2.10语法 51

2.11Atom中的版本控制 53

2.12在Atom中写作 58

2.13基本的自定义 61

2.14小结 69

3.HackingAtom 69

3.1所需工具 69

3.2初始文件 70

3.4文本处理包 71

3.5创建主题 75

3.6图标 82

3.7调试 82

3.8编写spec 89

3.9从Textmate中转换 92

4.在Atom背后 94

4.1配置API 94

4.2深入键表（keymap） 95

4.3作用域设置、作用域和作用域描述符 99

4.4Atom中的序列化 101

4.5开发Node模块 103

4.6通过服务和其它包交互 103

4.7维护你的包 105

4.8小结 109

Atom飞行手册中文版

1.新手入门

1.1为什么选择Atom？

这个世界上有那么多种编辑器，为什么你要花时间学习和使用Atom呢？

虽然Sublime和TextMate之类的编辑器已经非常好用了，但它们仅提供了很有限的拓展性。而在另一个极端，Emacs和Vim提供了灵活的拓展性，但它们并不是很友好，需要使用专用的编程语言来配置和拓展。

我们觉得我们可以做得更好。我们的目标是在保证易用性的同时提供充分的可拓展性（hackability）：这个编辑器会受到第一天学习编程的新生欢迎，而且当他们成长为编程专家时也难以割舍。

当我们使用Atom来开发Atom的时候，随着它的逐渐完善，我们愈发觉得已经离不开它了。从表面上来看，Atom是一个能满足你的期待的，现代化的桌面文本编辑器，而在表面之下，这是一个值得你去一同完善的系统。

Atom的核心

Web技术虽然有其缺陷，但经过二十年的发展，Web已经逐渐成长为了一个强大的具有活力的平台。所以当我们计划写一个自用的可拓展的文本编辑器时，Web技术显然是一个好的选择，但首先我们需要摆脱来自Web的限制。

混合本地代码与Web技术

Web浏览器很适合用来浏览网页，但写代码是一种需要可靠的工具的专业活动。更重要的是，浏览器出于安全的考虑，严格限制了对本地系统的访问，但对一个文本编辑器而言，不能向本地系统写入文件是不可接受的。

因此，我们没有把Atom构建为一个传统的Web应用，Atom是一个专门被设计用作文本编辑器，而不是网页浏览器的Chromium定制版。Atom的每一个窗口实际上都是一个本地渲染的网页。

所有来自Node.js可用的API在Atom窗口的JavaScript中同样可用，这种结合带来了一种独一无二的开发体验。

因为一切都是本地的，你不需要将静态资源打包、不需要关注脚本的异步加载，如果你希望加载一些代码。只需要在文件的最顶部

require

它即可，Node.js的模块系统允许你将一个系统分割为小的、专注于某一功能的包。

JavaScript与C++的结合

与原生代码交互也很简单。例如，你基于Oniguruma正则引擎开发了一个用来提供对TextMate语法识别的支持。在浏览器里，你可能需要使用NaCl或Esprima,而在Node里这个过程变得非常简单。

在Node.js的API之外，我们还提供了一些API例如使用系统的对话框、使用菜单栏和右键菜单、操纵窗口尺寸等等。

Web技术：最有趣的部分

另一个好消息就是当你为Atom编写代码时，这些代码一定会被允许在最新版本的Chromium中。这意味着你可以无视与浏览器兼容性有关的黑科技，使用全部的最新的Web功能。

例如，Atom的工作区和窗格都是基于flexbox来进行布局的。这是一项刚刚出现的技术，从我们使用它之后也发生了很多变化，但不要紧，因为它工作得很好。

我们确信将Atom构建在Web技术之上是一个好的选择，因为整个行业都在推动着Web技术的发展。原生UI技术不断产生又不断淘汰，而Web是一个每年都变得更加强大和普及的标准。我们对于深入探索这一强大的技术感到无比兴奋。

一个开源的文本编辑器

GitHub的目标是帮助大家构建更好的软件，而Atom则是实现这一目标的重要补充。Atom是一项长期的投资，GitHub会持续投入开发力