VersionMgr

версия 0.9.12 – 2022-08-15 – Автор: Jean-François Nifenecker, Bordeaux.

Инструмент управления версиями документов LibreOffice.

VersionMgr помогает поддерживать согласованную схему управления версиями для ваших документов:

Панель_инструментов | Главное_диалоговое_окно | Схема_нумерации | Элементы_маски | Метаданные | Локаль | Список_участников | Автор | Лицензия

Панель инструментов

VersionMgr имеет специальную панель инструментов с тремя кнопками для доступа к трём функциям (слева направо):

Редактировать: установить информацию о версии для текущего документа, вызвав главное диалоговое окно.

Удалить: удалить всю информацию о версии из текущего документа (запрашивает подтверждение).

Сохранить: быстрое сохранение текущего документа с автоинкрементом (полезно, только если вы установили параметр автоинкремента номера версии).

Значки панели инструментов из IconDB (https://www.iconsdb.com/) и свободно доступны.

Главное диалоговое окно

Это диалоговое окно помогает установить информацию о версии. Доступны следующие настройки:

Редактирование

Содержимое

Примечания

Author name

Имя автора.

Эта информация может быть произвольным именем или получена из пользовательских данных.

Version #

Номер версии.

Состоит из трех частей :

основной номер версии (0-999).

дополнительный номер версии (0-999).

номер версии (0-9999).

(current numbering settings)

Показ настроек нумерации.

Сверху вниз: мажорная версия / минорная версия/ ревизия.

Буква по уровню:

N: число; M: буква верхний регистр; m: буква нижний регистр.

[+1]: автоинкремент для этого уровня, иначе ничего.

Numbering scheme button

Доступ к диалогу numbering scheme.


Build ID

Значение «build».

Любой произвольный набор символов (макс. 64 символа).

Идентификатор сборки может быть добавлен к имени файла с использованием маски %%B.

См. элементы маски ниже.

Date

Любая дата.

Выбор Auto-inc подразумевает автоматическое обновление даты при сохранении с помощью кнопки Сохранить .

Comments

Произвольные комментарии для вашего собственного использования.

Макс. 464 символа (8 строк из 58).

File root name

Имя корня документа.

Эта информация обязательна!

Эта метка редактирования отображается красным цветом, если имя корня не задано.

File mask

Маска файла для документа.

Предварительный просмотр отображается под полем редактирования.

См. элементы маски ниже.

Эта метка редактирования отображается красным цветом, если маска не содержит подмаски %%F (имя корня документа).

Title mask

Маска заголовка документа.

Предварительный просмотр отображается под полем редактирования.

См. элементы маски ниже.

Макс. 100 символов.

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

Диалог содержит пять кнопок:

Схема нумерации

Этот диалог позволяет выбрать режим нумерации и автоматический выбор шага инкремента.

Элемент

Содержимое

Примечания

Major Version

Minor Version

Revision

Выбор типа нумерации:

Число

Прописная буква

Строчная буква


Increment: Type

Выберите желаемый уровень автоинкремента.

Возможные значения:

(ничего)

Редакция

минорная версия

мажорная версия

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

Авто-инкремент прогрессирует в соответствии с определённым шагом. Когда достигается максимальное значение, оно устанавливается на 0, а следующий уровень, в свою очередь, увеличивается. Нижние уровни сбрасываются на 0.

Функциональность auto-inc доступна только через кнопку «Сохранить» диспетчера версий.

Обратите внимание, что тогда дата версии также обновляется до текущей.

Increment: Step

Шаг инкремента.

1..10

Элементы маски

Имя и заголовок документа можно задать автоматически с помощью масок. Поддерживаются следующие элементы масок.

Маска

Использовать для вставки

%%A или %%a

Имя автора (как через настройки Author в диалоге), ВЕРХНИЙ регистр (%%A) или нижний регистр (%%a).

См. также %%I.

%%B

Значение билда.

%%D

Дата, в ISO формате (YYYYMMDD).

%%F

Имя корня файла.

Эта субмаска необходима в маске корня имени.

%%I или %%i

Инициалы пользователя, ВЕРХНИЙ регистр (%%I) или нижний регистр (%%i).

Как определено в настройках LibreOffice Сервис > Параметры > Пользователь.

См. также %%A.

%%M

Номер основной версии.

Если вы вставляете 0 (нули) между %% и M, значение дополняется до этой длины нулями.

Пример: значение 5 с маской %%00M дает 05.

%%m

Второстепенный номер версии.

Если вы вставляете 0 (нули) между %% и m, значение дополняется до этой длины нулями.

Пример: значение 5 с маской %%000m дает 005.

%%N or %%n

Полное имя пользователя, в верхнем (%%N) или нижнем (%%n) регистре.

Как указано в инструментах LibreOffice Сервис > Параметры > Пользователь.

%%R

Номер ревизии.

Если вы вставляете 0 (нули) между %% и R, значение дополняется до этой длины нулями.

Пример: значение 5 с маской %%0000R дает 0005.

Метаданные

В результате сохранения настроек диалога вы обнаружите, что эти настройки сохраняются как метаданные документа. Каждая настройка представляет собой свойство, имя которого начинается с _Version.

Использование свойств документа позволяет:

Локаль

VersionMgr- разрабатывается на английском языке. Пользовательский интерфейс предназначен для автоматической адаптации к текущей локализации среды LibreOffice. В текущей версии поддерживаются только два языковых стандарта пользовательского интерфейса: английский, как резервный язык по умолчанию, и французский, мой родной язык.

Языковая локализация доступна через файлы PO. (https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html) (для UI) и файл справки HTML (для справки). Таким образом, добавление других языков легко.

Файлы PO хранятся в подкаталоге с расширением po. Файлы справки в формате HTML хранятся в подкаталоге справки расширения. Локализованные файлы выбираются автоматически, когда они соответствуют текущей локали, в противном случае английский язык является резервным языком пользовательского интерфейса.

Создание нового PO-файла

  1. Откройте предоставленный текстовый файл шаблона .pot (en.pot).

  2. Отредактируйте его с помощью любого текстового редактора и заполните строки msgstr (не трогайте msgid!).

  3. Сохраните как файл xx.po, где xx обозначает двухсимвольный код языка (en: английский, de: немецкий и т. д.)

  4. Скопируйте его в подкаталог po и все. При следующем запуске пользовательский интерфейс должен быть настроен на ваши строки.

Не забудьте отправить автору выпущенный PO-файл. Вы будете отмечены за это на этой странице справки.

Создание нового файла справки

  1. Откройте англоязычную версию HTML-справки (help_en.html).

  2. Переведите его на выбранный вами язык.

  3. Назовите его соответствующим образом: help_xx.html, где xx– двухсимвольный код языка (en: английский, it: итальянский и т. д.)

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

Не забудьте отправить автору выпущенный HTML-файл. Вы будете отмечены за это на этой странице справки.

Список участников

Автор

Jean-Francois Nifenecker, Bordeaux (Франция)

jean-francois.nifenecker@laposte.net

Тесты и предложения

Большое спасибо группе тестировщиков. Многие из них предпочли остаться анонимными. Выражаем благодарность Philippe Hemmel и Éric Hoffmann.

Иконки

Значки взяты с веб-сайта IconDB: https://www.iconsdb.com/

Переводы

(ru-RU)

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

Версия

Дата

Примечания

0.9.11

2020-10-07

First public version.

0.9.12

2022-08-15

Localized version (ru-RU).

Лицензия

VersionMgr выпускается под лицензией GNU GPL v3 и выше. Больше информации здесь:

https://antirao.ru/gpltrans/gplru.pdf



Heckert gnu.small.png