Sublime Text 3 Notes

Nearly all of the interesting files for users live underThe Data Directory. The data directory is ~/.config/sublime-text-3 for Linux

ThePackage Directoryis located under the data directory. All resources for supported programming and markup languages is stored here.

You can access the packages directory from the main Munu (Preference, Browse packages ...), by means of a API call (s Ublime.packages_path ()), and by other means that would be explained in later topics.

The Packages folder is referred to as packages, packages path, packages folder or packages directory.

Packages/user is a catch-all directory for custom plugins, snippets, macros, etc. Consider it your personal area in the Packages folder. Additionly, it'll ocntains most of your personal application or plugin settings.

Updates to ST'll never overwrite the contents of Packages/user.

ST is programmable, enabling users and programming skills to add their own features to the editor.

ST exposes its internal via a API that programmers can iteract with using the Python programming language. An enbedded Python interpreter was included in the editor. The embedded interpreter is useful to inspect the editor's settings and to quickly test API calls while developing plugin S.

ST and plugins output info to a console. To open the console, press Ctrl + ' or select View--Show console from the main menu.

ST3 comes with it own Python interpreter that's separate from your system ' s Python interpreter (if available). The embedded interpreter is a intended to interact with the plugin API and not for general development.

Almost every aspects of ST can be extended or customized. You can modify the editor's behavior, add macros and snippets, extend menus and much more. You can even create whole new features using the editor's API to build complex plugins.

ST's vast flexibility is the reason, why you'll learn about so many config. Files:there simply must is a place to specify all available preferences and settings.

Config. Files in ST is text files that conform to a predefined structure or Format:json predomimates and you'll find XML files Too. For the most advanced extensibility options, Python source code files is used.

For brevity, we sometimes refer collectively to all these disparate configuration files as resources.

ST'll look for resources inside the package folder. We'll take in length about packages later, but the short version is so, to keep things tidy, ST have a notion of a packag E, that's, a folder (or Zip archive) that contains resources this belong together (maybe they help compose emails fast, Write HTML efficiently, enhance the coding experience for C, Ruby, Go ...).

Build Systems Let's run your files through external programs like make, tidy, interpreters, etc.

Executables called from build systems must is in your PATH.

Build Systems is JSON files and has the extension. sublime-build.

Build systems must be located somewhere under the Packages folder (e.g. Packages/user). Many packages include their own build systems.

Build sys. Can is run by pressing F7 or from Tools->build.

The sidebar provides an overview of the active project.

Files and folders in the sidebar would be available in Goto anythng and project-wide actions like, for example, Project-wid E searches.

Projects and the sidebar are closely related. It's important to note that there's always an active project, whether it's explicit or implicit.

File opened from the sidebar create semi-transient views. Unlike transient views, semi-transient views show up as a new tab. The tab title of Semi-transient views appears in italics. Before a new Semi-transient view is opened, any and pre-existing semi-transient view in the same pane gets automatically Closed.

Projects group sets of files and folders to keep your work organized.

There is always a active project. If you haven ' t created one, an implicit one are created by ST.

Set up a project in a-a-suits-adding folders, and then save your new config. You can add and remove folders To/from a project using the Project menu or the side bar ' s context menu. If you drag a folder onto a ST window, it is added to the project too.

To save a project, go to Project--Save project as ...

Using the menu, you can switch projects by selecting projects-Recent projects

Projects can define settings applicable to this project only.

You can open a project from the command line by passing the. sublime-project file as a argument to the SUBL command line Helper included with ST.
A command line helper?)

---------------------------------------------------------------------------------
ST can be fully customized. In the following topics, we outline the most common options. In particular, we don ' t cover themes, a immensely configurable area of ST.

ST Stores config. Data in. sublime-settings files. Flexibility comes at the price of a slightly complex system for applying settings. However, here's a rule of thumb.

Always place your personal settings files under Packages/user to guarantee they would take precedence over any other Confli cting settins files.

Wiht that's out of the the-the-I, let's unveil, to-masochistic readers, the mysteries of how settings work.

ST uses color schemes to HL source code and to define the colors of some items in the editing area:background, foreground , Gutter, caret, selection ...

Color schemes is fully customizable.


Installing Packages

Regular users rarely need to know the install packages by hand, as automatic package managers is vailable.

The de facto package manager for St are package control:the ST Package Manager that makes it exceedingly simple to find, I Nstall and keep packages up-to-date.

. By copying ST resources to a folder under Packages, or
. by copying A. Sublime-package file to installed Packages.

Sublime Text 3 Notes