doc/latex

git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 259 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/lettrine/demo.tex b/Master/texmf-dist/doc/latex/lettrine/demo.tex
new file mode 100644
index 00000000000..f5ebfbafe06
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/lettrine/demo.tex
@@ -0,0 +1,259 @@
+%Format: pdfLaTeX
+
+\documentclass[12pt,a4paper]{article}
+
+\usepackage{lettrine}
+
+%%% Palatino fonts...
+\usepackage[T1]{fontenc}
+\usepackage{palatino}
+%%% ... or EC fonts ... 
+%\usepackage[T1]{fontenc}
+%\usepackage{type1ec}
+%%% ... or LM fonts
+%\usepackage[T1]{fontenc}
+%\usepackage{lmodern}
+%%% ... or CM fonts
+%\usepackage{type1cm}
+
+\usepackage[english,frenchb]{babel}
+
+\usepackage{graphicx,color}
+
+\newcommand{\MF}{{\small\sffamily\scshape metafont}}
+\newcommand{\MP}{{\small\sffamily\scshape metapost}}
+
+\setlength{\textheight}{680pt}
+\setlength{\textwidth}{412pt}
+\setlength{\oddsidemargin}{20pt}
+\setlength{\topmargin}{-35pt}
+
+\setlength{\parindent}{0pt}
+%\addtolength{\parskip}{0.5\baseineskip}
+\sloppy
+
+\begin{document}
+\thispagestyle{empty}
+
+\begin{center}
+\large\bfseries Quelques exemples de lettrines  
+\end{center}
+
+\vspace{\baselineskip}
+\textit{Usage standard (2 lignes) :}\\
+\verb+\lettrine{E}{n} plein marais...+
+
+\lettrine{E}{n} plein marais de la Souteyranne, \`a quelques kilom\`etres
+au nord d'Aigues-Mortes, se trouve la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+
+\vspace{\baselineskip}
+\textit{Lettrine sur une seule ligne (option {\ttfamily\upshape lines=1}) :}\\
+\verb+\lettrine[lines=1]{E}{n} plein marais...+
+
+\lettrine[lines=1]{E}{n} plein marais de la Souteyranne,
+\`a quelques kilom\`etres au nord d'Aigues-Mortes, se trouve 
+la Tour Carbonni\`ere.
+
+\vspace{\baselineskip}
+\textit{Lettrine sur trois lignes (option {\ttfamily\upshape lines=3}) :}\\
+\verb+\lettrine[lines=3]{E}{n} plein marais...+
+
+\lettrine[lines=3]{E}{n} plein marais de la Souteyranne, 
+\`a quelques kilom\`etres au nord d'Aigues-Mortes, 
+se trouve la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+
+\vspace{\baselineskip}
+\textit{Lettrine compl\`etement dans la marge} :\\
+\verb+\lettrine[lhang=1, nindent=0pt, lines=3]{J}{ustement},...+
+
+\lettrine[lhang=1, nindent=0pt, lines=3]{J}{ustement}, 
+\`a quelques kilom\`etres au nord d'Aigues-Mortes, 
+se trouve la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+L'abbaye \'etait ravitaill\'ee ---~dit-on ~--- par un souterrain
+qui la reliait au ch\^ateau de Treillan.
+
+\vspace{\baselineskip}
+\textit{Lettrine en saillie \`a la fois en hauteur et dans la marge} :\\
+\verb+\lettrine[lines=3, lhang=0.33, loversize=0.25]{E}{n} ...+
+
+\lettrine[lines=3, lhang=0.33, loversize=0.25]{E}{n} 
+plein marais de la Souteyranne,
+\`a quelques kilom\`etres au nord d'Aigues-Mortes la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} \dots
+% dont il ne reste que des vestiges.
+
+\vspace{\baselineskip}
+\textit{On peut ajouter un guillemet devant la lettrine} :\\
+\verb+\lettrine[ante=\og]{E}{n} plein marais ...+
+
+\lettrine[ante=\og]{E}{n} plein marais de la Souteyranne,
+\`a quelques kilom\`etres au nord d'Aigues-Mortes, se trouve 
+la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} \dots
+% dont il ne reste que des vestiges.
+
+\newpage
+Toutes Les lettrines suivantes  seront en gris jusqu'à nouvel ordre : \\
+\verb+\renewcommand{\LettrineFontHook}{\color[gray]{0.5}}+
+\renewcommand{\LettrineFontHook}{\color[gray]{0.5}}
+
+\vspace{.5\baselineskip}
+\textit{On diminue la taille de la lettrine de 10\% et on 
+la remonte de 10\%  \`a cause du \og Q {\fg}}
+\verb+\lettrine[lines=4, loversize=-0.1, lraise=0.1]{Q}{u'en...+
+
+\lettrine[lines=4, loversize=-0.1, lraise=0.1]{Q}{u'en plein marais}
+ de la Souteyranne, \`a quelques kilom\`etres au nord d'Aigues-Mortes, 
+se trouve la Tour Carbonni\`ere, surprend les visiteurs.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+L'abbaye \'etait ravitaill\'ee par un souterrain qui
+la reliait au ch\^ateau de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{La m\^eme chose sans ajustement :}\\
+\verb+\lettrine[lines=4]{Q}{u'en plein marais} de ...+
+
+\lettrine[lines=4]{Q}{u'en plein marais} de la Souteyranne,
+\`a quelques kilom\`etres au nord d'Aigues-Mortes, 
+se trouve la Tour Carbonni\`ere, surprend les visiteurs.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+L'abbaye \'etait ravitaill\'ee par un souterrain qui
+la reliait au ch\^ateau de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{Utilisation de l'option {\ttfamily\upshape slope}} pour que le texte
+suive la pente du \og \`A \fg :\\
+\verb+\lettrine[lines=4, slope=0.6em, findent=-1em,+\\
+\verb+          nindent=0.6em]{\`A}{quelques kilom\`etres}...+
+
+\lettrine[lines=4, slope=0.6em, findent=-1em, nindent=0.6em]{\`A} {quelques 
+kilom\`etres} au nord d'Aigues-Mortes, se trouve  la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+L'abbaye \'etait ravitaill\'ee ---~dit-on~--- par un souterrain qui
+la reliait au ch\^ateau de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{Utilisation de l'option {\ttfamily\upshape slope} pour que le texte
+ suive la pente du {\ttfamily\upshape V}, noter que celui-ci est \`a
+ demi-pouss\'e dans la marge par l'option {\ttfamily\upshape lhang=0.5} :}\\
+\verb+\lettrine[lines=4, slope=-0.5em, lhang=0.5, nindent=0pt]+\\
+\verb+  {V}{oici} \`a...+
+
+\lettrine[lines=4, slope=-0.5em, lhang=0.5, nindent=0pt]{V}{oici}
+\`a quelques kilom\`etres au nord d'Aigues-Mortes la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee, celle qui menait \`a Psalmody,
+l'une des \og abbayes de sel\fg{} dont il ne reste que quelques vestiges.
+L'abbaye \'etait ravitaill\'ee ---~dit-on~--- par un souterrain qui
+la reliait au ch\^ateau de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{Changement de police (ici AvantGarde gras italique) 
+  et de couleur pour la lettrine :}\\
+\verb+\renewcommand{\LettrineFontHook}{\fontfamily{pag}%+\\
+\verb+                \fontseries{bx}\fontshape{it}\color{red}}+\\
+\verb+\lettrine[findent=.3em]{E}{n} plein marais...+
+
+{% Groupe (changement local de fonte)
+\renewcommand{\LettrineFontHook}{%
+  \fontfamily{pag}\fontseries{bx}\fontshape{it}\color{red}}
+
+\lettrine[findent=.3em]{E}{n} plein marais de la Souteyranne, \`a quelques
+kilom\`etres au nord d'Aigues-Mortes, se trouve la Tour Carbonni\`ere.
+Construite au XIII\ieme~si\`ecle, elle contr\^olait l'unique voie d'acc\`es
+terrestre de la ville fortifi\'ee.
+\par}% Il est indispensable de terminer le paragraphe avant la fin du groupe.
+
+\newpage
+\begin{center}
+\large\bfseries Utilisation d'une image comme lettrine
+\end{center}
+
+\vspace{\baselineskip}
+Si la lettrine souhait\'ee n'est pas un caract\`ere d'une fonte mais une
+image, \verb+\lettrine+ peut encore \^etre utilis\'ee, il suffit
+d'utiliser le bool\'een \texttt{image}, exemple :
+
+{% Groupe pour garder les d\'efinitions LOCALES
+\fontfamily{yfrak}\selectfont\Large
+\renewcommand{\LettrineTextFont}{\relax}
+\renewcommand{\LettrineFontHook}{\color{red}}
+\lettrine[image=true,lhang=.2, loversize=.25, findent=0.1em]
+{W}{er} reitet so sp\"at durch Nacht und Wind?\\
+Es ist der Vater mit seinem Kind;\\
+Er hat den Knaben wohl in dem Arm,\\
+Er fa{\ss}t ihn sicher, er h\"alt ihn warm.
+\par}% Il est indispensable de terminer le paragraphe avant la fin du groupe.
+
+\vspace{\baselineskip}
+Et voici le code \LaTeX{} correspondant ;
+le  premier argument de \verb+\lettrine+ \'etant \verb+W+,
+\verb+\lettrine+ fait appel au fichier \verb+W.eps+ en \LaTeX{}
+ou \`a \verb+W.pdf+, \verb+W.jpg+, etc. en pdf\LaTeX{} (omission 
+possible du suffixe \verb+.eps+,  \verb+.pdf+, propri\'et\'e de 
+\verb+graphicx.sty+) ;
+
+\begin{verbatim}
+\fontfamily{yfrak}\selectfont\Large
+\renewcommand{\LettrineTextFont}{\relax}
+\renewcommand{\LettrineFontHook}{\color{red}}
+\lettrine[image=true,lhang=.2, loversize=.25, findent=0.1em]
+{W}{er} reitet so sp\"at durch Nacht und Wind?\\
+Es ist der Vater mit seinem Kind;\\
+Er hat den Knaben wohl in dem Arm,\\
+Er fa{\ss}t ihn sicher, er h\"alt ihn warm.
+\end{verbatim}
+
+Cet exemple fait appel aux fichiers suivants :
+\begin{itemize}
+\item \verb+graphicx.sty+ et \verb+color.sty+ (extensions standard \LaTeXe{}),
+\item \verb+blackletter1+ de Thorsten~\textsc{Bronger} (disponible sur CTAN),
+\item les fontes gothiques \og Fraktur \fg{} de Yannis~\textsc{Haralambous}
+  (sources \MF{}~\verb+yfrak*.mf+ ou type\,1 \verb+yfrak.pfb+ \'egalement
+  disponibles sur CTAN).
+\end{itemize}
+L'initiale gothique \og W \fg{} utilis\'ee dans
+cet exemple a \'et\'e cr\'e\'ee par \MP{} (fichier \verb+W.eps+ ci-joint) 
+\`a partir du source \MF{} \verb+yinitW.mf+ de Yannis gr\^ace aux pr\'ecieuses
+indications de Denis~\textsc{Roegel} que je remercie bien vivement.
+
+Si une sortie au format PDF est souhait\'ee, il suffit de convertir
+le fichier \verb+W.eps+ en \verb+W.pdf+ (en utilisant \verb+epstopdf+) et
+de compiler le fichier avec pdf\LaTeX.
+
+En fait, \verb+\lettrine+, utilis\'ee avec pdf\LaTeX, permet d'inclure
+des images au formats \texttt{pdf}, \texttt{png}, \texttt{jpeg} ou \MP{} en
+guise de lettrines.
+
+\vfill
+\begin{flushright}
+  Daniel \textsc{Flipo}\\
+  \texttt{Daniel.Flipo@univ-lille1.fr}\\
+  22 mai 2004.
+\end{flushright}
+
+\end{document}
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: t
+%%% End: