Руководство по Text Tools

Руководство по Power Text Tools

Быстрый старт — как начать работу за 5 минут
API и скрипты — документация API | создание скриптов

---Вот структурированная документация на основе предоставленных скриншотов:

Общее описание UI

Базовые операции

Структура интерфейса

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

Редактор — единое поле для ввода текста, загрузки файлов и просмотра результатов операций
Панель инструментов — категории операций и кнопки действий (Найти и Заменить, Скрипты)
Undo/Redo — пошаговая отмена и повтор операций (Ctrl+Z / Ctrl+Shift+Z)
Футер — статистика (строки, слова, символы) и глубина истории отмены/повтора

Категории функций (вкладки)

В верхней части интерфейса расположены категории инструментов:

`Текстовая обработка` — основная категория, содержит базовые операции.
`Форматирование текста`
`Очистка текста`
`Преобразование регистра`
`JSON операции`
`YAML операции`
`Кодирование/Декодирование`
`Генераторы`
`Сортировка и фильтрация`
`Извлечение данных`

В каждой категории доступны специализированные кнопки-функции (например, "Заменить кавычки", "Разделить строки" и т.д.).

Общие функции

Найти и заменить

Доступна через кнопку "Найти и заменить" в строке инструментов.
Позволяет выполнять поиск и замену текста по шаблону (возможно, с поддержкой регулярных выражений — не показано, но предполагается).

Скрипты

Доступны через кнопку "Скрипты" в строке инструментов.
Позволяют выполнять пользовательские операции над текстом (см. раздел 2).

Операции с выделенным текстом

В зоне «Редактор» есть флажок:

Только к выделенному
Если флажок активен, все операции (включая скрипты) применяются только к выделенному фрагменту текста, а не ко всему содержимому поля редактора.

Управление данными

Загрузка из файла

Кнопка "Загрузить" — позволяет загрузить текст из файла (поддерживаются текстовые форматы: `.txt`, `.csv`, `.log` и др.).

Очистка

"Очистить" — удаляет весь текст из редактора и сбрасывает историю отмены/повтора

📋 Копирование

Кнопка "Копировать" в заголовке редактора — копирует содержимое в буфер обмена

Использование скриптов

Запуск скрипта

Нажмите кнопку "Скрипты" в строке инструментов.
Откроется модальное окно со списком доступных скриптов.
Выберите нужный скрипт и нажмите стрелку → для запуска.

Информация о скрипте

В списке скриптов отображается:

Название
Тип: `custom` — пользовательский скрипт
Дата создания: например, `07.01.2026`
Версия: `v1`, `v2` и т.д.
Размер: количество символов в коде (`285 chars`, `1215 chars`)

Добавление новых скриптов

Открытие менеджера скриптов

В окне "Скрипты" нажмите "Управление скриптами" (иконка шестерёнки).
Откроется панель управления со списком всех скриптов.

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

Нажмите кнопку "+ Создать скрипт".
Откроется форма редактирования:
- Название скрипта — обязательное поле.
- Описание (опционально) — добавьте пояснения.
- Пользовательские теги — для группировки/поиска.
- Код скрипта — обязательное поле. Подсказка:
```
// Write your script here
// Use "input" as input text
// Set "output" as result
```

Скрипты пишутся на JavaScript. Переменная `input` содержит исходный текст, переменная `output` должна быть установлена как результат.

Важно: Переменная `output` уже определена системой. Не переобъявляйте её (например, с помощью `let`, `const` или `var`), так как это приведёт к ошибке выполнения скрипта. Просто присвойте результат переменной `output`.

После написания нажмите "Сохранить".

Управление существующими скриптами

В режиме "Управление скриптами" для каждого скрипта доступны действия:

Редактировать — изменить название, описание или код.
Экспортировать — сохранить скрипт в файл (возможно, в формате JSON или .js).
Удалить — удалить скрипт.

Также доступны глобальные действия:

Экспорт всех скриптов — скачать все пользовательские скрипты.
Импорт скриптов — загрузить ранее экспортированные скрипты.
Удалить все пользовательские скрипты — массовое удаление.

Text Tools – Навигация и поиск операций

Как использовать навигацию

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

Текстовая обработка: `?category=text-processing`
Форматирование: `?category=formatting`
Очистка текста: `?category=clear`
Регистр текста: `?category=case`
JSON операции: `?category=json`
YAML операции: `?category=yaml`
Кодирование/Декодирование: `?category=encoding`
Генераторы: `?category=generator`
Сортировка и фильтрация: `?category=sort`
Извлечение данных: `?category=extract`

Обзор категорий

Это руководство перечисляет основные категории, доступные в Text Tools, и выделяет ключевые операции в каждой из них. Полный список операций можно найти в самом инструменте, выбрав нужную категорию.

