开源中国

我们不支持 IE 10 及以下版本浏览器

It appears you’re using an unsupported browser

为了获得更好的浏览体验,我们强烈建议您使用较新版本的 Chrome、 Firefox、 Safari 等,或者升级到最新版本的IE浏览器。 如果您使用的是 IE 11 或以上版本,请关闭“兼容性视图”。
如何开发 Sublime Text 2 的插件 - 技术翻译 - 开源中国社区

如何开发 Sublime Text 2 的插件 【已翻译100%】

jerry2012cn 推荐于 4年前 (共 13 段, 翻译完成于 09-11) 评论 10
收藏  
140
推荐标签: Sublime Text 待读

Sublime Text 2是一个高度可定制的文本编辑器,一直以来对希望有一个快速强大现代的编辑工具的的程序员保持着持续的吸引力。现在,我们将创建自己的一个Sublime plugin,实现用Nettuts+ Prefixr API处理CSS实现跨浏览器CSS的目的。

当完成时,你会深入的明了如何创建一个 Sublime Prefixr plugin,并且有能力去写你自己的编辑器插件。

青崖白鹿
 翻译得不错哦!

前言:术语和参考资料

The extension model for Sublime Text 2 is fairly full-featured.

Sublime Text 2的扩展模型是相当的功能全面。你可以改变语法高亮,实际的编辑器外观,以及所有的菜单项。此外,还可以创建新的build环境,自动补全,语言定义,代码区段,宏,键绑定,鼠标绑定以及插件。所有这些不同形式的改装都是用组织在package中的文件来实现的。

所谓pacakage就是一个存储在你的Packages目录中的文件夹。你可以点击Preferences > Browse Packages… 菜单进入你的Packages目录。也可以通过创建一个zip文件并且把扩展名改为.sublime-package来实现把pacakage打包成一个单独文件。我们将在本教程中讨论一点怎么打包。

青崖白鹿
 翻译得不错哦!

Sublime绑定了很多不同的package。大不多数绑定的都是和特定语言相关的package,包括语言定义,自动补全以及build环境。除了语言相关的package,还有两个Default和User package。Defaultpackage包含了所有的标准键绑定,菜单定义,文件设置和一大堆用python写的插件。

During the process of writing a plugin, the   Sublime Text 2 API reference will be essential.

要写一个插件, Sublime Text 2 API reference是根本。此外,Defaultpackage对于怎么做我们的工作也是一个很好的参考。编辑器的大部分功能都是通过commans命令来实现,除了敲入字符之外的所有操作都可以通过commans完成。查看Preferences > Key Bindings – Defaultmenu ,你可以找到很多有用的内建的功能。

现在,pacakge和插件的区别已经清楚了,可以开始写我们的插件了。

青崖白鹿
 翻译得不错哦!

第一步 - 起步

Sublime有一个功能可以产生一个简单插件所需要的Python代码框架。选择Tools > New Plugin…菜单,可以打开一个新的文件,带有下面的样式:

import sublime, sublime_plugin

class ExampleCommand(sublime_plugin.TextCommand):
    def run(self, edit):
        self.view.insert(edit, 0, "Hello, World!")
可以看到,引入了两个Sublime Python的模块,使得我们可以访问其API并且创建一个新的类。在开始编辑创建我们自己的插件之前,请先保存这个文件。

青崖白鹿
 翻译得不错哦!

要保存这个文件我们需要创建一个package来保存它。 按下 ctrl+s(Windows/Linux) or cmd+s (OS X) 来保存文件。保存对话框默认打开Userpackage,不要把我们的文件存在那里,而是创建一个新的文件夹,命名为Prefixr。

Packages/
…
- OCaml/
- Perl/
- PHP/
- Prefixr/
- Python/
- R/
- Rails/
…

现在,把我们的文件保存在Prefixr文件夹中,命名为Prefixr.py。其实文件名并不重要,只要以.py为扩展名就可以。但方便起见,还是用我们的插件的名字吧。

