Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:texte:document:signaler_des_changements_entre_versions [2021/01/13 12:26] – Fusion avec la page anglaise (traduite). Correction de la structure. yannick.tanguy
+++ 3_composition:document:signaler_des_changements_entre_versions [2022/12/01 14:37] (Version actuelle) – [Avec l'extension “changebar”] https dbitouze
@@ Ligne 1: / Ligne 1: @@
-====== Comment afficher les modifications dans un document ? ======
+====== Comment marquer les modifications dans un document? ======
 ===== Par des barres de modification =====
-On a souvent besoin d'indications claires sur la façon dont un document a changé et la technique la plus courante, les barres de modification, demande beaucoup de ruse de la part du programmeur.
+On a souvent besoin d'indications claires sur la façon dont un document a changé et la technique la plus courante,
+avec des barres de modification dans la marge, demande quelques ruses de la part du programmeur.
-==== Avec l'extension backgrnd ====
+==== Avec l'extension “backgrnd” ====
-L'extension la plus simple qui offre des barres de changement est [[ctanpkg>backgrnd|backgrnd]] de Peter Schmitt. Elle a été écrite comme une application Plain <latex>\TeX</latex> qui corrige la routine de sortie (ce qui n'est pas anodin pour des utilisateurs avertis), mais cela semble fonctionner au moins sur des documents <latex>\LaTeX</latex> simples.
+L'extension la plus simple qui propose d'afficher des barres de changement est [[ctanpkg>backgrnd]], de Peter Schmitt.
+Elle a été écrite comme une application Plain <latex>\TeX</latex> qui modifie la routine de sortie
+(ce qui n'est pas anodin pour des utilisateurs avertis), mais cela semble fonctionner,
+au moins sur des documents <latex>\LaTeX</latex> simples.
-==== Avec l'extension changebar ====
+==== Avec l'extension “changebar” ====
-La solution spécifique à <latex>\LaTeX</latex> la plus ancienne est l'extension [[ctanpkg>changebar|changebar]] qui utilise les commandes ''\special'' liées aux pilotes que vous utilisez. Vous devez donc les indiquer à l'extension (de la même manière que vous devez indiquer l'extension [[ctanpkg>graphics|graphics]]). La liste des pilotes disponibles est assez large mais n'inclut pas ''dvipdfm''. L'extension est livrée avec un script shell ''chbar.sh'' (pour une utilisation sur les machines Unix) qui compare deux documents et en génère un troisième qui est balisé avec des commandes [[ctanpkg>changebar|changebar]] pour mettre en évidence les changements.
+La solution spécifique à <latex>\LaTeX</latex> la plus ancienne est l'extension [[ctanpkg>changebar]]
+qui utilise des commandes ''\special'' liées aux pilotes que vous utilisez.
+Vous devez donc  indiquer à l'extension le [[5_fichiers:dvi:qu_est_qu_un_pilote_dvi|pilote de sortie]] utilisé
+(de la même manière que vous devez l'indiquer à l'extension [[ctanpkg>graphics]]).
+La liste des pilotes disponibles est assez large mais n'inclut pas ''dvipdfm''. La Parmi les plus courants, il y a:
+  * DVItoPS,
+  * DVIps,
+  * pdfTeX,
+  * XeTeX (voir [[texdoc>changebar|la documentation]] pour une liste exhaustive).
-Notez que cette extension est assez fragile, et, par exemple, ne supporte pas le redimensionnement de page. En voici un exemple d'utilisation :
+L'extension est livrée avec un script shell ''chbar.sh'' (pour une utilisation sur les systèmes Unix),
+qui compare deux documents et en génère un troisième qui est balisé avec les commandes fournies par [[ctanpkg>changebar]]
+pour mettre en évidence les changements.
+Notez que cette extension est assez fragile, et, par exemple, ne supporte pas le redimensionnement de page.
+En voici un exemple d'utilisation :
 <code latex>
 \documentclass{article}
-\usepackage[frenchb]{babel}
+  \usepackage[frenchb]{babel}
-\usepackage[T1]{fontenc}
+  \usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
+  \usepackage[latin1]{inputenc}
-\usepackage[outerbars]{changebar}
+  \usepackage[outerbars]{changebar}
-    % permet de positionner les barres en marge externe
+    % permet de positionner les barres dans la marge externe
-\setcounter{changebargrey}{20}
+  \setcounter{changebargrey}{20}
-    % permet de fixer le niveau de gris des barres
+    % permet de configurer le niveau de gris des barres
 \begin{document}
@@ Ligne 42: / Ligne 59: @@
 </code>
-L'éditeur du shareware ''WinEDT'' dispose de fonctionnalités générant des commandes [[ctanpkg>changebar|changebar]] (ou autres) pour montrer les différences d'une version à une autre de votre fichier, stockées dans un dépôt ''RCS'' (Revision Control System) --- voir <http://www.winedt.org/old/Config/menus/RCS.php> FIXME //Cette information semble concerner une génération ancienne de cet éditeur...//
+L'éditeur du shareware ''WinEDT'' dispose de fonctionnalités générant des commandes [[ctanpkg>changebar]] (ou autres)
+pour montrer les différences d'une version à une autre de votre fichier, stockées dans un dépôt ''RCS''
+([[wpfr>GNU_RCS|Revision Control System]]) --- voir https://www.winedt.org/old/Config/menus/RCS.php.
-==== Avec l'extension vertbars ====
+FIXME //Cette information semble concerner une version ancienne de cet éditeur...//
-L'extension [[ctanpkg>vertbars|vertbars]] utilise très largement les techniques de l'extension [[ctanpkg>lineno|lineno]] (qu'elle charge). Elle définit un environnement ''vertbar'' pour créer des barres. Notez, cependant, que l'environnement fait un paragraphe séparé avec son contenu : il semble préférable de l'utiliser lorsque la convention est de marquer un paragraphe entièrement modifié.
+==== Avec l'extension “vertbars” ====
-==== Avec l'extension framed ====
+L'extension [[ctanpkg>vertbars]] utilise très largement les techniques de l'extension [[ctanpkg>lineno]] (qu'elle charge).
+Elle définit un environnement ''vertbar'' pour créer des barres.
+Notez, cependant, que l'environnement fait un paragraphe séparé avec son contenu: il semble préférable de l'utiliser
+lorsque la convention est de marquer un paragraphe entièrement modifié.
-Les barres que fournit l'extension [[ctanpkg>framed|framed]] sont un effet secondaire d'autres fonctionnalités : son environnement ''leftbar'' est simplement un cadre dépouillé. Cette extension s'applique aussi à des paragraphes entiers, comme [[ctanpkg>vertbars|vertbars]].
+==== Avec l'extension “framed” ====
-==== Avec la classe memoir ====
+Les barres que fournit l'extension [[ctanpkg>framed]] sont un effet secondaire d'autres fonctionnalités:
+son environnement ''leftbar'' est simplement un cadre dépouillé.
+Cette extension s'applique également à des paragraphes entiers, comme [[ctanpkg>vertbars]].
+==== Avec la classe “memoir” ====
+La classe [[ctanpkg>memoir]] permet de placer des commentaires éditoriaux dans les marges, que vous pouvez évidemment
+utiliser pour délimiter des zones de texte modifié.
-La classe [[ctanpkg> memoir]] permet de placer des commentaires éditoriaux dans les marges, que vous pouvez évidemment utiliser pour délimiter des zones de texte modifié.
 ===== Par un marquage des modifications =====
-Un moyen encore plus fin pour suivre des modifications, utilisé par certains traitements de texte, consiste à pour produire un document qui intègre à la fois les anciennes et nouvelles versions.
+Un moyen encore plus fin pour suivre des modifications, utilisé par certains traitements de texte, consiste à produire
+un document qui intègre à la fois les anciennes et nouvelles versions.
-==== Avec l'extension changes ====
+==== Avec l'extension “changes” ====
-À cette fin, l'extension [[ctanpkg>changes|changes]] permet à l'utilisateur de marquer manuellement les modifications de texte, telles que les ajouts, les suppressions ou les remplacements. Le texte modifié est affiché dans une couleur différente et le texte supprimé est barré. L'extension vous permet de définir des auteurs supplémentaires et leur couleur associée; il vous permet également de définir un balisage pour les auteurs ou les annotations. La documentation montre (très clairement) comment fonctionnent les différentes fonctions.
+À cette fin, l'extension [[ctanpkg>changes]] permet à l'utilisateur de marquer manuellement les modifications de texte,
+telles que les ajouts, les suppressions ou les remplacements. Le texte modifié est affiché dans une couleur différente
+et le texte supprimé est barré. L'extension vous permet de définir des auteurs supplémentaires et leur couleur associée;
+il vous permet également de définir un balisage pour les auteurs ou les annotations.
+La documentation montre (très clairement) comment utiliser les différentes fonctionnalités.
-==== Avec les scripts latexdiff et latexrevise ====
+==== Avec les scripts “latexdiff” et “latexrevise” ====
-Le script Perl [[ctanpkg>latexdiff|latexdiff]] peut également être utilisé pour générer ce type de balisage pour les documents <latex>\LaTeX</latex> : en lui soumettant deux documents, il produit un nouveau document <latex>\LaTeX</latex> dans lequel les changements sont visibles. Un exemple de sortie est intégré dans la documentation sur le CTAN.
+Le script Perl [[ctanpkg>latexdiff]] peut également être utilisé pour générer ce type de balisage pour les documents <latex>\LaTeX</latex>:
+en lui soumettant deux documents, il produit un nouveau document <latex>\LaTeX</latex> dans lequel les changements sont visibles.
+Un exemple de sortie est intégré dans [[texdoc>latexdiff|sa documentation sur le CTAN]].
-Une fonction de révision rudimentaire est fournie par un autre script Perl, [[ctanpkg>latexdiff|latexrevise]], qui accepte ou rejette toutes les modifications. L'édition manuelle du fichier de différences peut être utilisée pour accepter ou rejeter uniquement les modifications sélectionnées.
+Une fonction de révision rudimentaire est fournie par un autre script Perl, [[ctanpkg>latexdiff|latexrevise]],
+qui accepte ou rejette toutes les modifications. L'édition manuelle du fichier de différences peut être utilisée
+pour accepter ou rejeter uniquement les modifications sélectionnées.
 -----
 //Source:// [[faquk>FAQ-changebars|Marking changed parts of your document]]
-{{htmlmetatags>metatag-keywords=(LaTeX,modification,barre de modification,version,comparaison)
+{{htmlmetatags>metatag-keywords=(LaTeX,modification,barre de modification,version,comparaison,diff de fichier LaTeX,différences entres fichiers LaTeX)
-metatag-og:title=(Comment afficher les modifications dans un document)
+metatag-og:title=(Comment marquer les modifications dans un document)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}