Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Dernière révision Les deux révisions suivantes | ||
tutoriel:groff_tuto [Le 29/06/2015, 01:58] 188.155.178.131 [en console] |
tutoriel:groff_tuto [Le 01/09/2022, 00:09] moths-art Passage de http à https sur les liens externes (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | {{tag>Trusty Precise editeur_de_texte}} | + | {{tag>tutoriel Bionic editeur_de_texte}} |
---- | ---- | ||
Ligne 8: | Ligne 8: | ||
**[[:groff|Groff]]** demande à son utilisateur une bonne dose de "prise en main". Faciliter cette prise en main est le but de ce tutoriel. Il devrait permettre à un utilisateur moyen, formé à la ligne de commande, de faire ses premiers vols d'essai dans ce logi**ciel** :-). | **[[:groff|Groff]]** demande à son utilisateur une bonne dose de "prise en main". Faciliter cette prise en main est le but de ce tutoriel. Il devrait permettre à un utilisateur moyen, formé à la ligne de commande, de faire ses premiers vols d'essai dans ce logi**ciel** :-). | ||
- | Nous allons voir que Groff est accompagné d'un ensemble de 5 "paquets de macros", sortes de boîtes à outils qui facilitent l'écriture de documents en apportant des commandes toutes faites (par exemple pour définir des chapitres, paragraphes, listes...), plus simples à utiliser que les requêtes générales de Groff. Parmis ces paquets de macros, le paquet **Mom** est certainement le mieux documenté et le plus simple à utiliser, il est donc tout à fait recommandé pour débuter avec Groff. D'une certaine manière on peut faire un parallèle entre Groff/Mom et Tex/Latex: Mom offre la même facilité d'utilisation de Groff que Latex; [[:Latex]] étant un ensemble de macros du processeur de texte Tex. | + | Nous allons voir que Groff est accompagné d'un ensemble de 5 "paquets de macros", sortes de boîtes à outils qui facilitent l'écriture de documents en apportant des commandes toutes faites (par exemple pour définir des chapitres, paragraphes, listes...), plus simples à utiliser que les requêtes générales de Groff. Parmi ces paquets de macros, le paquet **Mom** est certainement le mieux documenté et le plus simple à utiliser, il est donc tout à fait recommandé pour débuter avec Groff. D'une certaine manière on peut faire un parallèle entre Groff/Mom et Tex/Latex: Mom offre la même facilité d'utilisation de Groff que Latex; [[:Latex]] étant un ensemble de macros du processeur de texte Tex. |
=====Rédiger en mode graphique===== | =====Rédiger en mode graphique===== | ||
Ligne 53: | Ligne 53: | ||
<code>cd /home/utilisateur/Documents | <code>cd /home/utilisateur/Documents | ||
groff votre_fichier > votre_fichier.ps</code> | groff votre_fichier > votre_fichier.ps</code> | ||
- | Ayant achevé votre travail, quitter le sous répertoire avec | + | Ayant achevé votre travail, quitter le sous-répertoire avec |
<code>cd</code> | <code>cd</code> | ||
Ligne 73: | Ligne 73: | ||
<note tip>Il est possible que votre terminal intégré écrive blanc sur blanc, ce qui n'est pas très lisible :-/. Il y a de quoi réparer ce bug ici: | <note tip>Il est possible que votre terminal intégré écrive blanc sur blanc, ce qui n'est pas très lisible :-/. Il y a de quoi réparer ce bug ici: | ||
- | http://askubuntu.com/questions/67593/make-gedit-embedded-terminal-colours-the-same-as-the-default-terminal. | + | https://askubuntu.com/questions/67593/make-gedit-embedded-terminal-colours-the-same-as-the-default-terminal. |
Veillez à faire rigoureusement ce qui est décrit. Abstenez-vous si vous n'êtes pas tout à fait sûr(e) d'avoir compris.</note> | Veillez à faire rigoureusement ce qui est décrit. Abstenez-vous si vous n'êtes pas tout à fait sûr(e) d'avoir compris.</note> | ||
Ligne 147: | Ligne 147: | ||
C'est le paquet de macros le plus jeune. Très général, largement configurable, conçu entre autres dans le but de rédiger un roman, -mom est un bon choix pour tout ceux qui trouvent les paquets de macros traditionnels (-me,-ms, -mm) trop austères. | C'est le paquet de macros le plus jeune. Très général, largement configurable, conçu entre autres dans le but de rédiger un roman, -mom est un bon choix pour tout ceux qui trouvent les paquets de macros traditionnels (-me,-ms, -mm) trop austères. | ||
- | On en trouve une courte présentation en français [[http://ftp.traduc.org/doc-vf/gazette-linux/html/2004/107/lg107-F.html|ici]] . | + | On en trouve une courte présentation en français [[https://ftp.traduc.org/doc-vf/gazette-linux/html/2004/107/lg107-F.html|ici]] . |
Pour apprendre à travailler vraiment avec -mom, c'est [[http://www.schaffter.ca/mom/mom-04.html|ici]] [en] ou téléchargez [[http://www.schaffter.ca/shared/groff-and-mom.pdf|ce pdf]] [en] | Pour apprendre à travailler vraiment avec -mom, c'est [[http://www.schaffter.ca/mom/mom-04.html|ici]] [en] ou téléchargez [[http://www.schaffter.ca/shared/groff-and-mom.pdf|ce pdf]] [en] | ||
Ligne 160: | Ligne 160: | ||
Paquet classique, bien documenté, conçu pour rédiger des documents universitaires. | Paquet classique, bien documenté, conçu pour rédiger des documents universitaires. | ||
- | Le document suivant vous permettra d'apprendre les principaux outils de -me: | + | Le document meintro_fr.ps vous permettra d'apprendre les principaux outils de -me:\\ |
- | [[http://git.savannah.gnu.org/cgit/groff.git/tree/doc/meintro_fr.me/]] [fr]\\ | + | Si vous avez installé groff, vous le trouvez dans votre système de fichiers sous:\\ |
- | Pour obtenir ce document, copiez-en les lignes 1 à 2268. Collez-les dans votre éditeur de texte. | + | |
- | Nommez-le meintro_fr.me. Appliquez la commande | + | |
- | <code>groff -me -k -t meintro_fr.me > meintro_fr.ps</code> | + | |
- | Récupérez meintro_fr.ps dans votre dossier personnel et imprimez-le si vous le désirez. | + | |
- | + | ||
- | <note> | + | |
- | À partir de la version 1.22.3 de groff, meintro_fr.ps sera livré avec le paquet groff. Vous le trouverez sur votre machine sous\\ | + | |
/usr/share/doc/groff\\ | /usr/share/doc/groff\\ | ||
- | ou, si vous êtes sur une autre distribution, avec la fonction de recherche. | + | ou, si vous êtes sur une autre distribution, avec la fonction de recherche.\\ |
- | </note> | + | Pour aller plus loin avec -me, vous trouverez au même endroit meref.ps, qui est la reférence de -me [en].\\ |
+ | Ouvrez les fichiers .ps simplement avec votre visionneur de documents ;-) | ||
Ajouter l'option **-me** à votre commande groff.\\ | Ajouter l'option **-me** à votre commande groff.\\ | ||
(À partir d' ici, votre fichier s'appelle simplement "foo"): | (À partir d' ici, votre fichier s'appelle simplement "foo"): | ||
- | <code>groff -me foo > foo.ps</code> | + | <code>groff -me -k foo > foo.ps</code> |
- | Pour aller plus loin avec -me, vous trouverez au même endroit meref.ps, qui est la reférence de -me [en]. | ||
==== -ms==== | ==== -ms==== | ||
Ligne 667: | Ligne 662: | ||
[[http://www.gnu.org/software/groff/manual/html_node/index.html|Documentation officielle]] [en] | [[http://www.gnu.org/software/groff/manual/html_node/index.html|Documentation officielle]] [en] | ||
- | Les utilisateurs de groff se retrouvent et s'entraident sur la [[http://lists.gnu.org/mailman/listinfo/groff/|liste de distribution]]. | + | Les utilisateurs de groff se retrouvent et s'entraident sur la [[https://lists.gnu.org/mailman/listinfo/groff/|liste de distribution]]. |
- | Sans être abonné à la liste de distribution, on y trouvera de l'aide en fouillant ses [[http://lists.gnu.org/archive/html/groff/|archives]]. | + | Sans être abonné à la liste de distribution, on y trouvera de l'aide en fouillant ses [[https://lists.gnu.org/archive/html/groff/|archives]]. |
Pour apprendre à définir ses propres macros dans groff, lire le chapitre 14 de | Pour apprendre à définir ses propres macros dans groff, lire le chapitre 14 de |