Le teTeX-HOWTO est copyright (C) 1997, 1998 par Robert Kiesling. Il est permis d'en faire des copies conformes et de les distribuer � condition que les instructions concernant les droits de reproduction et celles concernant les permissions soient pr�serv�es sur toutes les copies.
Il est permis de copier et de distribuer des versions modifi�es de ce manuel sous les m�mes conditions que les copies conformes, sous r�serve que les sections intitul�es Distribution et GNU General Public License soient incluses exactement comme dans l'original, et sous r�serve que l'int�gralit� du travail d�riv� r�sultant soit distribu� sous les termes d'une note concernant les droits identique � celle-ci.
Il est permis de copier et de distribuer des traductions de ce document dans d'autres langues, sous les conditions mentionn�es ci-dessus pour les versions modifi�es. � ceci pr�s que les sections intitul�es Distribution et GNU General Public License peuvent �tre incluses sous forme d'une traduction approuv�e par la Free Software Foundation au lieu de l'anglais originel. Veuillez vous reporter � la section Distribution et droits d'auteur pour les termes gouvernant la copie.
TeX ne s'occupe que de la partie mise en forme dans la pr�paration de
documents. Produire des sorties avec TeX, c'est comme compiler un code
source en code objet, dont il reste � faire l'�dition de liens. Vous
pr�parez un fichier d'entr�e avec un �diteur de textes -- ce qui
est du « traitement de texte » dans la t�te de
la plupart des gens -- et formatez le document d'entr�e avec TeX
pour produire un fichier de sortie ind�pendant de tout p�riph�rique,
appel� fichier .dvi
(pour device independent).
Vous aurez �galement besoin d'un programme ou deux pour traduire le
fichier .dvi
issu de TeX pour votre �cran et votre
imprimante. Ces programmes sont connus sous le nom collectif de
« dviware ». Par exemple, TeX lui-m�me n'�met
que des requ�tes pour les polices de caract�res. C'est la t�che du
traducteur de fichiers .dvi
de fournir les polices en
question pour la sortie, qu'elle se fasse sur �cran ou sur
papier. Cette �tape suppl�mentaire peut sembler inutilement
compliqu�e, mais cette abstraction permet aux documents d'avoir une
apparence identique sur diff�rents p�riph�riques sans aucun changement
(ou presque) du document d'origine.
Il existe une impl�mentation de TeX pour tout syst�me informatique s�rieux au monde -- et m�me pour un tas de syst�mes « non s�rieux »--, les impl�menteurs doivent donc fournir les outils d'installation pour tous ceux-ci. Ceci rend compte, en partie, de la complexit� de teTeX, en plus de la complexit� inh�rente � toute installation de TeX. Ceci explique �galement que l'installation du syst�me par vous-m�me est une t�che non n�gligeable, et, � moins d'�tre d�j� familier avec TeX, il est facile de se perdre dans le nombre de programmes ex�cutables, de fichiers TeX, de documentations et de polices.
Heureusement, teTeX est int�gr� � la distribution GNU/Linux. Il vous est possible d'installer le paquetage beaucoup plus facilement en utilisant les outils d'installation de GNU/Linux. Il se peut que teTeX soit d�j� install� sur votre syst�me. Si c'est le cas, vous pouvez passer directement � la section Utilisation de teTeX.
Toutefois, si vous voulez installer le paquetage, les archives n�cessaires � une installation utilisable de teTeX sont sur le r�seau d'archives CTAN. Une liste de ces sites se trouve dans la section Liste de sites CTAN.
CTAN est le Comprehensive TeX Archive Network (r�seau
abordable d'archives TeX), une s�rie de sites FTP anonymes archivant
des programmes, des macros, des polices et de la documentation pour
TeX. Au cours de votre utilisation de TeX, vous vous familiariserez
probablement avec au moins un site CTAN. Dans ce document, un chemin
d'acc�s tel que ~CTAN/contrib/pstricks
, signifie
« allez voir dans le r�pertoire contrib/pstricks
du site CTAN le plus proche ».
L'installation de la distribution g�n�rique de teTeX, d�crite dans la section Installation de la distribution CTAN de teTeX se focalise sur les versions Intel de Linux. L'installation de teTeX sur d'autres mat�riels ne devrait n�cessiter que la substitution appropri�e de l'archive des programmes ex�cutables au cours du processus d'installation.
En plus des programmes ex�cutables, la distribution contient
l'ensemble des extensions pour TeX et LaTeX, metafont
et ses
sources, bibtex, makeindex,
et toute la
documentation... le tout d�passant les 4 Mo. La documentation
couvre tout ce dont vous aurez a priori besoin pour d�marrer. Vous
devriez donc installer tous ces documents. Non seulement serez-vous
amen� � tous les lire, mais les documents par eux-m�mes fournissent de
nombreux exemples de code TeX et LaTeX
« vivant ».
TeX a �t� �crit par le professeur Donald Knuth de l'universit� de Stanford. Il s'agit d'un langage de composition de page de bas niveau utilis� par toutes les extensions de plus haut niveau comme LaTeX. LaTeX est principalement un ensemble de macros TeX fournissant des formats de documents pr�d�finis et pratiques pour l'utilisateur final. Si vous aimez les formats fournis par LaTeX, vous n'aurez peut-�tre jamais � apprendre la programmation de TeX au plus bas niveau. La diff�rence entre les deux langages est comme la diff�rence entre l'assembleur et le C. Vous pouvez avoir la vitesse et la flexibilit� de TeX, ou la facilit� d'utilisation de LaTeX.
Au passage, les lettres du mot « TeX » sont les lettres grecques tau-epsilon-chi. Il ne s'agit pas d'une confr�rie, mais de la racine du mot grec techne, qui signifie art et/ou science. « TeX » ne se prononce pas comme la premi�re syllabe de « Texas. » Le chi n'a pas d'�quivalent en fran�ais, mais « TeX » se prononce g�n�ralement de fa�on � rimer avec le mot anglais « yecch
NdT. : le chi se prononce par exemple comme le x dans Mexico tels que le prononcent les hispanophones., » exemple donn� par le professeur Knuth dans le TeXBook, l'un des standards de r�f�rence pour TeX. Pour �crire le mot « TeX » sur des p�riph�riques � base de caract�res, pensez � utiliser la casse standard, ou la macro
\TeX{}
lors de la composition.
N'importe lequel des �diteurs qui marchent sous Linux -- jed,
joe, jove, vi, vim, stevie,
Emacs et micro-Emacs -- peut
servir � pr�parer un fichier d'entr�e pour TeX, sous r�serve qu'il
puisse lire et �crire des fichiers en ASCII pur. Mon pr�f�r� est GNU
Emacs. Cela pour plusieurs raisons :
dvips
Le programme dvips
de Tomas Rokicki produit du Postscript �
partir d'un fichier .dvi
. De plus, en cas de besoin, il lance
Metafont pour g�n�rer les polices n�cessaires sous forme de
bitmap
NdT. : polices o� chaque symbole est repr�sent� par une matrice de points « allum�s » ou « �teints. »ou il utilise les polices Postscript pour la sortie. Il est aussi capable de redimensionner les pages et d'effectuer des translations graphiques � partir d'instructions contenues dans un fichier TeX ou LaTeX.
dvips
fait partie de la distribution teTeX. Il est abord�
plus compl�tement dans la section
Combiner textes et �l�ments graphiques avec dvips.
Une grande partie de la complexit� de TeX, et par cons�quent de LaTeX, provient de son impl�mentation de divers syst�mes de polices, et de la fa�on dont ces polices sont sp�cifi�es. Une am�lioration majeure de LaTeX 2e par rapport � son pr�d�cesseur �tait dans la mani�re dont les utilisateurs sp�cifiaient les polices, l'ancien New Font Selection Scheme (nouveau sch�ma de s�lection des polices). Cela est abord� dans les sections Symboles et styles typographiques, Commandes TeX pour les polices, et Utilisation de polices Postscript.
teTeX est distribu� avec une douzaine de polices standard pr�-charg�es,
ce qui est suffisant pour d�marrer. Les descriptions des m�triques des
polices sont �galement fournies dans les fichiers .tfm
(TeX
font metric). Pour g�n�rer les autres polices dont vous avez besoin,
il suffit simplement d'installer les sources pour
metafont
. Les utilitaires pour .dvi
de teTeX
invoqueront metafont
automatiquement et g�n�reront les
polices Computer Modern n�cessaires.
En th�orie tout du moins, tout est install� correctement et pr�t � fonctionner. teTeX est un paquetage logiciel tr�s vaste. Comme pour tout paquetage complexe, vous voudrez commencer par apprendre teTeX en douceur, au lieu d'�tre submerg� par sa complexit�.
Dans le m�me temps, nous voulons que le logiciel fasse quelque chose d'utile. Donc, au lieu de regarder TeX composer
``Hello, World !''comme le sugg�re le professeur Knuth, nous allons produire quelques unes des documentations de teTeX pour le mettre � l'�preuve.
Vous devriez �tre connect� en tant que root
les premi�res
fois que vous utilisez teTeX. Si vous ne l'�tes pas, Metafont peut
�tre dans l'incapacit� de cr�er les r�pertoires indispensables pour
ses polices. Le programme texconfig
inclut une option pour
rendre les r�pertoires de polices accessibles en �criture � tout un
chacun, mais si vous travaillez sur un syst�me multi-utilisateurs, des
consid�rations de s�curit� peuvent rendre cette option inapplicable ou
ind�sirable.
Dans chacun de ces cas, si vous ne disposez pas des droits appropri�s
pour cr�er ou �crire dans les r�pertoires o� sont log�s les polices,
Metafont se plaindra bruyamment parce qu'il ne peut cr�er les
r�pertoires. Vous ne verrez aucune sortie parce que vous aurez un tas
de symboles de polices de longueur nulle. Cela n'est pas un
probl�me. D�connectez-vous simplement, reconnectez-vous sous
root
, et r�p�tez l'op�ration qui a �chou�.
Le c�t� agr�able de teTeX, c'est que si vous vous plantez, il n'y a pas vraiment de d�g�ts. Ce n'est pas comme un compilateur, o�, par exemple, vous bousillerez la partition racine si un pointeur se met � d�lirer. Comment, vous n'avez pas encore lu le manuel de teTeX ? Bien s�r que non. Il est encore dans la distribution sous forme de code source, pr�t � �tre sorti.
Donc, sans plus attendre, il vous plairait de lire le manuel teTeX. Il se trouve dans le r�pertoire
/usr/lib/teTeX/texmf/doc/tetex.
Le source LaTeX pour le manuel s'appelle
TETEXDOC.tex
. (L'extension .tex
est utilis�e aussi
bien pour les fichiers TeX que LaTeX. Certains �diteurs, comme Emacs,
ne savent pas faire la diff�rence.) Un fichier TETEXDOC.dvi
est �galement inclus dans la distribution, fichier que vous voudrez
garder en lieu s�r -- disons, dans un autre r�pertoire -- au
cas o� vous voudriez tester vos pilotes .dvi
plus tard. Un
fois cela r�gl�, tapez
latex TETEXDOC.texLaTeX affichera plusieurs avertissements. Le premier,
LaTeX Warning: Label(s) may have changed. Rerun to get the cross-references right.est standard. Il est courant de construire la table des mati�res d'un document en « LaTeXant » le document deux fois. Donc, refaites la commande. Les autres avertissements peuvent �tre ignor�s sans danger. Il vous informent seulement que certains des chemins FTP mentionn�s dans la documentation sont trop longs pour l'espace qui leur est allou�. Les sections Styles et dimensions des paragraphes et Tol�rances d�crivent l'espacement horizontal en plus d�taill�.
teTeX aura g�n�r� plusieurs fichiers � partir de
TETEXDOC.tex.
Celui qui nous int�resse est
TETEXDOC.dvi.
C'est le fichier de sortie ind�pendant de tout
p�riph�rique que vous pouvez envoyer aussi bien sur l'�cran que sur
l'imprimante. Si vous faites marcher teTeX sous le syst�me X Window,
vous pouvez pr�visualiser le document avec xdvi
.
Pour le moment, supposons que vous ayez une HP LaserJet II. Vous lanceriez la commande
dvilj2 TETEXDOC.dviqui �crit un fichier de sortie PCL � partir de
TETEXDOC.dvi
,
incluant les polices logicielles qui seront d�charg�es sur la
LaserJet. Cela n'est pas une fonctionnalit� de TeX ou LaTeX,
mais une fonctionnalit� offerte par dvilj2
. D'autres pilotes
.dvi
offrent des fonctionnalit�s relatives aux p�riph�riques
qu'ils g�rent. dvilj2
essaie de r�pondre aux requ�tes de
polices faites dans le document LaTeX d'origine, avec leurs
�quivalents les plus proches pr�sents sur le syst�me. Dans le cas d'un
document purement textuel comme TETEXDOC.tex
, la difficult�
n'est pas bien grande. Toutes les polices demand�es par
TETEXDOC.tex
seront g�n�r�es par metafont
, qui est
invoqu� automatiquement par dvilj2
, si les polices ne sont
pas d�j� pr�sentes. (Si c'est la premi�re fois que vous lancez
dvilj2
, il se peut que le programme doive g�n�rer toutes les
polices.) Il existe plusieurs options pour contr�ler la mani�re dont
les polices sont g�n�r�es par dvilj2
. Elles sont expos�es
dans la page du manuel. � ce stade, vous ne devriez pas avoir �
manipuler metafont
directement. Dans le cas contraire,
quelque chose de pas net s'est produit dans votre installation. Tous
les pilotes .dvi
invoqueront directement metafont
au
travers de la biblioth�que de recherche de chemins kpathsea
-- dont la discussion d�passe le cadre de ce document -- et,
pour l'instant vous n'avez pas � travailler davantage avec
metafont
-- tous les sources metafont
pour la
biblioth�que de polices Computer Modern sont fournis.
Vous pouvez imprimer TETEXDOC.lj
avec la commande
lpr TETEXDOC.ljIl se peut que vous ayez � installer un filtre d'impression comprenant le PCL.
Le teTeX Guide de neuf pages fournit de l'information utile pour configurer votre syst�me plus finement ; j'en ai mentionn� quelques extraits, la majeure partie n'est pas couverte par ce document.
Je n'ai pas pu tester certaines informations de la section suivante car je dispose d'une imprimante couleurs � jet d'encre HP DeskJet 400 non Postscript connect�e au port parall�le de l'ordinateur. N�anmoins, ne pas poss�der d'imprimante Postscript ne constitue pas une barri�re � l'impression de textes et de graphiques � partir de vos documents textuels. Ghostscript est disponible dans la plupart des distributions Linux, et peut m�me �tre d�j� install� sur votre syst�me.
Pr�parer des documents pour que TeX en fasse la composition, c'est facile. Assurez-vous qu'une ligne blanche se trouve entre les paragraphes d'un fichier purement textuel, et faites passer le fichier au travers de la moulinette TeX avec la commande
tex votre_fichier_texteLe r�sultat sera un fichier dont le nom poss�de la m�me racine, mais portant l'extension
.dvi
. TeX formate le texte en mode
10 points, Computer Modern Roman, avec un interligne simple et
justifi� aussi bien � gauche qu'� droite. Si vous obtenez des messages
d'erreur au sujet de symboles sp�ciaux, comme le dollar, enlevez-leur
leur caract�re particulier en les faisant pr�c�der par la barre de
fraction invers�e (backslash), \
, et lancez TeX
une deuxi�me fois sur votre fichier. Vous devez pouvoir traiter le
fichier r�sultat avec le traducteur de .dvi
de votre choix
(cf. ci-dessus) pour obtenir une sortie imprim�e.
Une particularit� des entr�es pour TeX est que vous devez utiliser des guillemets ouvrants et fermants, qui figurent dans le fichier d'entr�e sous forme d'accents graves et d'apostrophes. Le mode TeX d'Emacs le fera pour vous automatiquement
NdT. : en fran�ais, les guillemets s'�crivent « et ». Si votre clavier en dispose vous pouvez les saisir tels quels, sinon, ils peuvent �tre compos�s en doublant les symboles.<
et>
.
"Voici des guillemets de type ASCII" ``Voici des guillemets `� la TeX'.''
En TeX, les commandes commencent par une barre de fraction invers�e (« \ »). Par exemple, la commande pour changer l'interligne est
\baselineskip=24pt
La ligne de base est la limite inf�rieure des symboles sur une ligne,
sans compter les jambages inf�rieurs. La distance entre les lignes de
base de deux lignes cons�cutives est le \baselineskip
,
auquel est affect� une valeur de 24 points.
En TeX, les mesures ou les dimensions sont souvent donn�es dans les unit�s suivantes :
pt % Point : 1/72 in. pc % Pica : 12 pt. in % Pouce : 72.27 pt. cm % Centimetre : 2.54 cm = 1 in. mm % Millimetre : 10 mm = 1 cm.
Quelques unes des commandes ne prennent pas d'affectation. Par exemple :
\smallskip % Environ 3 pt. \medskip % Deux \smallskips. \bigskip % Deux \medskips.
Un \smallskip
ins�re dans le document un espacement
vertical de 3 pt. Les mesures sont approximatives car TeX a besoin
d'ajuster les dimensions pour les sauts de page, les en-t�tes et
d'autres �l�ments d'espacement vertical. Cela vaut �galement pour
l'espacement horizontal.
\hsize=6.5inCette commande positionne la largeur de la ligne � 6,5 pouces. TeX essaie de remplir la ligne en ajustant l'espacement entre les mots, et certains caract�res. Si TeX est incapable de remplir une ligne en respectant ses tol�rances, il produit un message d'avertissement, et ajuste l'espacement horizontal au sein de la ligne du mieux qu'il peut. Les tol�rances de formatage sont expos�es dans la section Tol�rances. /export/home/mh/Docs/HOWTOS/TeTeX-HOWTO/ Il existe beaucoup d'autres commandes qui sp�cifient les dimensions et les tol�rances horizontales et verticales, et les plus r�pandues sont d�crites plus loin.
En TeX, la police par d�faut est la Computer Modern Roman en 10 pt. Pour pr�ciser un style typographique, comme l'italique, le gras, ou l'espacement fixe, utilisez les commandes suivantes :
\rm % Roman (par defaut). \it % Italiques. \bf % Gras. \tt % Espacement fixe (machine a ecrire). \sl % Oblique (slanted : incline).Ces commandes modifient le style typographique � l'endroit o� elles apparaissent dans le texte, comme dans cet exemple.
Ce texte est en Roman, \it et ce texte est en italiques. \bf Ce texte est en gras et \rm ce texte est a nouveau en Roman.
Pour sp�cifier une police pour votre document, utilisez la commande \font
.
\font\romantwelve=cmr12Cela cr�e la commande de police
\romantwelve
, qui,
lorsqu'elle est utilis�e dans le texte, active la police Computer Modern
Roman en 12 points.
\romantwelve Voici la police Computer Modern Roman en 12 points.Pour plus d'informations au sujet des polices de la distribution teTeX, consultez le fichier :
/usr/lib/teTeX/texmf/doc/fonts/fontname/fontname.dvi
Si vous voulez imprimer un �chantillon d'une police, lancez TeX sur le fichier
/usr/lib/teTeX/texmf/tex/plain/base/fontchart.texet, � l'invite, renseignez le nom de la police que vous voulez imprimer.
Vous pouvez �galement modifier la taille d'une police pour obtenir des
effets vari�s. L'agrandissement des polices est exponentiel, et est
d�fini par la commande scaled \magstep
, plac�e apr�s la
sp�cification de la police.
\font\sfmedium=cmss12 scaled \magstep 1Cette commande vous donnera une police sans s�rif d'une taille de 120 pourcent celle de la police sans s�rif Computer Modern Roman de 12 points. Les agrandissements de polices peuvent aller de 0 � 5. Chaque �chelle donne un agrandissement de 120 pourcent.
Comme mentionn� ci-dessus, TeX compose le texte en Computer Modern
roman 10 points par d�faut. La largeur d'une ligne est donn�e par
\hsize
, qui s'�l�ve � 6,5 in. par d�faut. Si vous voulez
changer la valeur de \hsize
en 5,5 in. par exemple,
utilisez cette commande.
\hsize=5.5in
En TeX, une dimension est une unit� de longueur ajustable,
soit horizontale, soit verticale. La quantit� dont on peut augmenter
ou diminuer une dimension peut �tre sp�cifi�e dans sa d�finition. En
relation �troite avec une dimension, il existe un pas (skip),
qui est une dimension plac�e dans l'un des registres internes de
TeX. Les pas sont d�finis avec la commande \newskip
. La
dimension \smallskip
, telle que d�finie par TeX
est :
\newskip\smallskipamount \smallskipamount=3pt plus 1pt minus 1ptLa commande
\smallskip
est un raccourci pour :
\vskip\smallskipamount
Il existe un certain nombre de dimensions qui contr�lent la mise en page. Elles sont r�sum�es dans la section Mise en page.
TeX compose les paragraphes en les justifiant aussi bien � gauche qu'� droite. Si vous souhaitez que le texte ne soit justifi� qu'� gauche, utilisez cette commande :
\raggedright
Pour composer une ligne qui doit �tre justifi�e � droite, utilisez la
commande \rightline
:
\rightline{Voici la ligne a composer.}
La commande \line
compose le texte de son argument pour
qu'il remplisse l'int�gralit� de la ligne.
\line{Ce texte sera espace pour remplir toute la ligne.}
La commande \hfil
ajoute de l'espace l� o� elle appara�t
pour remplir toute la ligne. Ainsi, par exemple, la commande
\rightline
est �quivalente � :
\line{\hfil Cette ligne sera justifiee a droite.}
Pour composer une ligne centr�e, utilisez la commande
\centerline
.
\centerline{Voici la ligne a centrer.}
Pour modifier la marge gauche, positionnez la valeur de
\hoffset
, comme dans cet exemple :
\hoffset=1.5in
La commande \parindent
sp�cifie la quantit� dont la
premi�re ligne de chaque paragraphe sera indent�e.
\parindent=.5in
Deux autres dimensions, \leftskip
et
\rightskip
, indenteront respectivement les marges gauche
et droite des paragraphes qui les suivent.
\leftskip=.5in \rightskip=.5inLa commande
\narrower
est l'�quivalent de :
\leftskip=\parindent \rightskip=\parindentEn fait,
\narrower
r�tr�cit les marges des paragraphes
avec la valeur de \parindent
.
Comme mentionn� dans la section pr�c�dente,
\baselineskip
sp�cifie la distance entre les lignes. Sa
valeur par d�faut est de 12 pt. Pour obtenir une approximation d'un
double interlignage, utilisez la commande suivante :
\baselineskip=\baselineskip*1.6
La commande \parskip
sp�cifie une distance qui s'ajoute
� \baselineskip
entre deux paragraphes. Aucun espace
suppl�mentaire n'est ajout� par d�faut, mais la distance entre
paragraphes peut s'�tirer jusqu'� 1 pt. pour remplir la page
correctement. Pour ins�rer une ligne blanche entre les paragraphes,
utilisez cette commande :
\parskip=\baselineskip
Normalement, TeX compose le texte dans le strict respect des
tol�rances. Si, pour une raison quelconque, le texte ne peut �tre
compos� en respectant ces tol�rances, TeX produit un message d'erreur
et compose le texte du mieux qu'il peut. Si le texte doit �tre trop
�tir� pour s'adapter � la ligne, TeX vous avertit que la
\hbox
n'est pas assez remplie (underfull). Tout
texte qui doit �tre comprim� produit un avertissement de d�bordement
(overfull \hbox
).
Pour chaque overfull \hbox
, TeX place un
slug, un rectangle noir, en fin de ligne. Ce rectangle
indique que la ligne n'a pu �tre format�e avec les contraintes
impos�es par le param�tre \hbadness
.
L'ajustement du texte � l'int�rieur de ses dimensions impos�es est
mesur� par sa « mauvaise qualit� »
(badness), qui est un nombre entre 0 et 10000. Une
badness de 0 correspond � un ajustement parfait, et une
badness de 1000 indique que la ligne ne sera probablement
jamais ajust�e. La valeur par d�faut de \hbadness
est
1000. Si vous mettez \hbadness
� 10000, TeX ne r�clamera
plus � propos des lignes pas assez remplies.
TeX autorise quelquefois une ligne � d�border dans la marge droite. Il
s'agit d'une d�cision esth�tique de la part de l'auteur de TeX. La
quantit� autoris�e pour ce d�bordement est d�termin�e par le param�tre
\hfuzz
, dont la valeur par d�faut est de 0,1 pt. Si
le texte ne peut s'adapter � la ligne, le param�tre de
\tolerance
d�termine la fa�on dont TeX va g�rer le
d�passement. La valeur par d�faut de \tolerance
est
200. Positionner \tolerance
� 1000 supprime les
avertissements � propos des overfull \hbox
et
l'affichage des rectangles noirs.
En plus des dimensions de marge gauche et de longueur de ligne d�crites dans la section pr�c�dente, TeX vous permet de sp�cifier les marges sup�rieure et inf�rieure, ainsi que l'espacement vertical.
� l'instar des dimensions \hsize
et
\hoffset
d�crites dans la section ci-dessus, TeX dispose
des commandes \vsize
et \voffset
. Par
d�faut, \vsize
vaut 8,9 in. et \voffset
vaut 0.
En temps normal, teTeX place le d�but de la premi�re ligne de texte � 1 in. sous le bord sup�rieur de la feuille et � 1 in. du bord gauche. Il vous est possible de commencer le texte plus pr�s du haut de la page avec la commande :
\voffset=-0.5in
Si vous voulez ajouter de l'espacement vertical dans un document, les
commandes \smallskip
, \medskip
et
\bigskip
ajouteront environ 3, 6 et 12 points d'espace
vide vertical. Ces mesures sont des approximations : TeX fera des
ajustements pouvant aller jusqu'� 1 pt. pour remplir correctement la page.
La commande \vfill
ajoute un espacement vertical
ajustable entre paragraphes d'une m�me page. Son �tirement peut aller
jusqu'� l'infini, ainsi elle ajoutera de l'espacement vertical pour
remplir au maximum le restant de la page. Si vous voulez sp�cifier une
dimension, utilisez \vskip
, comme dans :
\vskip 10pt
Les commandes \hss
et \vss
sont similaires
� \hfill
et \vfill
, mais elles fournissent
des dimensions pouvant �tre r�tr�cies ou �tir�es � l'infini.
Les commandes \vskip
et \vfill
produisent
des longueurs flexibles. Elles n'ajoutent pas d'espace l� o� il n'y a
aucun texte ; par exemple en haut de la page. Utilisez
\vglue
si vous voulez ajouter un espacement absolu.
TeX remplit la dimension \vsize
avec le plus possible de
texte avant de commencer une nouvelle page. Pour forcer un saut de
page, utilisez la s�quence \vfill \eject
. Si
\vfill
n'est pas utilis�, le texte avant le
\break
sera dispos� de fa�on � remplir la page.
Si vous voulez que TeX soit plus flexible pour ce qui est des
espacements verticaux sur la page, placez la commande
\raggedbottom
dans votre document. TeX ajustera alors
l�g�rement la marge inf�rieure de chaque page pour rendre l'espacement
vertical plus coh�rent.
Par d�faut, TeX place le num�ro de page au centre du pied de
page. Si vous souhaitez changer l'emplacement et le style du num�ro de
page, il vous est possible de sp�cifier d'autres en-t�tes et pieds de
page en changeant les d�finitions de \headline
et
\footline
. La valeur par d�faut pour
\footline
contient la commande \folio
, qui
imprime le num�ro de page. La valeur par d�faut pour
\headline
est \hfill
; ce qui imprime donc
une ligne blanche.
La commande \pageno
est un synonyme du compteur de pages
interne de TeX. Vous pouvez changer le num�ro de page en changeant la
valeur de \pageno
. Si \pageno
est n�gatif,
les nombres sont imprim�s en chiffres romains.
\pageno=10 \pageno=-1
La commande \nopagenumbers
est un raccourci pour :
\headline={\hfil} \footline={\hfil}
La ligne de pied de page par d�faut contient �galement la commande pour
police \tenrm
, qui sp�cifie une police Roman 10 points
pour le num�ro de page. Si vous d�sirez imprimer le num�ro de page en
Roman 12 points par exemple, vous devez d'abord d�finir une commande
pour positionner la police en Roman 12 points, et utiliser celle-ci
dans la d�finition de \footline
. Les commandes pour les
polices sont abord�es dans la section
Commandes pour les polices.
\font\twelvrm=cmr12 \footline={\hss\twelvrm\folio\hss}
Vous pouvez ins�rer une ligne horizontale ou rule, en haut de
chaque page en red�finissant \headline
comme suit :
\headline={\hrulefill}
Pour sp�cifier des en-t�tes diff�rents pour les pages paires et
impaires, utilisez la commande \ifodd
, qui a la forme :
\ifodd[condition][action-si-vrai]\else[action-si-faux]Un exemple de
\headline
utilisant des en-t�tes
diff�rents pour les pages paires et impaires est :
\headline={\ifodd\pageno en-tete-page-impaire \else en-tete-page-paire}L'expression
\ifodd
utilise le premier argument si le
num�ro de page est impair, et le deuxi�me argument sinon.
TeX ne fournit que la macro \beginsection
pour les
en-t�tes de section. Elle laisse un espace au-dessus de son argument,
imprime le texte de l'en-t�te en gras, ajoute un
\smallskip
apr�s le texte de l'en-t�te, et commence le
paragraphe suivant sans indentation.
Les commandes de chapitre et de section d�crites plus loin ajoutent la num�rotation des sections, impriment les titres et les num�ros des sections dans les en-t�tes de pages et ajoutent automatiquement les sections � la table de mati�res.
En TeX pur, c'est � vous d'�crire ces commandes. La commande
\def
vous permet de d�finir de nouvelles
commandes. Supposons que vous souhaitiez imprimer le titre d'un
chapitre. En premier, vous d�finissez la police que vous voulez
utiliser. Une police de grande taille et sans s�rif pour les titres de
chapitres peut �tre d�finie ainsi :
\font\chapterfontsans=cmss12 scaled \magstep 4Vous pouvez utiliser la commande
\chapterfontsans
�
n'importe quel endroit o� vous voulez adopter cette police, dont la
hauteur approximative est de 24 points. Toutefois, dans cet exemple,
son utilisation principale sera dans la commande
\chaptertitlesans
. Voici sa d�finition :
\def\chaptertitlesans#1{\hbox{}\bigskip\bigskip \noindent{\leftline{\chapterfontsans#1}} \par\bigskip\bigskip\noindent}La premi�re ligne,
\hbox{}\bigskip
, fixe un
espacement de 12 points en haut de la page en y pla�ant une
\hbox{}
vide. La ligne comportant le titre du chapitre
n'est pas indent�e, comme le paragraphe qui le suit imm�diatement. Si
vous placez une ligne vide entre la macro
\chaptertitlesans
et le paragraphe suivant, le
\noindent
final s'appliquera � la ligne vide, et non pas
au texte du paragraphe qui suit. Pour un formatage correct, utilisez
\chaptertitlesans
, comme dans cet exemple :
L'expression #1
dans la d�finition est remplac�e par le
premier argument de \chaptertitlesans
qui sera en fait
le titre du chapitre. Dans les d�finitions en TeX, les param�tres sont
d�clar�s par #1
, #2
, #3
et ainsi de
suite. Un exemple d'utilisation de \chaptertitlesans
serait :
\chaptertitlesans{Chapitre 1} Cela est le texte commen�ant le premier paragraphe du chapitre. Le paragraphe ne sera pas indente. Le titre du chapitre est "Chapitre 1."
Les documents compos�s pour LaTeX doivent ob�ir � quelques r�gles suppl�mentaires, mais pour des documents complexes, LaTeX peut grandement simplifier le processus de mise en forme.
LaTeX est � la base un langage de balisage de document essayant de
s�parer le style produit en sortie du contenu logique du document. Par
exemple, la composition d'un titre de section avec TeX n�cessiterait
de sp�cifier un espace de 36 points au dessus du titre, ensuite, le
titre lui-m�me en gras et en 24 points, puis la copie du texte et du
num�ro de page dans la table des mati�res, et enfin de laisser un
espace de 24 points apr�s le titre. Par contraste, LaTeX dispose de la
commande \section{}
, qui fait tout le travail pour
vous. Si vous devez changer le format des titres de section pour tout
le document, vous pouvez changer la d�finition de
\section{}
au lieu du texte lui-m�me dans le
document. Vous pouvez calculer par vous-m�me les heures de remise en
forme gagn�es pour des documents comportant plus d'une douzaine de pages.
Tous les documents LaTeX comportent trois sections : un pr�ambule, le corps du texte et un postambule. Ces termes font partie du jargon standard et sont largement utilis�s par les TeXperts.
Le pr�ambule, dans sa forme minimale, sp�cifie le type du document � produire -- la classe du document -- et une directive signalant le d�but du corps du texte du document. Par exemple :
\documentclass{article} \begin{document}Le postambule du document est habituellement tr�s simple. Sauf cas exceptionnels, il ne contient que la directive :
\end{document}Notez comment
\begin{document}
et
\end{document}
vont de pair. En LaTeX, on appelle cela
un environnement. Tout texte doit appara�tre dans un
environnement, et de nombreuses commandes ne s'appliquent qu'�
l'int�rieur des environnements o� elles sont appel�es. Cependant,
l'environnement document
est le seul cas o� LaTeX impose
cette convention. En effet, c'est le seul environnement obligatoire
dans un document. (La classe lettre, letter
pour LaTeX,
constitue un exception, dans la mesure o� elle vous impose de d�clarer
\begin{letter}
et
\end{letter}
. Reportez-vous � la section
Lettres.) Quoi qu'il en soit, de nombreuses
fonctions de formatage sont sp�cifi�es au travers
d'environnements. Elles sont d�crites dans les sections suivantes.
Les classes de documents peuvent �tre appel�es avec des arguments. Par exemple, au lieu de la taille de base de 10 points adopt�e par d�faut, comme dans l'exemple pr�c�dent, nous aurions pu sp�cifier :
\documentclass[12pt]{article}
pour produire un document bas� sur une police de 12 points. La classe de documents article, op�re les ajustements n�cessaires.
Il existe quelques classes de documents utilis�es de fa�on
courante. Elles sont d�crites plus loin. La classe rapport
(report
) est similaire � la classe article mais
produit une page de titre et commence chaque section sur une nouvelle
page. La classe lettre (letter
) comprend des
d�finitions sp�ciales pour les adresses, les salutations et les
formules de politesse, dont quelques-unes sont d�crites plus loin.
Vous pouvez inclure du code LaTeX pr�emball�, connu sous le nom
d'extension (package
), � l'aide de la commande
\usepackage{}
.
\usepackage{fancyhdr}La commande ci-dessus provoque l'inclusion du fichier de style LaTeX
fancyhdr.sty
se trouvant dans l'un des r�pertoires d�finis
par TEXINPUTS
, que vous-m�me et teTeX avez sp�cifi� lors de
la phase d'installation et de configuration.
\documentclass{article} \usepackage{fancyhdr} \begin{document}
Remarquez que les d�clarations \usepackage{}
sont
donn�es avant la directive \begin{document}
; et donc,
dans le pr�ambule du document.
fancyhdr.sty
�tend la commande \pagestyle{}
pour vous permettre de cr�er des en-t�tes et des pieds de page
personnalis�s. La plupart des classes de documents LaTeX fournissent
des en-t�tes et des pieds de page pour les styles de page standardis�s
suivants :
\pagestyle{plain} % style de page par defaut -- numero de page centre % dans le pied de page. \pagestyle{empty} % pas d'en-tetes ni de pied de page. \pagestyle{headings} % imprime le numero de section et le numero de % page dans l'en-tete. \pagestyle{myheadings} % imprime de l'information personnalisee dans % l'en-tete.Tout ce qui se trouve � droite du symbole pourcent sur une ligne est un commentaire.
La commande \pagestyle{}
ne prend effet qu'� la page
suivante. Pour modifier les en-t�tes et pieds de page de la page
courante, utilisez la commande :
\thispagestyle{style_de_page}
Le style des caract�res d�pend en partie des polices sp�cifi�es dans le document. Toutefois, la mise en �vidence de texte par les caract�res gras ou italiques devrait �tre disponible pour toutes les polices. Le soulign� peut �galement �tre utilis�, bien que son formatage pr�sente des probl�mes particuliers. Consultez la section Extensions pour LaTeX et autres ressources, plus loin.
Vous pouvez faire ressortir du texte de plusieurs mani�res. La plus
portable repose sur la commande \em
. Tout le texte dans
sa port�e sera mis en italiques par d�faut. Par exemple :
Ce mot sera {\em mis en evidence.}S'il y a du texte en italiques suivi de texte qui ne l'est pas, vous pouvez sp�cifier qu'un facteur de correction des italiques doit �tre utilis�. Pour cela, la commande est
\/
; ce qui
correspond � une barre de fraction invers�e puis une barre de fraction
normale.
Cet exemple {\em sera\/} correctement imprime. Cet exemple ne sera {\em pas} imprime correctement.L�g�rement moins portables, mais encore acceptables dans les situations o� elles sont employ�es de mani�re isol�e, il y a les commandes
\it
, \bf
, et \tt
, qui
sp�cifient que les caract�res dans leurs port�es doivent �tre imprim�s
respectivement en italiques, en gras et en espacement fixe (teletype).
{\tt Ce texte sera imprime avec un espacement fixe,} {\it ce texte sera en italiques,} et {\bf ce texte sera en gras\dots} le tout dans un meme paragraphe.La commande
\dots
imprime une suite de trois points
correspondant aux points de suspension, qui ne seront pas coup�s par
un saut de ligne.
La version la plus r�cente de LaTeX, qui est celle dont vous disposez, comprend des commandes tenant compte des occurrences o� une mani�re de mettre du texte en �vidence prendrait le pas sur une autre.
Cela n'est {\it pas {\bf en gras et en italiques !}}Ce qui se passe, c'est que teTeX compose le texte en italiques jusqu'� ce qu'il rencontre la commande
\bf
, endroit � partir
duquel il adopte les caract�res gras.
Pour �viter cela, NFSS, la m�thode de s�lection pour la forme des polices, n�cessite trois param�tres pour chaque jeu de caract�res : la forme, la s�rie et la famille. Tous les jeux de polices n'incluent pas l'ensemble de ces styles. LaTeX affichera cependant un avertissement s'il doit substituer une police � une autre.
Les formes suivantes peuvent �tre sp�cifi�es :
\textup{texte} % caracteres "droits" (par defaut) -- upright shape \textit{texte} % italiques \textsl{texte} % obliques \textsc{texte} % petites capitalesVoici les deux s�ries dont disposent la majorit� des polices :
\textmd{text} % serie moyenne (par defaut) -- medium \textbf{text} % caracteres grasTrois familles de caract�res sont g�n�ralement disponibles :
\textrm{text} % Roman (par defaut) \textsf{text} % sans serif \texttt{text} % espacement fixe (de type Courier) ou teletypeSp�cifier des styles de polices � l'aide de ces param�tres peut se faire en combinant les effets.
\texttt{\textit{Cet exemple produira vraisemblablement une substitution de police, car peu de polices comportent un style italique en espacement fixe.}}La famille de polices par d�faut est la Computer Modern, qui est une police matricielle. D'autres familles de polices sont g�n�ralement au format Postscript Type 1. Consultez la section Utilisation des polices Postscript pour les d�tails concernant leur utilisation.
De nombreuses formes d'accents ou de caract�res sp�ciaux sont �galement disponibles pour la composition. En voici quelques uns. (Essayez de les composer sur votre propre imprimante.)
\'{o} \`{e} \^{o} \"{u} \={o} \c{c} `? `! \copyright \pounds \dagEnfin, certains caract�res sont utilis�s comme des m�ta-caract�res ou des caract�res d'�chappement en TeX et LaTeX. L'un d'eux, le symbole du dollar est mentionn� plus haut. L'ensemble des m�ta-caract�res qu'il faut faire pr�c�der d'une barre de fraction invers�e pour leur faire perdre leur signification particuli�re est :
# $ % & _ { }
De nombreux alphabets, comme l'alphabet grec ou cyrillique, sont �galement disponibles. LaTeX fournit une aide pr�cieuse pour la composition de textes en diff�rentes langues, que l'on peut trouver dans quelques-unes des r�f�rences mentionn�es ici.
Changer les marges dans un document TeX ou LaTeX n'est pas une t�che �vidente. Beaucoup de choses d�pendent de l'indentation relative du texte dont vous essayez d'ajuster la marge. L'endroit o� est plac�e la commande de modification des marges est �galement significatif.
Pour des changements portant sur tout le document LaTeX, il existe les
commandes \evensidemargin
et
\oddsidemargin
. Elles influent sur les marges de gauche
respectivement des pages paires et des pages impaires. Par exemple,
\evensidemargin=1in \oddsidemargin=1inajoutent un pouce � la marge de gauche des pages paires et impaires en suppl�ment de la marge gauche standard d'un pouce. Ces commandes ont un effet sur l'int�gralit� du document, et d�caleront l'ensemble du corps du texte vers la droite et vers la gauche � travers la page, quelle que soit l'indentation locale ; leur utilisation est donc sans danger avec des environnements tels que
verse
et list
.
Ci-dessous figure un ensemble de macros de mon cru pour les changements de marges. Leur effet est diff�rent des commandes mentionn�es ci-dessus. Comme elles utilisent des commandes en TeX pur, il se peut qu'elles ne respectent pas les marges des environnements LaTeX qui peuvent �tre actifs, mais vous pouvez les placer n'importe o� dans le document pour changer les marges � partir de ce point.
%% margins.sty -- v. 0.1 by Robert Kiesling %% Des copies strictement conformes de ce code peuvent etre librement %% distribuees. %% %% Quelques commandes elementaires de changement de marges en TeX %% pur. Les mesures sont en pouces : %% \leftmargin{1} %% fixe la marge gauche du document a 1 pouce. %% \leftindent{1} %% fixe l'indentation des paragraphes suivants a %% %% 1 pouce. %% \rightindent{1} %% fixe la marge de droite des paragraphes suivants %% %% a 1 pouce. %% \llength{3} %% fixe la longueur des lignes suivantes a 3 pouces. %% \message{Macros pour les marges...} \def\lmargin#1{\hoffset = #1 in} \def\lindent#1{\leftskip = #1 in} \def\rindent#1{\rightskip = #1 in} \def\llength#1{\hsize = #1 in} %% %% (Fin des macros pour les marges.}Mettez ce code dans un fichier nomm�
margins.sty
dans le
r�pertoire local figurant dans votre
$TEXINPUTS
. L'explication des commandes se trouve dans
la section comment�e du fichier. Pour les inclure dans un document,
utilisez la commande
\usepackage{margins}dans le pr�ambule du document.
Pendant que nous y sommes, si ne voulez pas que le texte soit justifi� � droite, vous pouvez dire � LaTeX de laisser les marges de droite en dents de scie gr�ce � la commande :
\raggedright
Le positionnement de l'interligne comporte �galement quelques complications.
La mesure baselineskip est la distance entre les lignes de texte. Il s'agit d'une mesure absolue, par exemple,
\baselineskip=24ptou encore mieux :
\setlength{\baselineskip}{24pt}La diff�rence entre les deux formes est que setlength respectera toutes les r�gles de port�e qui sont actives au moment o� vous utilisez la commande.
Le probl�me avec l'utilisation de baselineskip est qu'il joue
�galement un r�le dans la distance entre les titres de sections, les
notes de bas de page et consorts. C'est � vous de veiller � ce que
baselineskip soit correct pour l'�l�ment que vous �tes en
train de composer, quel qu'il soit. Toutefois, il existe des
extensions compos�es de macros LaTeX comme setspace.sty,
qui
vous viendront en aide dans ces circonstances. Reportez-vous � la
section
Extensions pour LaTeX et autres ressources.
LaTeX fournit des classes de documents qui d�crivent des formats standardis�s pour ces documents. Elles donnent acc�s � des environnements de composition de listes, de citations, de notes de bas de page et autres �l�ments textuels. Les classes de documents d'usage courant sont abord�es dans les sections qui suivent.
Comme mentionn� ci-dessus, les classes article
et
report
(utilis�e pour les rapports) sont similaires. Les
principales diff�rences sont que la classe report
cr�e par
d�faut une page de titre et fait d�buter chaque section sur une
nouvelle page. Dans la plupart des cas, ces deux classes de documents
sont toutefois similaires.
Pour cr�er des titres, des r�sum�s et autres dans ces classes de documents, vous pouvez entrer, par exemple :
\title{La reproduction des cactacees} \author{John Q. Public} \abstract{Description de la maniere dont la cactacee commune du desert recherche des points d'eau appopries pour pratiquer ses rituels de reproduction.}dans le pr�ambule du document. Puis, la commande
\maketitleplac� en d�but de texte, g�n�rera soit une page de titre dans la classe
report
, soit le titre et le r�sum� en haut de la
premi�re page, dans la classe article
.
La d�finition des sections peut se faire avec des commandes de la liste suivante :
\section \subsection \subsubsectionCes commandes produiront des sections num�rot�es standardis�es utilis�es dans des documents techniques. Pour obtenir des sections non-num�rot�es, utilisez :
\section* \subsection* \subsubsection*et ainsi de suite.
LaTeX fournit de multiples environnements pour composer le texte �
imprimer. Les citations peuvent �tre incluses avec l'environnement
quotation
.
\begin{quotation} D�but du paragraphe de la citation... ... fin du paragraphe. \end{quotation}Pour des citations plus courtes, vous pouvez utiliser l'environnement
quote
.
Pour composer des vers, utilisez l'environnement verse
.
\begin{verse} Ne pouvant m'arreter pour la mort\\ Elle eut l'obligeance de s'arreter pour moi \end{verse}Remarquez que vous devez utiliser deux barres de fraction invers�es pour couper les lignes � la bonne place. Sinon, LaTeX remplit les lignes dans un environnement verse, comme dans tout autre environnement.
Les listes peuvent adopter plusieurs formats. Pour composer une liste
avec des tirets, c'est l'environnement list
qui est utilis� :
\begin{list} \item Ceci est le premier element de la liste. \item Ceci est le deuxieme element de la liste... \item ... et ainsi de suite. \end{list}
Une liste num�rot�e utilise l'environnement enumerate
:
\begin{enumerate} \item Element No. 1. \item Element No. 2. \item \dots \end{enumerate}
Une liste descriptive utilise l'environnement description
:
\begin{description} \item{Four} Sale, a besoin d'un nouveau bruleur. \item{Refrigerateur} Sale. Desole. \item{Evier et egouttoir} Robinet d'eau froide tache et qui goutte. \end{description}
La classe letter
utilise des d�finitions sp�cifiques pour la
composition du courrier d'entreprise.
L'environnement letter
prend un argument, l'adresse du
destinataire de la lettre. La commande address
, qui doit
figurer dans le pr�ambule du document d�finit l'adresse de retour. La
commande signature
d�finit le nom de l'exp�diteur tel qu'il
figurera apr�s les salutations.
Le source LaTeX d'un courrier d'entreprise �l�mentaire pourrait ressembler � ceci :
\documentclass[12pt]{letter} \signature{John Q. Public} \address{123 Main St.\\Los Angeles, CA. 96005\\Tel : 123/456-7890} \begin{document} \begin{letter}{ACME Brick Co.\\100 Ash St.\\San Diego, CA 96403} \opening{Cher(e) Monsieur/Madame,} Concernant l'une de vos briques que j'ai retrouvee sur le tapis de mon salon entouree des debris de verre de la fenetre de ma facade... (Suite du corps de la lettre.) \closing{Sincerement votre,} \end{letter} \end{document}Notez que l'adresse inclut deux barres de fraction invers�es, qui indiquent o� doivent se produire les sauts de ligne.
Plus haut, nous avons mentionn� que le soulign� utilis� comme moyen de mettre du texte en �vidence pr�sente des probl�mes particuliers. En fait, TeX n'a aucun probl�me pour souligner du texte, puisqu'il s'agit d'une convention pour la composition en math�matiques. En LaTeX, vous pouvez souligner des mots avec la commande :
\underline{texte a souligner}Le probl�me est que le soulign� ne suivra pas les sauts de ligne, et qu'il peut se r�v�ler irr�gulier dans certaines circonstances. Toutefois, il existe une extension de macros LaTeX, pr�tes � l'emploi, qui font du soulign� la m�thode de mise en �vidence par d�faut. Elle s'appelle
ulem.sty
, et c'est l'une des nombreuses contributions � LaTeX
qui sont disponibles gratuitement sur l'Internet.
Pour utiliser ulem.sty
, incluez la commande :
\usepackage{ulem}dans le pr�ambule du document.
Parmi les extensions disponibles pour LaTeX, il y a :
Permet d'inclure des expressions conditionnelles dans vos documents.
D�finit une police pour les lettrines.
Police et pr�processeur pour la production de documents en sanscrit.
Une classe LaTeX2e pour composer des recettes.
Variante des styles rapport et article.
Pour obtenir l'URL pleinement qualifi� � partir d'un chemin donn� dans
le catalogue, concat�nez le chemin � l'URL donnant le nom de la
machine et la racine de l'arborescence du site CTAN que vous d�sirez
contacter. Par exemple, la racine de l'arborescence CTAN du site
ftp.tex.ac.uk est
ctan/tex-archive
. L'URL complet du r�pertoire
refman sera :
ftp://ftp.tex.ac.uk/ctan/tex-archive/ + macros/latex/contrib/supported/refman = ftp://ftp.tex.ac.uk/ctan/tex-archive/macros/latex/contrib/supported/refman/Certaines extensions comportent plusieurs fichiers ; seul le chemin vers le r�pertoire contenant l'extension est alors donn�.
Avec l'URL sous la main, vous pouvez t�l�charger l'extension � partir
de l'un des sites d'archives CTAN recens�s dans l'annexe
Annexe A. Vous avez la possibilit� de d�charger la liste
compl�te du contenu de l'archive qui se trouve dans le fichier
FILES.byname
, dans le r�pertoire racine de l'archive. Vous
pouvez �galement faire une recherche par mot-cl� en ligne � l'aide de
la commande ftp
quote site index <mot-cle>
dvips
De mani�re g�n�rale, cette section s'applique � tout document TeX ou
LaTeX qui combine du texte et des graphiques. teTeX, comme la plupart
des autres distributions TeX, est configur� pour utiliser par d�faut
les polices Computer Modern. Lors de l'impression de documents
contenant des polices vectorielles Type 1 ou des �l�ments
graphiques, le rendu du texte et des graphiques est du ressort de
dvips
. dvips
peut utiliser indiff�remment des
polices matricielles Computer Modern ou des polices vectorielles Type
1, ou n'importe quelle combinaison des deux. En premier lieu,
int�ressons-nous � l'impression et � la pr�visualisation de quelques
�l�ments graphiques.
Vous souhaiterez sans doute suivre cette proc�dure � chaque fois qu'un document source LaTeX poss�de la directive
\includepackage{graphics}dans son pr�ambule. Cette directive indique � LaTeX d'inclure le texte de l'extension
graphics.sty
dans le document source. Il existe d'autres
commandes pour effectuer des op�rations graphiques, et les directives
contenues dans des documents en TeX pur ne vous renseignent pas
forc�ment sur l'obligation ou non d'utiliser
dvips
. Toutefois, la diff�rence se verra dans la sortie,
lorsque le document imprim� ne comportera pas toutes les figures ou
autres �l�ments graphiques.
Donc, pour l'instant, nous nous focaliserons sur l'impression de
documents utilisant l'extension LaTeX graphics.sty
. Vous avez
peut-�tre envie d'aller examiner le fichier TeX d'origine. Il ne se
trouve pas dans la distribution, mais est disponible � :
~CTAN/macros/latex/packages/graphics/grfguide.tex.Ce qui se trouve bien dans la distribution teTeX est le fichier de sortie
.dvi
, et il a d�j� �t� « TeX� » pour
vous. L'explication en est que l'impression correcte du document
repose sur la n�cessit� d'y inclure des polices Type 1. Si vous
d�sirez composer grfguide.tex
avec LaTeX, reportez-vous � la
section suivante. Pour le moment, nous t�cherons d'obtenir une sortie
utilisable � l'aide de dvips
.
Le fichier grfguide.dvi
se trouve dans le r�pertoire
texmf/doc/latex/graphicsLe premier pas dans la production d'une sortie de
grfguide.dvi
est de le traduire en Postscript. Pour cela, on
utilise le programme dvips
. Il fait exactement ce qu'indique
son nom. Il existe de nombreuses options au lancement de
dvips
, mais la forme la plus simple (ou presque) est
dvips -f -r <grfguide.dvi >grfguide.psL'option
-f
demande � dvips
de se comporter comme un
filtre, lisant � partir de l'entr�e standard et �crivant sur la sortie
standard. Il est possible de configurer dvips
pour qu'il
�crive par d�faut sur lpr
.
Si vous avez la possibilit� d'imprimer directement du Postscript sur
votre imprimante via lpr
, il vous suffit de taper
dvips -r grfguide.dviL'option
-r
indique � dvips d'�crire les pages en ordre
inverse pour qu'elles s'empilent correctement � leur sortie de
l'imprimante. Libre � vous de l'utiliser, en fonction de votre
p�riph�rique de sortie.
En fonction de l'existence ou non des polices g�n�r�es par
dvilj2
pour le dernier document, dvips
et metafont
peuvent �tre amen�s � cr�er de nouvelles polices pour les besoins du
grfguide.dvi
. Cependant, en fin de compte, dvips
produira la liste des pages traduites en Postscript, et vous
obtiendrez une sortie Postscript pr�te � �tre imprim�e sur le
p�riph�rique dont vous disposez.
Si vous �tes chanceux (et riche), alors vous disposez d�j� d'une
imprimante capable de traiter du Postscript et �tes pr�t � imprimer
directement le fichier grfguide.ps
. Vous pouvez envoyer la
sortie vers la file d'impressions � l'aide de lpr
. Si, pour
une raison ou pour une autre, le programme d'impression ne fonctionne
pas correctement, d�chargez directement le fichier sur l'imprimante en
un tour de main, avec
cat grfguide.ps >/dev/lp0ou tout autre port auquel votre imprimante est attach�e, bien que cela ne soit pas recommand� pour un usage courant.
Si vous devez invoquer Ghostscript � la main, voici la d�marche standard � suivre pour cette op�ration. La premi�re chose que vous voudrez faire est d'invoquer Ghostscript pour conna�tre ses options, comme ceci :
gs -help | lessVous verrez la liste des p�riph�riques de sortie support�s et une flop�e d'autres commandes. Choisissez le p�riph�rique de sortie qui correspond le mieux � votre imprimante. Pour ma part, je produis en g�n�ral du texte en noir et blanc et utilise le pilote
cdjmono
, adapt� � une imprimante couleur DeskJet en mode
monochrome (noir et blanc).
La ligne de commande que j'utiliserais est :
gs -dNOPAUSE -sDEVICE=cdjmono -sOutputFile=/tmp/gs.out grfguide.ps -c quitCela produira une sortie compatible avec ma HP dans le r�pertoire
/tmp
. Il est de bon ton d'utiliser un r�pertoire du type
/tmp
car gs
peut �tre quelque peu singulier � propos
des droits d'acc�s, et vous ne pouvez (et ne devriez) pas compter sur
le fait d'�tre connect� sous root
pour effectuer ces
�tapes. � pr�sent vous pouvez imprimer le fichier :
lpr /tmp/gs.outDe toute �vidence, tout cela peut �tre cas� dans un fichier de commandes (shell-script). Sur mon syst�me, j'ai �crit deux scripts tout simples,
pv
et pr
, qui se contentent de
sortir le fichier Postscript soit sur l'�cran, soit sur l'imprimante.
La pr�visualisation sur l'�cran est possible sans X, mais c'est loin
d'�tre l'id�al. Ainsi, cela vaut vraiment le coup, et l'effort,
d'installer XFree86 pour voir la sortie sur l'�cran.
L'ordre des commandes sur la ligne de commande de gs
est
important, car quelques unes des options indiquent � Ghostscript de
chercher des bouts de code Postscript dans sa biblioth�que.
L'important dont il faut se souvenir est que grfguide.dvi
�met des requ�tes � la fois pour des polices matricielles Computer
Modern et pour des polices vectorielles Type 1. Si vous arrivez �
m�langer des polices vectorielles et matricielles dans un document,
vous �tes en bonne voie pour devenir un TeXpert.
La distribution teTeX est accompagn�e d'une s�lection limit�e de
pilotes pour les sorties DVI : dvips
, des pilotes pour les
LaserJet de Hewlett-Packard et c'est tout. Deux possibilit�s s'offrent
� vous si vous avez une imprimante incompatible avec la LaserJet :
vous pouvez utiliser dvips
et Ghostscript, ce que je
recommande de toutes fa�ons, ou vous pouvez vous lancer dans la
recherche d'autres sources de dviware.
Un nombre restreint de pilotes DVI a �t� port� sous Linux et est disponible sous forme de binaires pr�-compil�s. Il se trouvent dans les archives Linux � archives ftp://sunsite.unc.edu/pub/Linux/apps/tex/dvi/.
Les biblioth�ques principales de dviware sont maintenues dans les archives de l'universit� de l'Utah. Si vous ne pouvez y trouver le pilote DVI adapt� � votre imprimante, il est probable qu'il n'existe pas. Vous pouvez �galement �crire votre propre pilote DVI � partir des mod�les qui s'y trouvent. L'URL de la biblioth�que est ftp://ftp.math.utah.edu/pub/tex/dvi/.
Il �tait d'usage que la qualit� des polices Type 1 du domaine public soit nettement inf�rieure � celle des polices matricielles Computer Modern. N�anmoins, cette situation s'est am�lior�e au cours des derni�res ann�es. Mais la mise en correspondance des polices reste � votre charge. Disposer de plusieurs syst�mes de polices diff�rents sur une seule machine peut para�tre redondant et un g�chis en espace disque. Et les polices Computer Modern peuvent para�tre un peu trop formelles, disons, pour un usage courant. C'est un peu comme jeter des perles aux cochons. Au moins, vous n'�tes plus oblig� de d�penser une fortune pour des polices de qualit� professionnelle.
L'une des am�liorations majeures de LaTeX2e par rapport � son pr�d�cesseur est l'inclusion du New Font Selection Scheme (nouveau sch�ma de s�lection des polices). (Qui s'appelle � pr�sent PSNFSS.) Auparavant, les auteurs �crivant en TeX devaient sp�cifier les polices � l'aide de commandes comme
\font=bodyroman = cmr10 scaled \magstep 1
ce qui permet d'�tre pr�cis mais n�cessite les talents d'un typographe
et d'un math�maticien pour �tre utilis� correctement. De plus, cela
manque de portabilit�. Si un autre syst�me �tait d�pourvu de la police
cmr10
(ce qui est la nomenclature TeX pour Computer Modern
Roman, 10 points, d'�paisseur de trait moyenne), quelqu'un devait
recoder les sp�cification des polices pour tout le document. PSNFSS
cependant, vous permet de sp�cifier les polices par famille (Computer
Modern, URW Nimbus, Helvetica, Utopia et ainsi de suite), �paisseur
(l�ger, moyen, gras), orientation (droit ou oblique), style (Roman ou
Italique) et taille de base en points. (Cf. section
Caract�res et styles typographiques pour une
description des commandes de sp�cification des styles typographiques.)
De nombreuses polices sont group�es en familles. Par exemple, une
police du type Roman peut �tre group�e avec une police sans-s�rif,
comme Helvetica, et une police � espacement fixe, comme Courier. Vous,
en tant qu'auteur du document LaTeX, pouvez sp�cifier une famille
enti�re de polices avec une seule commande.
Comme je l'ai d�j� mentionn�, il existe des ensembles de polices de tr�s bonne qualit� dans le domaine public. L'un d'entre eux est Adobe Utopia. Un autre est Bitstream Charter. Ce sont tous les deux des ensembles de qualit� professionnelle qui ont �t� vers�s dans le domaine public.
Il se trouve que ceux-l� sont mes pr�f�r�s. Si vous examinez les sites CTAN, vous y trouverez les archives qui les contiennent ainsi que d'autres. Il y a suffisamment de polices en circulation pour vous permettre de concevoir des documents qui correspondent � vos attentes, et pas seulement pour du texte en fran�ais. � l'origine, TeX a �t� con�u pour la mise en page de math�matiques, ainsi, il existe toute une panoplie de polices math�matiques, tout comme les alphabets cyrilliques et grecs, le kana et d'autres alphabets, trop nombreux pour �tre mentionn�s ici.
L'important est de rechercher les fichiers portant les extensions
.pfa
ou .pfb
. Elles indiquent qu'il s'agit des
polices vectorielles en tant que telles, et non pas simplement des
fichiers des m�triques. Les polices Type 1 utilisent des fichiers de
m�triques .pfm
, par opposition au fichiers .tfm
des
polices matricielles. Les deux ensembles de polices que j'ai
mentionn�s plus haut sont compris dans les distributions teTeX, mais
�galement de mani�re s�par�e.
Ce que j'ai dit ci-dessus, au sujet de la facilit� apport�e par PSNFSS pour la s�lection des polices, se r�v�le appropri� dans le cas de figure suivant : si nous voulons utiliser les polices Charter dans notre document au lieu des polices matricielles Computer Modern, tout ce qu'il y a � faire est d'inclure la directive LaTeX
\renewcommand{\familydefault}{bch}dans le pr�ambule du document, o� « bch » est la d�signation courante pour Bitstream Charter. Les polices Charter se trouvent dans le r�pertoire
/usr/lib/teTeX/texmf/fonts/type1/bitstrea/charter
Vous y verrez les fichiers .pfb
des polices Charter :
bchb8a.pfb
pour Charter Bold, bchr8a.pfb
pour
Charter Roman, bchbi8a.pfb
pour Charter Bold Italic. Le
« 8a » dans les noms des polices indique
l'encodage des caract�res. Arriv� � ce point, vous n'avez pas � vous
pr�occuper � leur sujet
NdT. : cela vaut plus pour les anglophones que pour les francophones., car les encodages diff�rent principalement pour les caract�res 8-bits, dont les valeurs num�riques d�passent 128 en d�cimal. Ils d�finissent pour la plupart des accents et des caract�res non-anglais. Les encodages des Type 1 marchent en g�n�ral bien pour les alphabets occidentaux car ils r�pondent au standard ISO 8859 concernant les jeux de caract�res internationaux, ce qui constitue un argument de plus pour leur utilisation.
Pour composer un document o� sont s�lectionn�es des polices Charter, vous lanceriez la commande
pslatex document.tex
pslatex
est une variante de la commande latex
standard de teTeX qui d�finit les r�pertoires o� se trouvent les
polices Type 1, ainsi que des suppl�ments de code LaTeX �
utiliser. Vous verrez l'�cran d'avertissement de pslatex
suivi de la sortie relative au processus TeX lui-m�me. En un instant,
vous aurez un fichier .dvi
incluant des requ�tes pour des
polices Charter. Il vous est possible d'imprimer le fichier avec
dvips
, et gs
si n�cessaire.
L'installation d'une famille de polices Type 1 n'est pas difficile,
tant que vous suivez quelques �tapes �l�mentaires. Vous devriez
d�baller les polices dans une r�pertoire situ� sous
/usr/lib/teTeX/texmf/fonts/type1
, l� o� se trouvent les
autres polices de Type 1, et lancer texhash
pour faire savoir
aux routines de recherche dans les r�pertoires que de nouvelles
polices ont �t� ajout�es. Ensuite, vous devez ajouter les descriptions
des polices au fichier psfonts.map
pour informer
dvips
de leur existence. Le format du fichier
psfonts.map
est document� � plusieurs endroits dans les
r�f�rences mentionn�es ci-dessus. Encore une fois, n'oubliez pas de
lancer texhash
pour mettre � jour la base de r�pertoires de
teTeX.
L'utilisation d'un syst�me X Window-- XFree86 sous Linux -- avec teTeX constitue vraiment un avantage car il permet une pr�visualisation des documents de qualit� sup�rieure. Il n'est pas exig�, mais en r�gle g�n�rale, tout ce qui facilite la pr�visualisation � l'�cran apportera un plus � votre travail en termes de qualit� des sorties. Cela se paye n�anmoins en vitesse de frappe, bien plus rapide sur des �crans en mode texte.
Voici le texte du fichier CTAN.sites,
qui est disponible dans
le r�pertoire racine de toute archive et de tout miroir
CTAN
NdT. : en plus de la liste des sites miroir, ce texte recommande d'utiliser le site le plus proche de chez vous pour ne pas p�naliser le r�seau. Il �voque �galement la possibilit� d'obtenir une copie du site CTAN sur CD-ROM (cf. le fichier help/CTAN.cdrom).
In order to reduce network load, it is recommended that you use the Comprehensive TeX Archive Network (CTAN) host which is located in the closest network proximity to your site. Alternatively, you may wish to obtain a copy of the CTAN via CD-ROM (see help/CTAN.cdrom for details). Known mirrors of the CTAN reside on (alphabetically): cis.utovrm.it (Italia) /TeX ctan.unsw.edu.au (NSW, Australia) /tex-archive dongpo.math.ncu.edu.tw (Taiwan) /tex-archive ftp.belnet.be (Belgium) /packages/TeX ftp.ccu.edu.tw (Taiwan) /pub/tex ftp.cdrom.com (West coast, USA) /pub/tex/ctan ftp.comp.hkbu.edu.hk (Hong Kong) /pub/TeX/CTAN ftp.cs.rmit.edu.au (Australia) /tex-archive ftp.cs.ruu.nl (The Netherlands) /pub/tex-archive ftp.cstug.cz (The Czech Republic) /pub/tex/CTAN ftp.duke.edu (North Carolina, USA) /tex-archive ftp.funet.fi (Finland) /pub/TeX/CTAN ftp.gwdg.de (Deutschland) /pub/dante ftp.jussieu.fr (France) /pub4/TeX/CTAN ftp.kreonet.re.kr (Korea) /pub/CTAN ftp.loria.fr (France) /pub/unix/tex/ctan ftp.mpi-sb.mpg.de (Deutschland) /pub/tex/mirror/ftp.dante.de ftp.nada.kth.se (Sweden) /pub/tex/ctan-mirror ftp.oleane.net (France) /pub/mirrors/CTAN/ ftp.rediris.es (Espa\~na) /mirror/tex-archive ftp.rge.com (New York, USA) /pub/tex ftp.riken.go.jp (Japan) /pub/tex-archive ftp.tu-chemnitz.de (Deutschland) /pub/tex ftp.u-aizu.ac.jp (Japan) /pub/tex/CTAN ftp.uni-augsburg.de (Deutschland) /tex-archive ftp.uni-bielefeld.de (Deutschland) /pub/tex ftp.unina.it (Italia) /pub/TeX ftp.uni-stuttgart.de (Deutschland) /tex-archive (/pub/tex) ftp.univie.ac.at (\"Osterreich) /packages/tex ftp.ut.ee (Estonia) /tex-archive ftpserver.nus.sg (Singapore) /pub/zi/TeX src.doc.ic.ac.uk (England) /packages/tex/uk-tex sunsite.auc.dk (Denmark) /pub/tex/ctan sunsite.cnlab-switch.ch (Switzerland) /mirror/tex sunsite.icm.edu.pl (Poland) /pub/CTAN sunsite.unc.edu (North Carolina, USA) /pub/packages/TeX wuarchive.wustl.edu (Missouri, USA) /packages/TeX Known partial mirrors of the CTAN reside on (alphabetically): ftp.adfa.oz.au (Australia) /pub/tex/ctan ftp.fcu.edu.tw (Taiwan) /pub2/tex ftp.germany.eu.net (Deutschland) /pub/packages/TeX ftp.gust.org.pl (Poland) /pub/TeX ftp.jaist.ac.jp (Japan) /pub/TeX/tex-archive ftp.uu.net (Virginia, USA) /pub/text-processing/TeX nic.switch.ch (Switzerland) /mirror/tex sunsite.dsi.unimi.it (Italia) /pub/TeX sunsite.snu.ac.kr (Korea) /shortcut/CTAN Please send updates to this list to <ctan@urz.uni-heidelberg.de>. The participating hosts in the Comprehensive TeX Archive Network are: ftp.dante.de (Deutschland) -- anonymous ftp /tex-archive (/pub/tex /pub/archive) -- gopher on node gopher.dante.de -- e-mail via ftpmail@dante.de -- World Wide Web access on www.dante.de -- Administrator: <ftpmaint@dante.de> ftp.tex.ac.uk (England) -- anonymous ftp /tex-archive (/pub/tex /pub/archive) -- gopher on node gopher.tex.ac.uk -- NFS mountable from nfs.tex.ac.uk:/public/ctan/tex-archive -- World Wide Web access on www.tex.ac.uk -- Administrator: <ctan-uk@tex.ac.uk>
La distribution g�n�rique de teTeX n'est pas plus difficile � installer que les paquetages Linux. Cf. la section Distribution g�n�rique CTAN, ci-dessous.
Vous devriez envisager d'installer la distribution g�n�rique de teTeX � partir des archives CTAN si :
/usr
.Une installation compl�te de la distribution binaire n�cessite de 40 � 50 Mo d'espace disque, et la construction de la distribution � partir du code source requiert environ 75 Mo, il faut donc vous assurer de disposer de cet espace disque avant de commencer. Il n'est pas n�cessaire d'avoir install� le compilateur GCC ou le syst�me X Window (bien que X soit d'une aide pr�cieuse puisqu'il permet la pr�visualisation des documents � l'�cran). Tout ce qu'il vous faut est un �diteur capable de produire du texte en ASCII pur (cf. section 2). Peut-on faire plus simple ?
Vous pouvez t�l�charger les fichiers � partir de l'un des sites CTAN recens�s dans la section Annexe A. Dans les exemples ci-dessous, les fichiers sont originaires de l'archive CTAN situ�e � ftp.tex.ac.uk.
En premier lieu, faites un FTP sur
ftp.tex.ac.uk et un cd
vers le r�pertoire
ctan/tex-archive/systems/unix/teTeX/distrib/R�cup�rez les fichiers
INSTALL.bin install.shet placez-les dans le r�pertoire-racine de l'endroit ou vous voulez installer teTeX, par exemple
/var/teTeX
si vous souhaitez
installer teTeX dans le r�pertoire /var
.
Imprimez le fichier INSTALL.bin
. Gardez-le sous la main car
il d�crit comment installer une version minimale de
teTeX. L'installation minimale ne demande que 10 � 15 Mo mais, si
possible, il est recommand� d'installer l'ensemble du paquetage
teTeX. Pour une installation minimale, vous aurez besoin des fichiers
ctan/tex-archive/systems/unix/teTeX/distrib/base/latex-base.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/base/tetex-base.tar.gzVous aurez �galement besoin de l'une des deux archives contenant les programmes ex�cutables de teTeX. R�cup�rez le fichier
ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linux.tar.gzsi votre syst�me utilise les biblioth�ques partag�es au format Linux ELF,
ld.so
dans une version au moins �gale � 1.73, et clibs
dans une version au moins �gale � 5.09. Si ce n'est pas le cas,
r�cup�rez l'archive
ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linuxaout.tar.gzcompil� pour des syst�mes utilisant les biblioth�ques statiques au format a.out, plus anciennes.
Puis, suivant en cela les instructions du fichier
INSTALL.bin
, ex�cutez la commande
sh ./install.sh� partir du r�pertoire-racine de l'installation teTeX. (Assurez vous que les archives teTeX s'y trouvent �galement). Apr�s quelques instants, le programme d'installation vous avertira s'il manque certains paquetages teTeX. Si toutefois vous pr�voyez une installation minimale de teTeX, vous pouvez ignorer ces avertissements et passer � la suite. Pour configurer le syst�me teTeX �l�mentaire, reportez-vous � la section Configuration d'un syst�me �l�mentaire, ci-dessous.
Pour installer les paquetages restants, voyez la section suivante.
Pour effectuer une installation compl�te de teTeX, r�cup�rez les fichiers d'archives recens�s dans la section pr�c�dente, puis les fichiers suivants :
ctan/tex-archive/systems/unix/teTeX/distrib/doc/ams-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/bibtex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/eplain-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/fonts-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/general-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/generic-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/latex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/makeindex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/metapost-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/programs-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ams-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/dc-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ec-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/misc-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/postscript-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/sauter-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/amstex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/bibtex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/eplain.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/latex-extra.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/metapost.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pictex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pstricks.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/texdraw.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/xypic.tar.gzTous ces fichiers devraient �tre plac�s dans le r�pertoire-racine de l'arborescence o� teTeX doit r�sider. Comme pour l'installation minimale, ex�cutez la commande
sh ./install.sh
Le script install.sh
, apr�s avoir d�termin� l'ensemble des
archives teTeX disponibles, vous offrira un menu d'options. Le seul
param�tre que vous avez � d�finir � ce moment-l� est le
r�pertoire-racine de l'endroit o� vous voulez installer teTeX, en
s�lectionnant l'option « D ». Bien s�r, vous
devez s�lectionner un r�pertoire pour lequel vous avez les droits
d'�criture dans le r�pertoire p�re. Par exemple, si vous installez
teTeX dans votre home directory, vous sp�cifierez le r�pertoire
d'installation de teTeX comme
/home/john.q.public/teTeXet, apr�s �tre retourn� au menu principal, s�lectionnerez « I » pour poursuivre l'installation. Notez que ce r�pertoire ne doit pas exister : le script
install.sh
doit
pouvoir le cr�er.
Une option que vous pourriez envisager de modifier est la d�finition d'un r�pertoire pour la g�n�ration des polices. M�me si vous pr�voyez de n'utiliser que des polices vectorielles Postscript Type 1, il vous arrivera � l'occasion de travailler sur un fichier bas� sur des polices Computer Modern. L'activation de cette option vous demande d'entrer le nom du r�pertoire � utiliser. Vous devez disposer des droits d'�criture dans son r�pertoire-p�re. En se basant sur l'exemple pr�c�dent, vous pourriez sp�cifier
/home/john.q.public/texfontsou bien, si vous souhaitez rendre les polices g�n�r�es accessibles � tous les utilisateurs du syst�me, sp�cifiez un r�pertoire comme
/var/texfontsJe vous recommanderai cependant de ne pas utiliser le r�pertoire par d�faut pour cette option,
/var/tmp/texfonts
, car les
polices g�n�r�es pourraient �tre effac�es au prochain red�marrage, et
elles devraient �tre r�g�n�r�es lorsqu'elles seraient � nouveau n�cessaires.
Apr�s que vous aurez s�lectionn� l'option « I »
et que install.sh
aura install� les archives, positionn� les
droits d'acc�s divers et g�n�r� les liens et les fichiers de format,
le programme se terminera avec un message vous indiquant de rajouter
le r�pertoire des binaires teTeX � votre variable d'environnement
$PATH
, et les r�pertoires o� se trouvent les pages
man
et info
� vos variables d'environnement
$MANPATH
et $INFOPATH
. Par exemple,
ajoutez les directives
export PATH=$PATH:"/home/john.q.public/teTeX/bin" export MANPATH=$MANPATH":/home/john.q.public/teTeX/man" export INFOPATH$=INFOPATH":/home/john.q.public/teTeX/info"� votre
~/.bash_profile
si vous utilisez bash
comme interpr�teur de commandes, ou � votre ~/.profile
si vous en utilisez un autre pour vos connexions.
D�connectez-vous, puis reconnectez-vous pour que les variables d'environnement puissent �tre prises en compte. Puis, lancez la commande
texconfig confallpour vous assurer que l'installation est correcte.
Ensuite, vous pouvez configurer teTeX pour votre mat�riel sp�cifique : reportez-vous � la section D�tails de configuration apr�s l'installation, ci-dessous.
Pour installer teTeX V. 0.4 � partir du code source, faites un
ftp
sur un site CTAN comme
ftp://ftp.tex.ac.uk et r�cup�rez les fichiers
ctan/tex-archive/systems/unix/teTeX/distrib/INSTALL.src ctan/tex-archive/systems/unix/teTeX/distrib/sources/README.texmf-src ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-lib-0.4pl8.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-src-0.4pl7.tar.gz
Parcourez les instructions dans INSTALL.src
, puis faites
su
pour devenir root et d�ballez les fichiers dans un
r�pertoire pour lequel vous avez les droits de lecture-�criture-ex�cution.
Souvenez-vous d'utiliser l'argument p
pour faire le
tar
, et de d�sactiver l'option noclobber
du
bash
. Cela est possible gr�ce � la commande suivante, �
l'encontre du bon sens,
set +o noclobberRemarquez que l'argument
+o
de la commande set
d�sactive une variable, � l'inverse de ce que l'on pourrait croire.
Le fichier teTeX-lib-0.4pl8.tar.gz
va cr�er le r�pertoire
./teTeX
. Le fichier teTeX-src-0.4pl7.tar.gz
va cr�er
le r�pertoire teTeX-src-0.4
. Imprimez le fichier
INSTALL.src
et gardez-le � proximit� pour les �tapes
suivantes. Faites un cd
vers le r�pertoire
./teTeX-src-0.4
, et, comme indiqu� dans les instructions du
fichier INSTALL.src
, �ditez le fichier
./Makefile
. Vous devrez positionner la variable
TETEXDIR
avec le chemin absolu vers le r�pertoire p�re du
r�pertoire teTeX. Il s'agit donc du sous-r�pertoire teTeX
du
r�pertoire o� vous avez d�ball� les archives des sources et des
biblioth�ques. Par exemple, si vous avez d�ball� les archives dans
votre home directory, vous positionnerez TETEXDIR
�
/home/john.q.public/teTeXLes autres options du
Makefile
sont assez g�n�riques. Avec
GCC version 2.7.2 ou plus, vous ne devriez pas �tre oblig� de faire
plus d'ajustements � moins d'avoir une configuration non standard pour
le compilateur et les biblioth�ques, ou de souhaiter le que
compilateur fasse plus d'optimisations ou pour toute autre
raison. V�rifiez que les variables USE_DIALOG
,
USE_NCURSES
, et HAVE_NCURSES
sont correctement
positionn�es pour votre syst�me, car le programme dialog
a
besoin de la biblioth�que ncurses
pour �tre install�. Une
biblioth�que ncurses
est comprise dans la distribution source,
par cons�quent, les valeurs par d�faut du Makefile
devraient
fonctionner correctement. Si vous n'arrivez pas � compiler ou � faire
l'�dition de liens de ncurses
, le programme
texconfig
peut �galement �tre lanc� � partir de la ligne de
commande.
Si vous avez tout bon jusqu'ici, vous devriez pouvoir taper make
world
dans la racine de l'arborescence des sources et vous
d�tendre jusqu'� ce que les ex�cutables teTeX soient construits. Cela
peut prendre quelques heures.
Apr�s que la compilation a pris fin, positionnez les variables
d'environnement $PATH, $MANPATH
, et
$INFOPATH
pour y inclure les r�pertoires de teTeX. Les
directives � ajouter au fichier ~/.bash_profile
, dans
l'exemple ci-dessus, seraient
export PATH=$PATH":/home/john.q.public/teTeX/bin/i386-linux" export MANPATH=$MANPATH":/home/john.q.public/teTeX/man" export INFOPATH=$INFOPATH":/home/john.q.public/teTeX/info"La variable
$PATH
diff�re entre les distributions
source et binaire. Remarquez que le chemin vers les binaires est
teTeX/bin/i386-linux
au lieu de simplement teTeX/bin
comme dans la distribution binaire.
� ce stade, vous pouvez lancer texconfig confall
pour vous
assurer que les chemins ont �t� positionn�s correctement, et
poursuivre la configuration de teTeX comme pour la distribution
binaire. Cf. section
D�tails de configuration apr�s l'installation, ci-dessous.
La premi�re chose que vous voudrez faire est de regarder le fichier
README
de Thomas Esser. Il contient un tas d'indices sur la
mani�re de configurer teTeX pour votre p�riph�rique de sortie
(imprimante par exemple). Le fichier README
se trouve dans le
r�pertoire
/usr/lib/teTeX/texmf/doc/tetexParcourez le fichier � l'aide de la commande (le chemin dans les exemples qui suivent est celui de la distribution Slackware) :
less /usr/lib/teTeX/texmf/doc/tetex/READMEou imprimez-le avec la commande
cat /usr/lib/teTeX/texmf/doc/tetex/README >/dev/lp0en supposant que votre imprimante est connect�e �
/dev/lp0
. Remplacez-le par le fichier correspondant au pilote
auquel votre imprimante est attach�e le cas �ch�ant.
Ou, encore mieux, imprimez-le avec la commande lpr
:
lpr /usr/lib/teTeX/texmf/doc/tetex/READMEVous devriez avoir install� le d�mon d'impression qui est inclus dans votre distribution Linux. Si ce n'est pas le cas, faites-le maintenant, en suivant les instructions qui accompagnent ce paquetage.
Imprimez la teTeX-FAQ.
Gardez la FAQ sous la main car elle
contient des indications utiles pour la configuration des pilotes de
sortie pour teTeX adapt�e � votre imprimante. Nous y viendrons dans un
moment. Dans des versions plus r�centes de teTeX, la
teTeX-FAQ
peut �tre visualis�e � l'aide de l'utilitaire
texconfig
.
Ensuite, vous souhaiterez d�finir un r�pertoire o� stocker vos propres
fichiers de formats TeX. teTeX parcourt les r�pertoires figurant dans
la variable d'environnement $TEXINPUTS
pour des
fichiers d'entr�e pour TeX disponibles en local.
Ajoutez
export TEXINPUTS=".:~/texinputs:"au fichier syst�me
/etc/profile
. Chaque utilisateur peut
positionner son propre r�pertoire $TEXINPUTS
local, en
ajoutant la ligne dans son ~/.profile
ou
~/.bash_profile
si bash
est l'interpr�teur de
commandes par d�faut. La variable d'environnement
$TEXINPUTS
indique � teTeX de chercher les fichiers de
style TeX des utilisateurs dans les r�pertoires
~/texinputs
sous les home directory de chacun des
utilisateurs. Il est indispensable de mettre un deux-points avant
et apr�s ce r�pertoire. teTeX va ajouter ses propres r�pertoires de
recherche aux v�tres. Vous voudrez que teTeX recherche en premier lieu
les fichiers de format locaux, pour qu'il utilise les versions locales
des fichiers standardis�s que vous avez �dit�s.
Ajoutez le r�pertoire /usr/lib/teTeX/bin
aux chemins d�finis
pour le syst�me si vous installez teTeX en tant que root. Encore une
fois, si vous installez un exemplaire personnel de teTeX, ajoutez le
r�pertoire o� se situent les binaires teTeX en t�te de votre
$PATH
en ins�rant la ligne suivante dans votre
~/.profile
ou votre ~/.bash_profile
:
export PATH="~/tetex/bin:"$PATH� pr�sent, connectez-vous sous
root
et lancez
texconfig
comme il est dit dans la teTeX-FAQ
et
choisissez l'imprimante attach�e � votre syst�me. Assurez-vous de
configurer teTeX aussi bien pour la bonne imprimante que pour la bonne
r�solution d'impression.
Enfin, lancez le programme texhash
. Cela garantit que la base
de donn�es interne de teTeX est bien � jour. Cette base de donn�es
n'est autre que le fichier ls-lR
. Vous devez lancer
texhash
� chaque fois que vous modifiez la configuration du
syst�me, sans quoi teTeX sera incapable de prendre en compte vos
changements.
teTeX est un logiciel libre ce qui signifie que tout un chacun est libre de l'utiliser et de le redistribuer sous certaines conditions. Le paquetage n'est pas dans le domaine public. Il est soumis � copyright et il existe des restrictions concernant sa distribution, mais ces restrictions sont con�ues pour permettre tout ce qu'un bon citoyen coop�ratif aurait envie de faire. Ce qui n'est pas autoris�, c'est d'essayer d'emp�cher les autres de partager plus en avant toute version d'un logiciel libre qu'ils pourraient recevoir de vous. Les conditions pr�cises figurent dans la GNU General Public License qui accompagne de nombreux paquetages logiciels et appara�t �galement dans la section suivante.
Un moyen d'obtenir un exemplaire du paquetage est de le r�cup�rer aupr�s de quelqu'un qui le poss�de. Vous n'avez pas besoin de nous demander la permission pour ce faire, ni d'en informer qui que ce soit ; vous pouvez le copier tout simplement. Si vous disposez d'un acc�s � l'Internet, vous pouvez rapatrier la distribution la plus r�cente par FTP. Lisez le chapitre Sources pour plus d'information.
Vous pouvez �galement recevoir le logiciel lors de l'achat d'un ordinateur. Les fabricants d'ordinateurs sont libres de distribuer des exemplaires aux m�mes conditions que n'importe qui d'autre. Ces conditions exigent d'eux qu'ils vous donnent les sources complets, y compris toutes les modifications qu'ils peuvent y avoir faites, et qu'ils vous permettent de redistribuer les paquetages obtenus aupr�s d'eux sous les conditions habituelles de la GNU General Public License. En d'autres termes, le programme doit �tre gratuit pour vous lorsque vous en prenez possession, et pas seulement gratuit pour le fabricant.
Vous pouvez �galement commander des exemplaires des logiciels GNU sur CD-ROM � la Free Software Foundation. C'est un moyen pratique et s�r de se procurer une copie ; c'est �galement une bonne m�thode pour soutenir nos travaux. (La plupart des fonds de la fondation ont toujours �t� fournis par ce biais.) Un bon de commande est inclus dans de nombreuses distributions, et sur notre site Web � http://www.gnu.ai.mit.edu/order/order.html. Pour plus d'information, �crivez � l'adresse
Free Software Foundation 59 Temple Place, Suite 330 Boston, MA 02111-1307 USA USA
Les revenus g�n�r�s par la commercialisation des distributions vont au soutien des buts que s'est assign�s la fondation : le d�veloppement de nouveaux logiciels libres, et l'am�lioration des programmes existants.
Si vous utilisez des logiciels GNU � votre lieu de travail, vous pourriez sugg�rer � votre entreprise de faire un don. Si votre entreprise n'est pas favorable aux dons aux oeuvres de charit�, vous pourriez alors sugg�rer de commander � l'occasion un CD-ROM � la fondation, ou de s'abonner aux mises � jour p�riodiques.
Version 2, juin 1991
NdT. : la version fran�aise reproduite ici est le fruit du travail de l'association APRIL http://www.april.org.
Copyright (C) 1989, 1991, Free Software Foundation Inc. 675 Mass Ave, Cambridge, MA02139, Etats-Unis.
Il est permis � tout le monde de reproduire et distribuer des copies conformes de ce document de licence, mais aucune modification ne doit y �tre apport�e.
Pr�ambule
Les licences relatives � la plupart des logiciels sont destin�es � supprimer votre libert� de les partager et de les modifier. Par contraste, la licence publique g�n�rale GNU General Public License veut garantir votre libert� de partager et de modifier les logiciels libres, pour qu'ils soient vraiment libres pour tous leurs utilisateurs. La pr�sente licence publique g�n�rale s'applique � la plupart des logiciels de la Free Software Foundation, ainsi qu'� tout autre programme dont les auteurs s'engagent � l'utiliser. (Certains autres logiciels sont couverts par la Licence Publique G�n�rale pour Biblioth�ques GNU � la place). Vous pouvez aussi l'appliquer � vos programmes.
Quand nous parlons de logiciels libres, nous parlons de libert�, non de gratuit�. Nos licences publiques g�n�rales veulent vous garantir :
* que vous avez toute libert� de distribuer des copies des logiciels libres (et de facturer ce service, si vous le souhaitez) ;
* que vous recevez les codes sources ou pouvez les obtenir si vous le souhaitez ;
* que vous pouvez modifier les logiciels ou en utiliser des �l�ments dans de nouveaux programmes libres ;
* et que vous savez que vous pouvez le faire.
Pour prot�ger vos droits, nous devons apporter des restrictions, qui vont interdire � qui que ce soit de vous d�nier ces droits, ou de vous demander d'y renoncer. Ces restrictions se traduisent par certaines responsabilit�s pour ce qui vous concerne, si vous distribuez des copies de logiciels, ou si vous les modifiez.
Par exemple, si vous distribuez des copies d'un tel programme, gratuitement ou contre une r�mun�ration, vous devez transf�rer aux destinataires tous les droits dont vous disposez. Vous devez vous garantir qu'eux-m�mes, par ailleurs, re�oivent ou peuvent recevoir le code source. Et vous devez leur montrer les pr�sentes dispositions, de fa�on qu'ils connaissent leurs droits.
Nous prot�geons vos droits en deux �tapes :
1. Nous assurons le droit d'auteur (copyright) du logiciel, et
2. Nous vous proposons cette licence, qui vous donne l'autorisation l�gale de dupliquer, distribuer et/ou modifier le logiciel.
De m�me, pour la protection de chacun des auteurs, et pour notre propre protection, nous souhaitons nous assurer que tout le monde comprenne qu'il n'y a aucune garantie portant sur ce logiciel libre. Si le logiciel est modifi� par quelqu'un d'autre puis transmis � des tiers, nous souhaitons que les destinataires sachent que ce qu'ils poss�dent n'est pas l'original, de fa�on que tous probl�mes introduits par d'autres ne se traduisent pas par une r�percussion n�gative sur la r�putation de l'auteur original.
Enfin, tout programme libre est en permanence menac� par des brevets de logiciels. Nous souhaitons �viter le danger que des sous-distributeurs d'un programme libre obtiennent � titre individuel des licences de brevets, avec comme cons�quence qu'ils aient un droit de propri�t� sur le programme. Pour �viter cette situation, nous avons fait tout ce qui est n�cessaire pour que tous brevets doivent faire l'objet d'une concession de licence qui en permette l'utilisation libre par chacun, ou bien qu'il ne soit pas conc�d� du tout.
Nous pr�sentons ci-dessous les clauses et dispositions concernant la duplication, la distribution et la modification.
Conditions d'exploitation portant sur la duplication, la distribution et la modification
FIN DES CONDITIONS D'EXPLOITATION
Si le concessionnaire d�veloppe un nouveau programme, et s'il en souhaite l'utilisation la plus large possible dans le public, le meilleur moyen d'y arriver est d'en faire un logiciel libre, que tout le monde pourra redistribuer et modifier au titre des pr�sentes dispositions.
Dans ce but, il convient de rattacher au programme les avis suivants. Le moyen le plus s�r consiste � les rattacher au d�but de chaque fichier source, pour avertir le plus efficacement possible de l'exclusion de garantie ; et chaque fichier doit comporter au moins la ligne « copyright », et un pointeur indiquant o� est localis�e la totalit� de l'avis.
Une ligne pour donner le nom du programme et une id�e de ce qu'il fait. Copyright (C) 19yy nom de l'auteur Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier conform�ment aux dispositions de la Licence Publique G�n�rale GNU, telle que publi�e par la Free Software Foundation ; version 2 de la licence, ou encore (� votre choix) toute version ult�rieure. Ce programme est distribu� dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE ; sans m�me la garantie implicite de COMMERCIALISATION ou D'ADAPTATION A UN OBJET PARTICULIER. Pour plus de d�tail, voir la Licence Publique G�n�rale GNU . Vous devez avoir re�u un exemplaire de la Licence Publique G�n�rale GNU en m�me temps que ce programme ; si ce n'est pas le cas, �crivez � la Free Software Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, Etats-Unis.
Ajoutez aussi des informations sur le moyen permettant d'entrer en contact avec vous par courrier �lectronique (e-mail) et courrier normal.
Si le programme est interactif, pr�voyez en sortie un court avis, tel que celui qui est pr�sent� ci-dessous, lors du d�marrage en mode interactif.
Gnomovision est livr� absolument SANS AUCUNE GARANTIE ; pour plus de d�tails, tapez "show w". Il s'agit d'un logiciel libre, et vous avez le droit de le redistribuer dans certaines conditions ; pour plus de d�tail, tapez "show c".
Les instructions hypoth�tiques show w
et show c
doivent
pr�senter les parties appropri�es de la Licence Publique
G�n�rale. Bien �videmment, les instructions que vous utilisez peuvent
porter d'autres noms que show w
et show c
; elles peuvent m�me
correspondre � des clics de souris ou � des �l�ments d'un menu, selon
ce qui convient � votre programme.
Si n�cessaire, vous devrez aussi demander � votre employeur (si vous travaillez en tant que programmeur) ou � votre �ventuelle �cole ou universit�, de signer une « renonciation � droit d'auteur » concernant le programme. En voici un �chantillon (il suffit de modifier les noms) :
Yoyodyne, Inc., par la pr�sente, renonce � tout int�r�t de droits d'auteur dans le programme "Gnomovision" (qui fait des passages au niveau des compilateurs) �crit par James Hacker. Signature de Ty Coon, 1er avril 1989 Ty Coon, President of Vice
La pr�sente Licence Publique G�n�rale n'autorise pas le concessionnaire � incorporer son programme dans des programmes propri�taires. Si votre programme est une biblioth�que de sous-programmes, vous pouvez consid�rer comme plus int�ressant d'autoriser une �dition de liens des applications propri�taires avec la biblioth�que. Si c'est ce que vous souhaitez, vous devrez utiliser non pas la pr�sente licence, mais la Licence Publique G�n�rale pour Biblioth�ques GNU.