Difference between revisions of "RU/extensions/writer/minicorrector"

From Wiki
Jump to navigationJump to search
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<section begin=title /><noinclude>{{DISPLAYTITLE:Расширения {{OOoW|1}}. </noinclude>Мини-Корректор (MiniCorrector.oxt)<noinclude>}}</noinclude><section end=title />
 
<section begin=title /><noinclude>{{DISPLAYTITLE:Расширения {{OOoW|1}}. </noinclude>Мини-Корректор (MiniCorrector.oxt)<noinclude>}}</noinclude><section end=title />
 
{{BreadCrumbL10n}}
 
{{BreadCrumbL10n}}
−
 
 
<section begin=anonce /><noinclude>
 
<section begin=anonce /><noinclude>
 
{{Software
 
{{Software
−
| softwaretitle         = Мини-Корректор
+
| softwaretitle = Мини-Корректор
−
| type                 = Расширение
+
| type = Расширение
−
| developer             = Н. Е. Гарбуз. Инфра-Ресурс
+
| developer = Н. Е. Г.; Инфра-Ресурс
−
| programminglanguage   = StarBASIC
+
| programminglanguage = StarBASIC
−
| os                   = независимо
+
| module = {{IopW|1}}
−
| latestversion         = 2.2.1
+
| os = независимо
−
| license               = License
+
| latestversion = 2.2.1
−
| site                 = i-rs.ru
+
| license = GNU&nbsp;LGPL&nbsp;v.&nbsp;3.0
−
}}__TOC__
+
| site = [http://i-rs.ru i-rs.ru]
 +
}}
 +
{| align="left"
 +
|__TOC__
 +
|}
 +
 
 +
{| align="right"
 +
|{{Load|MiniCorrector.oxt|MiniCorrector.oxt}}
 +
|}<br clear="all" />
 
== Описание ==
 
== Описание ==
 
</noinclude>
 
</noinclude>
Line 26: Line 33:
 
:1. Изменён путь хранения файла пользовательских правил. Начиная с&nbsp;этой версии файл с&nbsp;правилами пользователя хранится в&nbsp;пользовательском профиле InfraOffice. pro. Ранее файл настроек хранился в&nbsp;каталоге расширения, что делало не&nbsp;возможным его редактирование пользователем при административной установке.
 
:1. Изменён путь хранения файла пользовательских правил. Начиная с&nbsp;этой версии файл с&nbsp;правилами пользователя хранится в&nbsp;пользовательском профиле InfraOffice. pro. Ранее файл настроек хранился в&nbsp;каталоге расширения, что делало не&nbsp;возможным его редактирование пользователем при административной установке.
  
−
{{DocLinux|{{Path|~/. InfraOffice/3/user/config}}}}
+
{{DocLinux|{{Path|~/.InfraOffice/3/user/config}}}}
 
{{DocWindows|{{Path|%USERPROFILE%\InfraOffice\3\user\config}}}}
 
{{DocWindows|{{Path|%USERPROFILE%\InfraOffice\3\user\config}}}}
  
 
:2. Исправлены незначительные ошибки.
 
:2. Исправлены незначительные ошибки.
−
 
  
 
== Установка ==
 
== Установка ==
Line 40: Line 46:
 
* установка для одного пользователя:
 
* установка для одного пользователя:
  
−
  {{Path|unopkg add Minicorrector.oxt}}
+
  {{Path|echo yes {{!}} unopkg add Minicorrector.oxt}}
  
 
* установка для всех пользователей:
 
* установка для всех пользователей:
  
−
  {{Path|unopkg add –-shared Minicorrector.oxt}}
+
  {{Path|echo yes {{!}} unopkg add –-shared Minicorrector.oxt}}
−
 
 
  
 
=== Обновление с версии ранее 2.2.1 ===
 
=== Обновление с версии ранее 2.2.1 ===
Line 101: Line 106:
  
  
−
[[File:MiniCorrector-2.png|250px|thumb|right|''Рис. 2: Индикатор работы приложения'']]Во время работы «Мини-корректора» в&nbsp;первой строке отображается название применяемого в&nbsp;данный момент времени правила корректуры, ленточный индикатор показывает отношение обработанных правил к&nbsp;числу используемых правил из&nbsp;списка - Рис. 2.
+
[[File:MiniCorrector-2.png|250px|thumb|right|''Рис. 2: Индикатор работы приложения'']]Во время работы «Мини-корректора» в&nbsp;первой строке отображается название применяемого в&nbsp;данный момент времени правила корректуры, ленточный индикатор показывает отношение обработанных правил к&nbsp;числу используемых правил из&nbsp;списка - Рис. 2.
  
  
Line 109: Line 114:
 
=== Окно редактора правил ===
 
=== Окно редактора правил ===
  
−
[[File:MiniCorrector-3.png|250px|thumb|right|''Рис. 3: Окно редактора правил'']]Окно редактора правил служит для управления списком применяемых правил и&nbsp;создания редактирования списка правил - Рис. 3.
+
[[File:MiniCorrector-3.png|250px|thumb|right|''Рис. 3: Окно редактора правил'']]Окно редактора правил служит для управления списком применяемых правил и&nbsp;создания редактирования списка правил - Рис. 3.
  
  
Line 123: Line 128:
 
==== Управление списком правил ====
 
==== Управление списком правил ====
  
−
[[File:MiniCorrector-4.png|250px|thumb|right|''Рис. 4: Управление списком правил'']]Элементы управления списком используемых правил находятся справа от&nbsp;него - Рис. 4. Используемые «Мини-корректором» правила помечены '''[*]''' (звёздочкой в&nbsp;квадратных скобках) слева от&nbsp;названия правила в&nbsp;списке. Если звёздочки в&nbsp;квадратных скобках слева от&nbsp;названия правила в&nbsp;списке нет ('''[&nbsp;]'''), то правило игнорируется, не&nbsp;применяется «Мини-колрректором».
+
[[File:MiniCorrector-4.png|250px|thumb|right|''Рис. 4: Управление списком правил'']]Элементы управления списком используемых правил находятся справа от&nbsp;него - Рис. 4. Используемые «Мини-корректором» правила помечены '''[*]''' (звёздочкой в&nbsp;квадратных скобках) слева от&nbsp;названия правила в&nbsp;списке. Если звёздочки в&nbsp;квадратных скобках слева от&nbsp;названия правила в&nbsp;списке нет ('''[&nbsp;]'''), то правило игнорируется, не&nbsp;применяется «Мини-колрректором».
  
  
Line 130: Line 135:
 
Кнопка {{Button|Включить все}} - включает/выключает список правил целиком.
 
Кнопка {{Button|Включить все}} - включает/выключает список правил целиком.
  
−
[[File:MiniCorrector-5.png|250px|thumb|right|''Рис. 5: Диалог ввода краткого названия правила'']]Кнопка {{Button|Создать}} - вызывает диалог создания правила, где требуется ввести краткое название правила, отражаемое в&nbsp;списке правил - Рис. 5.
+
[[File:MiniCorrector-5.png|250px|thumb|right|''Рис. 5: Диалог ввода краткого названия правила'']]Кнопка {{Button|Создать}} - вызывает диалог создания правила, где требуется ввести краткое название правила, отражаемое в&nbsp;списке правил - Рис. 5.
  
  
−
[[File:MiniCorrector-6.png|250px|thumb|right|''Рис. 6: Диалог переименования правила'']]Кнопка {{Button|Поменять}} - вызывает диалог переименования правила - Рис. 6.
+
[[File:MiniCorrector-6.png|250px|thumb|right|''Рис. 6: Диалог переименования правила'']]Кнопка {{Button|Поменять}} - вызывает диалог переименования правила - Рис. 6.
  
  
Line 144: Line 149:
  
  
−
Для исключения потерь правил служат функции {{Button|Экспорт}} и {{Button|Импорт}}, вызываемые соответствующими кнопками внизу окна редактора правил - Рис. 3.
+
Для исключения потерь правил служат функции {{Button|Экспорт}} и {{Button|Импорт}}, вызываемые соответствующими кнопками внизу окна редактора правил - Рис. 3.
  
  
Line 152: Line 157:
 
==== Редактирование содержания правил ====
 
==== Редактирование содержания правил ====
  
−
[[File:MiniCorrector-7.png|250px|thumb|right|''Рис. 7: Редактирование содержания правил'']]Для перехода в&nbsp;режим редактирования содержания правил, необходимо и&nbsp;достаточно отметить флажок {{Button|Просмотр/Редактирование}}, находящийся под списком используемых правил - Рис. 7.
+
[[File:MiniCorrector-7.png|250px|thumb|right|''Рис. 7: Редактирование содержания правил'']]Для перехода в&nbsp;режим редактирования содержания правил, необходимо и&nbsp;достаточно отметить флажок {{Button|Просмотр/Редактирование}}, находящийся под списком используемых правил - Рис. 7.
  
  
Line 196: Line 201:
 
=== Окно «О программе» ===
 
=== Окно «О программе» ===
  
−
[[File:MiniCorrector-8.png|250px|thumb|right|''Рис. 8: Информационное окно "О программе"'']]Окно «О программе» вызывается щелчком по пиктограмме главного окна «Мини-корректора». Это окно содержит справочную информацию о&nbsp;расширении, в т.&nbsp;ч. версию расширения, версию {{Iop}}.
+
[[File:MiniCorrector-8.png|250px|thumb|right|''Рис. 8: Информационное окно "О программе"'']]Окно «О программе» вызывается щелчком по пиктограмме главного окна «Мини-корректора». Это окно содержит справочную информацию о&nbsp;расширении, в т.&nbsp;ч. версию расширения, версию {{Iop}}.
  
  
Line 204: Line 209:
  
  
−
{{DocLinux|{{Path|~/. InfraOffice/3/user/config}}}}
+
{{DocLinux|{{Path|~/.InfraOffice/3/user/config}}}}
  
  
Line 231: Line 236:
  
  
−
В секциях хранятся краткие названия правил, отображаемые в&nbsp;списке используемых правил редактора (см. Рис. 7). В&nbsp;параметрах секций хранится содержание правил.
+
В секциях хранятся краткие названия правил, отображаемые в&nbsp;списке используемых правил редактора (см. Рис. 7). В&nbsp;параметрах секций хранится содержание правил.
  
 
  '''<nowiki>[Пробел множественный]</nowiki>'''
 
  '''<nowiki>[Пробел множественный]</nowiki>'''
Line 245: Line 250:
  
  
−
=== Содержание правил в файле ===
+
=== Поля правила в файле ===
  
 
;Description : — описание правила. По-умолчанию — пустая строка.
 
;Description : — описание правила. По-умолчанию — пустая строка.
Line 257: Line 262:
  
  
−
Скачать текущую версию «Мини-корректора» можно по следующей ссылке: [[File:MiniCorrector.oxt]]
+
== Дистрибутив ==
 +
Скачать все версии «Мини-корректора» можно по следующей ссылке: {{LoadAll|MiniCorrector.oxt}}
 
<section end=toc />
 
<section end=toc />
  

Latest revision as of 07:34, 22 April 2017

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

 Расширение
Разработчик

 Н. Е. Г.; Инфра-Ресурс
Язык программирования

 StarBASIC
Модуль

 Writer
ОС

 независимо
Последняя версия

 2.2.1
Лицензия

 GNU LGPL v. 3.0
Сайт

 i-rs.ru


Описание

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



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

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

1. Изменён путь хранения файла пользовательских правил. Начиная с этой версии файл с правилами пользователя хранится в пользовательском профиле InfraOffice. pro. Ранее файл настроек хранился в каталоге расширения, что делало не возможным его редактирование пользователем при административной установке.
Documentation linux.png ~/.InfraOffice/3/user/config
Documentation windows.png %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


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


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


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


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


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


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


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


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

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


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

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


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


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

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

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


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


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


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


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

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

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


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

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

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

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


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

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


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


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

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


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


Documentation linux.png ~/.InfraOffice/3/user/config


Documentation windows.png %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







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

Retrieved from "https://wiki.harlamenkov.ru/index.php?title=RU/extensions/writer/minicorrector&oldid=22979"