VersionMgr
version 0.9.11 – 2021-10-07 – Auteur : Jean-François Nifenecker, Bordeaux.
Outil de gestion des versions des documents LibreOffice
|
VersionMgrversion 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 :
Automatisation de la numérotation.
Choix de ce qui doit apparaître dans le nom du document et dans le nom du fichier.
Choix du schéma de numérotation (type de numéro et auto-incrémentation).
Intégration des informations de version à l’intérieur des métadonnées du document.
La barre d'outils | Le dialogue principal | Le schéma de numérotation | Les masques | Les métadonnées | Localisation | Crédits | Auteur | Licence
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.
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 :
|
(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). |
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 :
OK
Validation du dialogue.
Ce bouton n’est actif que si le nom racine du document est défini et le masque du nom du fichier contient le sous-masque %%F.
Lors du clic sur OK, VersionMgr enregistre le document en tenant compte des paramètres saisis.
Notez que la sauvegarde proposée ici ne tient pas compte de l’auto-incrémentation si elle a été demandée.
Annuler
Annulation des modifications en cours et retour au document.
Aide
Accès à l’aide (ici !)
Réinitialiser
Remise des zones de saisie aux valeurs par défaut.
À propos
Affiche la boîte À propos.
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 :
|
|
Incrément : Type |
Choisissez dans la liste le type d’auto-incrément désiré, parmi :
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 |
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. |
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 :
De les réutiliser facilement dans le corps du document.
D’y accéder depuis le système d’exploitation.
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.
Ouvrez le modèle .pot fourni (fichier en.pot).
Éditez-le au moyen de n’importe quel éditeur de texte et remplissez les chaînes msgstr (ne touchez pas aux msgid’s !).
Enregistrez vos modifications sous un fichier xx.po, où xx sont les deux lettres du code de langue (en : anglais, de : allemand, etc.)
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.
Ouvrez le fichier d’aide HTML en anglais (help_en.html).
Traduisez-le dans la langue de votre choix (LibreOffice Writer peut être utilisé pour ça).
Enregistrez-le en conséquence : help_xx.html, où xx sont les deux lettres du code de langue (en : anglais, it : italien, etc.)
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.
Jean-Francois Nifenecker, Bordeaux (France)
jean-francois.nifenecker@laposte.net
Tous mes remerciements au panel de testeurs dont plusieurs ont choisi l’anonymat. Merci à Philippe Hemmel et à Éric Hoffmann.
Les icones proviennent du site web IconDB : https://www.iconsdb.com/
(aucune actuellement)
Version |
Date |
Notes |
|---|---|---|
0.9.11 |
2020-10-07 |
Première version publique. |
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
