==Основные понятия==

 

{AVS: Все ссылки в тексте перевода пока ведут на англоязычные статьи. Позже я поправлю их, и они будут вести на переведённые разделы. Так же в конце каждого раздела будет добавлено содержание.}

 

=В двух словах=

 

Для полнейшего понимания текста данного руководства вам нужно ознакомиться с определениями, представленными в текущем разделе.

 

=Договор=

 

Написан с точки зрения пользователя Windows. Большинство инструкций потребует небольших правок, чтобы соответствовать другим платформам.

 Относительные пути вроде Packages/User, если не указано иное, начинаются в папке с данными. {AVS: корневой для всех относительных путей является папка данных} Понятие "папка данных" разъясняется ниже.

  Когда мы будем говорить о клавишах быстрого вызова, мы будем иметь ввиду стандартные назначения клавиш. Если вы используете не-английскую раскладку, некоторые назначения могут не совпадать с вашей раскладкой. Это происходит из-за способа, которым Sublime Text приписывает клавишам команды.

 

=Большая сила - больше вопросов=

 

Sublime Text несомненно универсальный инструмент для программистов: вам не нужно быть одним из разработчиков, чтобы использовать Sublime Text, или даже, чтобы хорошенько настроить. Однако, если вы хакер, вас ждёт много приятных сюрпризов: Sublime Text можно расширять и настраивать бесконечно. Безусловно, вы можете начать эффективно использовать его сразу после установки, но потратив немного времени на подгонку, вы сделаете Sublime Text ещё лучше.

Это руководство научит вас настраивать Sublime Text.

 Нельзя освоить Sublime Text за день, однако всё сводится к небольшому числу распространённых идей, и если все части сложить вместе, система представляется последовательной и понятной.

В продолжение раздела мы опишем ключевые моменты, которые возможно не найдут отклика в ваших мыслях, пока вы не проведёте достаточно времени за редактором. Экспериментируйте, перечитывайте руководство и в конце-концов всё встанет на свои места.

 

=Папка с данными {папка данных}=

 

Все интересующие пользователей файлы расположены в папке данных. Её расположение зависит от платформы:

• Windows: %APPDATA%\Sublime Text 3
• OS X: ~/Library/Application Support/Sublime Text 3
•  Linux: ~/.config/sublime-text-3

Для портативной установки смотрите в Sublime Text 3/Data. Здесь Sublime Text 3 - название папки, в которую вы извлекли файлы из архива.

Заметьте, что только в портативной версии папка называется Data. Для других версий установки, папка данных располагается так, как обозначено выше.
 

=Папка для пакетов {Packages Directory}=

 Это ключевая папка: все ресурсы для поддержки языков программирования и языков разметки хранятся здесь. Пакет - это папка или zip-архив, содержащий файлы, которые имеют особое значение для Sublime Text.

Вы можете попасть в папку с пакетами из основного меню (Preferences | Browse Packages...), или через команду API:  sublime.packages_path() . В этом руководстве папка для пакетов будет называться Пакеты, расположение пакетов, папка с пакетами, директория с пакетами.

 -- User -пакет--

Packages/User - это папка для всех подключаемых плагинов, отрывков {фрагментов, сниппетов}, макросов и прочего. Грубо говоря, это ваша личная зона в папке для пакетов. Во время обновления Sublime Text содержимое этой папки не перезаписывается.
 

=Python. Консоль и API=

Эта информация особо интересна программистам. Остальным пользователям нужно знать лишь то, что Sublime Text позволяет пользователям с навыками программирования расширять редактор собственным функционалом. (Так что все бегом учиться программированию, это очень весело!)

Sublime Text поставляется со встроенным интерпретатором Python. Это полезный инструмент для проверки настроек редактора и быстрого теста команд API при разработке плагинов.

 Чтобы открыть консоль, нажмите  Ctrl + ` , или выберите в главном меню пункт View|Show Console. {AVS: Символ ` расположен на клавише "Ё". В русскоязычных мануалах для обозначения этого сочетания клавиш используется запись  Ctrl + ~  - котрол-тильда.}

Смущены? Давайте попробуем ещё раз и медленнее:

Python - это язык программирования, известный тем, что прост для новичков, но очень мощный при дальнейшем использовании.

