Plugin Word : mise au gabarit

Auteurs

| Thierry GASPERMENT | Claude Leloup |

Cet article décrit la mise au gabarit à l’aide du plugin Word.

- Titre : Plugin Word : mise au gabarit

- Auteurs : Thierry GASPERMENT, Claude Leloup

- Parution : 19 décembre 2013

- Licence : Copyright ® 2013 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Prérequis

- I-A. Installation du plugin Word

- I-B. Affichage de l’onglet DVP Révision

- II. Exemple de mise au gabarit d’une page internet

- II-A. Création d’un nouvel article

- II-B. En-tête et informations de l’article

- II-B-1. En-tête

- II-B-2. Auteurs

- II-B-3. Licence

- II-B-4. Personnalisation, Statiques et Options

- II-B-5. Serveur

- II-B-6. URL

- II-C. Sous-titre et synopsis

- II-D. Contenu de l’article

- II-D-1. Chapitres

- II-D-2. Zones de code

- II-D-2-a. Méthode manuelle

- II-D-2-b. Méthode automatisée

- II-D-2-b-1. Écran de gestion des combinaisons

- II-D-2-b-2. Créer une nouvelle combinaison

- II-D-2-b-3. Définir les opérations

- II-D-2-b-4. Exécuter la combinaison

- II-D-2-b-5. Ajouter un raccourci clavier

- II-D-2-b-6. Partager une combinaison

- II-E. Fin de la mise au gabarit

I - Prérequis

I-A - Installation du plugin Word

Vous devez posséder Word dans une version 2007 ou supérieure.

Pour installer et paramétrer le plugin Word, suivez les instructions de la documentation du plugin article Word docx.

I-B - Affichage de l’onglet DVP Révision

L’onglet « DVP Révision » qui contient les commandes spécifiques à la mise au gabarit n’est pas affiché par défaut.

Cliquez sur le bouton du ruban du plugin Word.

Puis dans le cadre « Correction/mise au gabarit », cochez la case « Afficher l’onglet DVP Révision » pour afficher dans le ruban l’onglet « DVP Révision ».

L’onglet « DVP Révision » s’affiche alors dans le ruban.

II - Exemple de mise au gabarit d’une page internet

Nous allons dérouler la mise au gabarit de la page internet  Installation pas à pas d’un serveur de supervision Shinken.

Voici un aperçu du début de l’article internet :

C’est un cas réel de mise au gabarit.
L’ article en ligne sur DVP a été mis au gabarit à l’aide du plugin OOo.

L’exercice est de faire la même mise au gabarit de ce document avec Word.

II-A - Création d’un nouvel article

Dans le ruban du plugin Word, cliquez sur le bouton « Nouveau ».

Saisissez le nom du dossier de l’article, par exemple « serveur_shinken » et validez.

Un assistant se déclenche pour vous aider à remplir l’en-tête de l’article.

II-B - En-tête et informations de l’article

Cliquez sur le bouton « Suivant » pour passer chaque étape de l’assistant.

II-B-1 - En-tête

La « Rubrique » est par défaut celle que vous avez définie dans les paramètres.
N’oubliez pas de la modifier en fonction de la rubrique ciblée par l’article.

Renseignez ensuite le « Titre page » ou le « Titre article ».

Ici, on copie dans le « Titre page » le titre pris sur la page internet : « Installation pas à pas d’un serveur de supervision Shinken ».

Les champs « Titre article » (ou « Titre page » en fonction du titre renseigné), « Meta : Description » et « Meta : Keywords » sont automatiquement remplis.
Ils peuvent cependant être modifiés.

La « Date de publication » est par défaut la date du jour.

II-B-2 - Auteurs

Par défaut l’auteur est le premier de votre liste d’auteurs.

L’auteur du document doit être celui du blog : « nicolargo ».

Cliquez sur le bouton « Créer un nouvel auteur ».

Remplissez les champs en rouge, par exemple :

- Alias = nicolargo ;

- Rôle = auteur ;

- Nom complet = nicolargo.

Cliquez sur « Valider » ; l’auteur est ajouté à votre liste d’auteurs et sélectionné pour l’article.

II-B-3 - Licence