Текстовая обработка: Изменение и подготовка исходного текста. Включает операции по преобразованию табуляций в пробелы, нормализации окончаний строк, замене кавычек, конвертации систем счисления, объединению и разделению строк.
Форматирование: Настройка структуры и оформления текста, часто связанная с разделителями или разметкой. Включает операции по переносу строк, форматированию в виде таблиц (CSV, Markdown), преобразованию HTML в текст/Markdown, добавлению запятых в числа, подсчету вхождений строк и добавлению номеров строк.
Очистка текста: Базовая очистка и санитизация текста. Включает удаление HTML-тегов, эмодзи, диакритических знаков, пустых строк, дубликатов, управляющих символов, лишних пробелов, а также очистку вывода LLM и функцию «Найти и заменить».
Регистр текста: Преобразование капитализации и представления символов текста. Включает операции по преобразованию в верхний/нижний регистр, заглавные буквы, регистр предложения, camelCase, kebab-case, создание slug, обращение текста и нормализацию Unicode.
JSON операции: Манипуляции с данными JSON, включая форматирование, минификацию, извлечение значений, преобразование в/из других форматов (CSV, XML, YAML, TOML) и проверку синтаксиса JSON.
YAML операции: Работа с данными YAML. Включает проверку синтаксиса YAML, конвертацию YAML в JSON с настраиваемыми отступами и форматирование YAML для единообразного вывода.
Кодирование/Декодирование: Кодирование или декодирование текста с использованием распространенных схем. Включает операции по кодированию/декодированию URL, HTML-сущностей, Base64, а также декодирование/проверку JWT.
Генераторы: Создание нового текстового контента или добавление сгенерированных элементов. Включает операции по генерации Lorem Ipsum, случайных чисел, последовательностей, временных меток, UUID и хэшей паролей.
Сортировка и фильтрация: Организация строк текста или данных по определенным критериям. Включает операции по перемешиванию строк, выбору случайных строк, сортировке строк по алфавиту, числу, длине, количеству слов.
Извлечение данных: Поиск и извлечение конкретной информации из текста. Включает операции по извлечению телефонных номеров, электронных адресов, IP-адресов, URL, блоков кода, специфических шаблонов регулярных выражений и сравнению текстов на предмет различий.

Практическое использование регулярных выражений

Замена по регулярному выражению

Операция «Найти и заменить» с поддержкой регулярных выражений позволяет выполнять сложные преобразования текста.

Практический пример: Изменение формата даты из "31.12.2023" в "2023-12-31"

Найти: (\d{2})\.(\d{2})\.(\d{4})
Заменить на: $3-$2-$1

Другой пример: Извлечение email-адресов из текста

Найти: .*?([\w.-]+@[\w.-]+\.\w+).*?
Заменить на: $1\n

Разделение текста по регулярному выражению

Операция «Разделить строки» позволяет использовать регулярные выражения в качестве разделителей.

Практический пример: Разделение текста по различным знакам препинания

Разделитель: [.,;!?]+
Текст: "Привет,мир!Как дела?"
Результат: ["Привет", "мир", "Как дела"]

Пример для CSV-данных: Разделение с учетом кавычек

