VersionMgr

version 0.9.11 – 2021-10-07 – Auteur : Jean-François Nifenecker, Bordeaux.

Outil de gestion des versions des documents LibreOffice

VersionMgr permet de maintenir un système cohérent pour les versions de vos documents :

La barre d'outils | Le dialogue principal | Le schéma de numérotation | Les masques | Les métadonnées | Localisation | Crédits | Auteur | Licence

La barre d’outils

VersionMgr dispose d’une barre d’outils dédiée. Celle-ci comporte trois boutons qui donnent accès aux trois fonctionnalités (de gauche à droite) :

Édition : Définition des informations de version pour le document actuellement ouvert (dialogue principal).

Suppression : Suppression de toutes les informations de version pour le document actuellement ouvert (demande de confirmation).

Enregistrement : Enregistrement rapide du document actuellement actif avec auto-incrémentation (utile uniquement lorsque vous avez paramétré l’auto-incrémentation du numéro de version).

Les icônes des boutons proviennent du site IconDB (https://www.iconsdb.com/) et sont librement réutilisables.

Le dialogue principal

Ce dialogue a pour objet de définir les paramètres de version. Vous pouvez utiliser les éléments suivants :

Élément

Contenu

Notes

Auteur

Le nom de l’auteur.

Ce peut être un nom arbitraire ou bien récupéré à partir des données utilisateur.

N° de version

Le numéro de version.

Constitué de trois parties :

  • le numéro de version majeure (0-999).

  • le numéro de version mineure (0-999).

  • le numéro de révision (0-9999).

(paramétrage courant)

Affichage des paramètres de numérotation.

Dans l’ordre : version majeure / version mineure / révision.

Une lettre par niveau :

N : numéro ; M : lettre majuscule ; m : lettre minuscule.

[+1] : auto-incrément au niveau choisi s’il existe.

Bouton Schéma

Accès au dialogue de sélection du schéma de numérotation.


Build

La valeur de « construction » (build).

Toute suite arbitraire de caractères (max. 64 caractères).

Peut être ajoutée au nom du fichier (masque %%B).

Reportez-vous aux éléments des masques ci-dessous.

Date

Une date.

Le choix de l’Auto-incrémentation ci-dessus entraîne la mise à jour automatique de la date lors des enregistrements avec le bouton Enregistrement .

Notes

Des annotations et commentaires pour votre usage.

Max. 464 caractères (8 lignes de 58).

Radical fichier

La racine du nom du document.

Information obligatoire !

L’étiquette est en rouge lorsque ce nom n’est pas défini.

Masque de fichier

Le masque du nom du fichier.

Une ligne de prévisualisation est affichée sous la zone d’édition.

Reportez-vous aux éléments des masques ci-dessous.

L’étiquette de cette rubrique est en rouge lorsque le masque ne contient pas le marque-place %%F (qui marque le radical du nom du fichier).

Masque du titre

Le masque pour le titre du document.

Une ligne de prévisualisation est affichée sous la zone d’édition.

Reportez-vous aux éléments des masques ci-dessous.

Max. 100 caractères.

Laissez vide si vous ne voulez pas que le titre soit généré par VersionMgr.

Le dialogue possède cinq boutons :

Le schéma de numérotation

Ce dialogue permet de choisir le mode de numérotation désiré et son auto-incrémentation.

Élément

Contenu

Notes

Version majeure

Version mineure

Révision

Choix du type de numérotation, parmi :

  • Nombre

  • Majuscule

  • Minuscule


Incrément : Type

Choisissez dans la liste le type d’auto-incrément désiré, parmi :

  • (aucun)

  • Révision

  • Version mineure

  • Version majeure

VersionMgr actualise automatiquement le numéro de version et la date lors du clic sur le bouton Enregistrement.

L’auto-incrémentation progresse selon le pas à partir du niveau choisi. Lorsque la valeur maximale est atteinte, elle est remise à zéro et le niveau supérieur est incrémenté.

La fonctionnalité d’auto-incrémentation n’est disponible qu’au travers du bouton Enregistrement de VersionMgr.

Dans ce cas, la date de version est actualisée à la date courante.

Incrément : Pas

Le pas d’incrément.

1..10

Éléments des masques

Le nom du document (fichier) et son titre peuvent être définis automatiquement au moyen de masques. Les éléments de masques suivant sont supportés.

Masque

Utilisé pour insérer…

%%A ou %%a

Nom de l’auteur (rubrique Auteur du dialogue), en majuscules (%%A) ou en minuscules (%%a).

Voir aussi %%I.

%%B

Référence de construction.

%%D

Date, au format ISO (AAAAMMJJ).

%%F

Nom du radical du fichier.

La présence de ce sous-masque est obligatoire dans le masque du nom du fichier.

%%I ou %%i

Initiales de l’utilisateur, en majuscules (%%I) ou en minuscules (%%i).

Selon ce qui a été saisi dans le menu Outils > Options, options Données utilisateur.

Voir aussi %%A.

%%M

Numéro de version majeure.

L’insertion de zéros (0) entre %% et M permet d’obtenir une valeur de la longueur correspondant au nombre de zéros.

Exemple : la valeur 5 avec un masque %%00M donne 05.

%%m

Numéro de version mineure.

L’insertion de zéros (0) entre %% et m permet d’obtenir une valeur de la longueur correspondant au nombre de zéros.

Exemple : la valeur 5 avec un masque %%000m donne 005.

%%N ou %%n

Nom complet de l’utilisateur, en majuscules (%N) ou en minuscules (%%n).

Selon ce qui a été saisi dans le menu Outils > Options, options Données utilisateur.

%%R

Numéro de révision.

L’insertion de zéros (0) entre %% et R permet d’obtenir une valeur de la longueur correspondant au nombre de zéros.

Exemple : la valeur 5 avec un masque %%0000R donne 0005.

Les métadonnées

L’enregistrement des paramètres de version s’effectue dans les métadonnées du document. Un champ de métadonnées correspond à chaque paramètre. Les noms de ces champs sont tous préfixés _Version.

L’utilisation des propriétés du document permet :

La localisation

VersionMgr est développé en anglais. L’interface est conçue pour pouvoir s’adapter automatiquement à la localisation de LibreOffice utilisée. Sous la version actuelle, il existe deux locales : l’anglais, en tant que langue par défaut, et le français puisque c’est ma langue maternelle.

La localisation est rendue possible au moyen de fichiers PO (https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html) (pour l’interface) et d’un fichier d’aide en HTML (pour l’aide). L’ajout d’autres langues est donc facilité.

Les fichiers PO sont stockés dans le sous-répertoire po de l’extension. Les fichiers d’aide HTML et les images associées sont rangés dans le sous-répertoire help de l’extension. Ces différents fichiers sont automatiquement utilisés lorsqu’ils sont adaptés à la localisation courante. Dans le cas contraire, l’interface reste en anglais.

Création d’un fichier PO

  1. Ouvrez le modèle .pot fourni (fichier en.pot).

  2. Éditez-le au moyen de n’importe quel éditeur de texte et remplissez les chaînes msgstr (ne touchez pas aux msgid’s !).

  3. Enregistrez vos modifications sous un fichier xx.po, où xx sont les deux lettres du code de langue (en : anglais, de : allemand, etc.)

  4. Copiez le fichier dans le sous-répertoire po et c’est tout. Au prochain lancement, l’interface devrait être adaptée à votre langue.

N’oubliez pas d’envoyer le fichier PO ainsi réalisé à l’auteur de VersionMgr afin qu’il y soit intégré. Vous recevrez crédit de votre travail dans cette page d’aide.

Création d’un fichier d’aide

  1. Ouvrez le fichier d’aide HTML en anglais (help_en.html).

  2. Traduisez-le dans la langue de votre choix (LibreOffice Writer peut être utilisé pour ça).

  3. Enregistrez-le en conséquence : help_xx.html, où xx sont les deux lettres du code de langue (en : anglais, it : italien, etc.)

  4. Copiez-le dans le sous-répertoire de l’aide et c’est tout. Au prochain démarrage, l’aide sera adaptée à votre langue.

N’oubliez pas d’envoyer le fichier HTML ainsi réalisé à l’auteur de VersionMgr afin qu’il y soit intégré. Vous recevrez crédit de votre travail dans cette page d’aide.

Crédits

Auteur

Jean-Francois Nifenecker, Bordeaux (France)

jean-francois.nifenecker@laposte.net

Tests et suggestions

Tous mes remerciements au panel de testeurs dont plusieurs ont choisi l’anonymat. Merci à Philippe Hemmel et à Éric Hoffmann.

Icones

Les icones proviennent du site web IconDB : https://www.iconsdb.com/

Traductions

(aucune actuellement)

Historique

Version

Date

Notes

0.9.11

2020-10-07

Première version publique.

Licence

VersionMgr est placé sous licence GNU GPL v3 et suivantes. Pour plus d’informations, lisez ceci :

https://www.gnu.org/licenses/gpl-3.0.fr.html

Heckert gnu.small.png