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 Prochaine révision Les deux révisions suivantes | ||
tutoriel:groff_tuto [Le 03/03/2015, 00:09] 188.155.178.195 [Rédiger en mode graphique] |
tutoriel:groff_tuto [Le 27/02/2020, 01:03] hibou7 |
||
---|---|---|---|
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> | ||
====gedit==== | ====gedit==== | ||
- | L'avantage de [[gedit]] est qu'il offre une console intégrée en-dessous de la fenêtre d'édition. | + | L'avantage de [[:gedit]] est qu'il offre une console intégrée en-dessous de la fenêtre d'édition. |
Cela vous permet de travailler sur deux bureaux virtuels seulement au lieu de trois. | Cela vous permet de travailler sur deux bureaux virtuels seulement au lieu de trois. | ||
Ligne 81: | Ligne 81: | ||
====emacs==== | ====emacs==== | ||
- | Sur [[emacs]], la situation ressemble à celle de gedit. Taper simplement le texte d'entrée sur un nouveau fichier, __enregistrez__ et __nommez__ le fichier. Ensuite par Tool > shell command, il est possible, sans rien avoir installé, d'avoir une console intégrée sous la fenêtre de l'éditeur de texte. Là, vous pouvez taper votre commande groff et récupérer le fichier de sortie dans votre dossier personnel. | + | Sur [[:emacs]], la situation ressemble à celle de gedit. Taper simplement le texte d'entrée sur un nouveau fichier, __enregistrez__ et __nommez__ le fichier. Ensuite par Tool > shell command, il est possible, sans rien avoir installé, d'avoir une console intégrée sous la fenêtre de l'éditeur de texte. Là, vous pouvez taper votre commande groff et récupérer le fichier de sortie dans votre dossier personnel. |
{{:doc:groff_05.png?300|}} | {{:doc:groff_05.png?300|}} | ||
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 422: | Ligne 417: | ||
<code>groff -me -k -p foo > foo.ps</code> | <code>groff -me -k -p foo > foo.ps</code> | ||
+ | ====musique==== | ||
+ | |||
+ | ===avec Lilypond=== | ||
+ | |||
+ | Vous pouvez insérer quelques lignes de musique à votre texte. Lilypond doit être installé. | ||
+ | |||
+ | **Glilypond** est un script qui permet d'intégrer du code Lilypond dans un texte d'entrée groff. | ||
+ | Principe: glilypond prend tout le texte compris entre les requêtes | ||
+ | ''.lilypond start'' et ''.lilypond end'' . Il en fait une image au format .eps, que vous pouvez placer dans votre fichier d'entrée de manière analogue à celles du sous-chapitre précédent. | ||
+ | |||
+ | |||
+ | Procédons par l'exemple: | ||
+ | |||
+ | <code> | ||
+ | asdf | ||
+ | |||
+ | .lilypond start | ||
+ | \version "2.16.2" # on commence par indiquer la version de lilypond utilisée | ||
+ | |||
+ | \header { # les lignes suivantes permettent de supprimer | ||
+ | footer = "" # le "footer" de lilypond. Sans elles, lilypond place les | ||
+ | tagline = "" # lignes de musique sur une page entière | ||
+ | } # avec une note en bas de page (footer). | ||
+ | |||
+ | \paper { | ||
+ | indent = 0 | ||
+ | } | ||
+ | |||
+ | { c' e' g' e' } # texte d'entrée lilypond | ||
+ | .lilypond end | ||
+ | |||
+ | |||
+ | Et voilà :-) | ||
+ | </code> | ||
+ | |||
+ | Copiez le code ci-dessus dans votre éditeur de texte, nommez le par exemple lyfoo et traitez le avec les 3 commandes suivantes: | ||
+ | |||
+ | <code>glilypond lyfoo > lyfoo1</code> | ||
+ | <code>groff -k lyfoo1 > lyfoo1.ps</code> | ||
+ | |||
+ | Vous ne pourrez pas ouvrir lyfoo1.ps avec votre visionneur de documents. | ||
+ | Ne vous en faites pas, la commande suivante fournit un pdf bien lisible lui. | ||
+ | |||
+ | <code>ps2pdf -dNOSAFER lyfoo1.ps</code> | ||
+ | |||
+ | Pour plus de détails, vous pouvez consulter la page man de glilypond: | ||
+ | |||
+ | <code>man glilypond</code> | ||
Ligne 544: | Ligne 587: | ||
Ce que nous venons de faire dans le terminal vous à peut-être mis la puce à l'oreille: avec groff nous sommes à même de formater des documents __sans interface graphique__ 8-) 8-) 8-). | Ce que nous venons de faire dans le terminal vous à peut-être mis la puce à l'oreille: avec groff nous sommes à même de formater des documents __sans interface graphique__ 8-) 8-) 8-). | ||
- | Comment? Ça ne vous tente pas :-O ?\\ Passez dans ce cas directement au chapitre suivant. | + | Comment? Ça ne vous tente pas :-O ?\\ |
+ | Oubliez ce chapitre alors. | ||
Si par contre l'aventure vous tente, choisissez un des deux éditeurs de texte qui fonctionnent en [[console]]: [[nano]] ou [[vim]]. | Si par contre l'aventure vous tente, choisissez un des deux éditeurs de texte qui fonctionnent en [[console]]: [[nano]] ou [[vim]]. |