Différences

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

Lien vers cette vue comparative

Prochaine révision
Révision précédente
tutoriel:groff_tuto [Le 16/01/2015, 12:40]
frombenny déplacée de la racine vers les tutoriels
tutoriel:groff_tuto [Le 27/02/2020, 01:03] (Version actuelle)
hibou7
Ligne 1: Ligne 1:
-{{tag>Trusty Precise ​editeur_de_texte}}+{{tag>tutoriel Bionic ​editeur_de_texte}}
 ---- ----
  
Ligne 6: Ligne 6:
  ​{{:​doc:​groff-head.png?​200|}}  ​{{:​doc:​groff-head.png?​200|}}
  
-**[[:​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 logiciel ​:-). +**[[:​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 14: Ligne 14:
 Tout d'​abord,​ voici la manière classique de rédiger avec Groff. Pour garder une certaine clarté, répartissez le travail sur 3 bureaux virtuels. ​ Tout d'​abord,​ voici la manière classique de rédiger avec Groff. Pour garder une certaine clarté, répartissez le travail sur 3 bureaux virtuels. ​
  
-Sur le premier bureau, placez un [[éditeur de texte]] ( [[gedit]], [[mousepad]],​ [[leafpad]]...) où vous pouvez taper votre texte d'​entrée. N'​oubliez pas d'​__enregistrer__ le texte d'​entrée et de __nommer__ le fichier d'​entrée. Le plus pratique est de placer votre fichier d'​entrée dans votre répertoire utilisateur.+Sur le premier bureau, placez un [[:éditeur de texte]] ( [[:gedit]], [[:mousepad]], [[:leafpad]]...) où vous pouvez taper votre texte d'​entrée. N'​oubliez pas d'​__enregistrer__ le texte d'​entrée et de __nommer__ le fichier d'​entrée. Le plus pratique est de placer votre fichier d'​entrée dans votre répertoire utilisateur.
  
 Sur un deuxième bureau virtuel, ouvrez un terminal où vous transformez votre fichier d'​entrée avec la commande groff. Sur un deuxième bureau virtuel, ouvrez un terminal où vous transformez votre fichier d'​entrée avec la commande groff.
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é groffvous le trouvez ​dans votre système ​de fichiers ​sous:\\
-Pour obtenir ce documentcopiez-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]].
  • tutoriel/groff_tuto.1421408451.txt.gz
  • Dernière modification: Le 16/01/2015, 12:40
  • par frombenny