Différences

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

--- groff [Le 16/04/2014, 11:15]
188.155.179.0 [Groff en console: nano ou vim]
+++ groff [Le 11/09/2022, 11:05] (Version actuelle)
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
@@ Ligne 1: / Ligne 1: @@
-{{tag>Precise terminal console editeur_de_texte groff latex}}
+{{tag>Xenial Bionic editeur_de_texte}}
 ----
+ {{ :doc:groff-head.png?100|}}
 ====== groff ======
-{{http://www.gnu.org/graphics/groff-head.png}}
+Comme l'indique son logo, **Groff** est le logiciel de typographie de [[GNU]], et permet de mettre en forme des textes. C'est un logiciel de type [[wpfr>What_you_see_is_what_you_mean|WYSIWYM]]: la mise en forme du texte s'effectue à l'aide de balises (ou requêtes) placées avec adresse dans un** fichier d'entrée**, celles-ci sont exécutées ensuite par la commande groff et le texte mis en forme apparaît alors dans un** fichier de sortie**.  Groff s'utilise donc de manière analogue à [[latex]].
-<note tip>Cette page de doc est en cours de rédaction. Elle n'est pas encore utilisable dans l'état actuel</note>
+Le fichier de sortie peut avoir différents formats: .ps,  .pdf, .html, .dvi.
-Comme l'indique son Logo, **Groff** est le logiciel de typographie de GNU, et permet donc de mettre en forme des textes. C'est un logiciel de type WYSIWYM (What you see is what you mean), la mise en forme du texte s'effectue à l'aide de requêtes, celles-ci sont exécutées ensuite par la commande groff et le texte mis en forme apparaît alors dans un fichier de sortie.  Groff s'utilise donc de manière analogue à Latex.
+Groff tourne essentiellement sur les systèmes UNIX, mais on trouve sur le site officiel une version installable sur Windows.
-Le texte d'entrée peut être rendu en différends formats: .ps,  .pdf, .html, .dvi
-Groff tourne essentiellement sur les systèmes UNIX, mais il est possible aussi de l'installer sur un système Windows.
+Groff, qu'on appelle aussi GNU-Troff, a une longue histoire que vous pouvez lire [[https://linuxfr.org/news/groff-sort-en-version-121|ici]]
-Ce logiciel a une longue histoire que vous découvrirez sur
-  * [[http://linuxfr.org/news/groff-sort-en-version-121]]
-===== Pré-requis =====
- Pour l'installer:
-  * Disposer des [[:sudo|droits d'administration]] .
-  * Disposer d'une connexion à Internet configurée et activée.
 ===== Installation =====
-Même si vous ne l'avez pas encore installé, groff est déjà présent sur votre machine de manière rudimentaire. Vous pouvez vous  convaincre de cette présence en copiant-collant la commande suivante dans votre terminal.
+Même si vous ne l'avez pas encore installé, groff est déjà présent sur votre machine de manière rudimentaire (groff-base). Vous pouvez vous  en convaincre en copiant-collant la commande suivante dans votre terminal.
-<code>echo un petit texte de votre choix | groff > petitexte.ps</code>
+<code bash>echo un petit texte de votre choix | groff > petitexte.ps</code>
-La commande echo édite le texte qui la suit.\\
+La commande echo édite le texte qui la suit.
-Le "pipe" | redirige le texte sur groff.\\
+Le "pipe" | redirige le texte sur groff.
 Groff fait de votre texte un fichier au format .ps (qui est l'ancêtre de .pdf).
 Vous pourrez alors récupérer petitexte.ps dans votre répertoire personnel.
-Pourquoi cette présence discrète de groff sur votre machine? Tous ceux /celles qui utilisent les commandes Unix connaissent bien les pages man. Ces pages sont justement rédigées à l'aide de groff, et c'est donc lui qui nous permet de les lire.
+Pourquoi cette présence discrète de groff sur votre machine? Tous ceux/celles qui utilisent les commandes Unix connaissent bien les pages man. Bon nombre d'entre elles ont été rédigées à l'aide de groff, et c'est donc lui qui nous permet de les lire.
 Cette installation rudimentaire ne permet pas encore de vraiment mettre des textes en forme. Si vous voulez profiter de toutes ses fonctionnalités,
+ [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>groff|groff]]**.
- *  [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>groff|groff]]**.
+Une fois installé, groff n'apparaît dans aucun menu déroulant et c'est normal. Les 2 commandes suivantes vous montrent si groff-base et groff sont installés.
+<code>dpkg -l groff-base</code>
+<code>dpkg -l groff</code>
+Par la même occasion, elles vous renseignent sur le numéro de version.
-Une fois installé, groff n'apparaît dans aucun menu déroulant et c'est normal. C'est en l'utilisant en ligne de commande avec des options que vous pourrez vérifier que l'installation a eu lieu.
-===== Groff pas à pas =====
+===== Utilisation =====
-Très léger (le fichier exécutable ne fait que 75 Ko !) et très fiable, groff demande toutefois à  son utilisateur une bonne dose de "prise en main".  Le but de cette page de doc est de faciliter cette prise en main et de permettre à un Ubuntero moyen, formé à la ligne de commande, de faire ses premiers vols d'essai dans ce logi-ciel qu'est groff :-) .
+Pour apprendre à rédiger des textes avec groff, utilisez [[:tutoriel:groff_tuto|ce tutoriel]].
-Pour l'utiliser vous pourrez choisir un mode d'utilisation qui vous plaira.
-Le chaptire actuel  vous y aidera.
-Pour formater vos textes, vous choisirez aussi le paquet de macros qui vous convient le mieux (-me, -mom, -mm, -ms ou -man). Le chapitre 4 vous guidera.
-==== dans le terminal ====
-Revenons à notre premier exemple et modifions le un peu:
-<code>echo un petit fromage crémeux | groff > fgcrem.ps</code>
-Si vous avez utilisé des caractères accentués ou spéciaux tels que le "ç", vous aller retrouver dans votre fichier de sortie fgcrem.ps des signes kabalistiques! Pas de soucis: il suffit d'ajouter l'option -k.
-<code>echo un petit fromage crémeux | groff -k > fgcrem.ps</code>
-L'option - fait appel à preconv,  un logiciel qui préconvertit les caractères spéciaux en quelque chose que groff peut comprendre. (Pour en savoir plus: man preconv)
- À l'aide de la commande printf nous pouvons à présent formater un petit texte de plusieurs lignes.
-Ici un élément fondamental. Groff ne tient pas compte des changements de ligne. \n permet de spécifier que vous voulez un changement de ligne à tel endroit. Supprimer les \n ,et groff écrira votre texte sur une ligne.
-<code>printf ' \n \n \n
-la jument de Michao\n
-et son petit poulain\n
-a passé dans le pré\n
-et mangé tout le foin' | groff -k > Michao.ps</code>
-Au lieu de l'envoyer sur un fichier .ps nous pouvons aussi en avoir un aperçu avec l'option -X (gxditview).
-<code>printf ' \n \n \n
-la jument de Michao\n
-et son petit poulain\n
-a passé dans le pré\n
-et mangé tout le foin' | groff -k -X</code>
-En cliquant gauche sur l'aperçu, nous pouvons diriger le fichier sur l'imprimante (choisir "print" puis grops | lpr)
-Nous pouvons aussi le diriger directement sur l'imprimante:
-<code>printf ' \n \n \n
-la jument de Michao\n
-et son petit poulain\n
-a passé dans le pré\n
-et mangé tout le foin' | groff -k | lp </code>
-Le désavantage du terminal est qu'on ne peut pas revenir à une ligne précédente. Il ne permet donc pas de travailler vraiment un texte. C'est pourquoi, pour formater des textes plus longs nous avons besoin d'un [[éditeur de texte]].
-==== Groff en console:  nano ou vim ====
-Ce que nous venons de faire dans le terminal est naturellement aussi possible en [[console]].
-[[Nano]] et [[vim]] sont deux éditeurs de texte qui fonctionnent en console.
-Avec groff et l'un de ces éditeurs de texte, nous sommes à même de formater des documents. __sans interface graphique__  8-) 8-).
-Si cette manière de faire ne vous intéresse pas. Vous pouvez sauter ce chapitre sans autre, il n'est pas essentiel pour la compréhension générale de cette page de doc.
-===nano===
-En principe, nano est déjà installé sur Ubuntu.
-Un apprentissage rapide est possible en lisant la doc [[nano]] ou en  regardant  la 2e moitié de cette vidéo: http://www.tutoriels-video.fr/editer-un-fichier-en-mode-administrateur-sur-ubuntu/
-Si voue êtes prêt(e), vous pouvez imprimer ce paragraphe, et rendez-vous en console par Ctrl+Alt+F1.
-...
-Après avoir renseigné les informations de login
-Lancer nano avec la commande
-<code>nano</code>
-Se déplacer dans nano à l'aide des flèches.
-Vous pouvez entrer par exemple les 4 petites lignes dans l'encadré ci-dessous:
-Commencer  par 3-4 lignes vides pour que le texte soit bien cadré.
-Dans un éditeur de texte,  la requête \n n'est plus de mise.  Si vous voulez rédiger quelques vers, commencez chaque ligne par un signe "espace", groff mettra alors le texte sur 4 lignes.
-<code>
- l'hiver viendra et quand
- l'hiver viendra
- la jument de Michao
- elle s'en repentira</code>
-Ressortez de nano avec ctrl+x .
-Enregistrez le fichier comme demandé.
-Nommez le comme demandé (par ex. "hiver")
-Vous retrouvez le prompt où vous pouvez lancer la commande
-<code>groff -k hiver | lp </code>
-L'aperçu Gxditview (l'option -X) ne fonctionne évidemment pas en console. Si vous travaillez exclusivement en console, le seul moyen de voir ce que vous avez écrit est de l'imprimer.
-===vim===
-Toutes les remarques concernant nano ci dessus, sont aussi valables pour vim.
-Ici aussi, vous pouvez apprendre à travailler sur vim en lisant la doc [[vim]], ou le chapitre 16 de
-http://formation-debian.via.ecp.fr/
-Si vous êtes prêt(e). Imprimez ce chapitre et rendez-vous en console par Ctrl+Alt +F1.
-Après avoir renseigné les informations de login. Lancez  la commande
-<code>vim</code>
-Par la touche Insert, vous accédez au mode INSERTION (confirmation en bas à gauche de l'écran).
-Vous pouvez alors entrer votre texte. Si vous cherchez un exemple; reprenez les 4 lignes proposées pour nano ci-dessus.
-Une fois le texte entré, retournez en mode commande par "Échap".
-Enregistrez votre texte et nommez le avec **:w** nom_de_fichier (par ex. "hiver").
-Quittez nano avec **:q**. Vous retrouvez le prompt où vous pouvez entrer la commande groff:
-<code>groff -k hiver | lp </code>
-==== dans gedit ====
-==== dans emacs====
+===== Désinstallation =====
-Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|ouvrez le fichier]] **/truc/machin/bidule** en modification puis …
+Pour supprimer le paquet groff, voir [[:tutoriel:comment_supprimer_un_paquet|supprimer un paquet]].\\
+Ne touchez pas à groff-base, qui vous permet le lire les pages man.
-===== Choisir son paquet de macros =====
-==== -me ====
-==== -mom ====
-==== -ms ====
-==== -man====
-Lancez l'application via le [[:unity#tableau_de_bord_dash|dash]] (Ubuntu 11.04 et ultérieures) ou via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
-<code>machin-chose</code>
-===== Intégrer des éléments graphiques =====
+===== Liens =====
-==== tableaux====
+  * [[http://www.gnu.org/software/groff/|Site officiel du projet groff]] [en]
-==== formules de maths====
+  * [[http://www.gnu.org/software/groff/manual/|Documentation officielle]] [en]
-==== images====
+  * [[https://lea-linux.org/documentations/Software-soft_texte-groff|Groff sur Léa Linux]] [fr]
-===== Commandes plus générales =====
-grog,  groffer,
-===== Désinstallation =====
-Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
-===== Liens officiels =====
-  * [[http://www.gnu.org/software/groff/]] [en]
-===== autres liens =====
-  * [[http://lea-linux.org/documentations/Software-soft_texte-groff]] [fr]
 ----
-//Contributeurs principaux : [[hibou7]].//
+//Contributeur principal : [[:utilisateurs:hibou7]] //