Le type de licence est par défaut celui que vous avez défini dans les paramètres.
N’oubliez pas de le modifier en fonction de la licence souhaitée pour l’article.

L’auteur et l’année sont renseignés par défaut avec le nom complet de l’auteur et l’année en cours.

II-B-4 - Personnalisation, Statiques et Options

Les onglets suivants (« Personnalisation », « Statiques » et « Options ») sont à renseigner en fonction des options de page et d’upload souhaitées.

II-B-5 - Serveur

Si vous souhaitez faire l’upload de l’article, il faut renseigner le serveur.

Sinon vous pouvez le vider.

II-B-6 - URL

Vérifiez l’URL écrite par défaut si vous souhaitez faire l’upload.

Sinon l’URL pourra être renseignée ultérieurement.

Une fois l’assistant déroulé, cliquez sur « Terminer » ou « Valider » pour sauvegarder les modifications.

II-C - Sous-titre et synopsis

À l’issue de l’assistant, voici l’article sous Word.

Notez en en-tête du document quelques données reprises de l’en-tête d’article.

Puis on trouve le titre de l’article qui peut être modifié directement sur le document.

Ensuite, on voit le sous-titre de l’article qui n’est pas obligatoire.

Mais nous allons quand même y ajouter le logo Shinken.

Copiez l’image « Shinken » du site internet, puis collez-la dans le sous-titre.

Par contre le synopsis est obligatoire.

L’article original possède un texte d’introduction que nous allons copier-coller dans la zone du synopsis.

Choisir l’option de collage « Fusionner la mise en forme » pour conserver le style bleu du synopsis (ce n’est pas obligatoire, mais c’est visuellement plus joli…).

Voici donc le document Word avec le titre, le sous-titre et le synopsis.

II-D - Contenu de l’article

Pour le corps de l’article, commencez par supprimer les chapitres par défaut du modèle (« Titre niveau 1 », « Titre niveau 2 » et« Titre niveau 3 »).

Puis copiez-collez le contenu de la page internet à la place des chapitres supprimés.

Vous avez supprimé tous les chapitres et n’arrivez plus à vous placer à la fin du document pour faire l’opération de collage ? Procédez comme ceci :

- placez-vous sur le dernier contrôle de contenu (« Liens supplémentaires » à ce jour) ;

- cliquez sur la flèche droite du clavier pour vous placer juste après ce contrôle ;

- le curseur doit être à droite (pas de texte sélectionné), juste avant la marque de paragraphe ;

- tapez sur la touche entrée ;

- la nouvelle ligne est en couleur, on va ôter cette mise en forme ;

- appuyer sur le bouton dans le groupe « Mise en forme » du ruban du plugin Word ;

- ou « clic droit », « Styles » et « Effacer la mise en forme » ;

- vous avez de nouveau récupéré un paragraphe à la fin du document et vous pouvez faire le collage.

Voici un aperçu du document Word après copier-coller :

Les images et liens hypertextes sont généralement collés correctement dans le document Word et ne nécessitent pas de modifications particulières (un centrage des images éventuellement).

II-D-1 - Chapitres

Bonne nouvelle, les chapitres ont correctement été détectés.

Ils sont en bleu avec une numérotation en chiffres romains et en majuscules pour le premier niveau.

Il faut obligatoirement que le premier chapitre soit de niveau 1.

Si les chapitres ne sont pas reconnus automatiquement, utilisez les boutons du groupe « Chapitres » du ruban du plugin Word.

Si les chapitres à convertir ont le même format (par exemple tous en gras, bleu, de taille 14), il est possible de faire une sélection par format puis cliquer sur le bouton correspondant au niveau de chapitre pour les modifier tous en une seule fois.

II-D-2 - Zones de code

Le plus gros du travail va être de modifier les zones de codes.

Dans l’article original on a ceci :

Et lorsqu’on colle dans Word on obtient ceci :

II-D-2-a - Méthode manuelle

Pour mettre les zones de code au gabarit, on commence par supprimer le texte « Shell » puis le contrôle juste dessous (celui avec les barres de défilement).

Il nous reste un tableau avec le code :

La numérotation est dans une première cellule et le code dans une deuxième cellule.

On copie le code de la deuxième cellule puis on supprime le tableau.

