This guide is deprecated. New content at docs.sublimetext.info
In these pages we use several forms of shorthand and make a few assumptions. Below we explain them in full, in addition to describing fundamental aspects of the Sublime Text 2 editor. All this information will enable you to understand better the content of this guide.
Sublime Text 2 stores nearly all of the interesting files for users under the data directory. This is a platform-dependent location:
This is a location within the data directory that we’ll keep referring to again and again. You can obtain it by means of an API call: sublime.packages_path(). In this guide, we refer to this location as Packages, packages path or packages folder.
Packages/User is a catch-all directory for custom plugins, snippets, macros, etc. Consider it your personal area in the packages folder. Sublime Text 2 will never overwrite the contents of Packages/User during upgrades.
Sublime Text 2 has an embedded Python interpreter. You will find yourself turning to it often in order to inspect Sublime Text 2 settings and to quickly test API calls while you’re writing plugins.
To open the Python console, press Ctrl+` or select View | Show Console in the menu.
Sublime Text 2 comes with its own Python interpreter and it’s separate from your system’s Python installation. This embedded interpreter is intended only to interact with the plugin API, not for general development.
Sublime Text 2 is compatible with Textmate snippets, color schemes, .tmLanguage files and .tmPreferences files.