lgrind - En ligne dans le Cloud

PROGRAMME:

Nom

lgrind - créer de belles listes de programmes à l'aide de LaTeX

REMARQUE

Cette page de manuel n'est pas encore très obsolète, mais pourrait l'être bientôt, sauf si quelqu'un me demande de travailler
dessus. Considérez les documents LaTeX comme les vrais documents.

SYNOPSIS

lgrind [ -e ] [ -i ] [ - ] [ -n ] [ -c ] [ -t ] [ -h ] [ -d <description
fichier> ] [ -l ] [ -s ] ...

DESCRIPTION

LGrind formate les sources du programme dans un style agréable en utilisant Latex(1). Les commentaires sont placés dans
Roman, mots-clés en gras, variables en italique et chaînes en police machine à écrire. Source
les numéros de ligne de fichier apparaissent dans la marge de droite (toutes les 10 lignes).

LGrind traite ses fichiers d'entrée et écrit le résultat sur la sortie standard. Cette sortie
peut être enregistré pour une édition ultérieure, une inclusion dans un document plus volumineux, etc.

Les options sont:

-e traiter un fichier LaTeX pour le code intégré.

-i traiter le fichier de code source pour l'inclure dans un document LaTeX.

- prendre l'entrée à partir de l'entrée standard.

-n ne mettez pas les mots-clés en gras.

-c ne traitez pas @, etc. spécialement dans les commentaires.

-t modifier la largeur de l'onglet (par défaut 8).

-h spécifie le texte à insérer dans l'en-tête.

-d spécifie le fichier de définitions de langue (la valeur par défaut est
/usr/lib/texmf/tex/latex/lgrind/lgrindef).

-d! même que ci-dessus, mais écrivez un exécutable corrigé.

-l spécifie la langue à utiliser.

-s affiche une liste des langues actuellement connues.

Si LGrind est appelé sans paramètres, un écran d'aide s'affichera. Si aucun paramètre n'est défini, -e ni -i
sont spécifiées, un fichier LaTeX complet est généré. Lorsqu'aucune langue n'est spécifiée, LGrind
essaie de découvrir lui-même la langue utilisée ; C est utilisé lorsque cela échoue.

UTILISATION

Par exemple, pour inclure un fichier C nommé foo.c dans votre document LaTeX, donnez d'abord le
commander:

lgrind -i -lc foo.c > foo.tex

Cela générera foo.tex, qui contiendra la version joliment imprimée de foo.c avec beaucoup de
des commandes LaTeX.

Ensuite, incluez lgrind.sty comme vous incluez n'importe quel autre style, à savoir avec le
\usepackage{lgrind} au début de votre document LaTeX. Ceci fait, dans
le document que vous pouvez inclure foo.tex en utilisant l'une des commandes suivantes :

\lgrindfile{foo.tex}
qui inclura simplement le fichier à ce point du texte, et dessinera horizontalement
lignes avant et après la liste.

\lagrind[htbp]{foo.tex}{caption}{label}
qui placera également la liste dans un environnement de figure, en utilisant le float
options, légende et étiquette que vous avez données.

Pour produire un fichier LaTeX autonome à partir, par exemple, d'un fichier Yacc :

lgrind -ly bary.y > bary.tex
Ceci utilise fancyhdr.sty de Piet van Oostrum pour créer les en-têtes et les pieds de page.

Pour une explication plus détaillée de ces commandes, reportez-vous à
/usr/TeX/texmf/doc/latex/lgrind.dvi.

EMBEDDED Programmes DANS A Latex DOSSIER

(D'après les notes de Jerry Leichter.)

Dans le texte de votre fichier LaTeX, vous marquez des groupes de lignes comme étant du texte ou de l'affichage.
code du programme de style :

Style de texte :

L'expression
%(
a + 3
%)
produit 10.
imprime quelque chose comme : « L'expression a + 3 produit 10." (avec "a + 3" défini comme a
programme.)

Le même effet peut être obtenu avec des @ en ligne.

L'expression @a + 3@ produit 10.

Style d'affichage :

La déclaration
%[
a += 3;
%]
est un exemple d'opérateur d'incrémentation.
imprime quelque chose comme :

La déclaration
a += 3;
est un exemple d'opérateur d'incrémentation.

Règles importantes :

% et le caractère suivant doivent être les deux premiers caractères de la ligne à
reconnu.

mettre rien sur la ligne après le % et le caractère clé. Si vous faites cela, LGrind
fournira un environnement par défaut qui produira une \hbox pour %( )%, et une
\vbox pour %[ - %]. Si vous ajoutez des éléments à la ligne, LGrind suppose que vous souhaitez
maîtriser entièrement le format. Cela nécessite une compréhension exactement ce que le
Le code produit par LGrind fonctionne. (Parfois, je n'en suis pas sûr !)

%) et %] sont, si je me souviens bien, simplement ignorés en dehors d'un groupe de codes, mais tout
un %( ou %[ supplémentaire produit un avertissement, donc un %) ou %] manquant est généralement détecté.

Vous pouvez insérer votre propre code en utilisant une ligne commençant par %= dans le texte du programme.
Tout ce que vous saisissez ensuite est conservé dans le résultat, exactement comme vous l'avez tapé.
exécuté dans un environnement étrange, donc faire quoi que ce soit d'extraordinaire est très délicat. Une macro,
\Line est fourni pour vous aider à réaliser des tâches simples. Par exemple :

%[
%=\Ligne{________\vdots}

a = 1 ;
%]
produit:

.
.
.
a = 1 ;

(Dans le texte du programme, _ est actif et s'étend jusqu'à un espace de largeur fixe. Tout un tas
Des macros sont également définies. Si vous comprenez comment LGrind configure les lignes, vous pouvez remplacer
les 8 _ avec un appel à \Tab — mais je vous laisse vous pendre sur celui-là.)

La sortie de LGrind contient toujours exactement une ligne de sortie pour chaque ligne d'entrée. Par conséquent,
vous pouvez rechercher les numéros de ligne dans les messages d'erreur TeX dans votre fichier d'origine, plutôt que dans
le fichier lgrind'ed (lground ?). (Bien sûr, si le problème se situe dans la sortie LGrind...)

De nombreux éléments sont contrôlables en redéfinissant diverses macros. Vous pouvez modifier les polices.
LGrind sera utilisé pour différents types de choses, dans quelle mesure il indente la sortie, s'il
ajoute des numéros de ligne, et si oui, à quel intervalle il les imprime et s'il les colle
à gauche ou à droite, etc. Tout cela est décrit dans lgrind.dvi, bien que
pas très bien. Les paramètres par défaut produisent un résultat qui me semble raisonnable, même si je
Je ne peux pas dire que j'en sois ravi. Faire un vraiment un bon travail nécessiterait de définir certains
polices spéciales.

Utilisez lgrind en ligne avec les services onworks.net