Différences

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

--- composition:texte:document:signaler_des_changements_entre_versions [2021/01/12 19:57] – Correction de la structure de la page. 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 générer des barres de modification dans un document ? ======
+====== Comment marquer les modifications dans un document? ======
-L'extension [[ctanpkg>changebar|changebar]] permet d'obtenir cette fonctionnalité. Cependant, elle est assez fragile, et, par exemple, ne supporte pas le redimensionnement de page. En voici un exemple d'utilisation :
+===== 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,
+avec des barres de modification dans la marge, demande quelques ruses de la part du programmeur.
+==== Avec l'extension “backgrnd” ====
+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” ====
+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).
+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 30: / Ligne 59: @@
 </code>
-{{htmlmetatags>metatag-keywords=(LaTeX)
+L'éditeur du shareware ''WinEDT'' dispose de fonctionnalités générant des commandes [[ctanpkg>changebar]] (ou autres)
-metatag-og:title=(Comment générer des barres de modification dans un document)
+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.
+FIXME //Cette information semble concerner une version ancienne de cet éditeur...//
+==== Avec l'extension “vertbars” ====
+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é.
+==== Avec l'extension “framed” ====
+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é.
+===== Par un marquage des modifications =====
+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” ====
+À 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” ====
+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.
+-----
+//Source:// [[faquk>FAQ-changebars|Marking changed parts of your document]]
+{{htmlmetatags>metatag-keywords=(LaTeX,modification,barre de modification,version,comparaison,diff de fichier LaTeX,différences entres fichiers LaTeX)
+metatag-og:title=(Comment marquer les modifications dans un document)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}