RU/extensions/writer/minicorrector

 < Энциклопедия | Расширения | Writer

Мини-Корректор

Тип	Расширение
Разработчик	Н. Е. Г.; Инфра-Ресурс
Язык программирования	StarBASIC
Модуль	Writer
ОС	независимо
Последняя версия	2.2.1
Лицензия	GNU LGPL v. 3.0
Сайт	i-rs.ru

Загрузить текущую версию MiniCorrector.oxt

Описание

«Мини-Корректор» создан для автоматической корректуры текста в пакете InfraOffice.pro. Осуществляет глобальный поиск и замену по всему документу по списку правил. Список правил может применяться в целом и выборочно, может быть изменён, экспортирован и импортирован.

Новое в «Мини-корректоре» 2.2.1

«Мини-корректор» 2.2.1 отличается от предыдущих версий:

1. Изменён путь хранения файла пользовательских правил. Начиная с этой версии файл с правилами пользователя хранится в пользовательском профиле InfraOffice. pro. Ранее файл настроек хранился в каталоге расширения, что делало не возможным его редактирование пользователем при административной установке.

~/.InfraOffice/3/user/config

%USERPROFILE%\InfraOffice\3\user\config

2. Исправлены незначительные ошибки.

Установка

Установка в первый раз

Установка «Мини-корректора» производится штатными средствами через меню Сервис → Управление расширениями или при помощи утилиты командной строки unopkg:

• установка для одного пользователя:

echo yes | unopkg add Minicorrector.oxt

• установка для всех пользователей:

echo yes | unopkg add –-shared Minicorrector.oxt

Обновление с версии ранее 2.2.1

При обновлении расширения с версии меньшей, чем 2.2.1, необходимо:

1. Сохранить пользовательские правила в файле через функцию Экспорт;
2. Установить (обновить) Мини-корректора, как указано выше;
3. Загрузить пользовательские правила через функцию Импорт (см. Рис. 3).

Работа с Мини-корректором

Вызов расширения

«Мини-корректор» может быть вызван через меню:

• Правка → Мини-корректор - вызов главного окна приложения;

• Сервис → Настройка Мини-корректора - вызов окна редактирования правил.

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

Главное окно

Рис. 1: Главное окно

Главное окно служит для запуска «Мини-корректора» и отражения статистики работы - Рис. 1

Кнопка  Правила  служит для вызова окна редактора правил.

ВАЖНО! Щелчок кнопки с комбинацией клавиш <Ctrl> + <Shift> приводит к загрузке списка правил по-умолчанию. При этом текущий список правил уничтожается. Для сохранения списка правил используйте функции Экспорт и Импорт (см. Окно редактора правил).

Кнопка  Выполнить  запускает расширение на исполнение.

Кнопка  Выход  закрывает окно расширения, прерывая его работу.

Первая строка содержит информацию об общем числе правил в наборе «Мини-корректора» и о том, сколько из них будет использовано (см. Окно редактора правил).

Пиктограмма «Мини-корректора» служит для вызова окна контроля версии - О программе.

Рядом с пиктограммой две строки, где отражается статистика применения правил во время работы расширения.

Принцип работы «Мини-корректора»

Работа «Мини-корректора» начинается по нажатию кнопки  Выполнить . Работая, «Мини-корректор» выбирает из списка используемые правила и осуществляет глобальный поиск и замену по всему документу согласно приоритетам используемых правил (см. Редактирование содержания правил).

Рис. 2: Индикатор работы приложения

Во время работы «Мини-корректора» в первой строке отображается название применяемого в данный момент времени правила корректуры, ленточный индикатор показывает отношение обработанных правил к числу используемых правил из списка - Рис. 2.

ВАЖНО! Результат работы «Мини-корректора» не сохраняется автоматически, если не включено авто сохранение документа. Используйте команду Файл → Сохранить после применения «Мини-корректора».

Окно редактора правил

Рис. 3: Окно редактора правил

Окно редактора правил служит для управления списком применяемых правил и создания редактирования списка правил - Рис. 3.

Список применяемых правил находится в верхней части окна. Список содержит названия правил. Содержание правил отражается в нижней части окна в строках под заголовками «Найти» и «Заменить на».

Кнопка  Записать  закрывает окно редактора правил, сохраняя результат редактирования.

ВАЖНО! Для закрытия редактора правил без сохранения результата редактирования используйте кнопку  Закрыть окно  (маленькая кнопка с крестиком на панели окна) или клавишу  Esc .

Управление списком правил

Рис. 4: Управление списком правил

Элементы управления списком используемых правил находятся справа от него - Рис. 4. Используемые «Мини-корректором» правила помечены [*] (звёздочкой в квадратных скобках) слева от названия правила в списке. Если звёздочки в квадратных скобках слева от названия правила в списке нет ([ ]), то правило игнорируется, не применяется «Мини-колрректором».

Кнопка  Включить  - включает/выключает выделенное правило.

Кнопка  Включить все  - включает/выключает список правил целиком.

Рис. 5: Диалог ввода краткого названия правила

Кнопка  Создать  - вызывает диалог создания правила, где требуется ввести краткое название правила, отражаемое в списке правил - Рис. 5.

