wiki:review

Version 4 (modified by g7moreau, 10 years ago) (diff)

Corps du document

Paquetage Review - Un module pour aider à l'édition collaborative

Liminaire

Review est un paquetage permet l'édition d'un document à plusieurs mais ayant une personne rédactrice principale.

On pourrait penser qu'un système de gestion de code source fasse cela. En pratique, les gestionnaires de code sources centralisés de type subversion ne sont pas conçu pour cela. Les systèmes décentralisés comme git pourraient le faire avec une autre approche.

Review peut être utilisé sans gestionnaire de code source, c'est un système complètement intégré à LaTeX. Cependant, utiliser un gestionnaire de code source pour un document TeX est toujours une bonne chose.

En pratique

Un document LaTeX est découpée en deux parties :

  • l'en tête, avant le \begin{document} ;
  • le corps du document.

Les commandes review vont permettre de modifier le document. Chaque modification sera visible avec un encart dans la marge (de largeur par défaut \marginparwidth).

Au moment de la compilation finale, il est possible de faire disparaître tous les encarts de sorte que review se rende invisible. Il n'y a donc aucune excuse à ne pas l'utiliser !

Toutes les commandes LaTeX commenceront par \rev afin de ne pas être trop verbeuse mais pourtant facile à retenir.

En tête

Le paquetage review doit être paramétré et chargé dans l'en tête d'un document. Tout comme de nombreux modules...

Il faut charger le module

\usepackage[options]{review}

Pour définir une liste des relecteurs, on utilise la commande revauthor qui prend deux paramètres : un nom (alias de la personne) et une couleur. Dans review, les couleurs sont toutes définies en RGB.

\revauthor{gaby}{1,0,1}
\revauthor{vincent}{1,1,0}
\revauthor{gerard}{0,1,1}
\revauthor{herve}{1,1,0}

Chaque review devra être signé par un relecteur. Il faut donc définit autant d'alias que de personne travaillant sur le document.

Les textes modifiés ainsi que les marques ont les couleurs par défaut rouge et bleu ({1,0,0} et {0,0,1}). Il est possible de les changer via les deux commandes :

\revcolormark{0,1,0}
\revcolortext{1,0,1}

Corps du document

Les commandes suivantes prennent toutes un argument en option, puis deux à quatre paramètres :

  • revadd[option]{author}{add}{com} Ajoute du texte add ;

  • revmod[option]{author}{old}{add}{com} Remplace le texte old par le texte add ;
  • revdel[option]{author}{old}{com} Supprime le texte old ;
  • revmark[option]{author}{com} Place une simple remarque dans la marge
  • revpar[option]{author}{com} Place une remarque conséquente (longue) dans le corps de la page

Le premier paramètre est author, il doit s'agir d'un des alias définit dans l'en tête. Le dernier paramètre est toujours com comme "commentaire". Il est là pour préciser la modification si nécessaire. Il peut être vide sous la forme {}.