|
| 1 | +# Скрипт для работы с шаблонами кода |
| 2 | + |
| 3 | +- [Скрипт для работы с шаблонами кода](#%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82-%D0%B4%D0%BB%D1%8F-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D1%81-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%B0%D0%BC%D0%B8-%D0%BA%D0%BE%D0%B4%D0%B0) |
| 4 | + - [Установить приложение, алгоритм установки стандартный](#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%82%D1%8C-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B0%D0%BB%D0%B3%D0%BE%D1%80%D0%B8%D1%82%D0%BC-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B8-%D1%81%D1%82%D0%B0%D0%BD%D0%B4%D0%B0%D1%80%D1%82%D0%BD%D1%8B%D0%B9) |
| 5 | + - [Использование](#%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) |
| 6 | + - [Конвертация шаблонов](#%D0%BA%D0%BE%D0%BD%D0%B2%D0%B5%D1%80%D1%82%D0%B0%D1%86%D0%B8%D1%8F-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%BE%D0%B2) |
| 7 | + - [Объединение шаблонов](#%D0%BE%D0%B1%D1%8A%D0%B5%D0%B4%D0%B8%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%BE%D0%B2) |
| 8 | + - [Разделение шаблонов](#%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%BE%D0%B2) |
| 9 | + |
| 10 | +## Установить приложение, алгоритм установки стандартный |
| 11 | + |
| 12 | +- склонировать репозиторий или |
| 13 | +- распаковать в нужный каталог архив репозитория |
| 14 | +- для Windows запустить [installlocalhost.bat](/installlocalhost.bat) |
| 15 | + |
| 16 | +## Использование |
| 17 | + |
| 18 | +### Конвертация шаблонов |
| 19 | + |
| 20 | +1. Шаблоны конфигуратора в шаблоны VS Code |
| 21 | +2. Шаблоны конфигуратора в шаблоны EDT |
| 22 | +3. Шаблоны EDT в шаблоны конфигуратора |
| 23 | + |
| 24 | +Поддерживаемые расширения файлов |
| 25 | + |
| 26 | +- ".st" - шаблон конфигуратора |
| 27 | +- ".json" - шаблон языка VSCode |
| 28 | +- ".code-snippets" - глобальный шаблон VSCode |
| 29 | +- ".xml" - шаблон EDT |
| 30 | + |
| 31 | +Определение типа преобразования происходит на основании расширения файла. |
| 32 | + |
| 33 | +Для запуска преобразования используется команда: |
| 34 | + |
| 35 | +`snippet-transform convert Исходный-шаблон Новый-шаблон` |
| 36 | + |
| 37 | +Примеры: |
| 38 | + |
| 39 | +- `snippet-transform convert "Мой любимый шаблон.st" "bsl.code-snippets"` |
| 40 | + Команда выполнить преобразование шаблона конфигуратор в глобальный шаблон VSCode |
| 41 | + |
| 42 | +- `snippet-transform convert "Мой любимый шаблон.xml" "bsl.st"` |
| 43 | + Команда выполнить преобразование шаблона EDT в шаблон конфигуратора |
| 44 | + |
| 45 | +### Объединение шаблонов |
| 46 | + |
| 47 | +`snippet-transform join-files Изменяемый-шаблон Добавляемый-шаблон` |
| 48 | + |
| 49 | +- `Изменяемый-шаблон` - Имя файла шаблона, в который будут добавлены записи из второго файла |
| 50 | +- `Добавляемый-шаблон` - Имя файла, в котором содержатся добавляемые записи |
| 51 | + |
| 52 | +`snippet-transform join-path Каталог-шаблонов Результирующий-шаблон` |
| 53 | + |
| 54 | +- `Каталог-шаблонов` - Имя каталога, в котором лежат шаблоны, которые нужно соединить. |
| 55 | +- `Результирующий-шаблон` - Имя файла, в который будет сохранен результат |
| 56 | + |
| 57 | +Примеры: |
| 58 | + |
| 59 | +- `snippet-transform join-files "Мой любимый шаблон.xml" "Мой второй любимый шаблон.st"` |
| 60 | + Команда выполнить объединение шаблонов EDT и конфигуратора и запишет результат в шаблон EDT c именем "Мой любимый шаблон.xml" |
| 61 | + |
| 62 | +- `snippet-transform join-path "Каталог любимый шаблонов" "Супер шаблон.code-snippets"` |
| 63 | + Команда выполнить объединение всех поддерживаемых шаблонов каталога и запишет результат в новый шаблон |
| 64 | + |
| 65 | +### Разделение шаблонов |
| 66 | + |
| 67 | +`snippet-transform apportion Изменяемый-шаблон Выражение-поиска [Новый-шаблон] [-r]` |
| 68 | + |
| 69 | +Удаляет (переносит в новый файл) элементы шаблона, полное наименование которых совпадает с `Выражение-поиска` |
| 70 | + |
| 71 | +- `Изменяемый-шаблон` - Имя файла шаблона, из которого будет вырезана часть |
| 72 | +- `Выражение-поиска` - Регулярное выражение для проверки наименования элемента шаблона. Если выражение совпадает с наименованием, то такой элемент переносится в новый файл. |
| 73 | +- `Новый-шаблон` - Имя файла шаблона, в который будут помещены исключенные записи |
| 74 | +- `-r` Переносить элементы, у которых наименование не совпадает с шаблоном |
| 75 | + |
| 76 | +Примеры: |
| 77 | + |
| 78 | +- `snippet-transform apportion "Мой любимый шаблон.st" "алгоритм"` |
| 79 | + Удалит из шаблона элементы, в наименовании которых есть слово "алгоритм" |
| 80 | + |
| 81 | +- `snippet-transform apportion "Мой любимый шаблон.st" "алгоритм" Алгоритмы.st` |
| 82 | + Перенесет из шаблона "Мой любимый шаблон.st" в шаблон "Алгоритмы.st" элементы, в наименовании которых есть слово "алгоритм" |
| 83 | + |
| 84 | +- `snippet-transform apportion "Мой любимый шаблон.st" "оставить" -r` |
| 85 | + Удалит из шаблона все элементы, в наименовании которых нет слова "оставить" |
| 86 | + |
| 87 | +- `snippet-transform apportion "Мой любимый шаблон.st" "^Супер группа\." -r` |
| 88 | + Удалит из шаблона все элементы, кроме группы первого уровня "Супер группа" |
| 89 | + |
| 90 | +- `snippet-transform apportion "Мой любимый шаблон.st" "Плохая группа\."` |
| 91 | + Удалит из шаблона группы "Плохая группа" и "очень плохая группа" |
0 commit comments