API - это аббревиатура от 'Application programming Interface' {интерфейс прикладного программирования}, такой причудливый способ сказать, что Sublime Text 3 можно перепрограммировать вручную. Иными словами, Sublime Text предоставляет пользователю доступ к своему внутреннему содержимому через Python.

Наконец, консоль - это маленькое окошко внутри окна Sublime Text, в котором можно набирать фрагменты кода на Python и запускать их. Консоль так же показывает текстовые сообщения Sublime Text или его плагинов. {В консоли выводятся разные сообщения о работе плагинов и редактора, иногда сообщения об ошибках}

 

--Ваш системный Python против Python'а, встроенного в Sublime Text--

SublimeText 3 поставляется со своим собственным интерпретатором Python'а, отдельным от Python'a, установленного в системе.

Встроенный интерпретатор предназначен только для взаимодействия с плагинами API, но не для основной разработки.

=Пакеты, Плагины, Ресурсы и прочие вещи, которые сейчас могут быть бессмысленными для вас=

Почти все стороны Sublime Text можно развить и улучшить. Сейчас вам не нужно знать больше для понимания. Огромная гибкость - основная причина, почему вы будете изучать так много файлов с настройками: там просто обязано быть место, где вы можете указать все свои предпочтения.

Среди прочего: вы можете изменить поведение редактора, добавить макросы, фрагменты, расширить меню... и даже расширить функционал - где под функционалом имеется ввиду "всё, о чём вы можете подумать". Хорошо, ладно, может быть вы можете делать не всё что угодно, но вас и так балуют возможностями.

Все эти файлы настроек - простые текстовые файлы, записи в которых создаются соответственно специальной структуре и формату: преобладают файлы JSON, но вы можете найти XML, и файлы Python'a тоже для более продвинутого расширения функционала.

 В этом руководстве для удобства мы объединили все эти разрозненные файлы настроек (файлы конфигураций) под названием ресурсы.

Sublime Text будет просматривать ресурсы, помещённые в папку для пакетов. И что это за пакеты, спросите вы? Мы подробнее поговорим о них, но короткая версия такова: чтобы держать вещи в порядке, редактор обладает понятием пакета, который является папкой, содержащей ресурсы, объединённые вместе (может быть они все позволяют быстрее составить электронное письмо, эффективно писать HTML, увеличить производительность при программировании на C, Ruby, Go...).

=Совместимость с Текстмэйт=

Эта информация будет наиболее полезна для эмигрантов с Текстмэйт, которые нашли новый дом в Sublime Text. Текстмэйт - редактор для Mac.

  Sublime Text хорошо совместим с пакетами Текстмэйта за исключением несовместимых команд. Кроме того, в Sublime Text все синтаксические определения должны иметь расширения  .tmLanguage  а файлы настроек  .tmPreferences . Это означает, что файлы с расширением  .plist  будут игнорироваться, даже если они находятся во вложенных папках Syntaxes или Preferences.

=Эмуляция Vi/Vim=

Эта информация будет наиболее полезна динозаврам и людям, которые любят упоминать термин RSI в разговорах. Vi - это древний модальный редактор в котором пользователь выполнял все операции с клавиатуры. Vim - современная версия Vi - всё ещё широко используется.

 Sublime Text предусмотрел Vi эмуляцию в пакете Vintage. По-умолчанию этот пакет игнорируется. Прочитайте больше о Vintage в официальной документации.

 Эволюционировавший Vintage называется Vintageous и предлагает лучший способ редактирования и обновляется чаще чем Vintage. Vintageous - это проект с открытым кодом.

--Emacs--

Эта информация жуть как нужна кому-то. Emacs - это... На самом деле никто точно не знает, что такое emacs, но некоторые люди редактируют в нём тексты.

Если вы пользователь emacs, вы скорее всего не будете читать это.

=Будь выше, друг мой=

 Одолжим мудрости у Брюса Ли: Sublime Text может стать всем, что тебе нужно. В умелых руках бла-бла-бла...

Очисти свои мысли; будь выше, друг мой.

{Просьба поддержать проект неофициальной документации есть на каждой странице англоязычного сайта. Если вы хотите поддержать авторов оригинальных статей, отправьте им долляров.}

 {AVS: 13-14.08.2014}