Разделитель: ,(?=(?:[^"]*"[^"]*")*[^"]*$)

Валидация текста по регулярному выражению

Используйте операцию «Извлечение с помощью regex» для проверки соответствия текста определенному шаблону.

Практические примеры валидации:

Проверка email:

Шаблон: ^[\w.-]+@[\w.-]+\.[a-zA-Z]{2,}$

Проверка телефонного номера (Россия):

Шаблон: ^\+7\s?\(?\d{3}\)?[\s-]?\d{3}[\s-]?\d{2}[\s-]?\d{2}$

Проверка пароля (мин. 8 символов, буквы и цифры):

Шаблон: ^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d@$!%*#?&]{8,}$

Группировка и обратные ссылки в замене

Регулярные выражения поддерживают группировку через круглые скобки `( )` и обратные ссылки `$1`, `$2`, `$3` и т.д. в строке замены.

Практические примеры:

Форматирование ФИО: "Иванов Иван Петрович" → "И.И. Петрович"

Найти: ^(\w+)\s+(\w)\w*\s+(\w+)$
Заменить на: $2.$1. $3

Перестановка даты и времени в логах:

Найти: (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})
Заменить на: [$2] $1

Извлечение домена из URL:

Найти: https?://(?:www\.)?([^/]+)
Заменить на: Домен: $1

Специальные возможности и escape-последовательности

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

Последовательность	Результат
`\n`	Новая строка
`\t`	Табуляция
`\r`	Возврат каретки
`\f`	Перевод страницы
`\v`	Вертикальная табуляция
`\\`	Обратный слеш

Пример: Создание Markdown-списка из простых строк

Найти: ^(.+)$
Заменить на: - $1\n

Ссылки на шпаргалку по регулярным выражениям

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

Полный справочник по синтаксису регулярных выражений
Готовые шаблоны для распространенных задач
Примеры использования для разных профессий
Решения частых проблем и ошибок

Подробное описание категорий

Текстовая обработка (`?category=text-processing`)

Направлена на изменение структуры, преобразование и подготовку текста.

Статистика подсчета: Предоставляет количество строк, слов, символов, предложений и абзацев.
Оставить только дубликаты: Фильтрует текст, чтобы показать только строки, которые дублируются где-то еще.
Разделить строки: Разделяет входной текст на отдельные строки по заданному разделителю.
Заменить кавычки: Преобразует различные типы кавычек (умные кавычки, угловые кавычки и т.д.) в указанный тип.
Табуляции в пробелы: Преобразует символы табуляции (`\t`) в указанное количество пробелов.
Пробелы в табуляции: Преобразует последовательности пробелов в один символ табуляции.
Дополнить строку: Добавляет отступ (пробелы или другие символы) в начало или конец каждой строки.
Конвертировать систему счисления: Преобразует числа внутри текста между разными основаниями (например, из десятичной в шестнадцатеричную).
Объединить строки: Объединяет все строки в одну строку, разделенную указанным символом.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Форматирование (`?category=formatting`)

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

Добавить запятые в числа: Добавляет разделители тысяч (запятые) к числам в тексте.
Подсчитать вхождения строк: Подсчитывает, сколько раз каждая уникальная строка встречается в тексте.
HTML в Markdown: Преобразует содержимое HTML в синтаксис Markdown.
HTML в текст: Извлекает содержимое обычного текста из строки HTML, удаляя все теги.
Добавить номера строк: Добавляет номера строк к каждой строке текста.
Перенос слов: Вставляет разрывы строк после указанного количества символов или перед следующим пробелом до этого предела.
Выровнять по центру: Центрирует каждую строку текста, добавляя соответствующие начальные пробелы.
CSV в Markdown: Преобразует строку в формате CSV в структуру таблицы Markdown.
Форматировать как таблицу: Форматирует выбранный текст в структуру таблицы (например, Markdown, CSV).
Обернуть строки: Переносит текст на новую строку по указанной ширине столбца.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Очистка текста (`?category=clear`)

Направлена на базовую очистку и санитизацию текстового содержимого.

Убрать HTML-теги: Удаляет все HTML-теги из ввода, оставляя только обычный текст.
Удалить эмодзи: Убирает все символы эмодзи из текста.
Удалить диакритические знаки: Удаляет диакритические пометки (ударения) с символов (например, é -> e).
Удалить пустые строки: Удаляет строки, содержащие только пробелы или полностью пустые.
Удалить дубликаты строк: Удаляет строки, которые являются точными дубликатами других строк в тексте.
Удалить смежные дубликаты: Удаляет дубликаты строк только если они встречаются подряд.
Удалить управляющие символы: Убирает непечатаемые управляющие символы из текста.
Удалить лишние пробелы: Сворачивает несколько последовательных пробелов в один и удаляет начальные/концевые пробелы.
Очистить вывод LLM: Пытается удалить общие артефакты, такие как вводные фразы или сопроводительные комментарии, часто встречающиеся в выводе больших языковых моделей.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Регистр текста (`?category=case`)

Применяет различные преобразования капитализации и формата символов.

Создать slug: Преобразует текст в дружественный URL slug (например, "Привет мир!" становится "privet-mir").
Обратить текст: Меняет порядок символов в тексте на противоположный.
ВЕРХНИЙ РЕГИСТР: Преобразует все буквы в верхний регистр.
нижний регистр: Преобразует все буквы в нижний регистр.
Заглавные буквы: Делает заглавной первую букву каждого слова.
Предложение: Делает заглавной первую букву каждого предложения.
Изменить регистр текста: Предлагает различные варианты изменения регистра текста.
Нормализовать Unicode: Нормализует символы Unicode к стандартной форме.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

JSON операции (`?category=json`)

Предоставляет инструменты для синтаксического анализа, форматирования и преобразования данных JSON.

Извлечь JSON: Пытается найти и извлечь объекты или массивы JSON из текста.
Экранировать JSON: Экранирует специальные символы в строке, чтобы ее можно было безопасно включить в строку JSON.
Убрать экранирование JSON: Убирает экранирование строки JSON.
Проверить JSON: Проверяет, является ли входная строка действительным синтаксисом JSON.
Конвертировать JSON в YAML: Преобразует объект/массив JSON в структуру YAML.
Конвертировать JSON в CSV: Преобразует массив JSON в формат CSV.
Конвертировать JSON в XML: Преобразует объект/массив JSON в структуру XML.
Конвертировать JSON в TOML: Преобразует объект/массив JSON в структуру TOML.
Форматировать JSON: Форматирует данные JSON с отступами для лучшей читаемости.
Минифицировать JSON: Удаляет весь ненужный пробел из данных JSON, делая их компактными.
Запрос JSON Path: Использует выражение JSONPath для извлечения конкретных значений из структуры JSON.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

YAML операции (`?category=yaml`)

Предоставляет инструменты для синтаксического анализа, проверки и конвертации данных YAML.

Проверить YAML: Проверяет, является ли входная строка действительным синтаксисом YAML.
YAML в JSON: Конвертирует содержимое YAML в форматированный JSON с настраиваемыми отступами.
Форматировать YAML: Разбирает и пересобирает YAML для единообразного форматирования и читаемости.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Кодирование/Декодирование (`?category=encoding`)

Обрабатывает общие схемы кодирования и декодирования текста.

Нормализовать Unicode: Нормализует символы Unicode к стандартной форме.
Base64 Кодировать: Кодирует входную строку с использованием Base64.
Base64 Декодировать: Декодирует строки, закодированные в Base64.
URL Кодировать: Кодирует специальные символы в строке для безопасного использования в URL.
URL Декодировать: Декодирует строки, закодированные в URL, обратно к их первоначальной форме.
HTML Кодировать: Преобразует специальные символы в соответствующие HTML-сущности.
HTML Декодировать: Преобразует HTML-сущности обратно в соответствующие символы.
Декодировать JWT: Декодирует заголовок и полезную нагрузку JWT (токена веб-маркера JSON) без проверки подписи.
Проверить JWT: Проверяет структуру и подпись токена JWT.
Кодировать/Декодировать: Общая операция для кодирования или декодирования текста.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Генераторы (`?category=generator`)

Создает новый текстовый контент или добавляет сгенерированные элементы к существующему тексту.

Сгенерировать числовую последовательность: Вставляет последовательность чисел (например, 1, 2, 3...) в текст.
Сгенерировать GUID: Создает случайный GUID (глобально уникальный идентификатор).
Сгенерировать пароль: Генерирует надежный пароль на основе заданных критериев (длина, типы символов).
Сгенерировать числа: Создает список случайных чисел.
Сгенерировать временную метку: Добавляет текущую дату и время.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Сортировка и фильтрация (`?category=sort`)

Организует строки текста или данные на основе заданных правил.

Перемешать строки: Случайным образом меняет порядок строк.
Выбрать случайные строки: Случайным образом выбирает указанное количество строк из ввода.
Сортировать строки: Сортирует строки по алфавиту, числу, длине, количеству слов или другим методам (по возрастанию или убыванию).
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Извлечение данных (`?category=extract`)

Определяет и извлекает конкретные типы данных из входного текста.

Извлечь email: Находит и перечисляет адреса электронной почты.
Извлечь URL: Находит и перечисляет веб-адреса.
Извлечь хештеги: Находит и перечисляет хештеги (например, #пример).
Извлечь телефоны: Находит и перечисляет телефонные номера, соответствующие общим шаблонам.
Извлечь IP адреса: Находит и перечисляет IPv4 и IPv6 адреса.
Извлечь даты: Находит и перечисляет даты.
Извлечь числа: Находит и перечисляет числовые значения.
Извлечь MAC адреса: Находит и перечисляет MAC-адреса.
Извлечь Markdown ссылки: Находит и перечисляет ссылки, отформатированные в синтаксисе Markdown.
Извлечь упоминания: Находит и перечисляет упоминания (например, @имяпользователя).
Извлечь с помощью regex: Использует пользовательский шаблон регулярного выражения для поиска и извлечения совпадающих подстрок.
Найти и заменить: Осуществляет поиск указанной строки или шаблона и заменяет его другой строкой.

Советы

Проверяйте связанные категории: Некоторые операции могут подходить для нескольких категорий.
Разбивайте сложные задачи на шаги: Комбинируйте операции из разных категорий последовательно — каждая операция добавляется в историю отмены.
Используйте Undo/Redo для сравнения: Переключайтесь между состояниями (Ctrl+Z / Ctrl+Shift+Z), чтобы быстро сравнить результат до и после любой операции.
Поиск по ключевому слову: Попробуйте искать конкретные термины в строке поиска инструмента.
Изучите документацию: Более подробные руководства и примеры доступны в основной документации.
Используйте регулярные выражения эффективно: Для сложных преобразований изучите операции поиска и замены, где описаны все возможности работы с регулярными выражениями.
Тестируйте регулярные выражения постепенно: Начинайте с простых шаблонов и постепенно усложняйте их.
Сохраняйте исходный текст: Перед выполнением сложных замен всегда сохраняйте копию исходного текста.
Используйте группы захвата для сложных преобразований: `$1`, `$2`, `$3` позволяют переставлять части текста при замене.