Pour supprimer le tableau, vous pouvez par exemple cliquer avec le bouton droit sur la double-flèche en haut à gauche, puis « Supprimer le tableau ».

Ajoutez une zone de code avec le bouton du ruban du plugin Word.

Puis collez-y le code précédemment copié.

Pensez à modifier la langue de code, ici j’ai mis « batch » :

Cette manipulation laborieuse doit être répétée pour chacune des zones de code du document.

II-D-2-b - Méthode automatisée

Si la suite vous décourage, vous pouvez bien entendu faire les corrections manuellement et passer au chapitre suivant.

Comme on a environ une quinzaine de zones de code, il peut être intéressant de définir une combinaison d’opération qu’il sera possible d’exécuter sur chacune des zones de code.

Évidemment, comme cela prend du temps de définir une nouvelle combinaison, il faut que l’opération soit rentable.
Si vous devez mettre au gabarit dix pages du même blog avec sur chaque page une quinzaine de zones de code, alors ça devient très intéressant.

II-D-2-b-1 - Écran de gestion des combinaisons

Cliquez dans le ruban sur le bouton « Combinaisons » :

Voici l’écran qui permet de gérer les combinaisons d’opérations :

1. Liste de vos combinaisons ;

2. Descriptions et raccourci clavier de la combinaison sélectionnée ;

3. Boutons pour afficher le XML de la combinaison, et pour importer le XML d’une combinaison ;

4. Liste des opérations de la combinaison sélectionnée ;

5. Liste des opérations disponibles ;

6. Boutons pour ajouter ou retirer une opération de la combinaison sélectionnée ;

7. Boutons pour valider ou annuler les modifications en cours.

II-D-2-b-2 - Créer une nouvelle combinaison

Dans le bloc 1, cliquez sur la page blanche pour créer une nouvelle combinaison.

Le bouton avec le petit carnet et le crayon permet de modifier la description courte qui apparaît dans la liste (sur cet écran et dans le ruban), par exemple « blog code ».

À droite dans le bloc 2, vous pouvez ajouter une description longue.

Juste en dessous, on peut définir un raccourci clavier ; on y reviendra plus tard.

II-D-2-b-3 - Définir les opérations

Les opérations seront exécutées à partir de la sélection.

Placez-vous d’abord sur une zone de code, dans le tableau (celui avec la numérotation).
Il faut refermer la fenêtre de gestion des combinaisons, puis la rouvrir.

Dans le bloc 5, on choisit la combinaison à ajouter.
Puis on l’ajoute à la combinaison courante avec la flèche gauche du bloc 6.

La première opération est la sélection de la cellule contenant le code.

Ajoutez une opération « sélectionne une cellule ».
Les paramètres de cette opération sont la ligne et la colonne à sélectionner.
Choisissez la ligne 1 et la colonne 2 pour sélectionner le code.

Pour tester la combinaison, cliquez sur le bouton « Exécuter la combinaison ».
Pour tester une partie de la combinaison, double-cliquez sur la ligne de l’opération jusqu’à laquelle vous souhaitez exécuter la combinaison.

On observe la sélection de la cellule (déplacez la fenêtre de gestion des combinaisons pour voir ce qui se passe en dessous).

Ajoutez ensuite une copie du texte sélectionné : opération « Copie le texte sélectionné ».

Cette opération copie le texte sans formatage, ce qui convient pour du code.
Les opérations « copie le texte avec formatage » et « copie le texte avec formatage et image… » font une copie avec le formatage (gras, italique…) et les images (et autres éléments) pour la deuxième.
L’opération de collage doit ensuite préciser si le collage s’effectue avec ou sans formatage.

Le code étant copié, on peut ajouter une opération de suppression de la table en ajoutant une opération « supprime la table de la sélection ».

Exécutez la combinaison, on observe la suppression de la table.
Notez que le curseur se situe au début du paragraphe suivant.

Pour supprimer le contrôle qui précédait le tableau, ainsi que le texte « Shell » au-dessus, nous allons enchaîner deux sélections de paragraphe puis suppression.

Ajoutez une opération « sélectionne le paragraphe ».
Dans le paramètre « Nombre d’unités : » en bas, choisissez « -1 » pour sélectionner le paragraphe précédant la sélection.