Рис. 6: Диалог переименования правила

Кнопка  Поменять  - вызывает диалог переименования правила - Рис. 6.

Кнопка  Удалить  - удаляет правило из списка. Если отметить флажок  Спрашивать , расположенный над кнопкой  Удалить , то будет появляться окно подтверждения перед удалением правил.

Экспорт и Импорт правил

Функции удаления и редактирования правил необратимы и могут приводить к потерям.

Для исключения потерь правил служат функции  Экспорт  и  Импорт , вызываемые соответствующими кнопками внизу окна редактора правил - Рис. 3.

Файл правил «Мини-корректора» — это текстовый файл, в формате .desktop файлов GNOME или .ini файлов Windows. Подробнее в разделе Файл правил «Мини-корректора».

Редактирование содержания правил

Рис. 7: Редактирование содержания правил

Для перехода в режим редактирования содержания правил, необходимо и достаточно отметить флажок  Просмотр/Редактирование , находящийся под списком используемых правил - Рис. 7.

Отметка флажка  Просмотр/Редактирование  делает доступным поля содержания правил. Снятие отметки сохраняет отредактированное правило.

Содержание правила «Мини-корректора» состоит всего из двух частей: что найти и на что заменить, если найдено.

Окно ввода Найти - содержит искомую строку. Синтаксис строки поиска такой же, как в диалоге  Поиск и замена  в InfraOffice.pro.

Флажок  регулярное выражение  отмечается, если в ищется регулярное выражение.

Флажок  учитывать регистр  отмечается, если в поиске важно строгое соответствие регистру.

Флажок  только целые слова  отмечается, если в поиске требуется игнорировать части слов.

Окно ввода  Заменить на  - содержит строку подстановки вместо найденной. Синтаксис строки замены такой же, как в диалоге  Поиск и замена  в InfraOffice.pro с небольшим расширением в виде функций MakeStr() и Chr(), да знака конкатенации срок '+'.

Функция Chr() используется для ввода в редакторе непечатаемых символов. Например, Chr(160) — неразрывный пробел; Chr(8) — табулятор.

Функция MakeStr() используется для объединения в одной строке замены переменных поиска и непечатных символов или задания пустых строк. Например, MakeStr(NULL) — вставить пустую строку; MakeStr($1 + chr(8209) + $2) — создать сроку замены из первой и второй переменой поиска, разделив их неразрывным тире.

Есть ещё два элемента правила.

Поле ввода  Приоритет  под списком используемых правил, в котором задаётся порядок применения правил для исключения коллизий. Приоритет — это любое целое число. Правила выполняются в порядке возрастания приоритета.

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

Многострочное окно ввода под флажком  Просмотр/Редактирования  служит для расширенного описания правила и носит информативный характер.

Окно «О программе»

Рис. 8: Информационное окно "О программе"

Окно «О программе» вызывается щелчком по пиктограмме главного окна «Мини-корректора». Это окно содержит справочную информацию о расширении, в т. ч. версию расширения, версию InfraOffice.pro.

Файл правил «Мини-корректора»

Файл правил «Мини-корректора» хранится в пользовательском каталоге конфигурации InfraOffice.pro

~/.InfraOffice/3/user/config

%USERPROFILE%\InfraOffice\3\user\config

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

xx_MiniCorrector.cfg

В имени файла 'xx' — это локаль правил. Например,

ru_MiniCorrector.cfg — правила для русского языка.

или

en_MiniCorrector.cfg — правила для английского языка.

«Мини-корректор» выбирает язык правил автоматически в зависимости от локализации InfraOffice.pro.

Структура файла правил

Файл правил «Мини-корректора» — это текстовый файл, в формате .desktop-файлов GNOME или .ini-файлов Windows.

В секциях хранятся краткие названия правил, отображаемые в списке используемых правил редактора (см. Рис. 7). В параметрах секций хранится содержание правил.

[Пробел множественный]
Description = "Удаление множественных пробелов."
IsEnabled = True
IsRegular = True
SearchStr = "[\x0020]{2,}"
ReplaceStr = MakeStr(Chr(32))
Order = 0

Порядок записи полей содержания может быть любым. Для пропущенных полей подставляются значения по-умолчанию.

Поля правила в файле

Description 

— описание правила. По-умолчанию — пустая строка.

IsEnabled 

— правило используется. По-умолчанию — FALSE.

IsRegular 

— в правиле регулярное выражение. По-умолчанию — FALSE.

SearchStr 

— строка поиска. По-умолчанию — пустая строка.

ReplaceStr 

— строка заменя. По-умолчанию — пустая строка.

IsCaseSensitive 

— строгое соответствие регистра. По-умолчанию — FALSE.

IsWord 

— игнорировать часть слова. По-умолчанию — FALSE.

Order 

— приоритет правила. По-умолчанию‑0 (высший).

Дистрибутив

Скачать все версии «Мини-корректора» можно по следующей ссылке:

Все версии: File:MiniCorrector.oxt

---

А. Е. Харламенков

---

InfraOffice.pro 3.1.x

---

---

К началу страницы