==Системы сборки (Пакетная обработка)==

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

Смотри также:

Справка по системам сборки               Полная документация по всем возможным опциям, переменным и прочему.

Системы сборки позволяют запускать ваши файлы через внешние программы, такие как make, tidy, интерпретаторы, и т.д.

Исполнительные файлы, вызываемые системами сборки, должны находиться по вашему пути. Для получения дополнительной информации о том, какой путь выбрать, чтобы Sublime Text правильно его распознал, смотрите раздел "Системы сборки. Устранение неполадок"

=Формат файла=

Системы сборки пишутся в JSON-файлы с разрешением .sublime-build.
 

--Пример--

Вот пример системы сборки:

{             "cmd": ["python", "-u", "$file"],             "file_regex": "^[  ]*File \"(...*?)\", line ([0-9]*)",             "selector": "source.python"  }

 cmd 

Обязательно. Эта опция содержит командную строку, предназначенную для выполнения:
 

python -u /path/to/current/file.ext

 

 file_regex 

 
 Perl-регэксп для сбора информации об ошибках на выходе внешней программы. Эта информация используется. чтобы помочь вам переключаться между ошибками по  F4 .

 selector 

Если режим Tools | Build System | Automatic включён, Sublime Text будет автоматически находить соответствующую систему сборки для текущего файла, проверяя соответствует ли область файла указанному  селектору .

 В дополнение к опции вы также можете использовать некоторые переменные в системах сборок, как мы использовали  $file , которая содержит имя файла активной вкладки.

 =Где хранятся системы сборки=

 Системы сборки должны помещаться в какой-нибудь папке пакетов (например Package/User). Многие пакеты включают в себя собственные системы сборок.

=Запуск систем сборки=

 Системы сборки могут быть запущены клавишей  F7  или через меню Tools | Build.

 

{AVS: На сайте неофициальной документации по Sublime Text были сняты плашки с воззванием помочь проекту материально. Начиная с этого раздела комментарии отсылающие тебя к этим просьбам публиковаться не будут.}

{AVS: 11.09.2014}

==Поиск и замена==

 

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

Данный раздел на сайте разбит на три части. Они небольшие по объёму, поэтому здесь я не стал разбивать раздел на три поста, а оставил всё в одном. Ссылки на подразделы, представленные ниже, ведут к двум оставшимся частям раздела на текущей же странице (на liveinternet криво создаются ссылки на якоря, пришлось извернуться - открываются в новом окне/вкладке). Для перехода к оригинальным подразделам воспользуйся ссылками, помещёнными в заголовки.}

Sublime Text оснащён двумя опциями поиска:

• Поиск по одиночному файлу
• Поиск по множеству файлов

Мы рассмотрим их по очереди, но сначала поговорим о мощном инструменте для поиска текста - о регулярных выражениях.

=Регулярные Выражения=

Поиск по регулярным выражениям позволяет находить текст, соответствующий шаблону. Чтобы в полной мере использовать поиск и замену, вы должны научиться хотя бы основам составления регулярных выражений. В этом руководстве мы не будем объяснять, как использовать регулярные выражения.

Постоянно писать "регулярные выражения" быстро надоедает, а произносить всякий раз - тем более, так что вместо этого обычно используют более короткое регэксп или регэкс. {AVS: Regular Expression - RegExp - Regex}

Вот как регэксп может выглядеть:

 

(?:Sw|P)i(?:tch|s{2})\s(?:it\s)?of{2}!

Как известно, регэкспы задевают чувства людей.

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

Sublime Text использует Boost-синтаксис регулярных выражений. {AVS: не имею ни малейшего понятия, что такое Boost, поэтому перевожу так.}

 

==Поиск и Замена - Одиночный файл== 

=Поиск=

Чтобы открыть панель поиска в текущем файле, нажмите  Ctrl + F . Некоторые функции и действия размещённые на этой панели можно запускать с клавиатуры:

Регулярные выражения	Alt + К
Чувствительность к регистру	Alt + C
Точное совпадение	Alt + W
Найти далее	Enter
Найти предыдущее	Shift + Enter
Найти всё	Alt + Enter

 

=Инкрементный поиск=

Панель инкрементного поиска вызывается комбинацией  Ctrl + I . Единственное отличие от обыкновенной панели поиска в поведении клавиши  Enter : в инкрементном поиске будет выделено следующее соответствие в тексте и панель поиска отключится. Выбор между этой панелью и обычной панелью поиска обыкновенно основывается на личных предпочтениях.
 

=Замена текста=

Чтобы открыть панель замены, нажмите  Ctrl + H . Некоторые действия, доступные в этой панели, можно вызвать с клавиатуры:

Заменить далее	Ctrl + Shift + H
Заменить всё	Ctrl + Alt + Enter

 

=Советы=

--Другие способы поиска по файлам--

Goto Anything предоставляет оператор  #  для поиска в текущем файле. Критерием поиска станет текст, следующий за оператором. {AVS: Goto Anything вызывается сочетанием Ctrl + P или через меню Goto | Goto Anything...}

--Другие сочетания клавиш, связанные с поиском--

Эти сочетания клавиш работают, когда панель поиска скрыта.

Искать далее, используя последний шаблон	F3
Искать назад, используя последний шаблон	Shift + F3
Выделить все соответствия, используя последний шаблон	Alt + F3

 

--Многострочный поиск--

Вы можете вводить многострочные шаблоны поиска в панели поиска. Для ввода символа перевода строки нажмите  Ctrl + Enter . Заметьте: панель поиска изменит размер.

 

==Поиск и Замена - Множество файлов==

=Поиск=

Чтобы открыть панель поиска по файлам, нажмите  Ctrl + Shift + F . Вы можете использовать клавиатуру для управления некоторыми опциями и действиями поисковой панели:

Регулярные выражения	Alt + К
Чувствительность к регистру	Alt + C
Точное соответствие	Alt + W
Найти далее	Enter

 

=Область поиска=

Поле Where {Где} в поисковой панели определяет область поиска. Вы можете определять области несколькими способами:

• Добавление отдельных папок (Пути в стиле Unix, даже на Windows)
• Добавление/исключение файлов на основании шаблона
• Добавление символических мест ( <open folders> ,  <open files> )

Кроме того можно комбинировать эти фильтры, используя запятые; к примеру:

 

/C/Users/Joe/Top Secret,-*.html,<open files>

Нажмите кнопку  ...  в панели поиска, чтобы увидеть меню, содержащее эти опции.

=Результирующий вид=

В панели поиска вы можете настроить отображение результатов, используя следующие опции:

 

• Показать на отдельной вкладке/в панели вывода
• Показать контекст

{AVS: контекст - это несколько строк до строки с найденным вхождением и несколько строк после неё}

=Перемещение по результатам=

Если поиск дал несколько совпадений, вы можете перемещаться по вхождениям, используя следующие компбинации клавиш:

Следующее совпадение	F4
Предыдущее совпадение	Shift + F4

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

 {AVS: 19-20.08.2014}

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

 

{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}