Puis supprimez le paragraphe avec une opération « supprime la sélection ».

Refaites l’ajout de ces deux dernières opérations une autre fois.

On a tout supprimé, il faut maintenant créer la zone de code.

Ajoutez une opération « ajoute du code ».
Dans le paramètre « langage : » en bas, choisissez le langage souhaité pour la coloration : « batch ».

Et enfin, collez le texte avec l’opération « colle le texte ».

Exécutez la combinaison.

On note un petit souci : il y a un saut de ligne à la fin du code.

En effet, à la création de la zone de code, la cellule contient un unique caractère de fin de ligne (¤).

Le code sélectionné en contient un également, ce qui en fait deux…

Pour éviter ce problème, on va réduire la sélection du code en retirant le dernier caractère.

Après l’opération « sélectionne une cellule », ajoutez une opération « déplace la fin de la sélection ».
En paramètre, définir unité à « caractère » et nombre à « -1 ».
Cela a pour effet de réduire de un caractère la fin de la sélection.

Exécutez à nouveau la combinaison, le saut de ligne final n’est plus présent.

Fermez la fenêtre en cliquant sur « Valider » (puis « Oui » pour faire l’enregistrement de la combinaison).

II-D-2-b-4 - Exécuter la combinaison

Dans l’onglet « DVP Révision » du ruban, la combinaison créée s’affiche dans une liste déroulante :

Il suffit de se placer sur un tableau de code et cliquer sur la combinaison dans la liste pour l’exécuter.

II-D-2-b-5 - Ajouter un raccourci clavier

Il est possible d’affecter un raccourci clavier à une combinaison.

Cela se fait en deux temps.

Premièrement : il faut affecter une séquence de touche.

Cliquez sur « Modifier les paramètres » dans l’onglet « Kit Word (suite…) », puis sur le bouton « Personnaliser les raccourcis clavier ».

Dans cet écran, choisissez dans la liste une ligne « Combinaison XX » libre (il y a vingt affectations possibles pour les combinaisons), puis cliquez sur la zone à droite de « Séquence de touches ».
Tapez la séquence de touches, par exemple « CTRL + 1 (pavé numérique) » puis cliquez sur le bouton affecter.

Fermez la fenêtre et validez les modifications.

Deuxièmement : affectez la séquence de touches à la combinaison.

Retournez dans l’écran de gestion des combinaisons.

Sélectionnez la combinaison puis choisissez le raccourci.

Maintenant il suffit de taper la séquence de touches pour exécuter la combinaison.

II-D-2-b-6 - Partager une combinaison

Dans le bloc 3, il y a deux boutons.

Le bouton « Afficher le XML » affiche le code XML de la combinaison.
Celui-ci peut être copié-collé dans un message de forum par exemple (avec balises de code xml).

<combo description="blog code">
<op name="op001" id="2" description="Sélectionne une cellule" param1="1" param2="2"/>
<op name="op010" id="24" description="Déplace la fin de la sélection" param1="1" param2="-1"/>
<op name="op002" id="3" description="Copie le texte sélectionné"/>
<op name="op003" id="50" description="Supprime la table de la sélection"/>
<op name="op004" id="1" description="Sélectionne le paragraphe" param1="-1"/>
<op name="op005" id="15" description="Supprime la sélection (ne supprime pas les tables ou cellules)"/>
<op name="op006" id="1" description="Sélectionne le paragraphe" param1="-1"/>
<op name="op007" id="15" description="Supprime la sélection (ne supprime pas les tables ou cellules)" param1=""/>
<op name="op008" id="4" description="Ajoute du code" param1="batch"/>
<op name="op009" id="5" description="Colle le texte"/>
</combo>

Un autre rédacteur pourra alors cliquer sur le bouton « Importer XML » et coller ce code pour importer la combinaison.

II-E - Fin de la mise au gabarit

Le document Word est terminé et prêt à passer en correction orthographique.

Transférez le docx sur votre serveur défini dans les paramètres en cliquant sur le bouton « Transférer Docx ».

Si, en plus, vous voulez présenter une version odt (par exemple pour qu’un correcteur qui ne disposerait pas d’une version Word puisse prendre votre demande en charge), utilisez les boutons « Génération Odt » et « Transférer Odt ».