现在,插件已经做了保存。我们可以试着运行了。输入 ctrl+`打开Sublime的控制台,这是一个可以访问API的Python控制台。输入下面的Python代码来测试我们的新插件:

view.run_command('example')
你将看到Hello World被插入到了我们的插件文件的开头。接下来继续之前先Undo掉这个新的插入。
青崖白鹿
 翻译得不错哦!

第二步 - Command的类型和名字

对于一个插件,Sublime提供了三种类型的command。

  • Text commands 提供通过一个View对象访问被选定的文件或者buffer的内的能力
  • Window commands 提供一个Window对象,可引用当前的窗口
  • Application commands 没有引用任何特定的窗口,文件或者buffer,很少使用。

因为我们要用我们的插件来操作CSS文件或者buffer里面的内容,所以我们要使用 sublime_plugin.TextCommand 类作为我们定制的Prefixr命令的基类。这时,我们就需要命名我们命令的类名了。

在我们的代码框架中,你可以看到下面的类:

class ExampleCommand(sublime_plugin.TextCommand):
在我们运行命令时,在控制台中执行的是下面的代码:
view.run_command('example')
Sublime将把继承自任意一个 sublime_plugin类
(TextCommand,WindowCommand or ApplicationCommand)的类的名字的Command后缀去掉,并且用下划线符号命名替换驼峰式命名。

这样一来,为创建一个名字是prefixr的command,类名就必须是PrefixrCommand。

class PrefixrCommand(sublime_plugin.TextCommand):
青崖白鹿
 翻译得不错哦!

第三步 - 选定文本

Sublime最有用的功能之一就是具备多行选定的功能

现在,我们已经正式命名了我们的插件,可以开始从当前的buffer中获取CSS并且发送到Prefixr API上了。Sublime最有用的功能之一就是具备多行选定的功能。由于要获取选定的文件,我们需要把所有选定的行放入我们的插件中处理,而不仅仅是第一个选定的。

由于我们写的是一个文本命令,所以可以通过self.view访问当前view。view对象的self()方法将返回一个当前选定内容的iterable Region集合,我们可以通过花括号扫描到这些内容。若找不到花括号,可以扩大选定内容到周围的括号,以保证整个块有一个括号前缀。选定内容中是否包含花括号还将有利于我们后面对Prefixr API返回的内容作空白调整和格式调整。

braces = False
sels = self.view.sel()
for sel in sels:
    if self.view.substr(sel).find('{') != -1:
        braces = True

用这几行代码替换框架中的run()方法中的代码。
青崖白鹿
 翻译得不错哦!

若未找到任何的花括号,我们需要循环检测每一个选定区段,把每一个区段和后括弧关联起来。之后,用带有to参数设置为 brackets的内建命令 expand_selectionl来确保获取了每个CSS块的完整内容。

if not braces:
    new_sels = []
    for sel in sels:
        new_sels.append(self.view.find('\}', sel.end()))
    sels.clear()
    for sel in new_sels:
        sels.add(sel)
    self.view.run_command("expand_selection", {"to": "brackets"})
若果你想再检查一次你的代码,你可以和源代码zip文件中的Prefixr1.py文件对比一下。
青崖白鹿
 翻译得不错哦!

第四步 - 线程

为防止糟糕的连接破坏其他正常工作,我们需要确保在后台完成Prefixr API调用。

此时,选定的文本已经扩展到了能抓取每个CSS块的完整内容。现在,我们需要把他们发送打牌Prefixr API上。这只需要一个简单的HTTP请求,用urllib和urllib2模块就可以实现。但是,在发起请求之前,需要想想一个潜在的web请求延迟会对编辑器性能造成的影响。如因为某些原因,用户处在一个很慢的连接环境下,对Prefixr API的请求很可能需要好几秒钟乃至更多。

为防止糟糕的连接破坏其他正常工作,我们需要确保在后台完成Prefixr API调用。若你不了解线程,很基础的一种解释就是,线程是使你的程序的多个代码块在同一时间运行的机制。这在我们的插件环境中是很重要的,因为这样做可以避免在向Prefixr发送数据和等待响应的过程中Sublime处于不可用状态。

青崖白鹿
 翻译得不错哦!

第五步 - 创建线程

我们将使用Python threading 模块来创建线程。要使用该模块,需要创建一个继承threading的新类。Thread包含一个所有线程代码都在其中执行的run()方法。

class PrefixrApiCall(threading.Thread):
    def __init__(self, sel, string, timeout):
        self.sel = sel
        self.original = string
        self.timeout = timeout
        self.result = None
        threading.Thread.__init__(self)

    def run(self):
        try:
            data = urllib.urlencode({'css': self.original})
            request = urllib2.Request('http://prefixr.com/api/index.php', data,
                headers={"User-Agent": "Sublime Prefixr"})
            http_file = urllib2.urlopen(request, timeout=self.timeout)
            self.result = http_file.read()
            return

        except (urllib2.HTTPError) as (e):
            err = '%s: HTTP error %s contacting API' % (__name__, str(e.code))
        except (urllib2.URLError) as (e):
            err = '%s: URL error %s contacting API' % (__name__, str(e.reason))

        sublime.error_message(err)
        self.result = False
这里,我们使用thread的__init__()方法来设置所有的在web请求中需要的数据变量。run()方法包含所有的设置代码和执行向Prefixr API 的http请求的代码。由于线程并发的执行,所以直接返回值是不可行的,取而代之的我们设置self.result作为调用的结果。
青崖白鹿
 翻译得不错哦!
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们
评论(10)
Ctrl/CMD+Enter

不知为何,这篇文章后面的部分没有发上来。英文原文后面还有很多内容
谢谢翻译
翻译的很不错,很有兴趣看下面的内容,是不是可以微博上@下官网解决问题
第二步 command少了d
术语里的“产检”应该是插件

引用来自“杨维杰”的评论

术语里的“产检”应该是插件

thanks,已修正~

引用来自“刘地”的评论

第二步 command少了d

的确是的~已修正,谢谢指出。
@红薯:这篇文章内容不全,大家关注的也比较多,能把后面的补上吗?
有兴趣可以看看 http://my.oschina.net/theforever/blog/136554 ,内容更全面,只是PYTHON语法方面没太多介绍,但有为此翻译的 SUBLIME TEXT 2 的API中文文档地址。
Text commands 提供通过一个View对象访问被选定的文件或者buffer的内的能力
这句话不通~ 感觉最后应该将 "内的能力" --> "内容的能力"
顶部