Фрагменты

Фрагменты — короткие аббревиатуры, которые раскрываются в полное содержимое: простой текст, богатый текст (HTML) или исполняемые скрипты (Pro). Несколько букв + клавиша запуска → целый блок. Переменные шаблонов вроде {{date}}, {{clipboard}} (Pro) подставляются при раскрытии. См. FillIn и переменные.

Главное окно — три колонки: группы слева, список фрагментов посередине, редактор справа. Заблокированные группы Организации на рабочем столе править нельзя.

Как раскрывать фрагменты

• Аббревиатура и запуск — введите аббревиатуру + клавишу запуска (по умолчанию Tab, или Пробел/Enter и др.) для раскрытия; работает в любом текстовом поле.
• Клавиша запуска: Tab, Пробел, Enter, Alt, ., ,, ;, -, /, =, ` настраиваются; «требовать клавишу запуска» рекомендуется, чтобы меньше случайных срабатываний.
• Режимы совпадения:
  • Слева направо: аббревиатура должна точно совпасть с вводом (например sig → sig+Tab)
  • Справа налево: аббревиатура должна совпасть как суффикс (например mysig → sig+Tab раскрывается)
  • Граница слова: в режиме справа налево требовать символ границы слова перед аббревиатурой, чтобы не срабатывать внутри слова
  • Адаптивный регистр: введите SIG для верхнего регистра, Sig для Title Case
• Встроенный поиск: введите // (настраиваемый префикс) — всплывающий поиск фрагментов; стрелки выбрать, Enter вставить
• Сочетания (Pro): глобально главное/поиск, создать из буфера, новый фрагмент, править последнее раскрытое, раскрыть последнее снова; глобальное сочетание на фрагмент. См. Настройки → Сочетания.

Группы и многофайловые

• Дерево групп + префикс: например всё под ai- раскрывается как ai-xxx; много фрагментов по сценариям. См. Введение · Фрагменты.
• Многофайловые фрагменты: один фрагмент, несколько «файлов» (язык/среда), у каждого своя аббревиатура и содержимое; правите один раз, раскрываете везде.
  • Добавление, копирование, удаление и сортировка файлов перетаскиванием
  • У каждого файла независимо: имя файла, среда, аббревиатура, содержимое, область раскрытия, глобальное сочетание
  • Многофайловые фрагменты показывают бейдж числа файлов в списке

Только в выбранных приложениях ᴾᴿᴼ

Раскрывать только в выбранных приложениях; та же аббревиатура в другом месте не сработает. Держите раскрытие в VS Code, Cursor или браузере без срабатываний в чате или веб-полях.

Как настроить

1. Откройте настройки фрагмента или группы.
2. Найдите ExpandIn (или «Раскрывать только в этих приложениях»).
3. Выберите или найдите приложения (например VS Code, Chrome, Cursor); можно несколько.
4. Сохраните; этот фрагмент или группа отвечают на «аббревиатура + клавиша запуска» только в этих приложениях.

Если приложение не выбрано, работает везде.

Как это работает

• Определение приложения: автоматически узнаёт переднее приложение; ручная техническая настройка не нужна.
• Лимит на группу: ExpandIn на группе применяется ко всем фрагментам под ней.
• Лимит на фрагмент: настройки фрагмента могут перекрыть группу для более тонкого контроля.
• Глобальный поиск: ExpandIn влияет только на раскрытие «аббревиатура + клавиша запуска»; глобальное окно поиска (по сочетанию) доступно везде.

Типовые сценарии

Заметки

• Нераспознанные приложения: если приложение не определяется (некоторые Electron), ExpandIn может не сработать; снимите ограничение у этих фрагментов.
• Производительность: ExpandIn проверяет переднее приложение перед каждым запуском; накладные расходы ничтожны.
• С границей слова: включите «проверку границы слова», чтобы не срабатывать внутри слова даже в разрешённых приложениях.

Лучше всего для: активного использования фрагментов в IDE и браузере без срабатываний в чате (WeChat, Slack).

Редактор фрагментов

Типы редактора

Переключается автоматически по среде фрагмента:

• Редактор кода: подсветка синтаксиса, номера строк, отмена/повтор. Удобно для обёрток кода и скриптовых фрагментов.
• Редактор богатого текста: жирный, курсив, заголовки, списки, таблицы, изображения, ссылки. Удобно для шаблонов писем и форматированного содержимого.

Панель редактора

Подсказка только чтения: когда фрагмент заблокирован (режим только чтения), наведите на область редактора — иконка замка мигнёт как напоминание; кликните её или нажмите Cmd/Ctrl+Shift+L, чтобы разблокировать и править.

Типовые сценарии

• Разработчики: пишите обёртки кода (try/catch, логирование) с подсветкой; запускайте скрипты напрямую и копируйте вывод.
• Технические писатели: черновики документации в богатом тексте с картинками и таблицами; скриншот и разметка в том же приложении.
• Многоязычные команды: делитесь фрагментами между регионами — код-фрагменты работают в любой IDE, шаблоны подстраиваются под локальные языки через FillIn.

Код в изображение

• Carbon share: отрисовать код красивой картинкой (Carbon.now.sh)
• Локальный рендер: код в изображение (локально)

FillIn и переменные шаблонов

• Переменные FillIn — окно при запуске: однострочные/многострочные, список, чекбокс, %date%, курсор %c% (поддерживаются прыжки по нескольким курсорам), буфер %cv%, вложенные %s:abbr%; удобно для промптов и параметризованных шаблонов.
  • Форматирование регистра переменных: camel/pascal/snake/kebab/upper/lower
• Переменные шаблона фрагмента (Pro) — в содержимом: {{date}}, {{time}}, {{clipboard}}, {{cursor}}, {{input}}; подставляются при раскрытии.

Типы фрагментов и выполнение ᴾᴿᴼ

Встроенные типы

Своя среда выполнения

Настройте свои среды в Настройках, чтобы запускать любой исполняемый файл. Можно передать содержимое фрагмента, буфер и выделенный текст в контекст выполнения, плюс свои обёртки для до/после обработки.

Способы выполнения

• Предпросмотр: кнопка запуска или Cmd/Ctrl+Shift+P в редакторе; результат в нижней панели
• Запустить и скопировать: правый клик в списке фрагментов → «Запустить и скопировать»; результат копируется в буфер после выполнения

История версий

Автосохраняемая история версий на файл:

• Автосохранение: правки автоматически пишутся в историю по ходу работы
• Источники версий: первичное создание, автосохранение, ручное сохранение и операции применения
• Diff версий: сравнение бок о бок; различия по строкам или форматированию
• Восстановление: откат к любой предыдущей версии одним кликом

Типовые сценарии восстановления:

• Случайное удаление → восстановление из истории за секунды
• Сравнить изменения → точно видно, что изменилось между правками
• Экспериментальные правки → пробуйте новые идеи спокойно, откатывайтесь когда угодно

Группы и префикс

Левая колонка — дерево групп. Фрагменты живут в группах; аббревиатуры — на файлах; префиксы — на группах.

1. Правый клик по пустому месту → Новая группа или добавьте дочернюю под группой.
2. Настройки группы: имя, префикс (например ai-). Префикс ai- + аббр. файла gen → вводите ai-gen, затем клавишу запуска.
3. Free: около 5 групп; Pro без лимита. У дочерней группы может быть свой префикс. Сохраните после изменения.

Группа также может задать ExpandIn / когда раскрывать / локальные клавиши запуска (не синхронизируются) и загружается ли она. Заблокированные группы Организации на рабочем столе править нельзя. См. Организации и Раскрытие.

Создание и правка

Поддержке нужна строка политики возврата как ret. Выберите одну из своих групп, создайте фрагмент, наберите тело, сохраните. В следующий раз введите ret и Tab в письме.

1. Выберите группу Только я (заблокированную группу организации здесь править нельзя).
2. Cmd/Ctrl+N или кнопка Новый. Free останавливается около 50 фрагментов.
3. Дайте имя; задайте аббревиатуру и тело на файле. Выберите простой текст, богатый текст или скрипт (Pro).
4. Сохраните. Новая аббревиатура или префикс группы работает при следующем наборе.

Также: создать из буфера, бросить файл, принять предлагаемый фрагмент или открыть пакет для обмена. Один фрагмент может держать китайскую и английскую подпись, каждая со своей аббревиатурой.

Предлагаемые фрагменты

Вы трижды за день набрали одну и ту же концовку. Главное окно может спросить: сохранить это как аббревиатуру? Предпросмотр, затем подтверждение. Если проигнорировать — библиотека не меняется. Подтвердите — добавится в текущую группу. Лимит Free ~50 всё равно действует. Счётчики остаются на этом компьютере.

Пакет для обмена

Соберите группы/фрагменты для коллеги. Они подтверждают в приложении; элементы попадают в их локальную библиотеку, не в живую синхронизацию организации.

1. Откройте codeexpander://import?d=... (слишком длинные полезные нагрузки отклоняются).
2. После декодирования приложение показывает диалог подтверждения. Только потом пишет. Лимиты Free всё равно действуют.
3. Пакеты, указывающие на общие фрагменты организации, распознаются; копировать в мою библиотеку делает редактируемую личную копию.

Экспорт — в меню фрагмента/группы и Данные → Перенос. Пакет для обмена — не доступ к организации CE Cloud. См. Глубокие ссылки.

Обмен и синхронизация

• Личное CE Cloud / Организации / Gist и WebDAV.
• Импорт/экспорт: Настройки → Данные; JSON и экспорт TextExpander.

Ещё: Скрипты · FillIn · Раскрытие