Twinkle是维基人用于快速执行常见维护工作（如提交删除候选及清理破坏）的JavaScript库和应用程式。

它构建于已被许多维基百科脚本和编辑工具使用的morebits.js库之上。

查看中文维基百科上的Wikipedia:Twinkle以获取更多信息。

AzaToth是本工具和morebits.js库的的最初作者和维护者。

• morebits.js：Twinkle和许多其他脚本使用的**库，包含与MediaWiki API进行交互、显示表单和对话框、生成状态日志及执行其他有用工作的代码。这当中大部分代码都不是Twinkle特有的。
• morebits.css：morebits.js所附带的样式表。在Modern皮肤中应用的一些样式是Twinkle特有的，或许这些应该被放进twinkle.css里。
• sync.pl：用来更新维基上小工具、或用维基上的修改更新此代码库的Perl脚本。参见下方的完整文档。
• twinkle.js：通用的Twinkle特有代码，大部分用于处理参数设置和在UI中显示Twinkle。此外，这个文件包含了Twinkle的默认参数。
• modules：包含了单个Twinkle模块。相关说明可在头部注释或Twinkle文档中找到。模块twinkleconfig.js用于提供Twinkle参数设置。

其他没有提到的文件大概已经过时了。

有两种方式将Twinkle脚本上传到维基百科或其他地方。

要生成拼接后的Twinkle脚本，请使用以下bash命令：

awk 'FNR==1{print ""}{print}' twinkle.js modules/*.js > alltwinkle.js

然后就可以把alltwinkle.js上传到MediaWiki:Gadget-Twinkle.js。这并未包含morebits.js和morebits.css，它们需要被分开上传。

如果morebits.js和/或morebits.css需要更新，它们应当被同步到MediaWiki:Gadget-morebits.js和MediaWiki:Gadget-morebits.css。

MediaWiki:Gadgets-definition应当包含这一行：

* Twinkle[ResourceLoader|dependencies=jquery.ui.dialog,jquery.tipsy]|morebits.js|morebits.css|Twinkle.js

存在一个名为sync.pl的同步脚本，可用于向维基百科上拉取和推送文件。

这个程序依赖于Perl 5.10和模块Git::Repository与MediaWiki::Bot，可轻易用App::cpanminus安装：

cpanm --sudo install Git::Repository MediaWiki::Bot

在运行这个程序时，您可以在命令行中使用--username和--password参数提供您的凭据，但更推荐将它们保存到~/.mwbotrc的文件中，采用以下格式：

username => "Username",
password => "password",
base     => "User::Username"

其中base是pull和push文件时的wiki路径前缀。

留意您的工作目录不需要是干净的；亦可以stash或commit您的修改。

要pull用户Foobar的修改（如User:Foobar/morebits.js），做：

./sync.pl --base User:Foobar --pull morebits.js

要push您的修改到Foobar的wiki页，做：

./sync.pl --base User:Foobar --push morebits.js

也有一deploy命令来部署所有Twinkle文件。

./sync.pl --deploy twinkle.js
make deploy

编辑摘要会包含分支和上次提交的SHA。

虽然旧的代码有许多不同且不一致的格式，但我们已经决定要在代码中使用更为一致的格式。

jQuery Core Style Guideline是我们在此之后使用的格式指引。

无需多言，例外也是存在的。这主要和括号旁的空白有关：旧Twinkle代码看起来像if ( condition ) {，但新代码一般会用if (condition) {。惯例是跟随周围代码的样式。