summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/lettrine/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/lettrine/doc
Initial commit
Diffstat (limited to 'macros/latex/contrib/lettrine/doc')
-rw-r--r--macros/latex/contrib/lettrine/doc/demo-de.pdfbin0 -> 136266 bytes
-rw-r--r--macros/latex/contrib/lettrine/doc/demo-de.tex239
-rw-r--r--macros/latex/contrib/lettrine/doc/demo.pdfbin0 -> 144777 bytes
-rw-r--r--macros/latex/contrib/lettrine/doc/demo.tex306
-rw-r--r--macros/latex/contrib/lettrine/doc/lettrine.pdfbin0 -> 123998 bytes
5 files changed, 545 insertions, 0 deletions
diff --git a/macros/latex/contrib/lettrine/doc/demo-de.pdf b/macros/latex/contrib/lettrine/doc/demo-de.pdf
new file mode 100644
index 0000000000..069a6e8640
--- /dev/null
+++ b/macros/latex/contrib/lettrine/doc/demo-de.pdf
Binary files differ
diff --git a/macros/latex/contrib/lettrine/doc/demo-de.tex b/macros/latex/contrib/lettrine/doc/demo-de.tex
new file mode 100644
index 0000000000..a5fabafa06
--- /dev/null
+++ b/macros/latex/contrib/lettrine/doc/demo-de.tex
@@ -0,0 +1,239 @@
+%Format: pdfLaTeX
+
+\documentclass[12pt,a4paper]{article}
+
+\usepackage[a4paper,text={150mm,240mm},centering]{geometry}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage{palatino} % Palatino und
+\renewcommand{\ttdefault}{lmtt} % Latin Modern Typewriter fonts
+\usepackage{microtype}
+
+\usepackage{lettrine}
+\usepackage{graphicx,color}
+\usepackage{lettrine}
+
+\usepackage{german}
+
+\newcommand{\MF}{{\small\sffamily\scshape metafont}}
+\newcommand{\MP}{{\small\sffamily\scshape metapost}}
+\setlength{\parindent}{0pt}
+\sloppy
+\begin{document}
+\thispagestyle{empty}
+
+\begin{center}
+\large\bfseries Einige Beispiele zur Anwendung des lettrine-Pakets
+\end{center}
+
+\vspace{\baselineskip}
+\textit{Einfachste Verwendung (2 Zeilen) :}\\
+\verb+\lettrine{E}{in} erstes Beispiel...+
+
+\lettrine{E}{in} erstes Beispiel zeigt das Standardverhalten von lettrine.
+Es wird eine Initiale über zwei Zeilen produziert, gefolgt vom Text zwischen
+den geschweiften Klammern, der als Kapitälchen gesetzt wird. Der weitere
+Text umfliesst die Initiale.
+
+\vspace{\baselineskip}
+\textit{Lettrine auf einer Zeile (option {\ttfamily\upshape lines=1}) :}\\
+\verb+\lettrine[lines=1]{E}{in} zweites Beispiel...+
+
+\lettrine[lines=1]{E}{in} zweites Beispiel zeigt, wie eine Initiale auf
+einer einzelnen Zeile aussieht. Auch hier ist der geklammerte Text in
+Kapitälchen gesetzt.
+
+\vspace{\baselineskip}
+\textit{Initiale über drei Zeilen (option {\ttfamily\upshape lines=3}) :}\\
+\verb+\lettrine[lines=3]{E}{in} drittes Beispiel...+
+
+\lettrine[lines=3]{E}{in} drittes Beispiel in dem die Initiale über drei
+Zeilen gesetzt wird. Beachten Sie die Einrückung der zweiten und dritten
+Zeile. Diese kann mit dem Parameter \verb+nindent= + beeinflusst werden. Die
+Einrückung der ersten Zeile wird hingegen mit dem Parameter \verb+findent= +
+beeinflusst.
+
+\vspace{\baselineskip}
+\textit{Initiale vollständig im Randbereich} :\\
+\verb+\lettrine[lhang=1, nindent=0pt, lines=3]{V}{erschieben}+
+
+\lettrine[lhang=1, nindent=0pt, lines=3]{V}{erschieben} wir nun im vierten
+Beispiel die Initiale in den Randbereich. Dieses Verhalten wird durch den
+Parameter \verb+lhang= + gesteuert.
+
+\vspace{\baselineskip}
+\textit{Initiale, vergrössert und teilweise im Randbereich} :\\
+\verb+\lettrine[lines=3, lhang=0.33, loversize=0.25]{A}{uch}+
+
+\lettrine[lines=3, lhang=0.33, loversize=0.25]{A}{uch}
+die Vergrösserung der Initiale ist möglich. Die Vergrösserung läuft
+über die Variable \verb+loversize= + . Sie müssen das Ergebnis nicht
+unbedingt schön finden. Es sieht nach meiner Meinung besser aus, wie das
+vollständige Verschieben in den Randbereich.
+
+\vspace{\baselineskip}
+\textit{Setzen wir nun eine %französisches
+ Anführungszeichen davor} :\\
+\verb+\lettrine[ante=\frqq]{M}{it} dem Parameter ...+
+
+\lettrine[ante=\frqq]{M}{it} dem Parameter \verb+ante= + kann auch ein
+beliebiger Text vor die Initiale gesetzt werden. In der Praxis dürften
+wohl nur Anführungszeichen dafür in Frage kommen.
+
+\vspace{\baselineskip}
+\verb+\def\lglqq{\raisebox{-\baselineskip}{\glqq}}+\\
+\verb+\lettrine[ante=\lglqq]{M}{it} dem Parameter ...+
+\def\lglqq{\raisebox{-\baselineskip}{\glqq}}
+
+\lettrine[ante=\lglqq]{M}{it} dem Parameter \verb+ante= + kann auch ein
+beliebiger Text vor die Initiale gesetzt werden. In der Praxis dürften
+wohl nur Anführungszeichen dafür in Frage kommen.
+
+\newpage
+\textit{Wir verkleinern die Initiale nun um 10\% und heben sie
+um 10\% wegen des {\glqq}Q{\grqq}}
+\verb+\lettrine[lines=4, loversize=-.1, lraise=.1]{Q}{ualität}+
+
+\lettrine[lines=4, loversize=-.1, lraise=.1]{Q}{ualität} hat ihren
+Preis. Und wenn es nur die Zeit ist, um zu lernen wie Sie solche Spielereien
+anstellen können. Bei den Ergebnissen lohnt sich aber die Mühe. Welche
+Parameter diesmal was beeinflussen, lasse ich Sie nun selbst herausfinden.
+Wie Sie sehen, ragt der Unterstrich des {\glqq}Q{\grqq} nicht in den Text
+hinein.
+
+\vspace{.5\baselineskip}
+\textit{Andere Möglichkeit: Nochmal das {\glqq}Q{\grqq} in normaler
+ Größe aber mit einer Zeile mehr darunter}
+\verb+\lettrine[lines=4,depth=1]{Q}{ualität}+
+
+\lettrine[lines=4,depth=1]{Q}{ualität} hat ihren Preis. Und wenn es nur die
+Zeit ist, um zu lernen wie Sie solche Spielereien anstellen können. Bei den
+Ergebnissen lohnt sich aber die Mühe. Welche Parameter diesmal was
+beeinflussen, lasse ich Sie nun selbst herausfinden. Wie Sie sehen, ragt der
+Unterstrich des {\glqq}Q{\grqq} auch nicht in den Text hinein: eine Zeile mehr
+wurde darunter mit \verb+depth=1+ frei gemacht.
+
+\vspace{.5\baselineskip}
+\textit{Verwendung der Option {\ttfamily\upshape slope}}, damit der Text
+der Neigung des {\glqq}A{\grqq} folgt:\\
+\verb+\lettrine[lines=4, slope=0.6em, findent=-1em,+\\
+\verb+ nindent=0.6em]{\A}{uch}...+
+
+\lettrine[lines=4, slope=0.6em, findent=-1em, nindent=0.6em]{A}{uch} eine
+Neigung kann angegeben werden. Damit werden die Löcher neben geneigten
+Buchstaben nicht so gross. Selbst eine negative Neigung ist möglich, damit
+bietet auch das {\glqq}V{\grqq} keine Schwierigkeiten mehr. Wie das beim
+{\glqq}V{\grqq} aussieht, sehen wir uns beim nächsten Beispiel an.
+
+\vspace{.5\baselineskip}
+\textit{Verwendung der Option {\ttfamily\upshape slope}, damit der Text
+der Neigung des {\ttfamily\upshape V} folgt; Das {\ttfamily\upshape V} ragt
+zusätzlich halb in den Rand hinein
+(Option {\ttfamily\upshape lhang=0.5} :})\\
+\verb+\lettrine[lines=4, slope=-0.5em, lhang=0.5, nindent=0pt]+\\
+\verb+ {V}{iel} ist...+
+
+\lettrine[lines=4, slope=-0.5em, lhang=0.5, nindent=0pt]{V}{iel} ist hier
+nicht anders. Nur die negative Neigung und das Hereinragen in den Rand. Ob
+Ihnen das Ergebnis gefällt müssen Sie selber entscheiden. Sie sehen aber,
+das das {\glqq}V{\grqq} wirklich keine Schwierigkeiten bietet. Der Unterschied
+zum vorhergehenden Beispiel ist nicht besonders gross.
+
+\vspace{.5\baselineskip}
+\textit{Ändern wir nun die Schriftfamilie für die Initiale
+(hier AvantGarde bold italique):}\\
+\verb+\renewcommand{\LettrineFontHook}{\fontfamily{pag}%+\\
+\verb+ \fontseries{bx}\fontshape{it}}+\\
+\verb+\lettrine[findent=.3em]{A}{uch} ein Wechsel...+
+
+{% (Ändern des lokalen fonts)
+\renewcommand{\LettrineFontHook}{\fontfamily{pag}\fontseries{bx}\fontshape{it}}
+
+\lettrine[findent=.3em]{A}{uch} ein Wechsel der Schriftfamilie ist problemlos
+möglich. Hier verwenden wir Avantgarde und setzen mit der Option
+\verb+findent= + den horizontalen Abstand des eingerückten Texts.
+\par}
+
+\vspace{.5\baselineskip}
+\textit{Ändern wir nun die Schriftfamilie und die Farbe für die Initiale
+(hier yfrak in Grau) :}\\
+\verb+\renewcommand{\LettrineFontHook}{\fontfamily{yfrak}\color[gray]{0.5}}+\\
+\verb+\lettrine[loversize=0.1]{A}{uch}...+
+
+{% (Aendern des lokalen fonts)
+\renewcommand{\LettrineFontHook}{\fontfamily{yfrak}\color[gray]{0.5}}
+
+\lettrine[loversize=0.1]{A}{uch} ein Wechsel der
+Schriftfamilie ist problemlos möglich. Hier verwenden wir yfrak,
+etwas vergrössert mit der Option \verb+loversize= +, und wir schreiben
+die Initiale in Grau mit \verb+\color[gray]{0.5}+.
+\par}
+
+\newpage
+\begin{center}
+\large\bfseries Verwendung eines PostScript-Bildes als Initiale
+\end{center}
+
+\vspace{\baselineskip} Wenn die erwünschte Initiale nicht als Zeichen eines
+Fonts, sondern als Bild im Postscript-Format vorliegt, kann ebenfalls
+\verb+\lettrine+ verwendet werden. Es genügt,
+die Boolsche Variable \texttt{image=true} zu benützen; z.B. so:
+
+\vspace{.5\baselineskip}
+{% Gruppierung, um die LOKALEN Definitionen zu schützen
+\fontfamily{yfrak}\selectfont\Large
+\renewcommand{\LettrineTextFont}{\relax}
+\lettrine[image=true, lines=3, lhang=.2, loversize=.25, %
+ lraise=-.05, findent=0.1em, nindent=0em]
+{W}{er} reitet so spät durch Nacht und Wind?\\
+Es ist der Vater mit seinem Kind;\\
+Er hat den Knaben wohl in dem Arm,\\
+Er faßt ihn sicher, er hält ihn warm.
+\par}
+
+\vspace{\baselineskip} Und hier der zum Beispiel gehörende \LaTeX{}--Code:
+Das erste Argument von \verb+\lettrine+ war \verb+W+. Die Option \texttt{image=true}
+lädt dann die Datei \verb+W.eps+. Das Suffix \verb+.eps+ kann -- dank des
+Pakets \verb+graphicx.sty+ -- weggelassen werden.
+
+\begin{verbatim}
+{\fontfamily{yfrak}\selectfont\Large
+\renewcommand{\LettrineTextFont}{\relax}
+\lettrine[image=true, lines=3, lhang=.2, loversize=.25, %
+ lraise=-.05, findent=0.1em, nindent=0em]
+{W}{er} reitet so spät durch Nacht und Wind?
+Es ist der Vater mit seinem Kind;
+Er hat den Knaben wohl in dem Arm,
+Er faßt ihn sicher, er hält ihn warm.\par}
+\end{verbatim}
+
+Zur Darstellung dieses Beispiels müssen folgende Pakete installiert sein:
+\begin{itemize}
+\item \verb+graphicx.sty+,
+\item die Schriften \verb+yfrak.pfb+ im type\,1-Format
+ von Yannis~\textsc{Haralambous},
+\item das Paket \verb+blacklettert1+ von Thorsten~\textsc{Bronger}.
+\end{itemize}
+
+Die gothische Initiale \glqq W\grqq{} in diesem Beispiel können Sie mit dem
+Programm \MP{} aus den \MF{}-Sourcen und \verb+yinitW.mf+ erzeugen.
+
+Falls Sie eine PDF-Datei erzeugen wollen, müssen Sie die Datei \verb+W.eps+
+in eine PDF-Datei \verb+W.pdf+ umwandeln (mit Hilfe von \verb+epstopdf+).
+
+\verb+\lettrine+ unterstützt die Verwendung der Formate:
+\texttt{pdf}, \texttt{png}, \texttt{jpeg} oder \MP{} als Initiale.
+
+\vfill
+\begin{flushright}
+ Deutsche Version Georg \textsc{Wagner}\\
+ \texttt{g.wagner@datacomm.ch}\\
+ Mai 2003, ergänzt September 2014
+\end{flushright}
+
+\end{document}
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End:
diff --git a/macros/latex/contrib/lettrine/doc/demo.pdf b/macros/latex/contrib/lettrine/doc/demo.pdf
new file mode 100644
index 0000000000..c0253dc0d5
--- /dev/null
+++ b/macros/latex/contrib/lettrine/doc/demo.pdf
Binary files differ
diff --git a/macros/latex/contrib/lettrine/doc/demo.tex b/macros/latex/contrib/lettrine/doc/demo.tex
new file mode 100644
index 0000000000..705f9272c3
--- /dev/null
+++ b/macros/latex/contrib/lettrine/doc/demo.tex
@@ -0,0 +1,306 @@
+%Format: pdfLaTeX
+
+\documentclass[12pt,german,french]{article}
+
+\usepackage[a4paper,text={145mm,240mm},centering]{geometry}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage{palatino} % Romain (sans-serif= helvetica)
+\renewcommand{\ttdefault}{lmtt} % Courier chasse trop !
+\usepackage{microtype}
+\usepackage{Rothdn, Typocaps} % cfr-initials (p. 3)
+
+\usepackage{lettrine}
+\usepackage{babel}
+\frenchbsetup{AutoSpacePunctuation=false,og=«,fg=»}
+
+\usepackage{graphicx,color}
+\usepackage{hyperref,bookmark}
+
+\newcommand{\MF}{{\small\sffamily\scshape metafont}}
+\newcommand{\MP}{{\small\sffamily\scshape metapost}}
+\setlength{\parindent}{0pt}
+\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, à quelques kilomètres
+au nord d'Aigues-Mortes, se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» 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,
+à quelques kilomètres au nord d'Aigues-Mortes, se trouve
+la Tour Carbonnière.
+
+\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,
+à juste quelques kilomètres au nord d'Aigues-Mortes,
+se trouve la Tour Carbonnière.
+Elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+
+\vspace{\baselineskip}
+\textit{Lettrine complètement dans la marge} :\\
+\verb+\lettrine[lhang=1, nindent=0pt, lines=3]{J}{ustement},...+
+
+\lettrine[lhang=1, nindent=0pt, lines=3]{J}{ustement},
+à quelques kilomètres au nord d'Aigues-Mortes,
+se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+L'abbaye était ravitaillée ---~dit-on ~--- par un souterrain
+qui la reliait au château de Treillan.
+
+\vspace{\baselineskip}
+\textit{Lettrine en saillie à 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,
+à quelques kilomètres au nord d'Aigues-Mortes la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» \dots
+% dont il ne reste que des vestiges.
+
+\vspace{\baselineskip}
+\textit{On peut ajouter un guillemet devant la lettrine} :\\
+\verb+\lettrine[ante=«]{E}{n} plein marais ...+
+
+\lettrine[ante=«]{E}{n} plein marais de la Souteyranne,
+à quelques kilomètres au nord d'Aigues-Mortes, se trouve
+la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» \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\% à cause du « Q »}
+\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, à quelques kilomètres au nord d'Aigues-Mortes,
+se trouve la Tour Carbonnière, surprend les visiteurs.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+L'abbaye était ravitaillée par un souterrain qui
+la reliait au château de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{Autre solution : ajout d’une ligne grâce à} \verb+depth+\\
+\verb+\lettrine[lines=4,depth=1]{Q}{u'en plein marais} de ...+
+
+\lettrine[lines=4,depth=1]{Q}{u'en plein marais} de la Souteyranne,
+à quelques kilomètres au nord d'Aigues-Mortes,
+se trouve la Tour Carbonnière, surprend les visiteurs.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+L'abbaye était ravitaillée par un souterrain qui
+la reliait au château de Treillan.
+
+\vspace{.5\baselineskip}
+\textit{Utilisation de l'option {\ttfamily\upshape slope}} pour que le texte
+suive la pente du « À » :\\
+\verb+\lettrine[lines=4, slope=0.6em, findent=-1em,+\\
+\verb+ nindent=0.6em]{À}{quelques kilomètres}...+
+
+\lettrine[lines=4, slope=0.6em, findent=-1em, nindent=0.6em]{À} {quelques
+kilomètres} au nord d'Aigues-Mortes, se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+L'abbaye était ravitaillée ---~dit-on~--- par un souterrain qui
+la reliait au château 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 à
+ demi-poussé 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} à...+
+
+\lettrine[lines=4, slope=-0.5em, lhang=0.5, nindent=0pt]{V}{oici}
+à quelques kilomètres au nord d'Aigues-Mortes la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody,
+l'une des « abbayes de sel» dont il ne reste que quelques vestiges.
+L'abbaye était ravitaillée ---~dit-on~--- par un souterrain qui
+la reliait au château de Treillan.
+
+\newpage
+\newgeometry{text={138mm,240mm},centering}
+
+\begin{center}
+\large\bfseries Deux exemples d’utilisation de cfr-initials
+\end{center}
+
+\textit{Dans le préambule :}
+\verb+\usepackage{Typocaps, Rothdn}+
+
+\vspace{.5\baselineskip}
+\textit{Changement de police (ici Typocaps)
+ et de couleur pour la lettrine :}\\
+\verb+\renewcommand{\LettrineFontHook}{\Typocapsfamily\color{red}}+\\
+\verb+\lettrine[findent=.3em]{E}{n} plein marais...+
+
+{% Groupe (changement local de fonte)
+\renewcommand{\LettrineFontHook}{\Typocapsfamily\color{red}}
+
+\lettrine[findent=.3em]{E}{n} plein marais de la Souteyranne, à quelques
+kilomètres au nord d'Aigues-Mortes, se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée.
+\par}% Fin du groupe.
+
+\vspace{.5\baselineskip}
+\textit{Les quatre exemples suivants font appel à la police d’initiales Rothdn}\\
+\verb+\renewcommand{\LettrineFontHook}{\Rothdnfamily}+
+
+\renewcommand{\LettrineFontHook}{\Rothdnfamily}
+
+\vspace{.5\baselineskip}
+\textit{Le calcul de la taille de la lettrine prend comme référence les
+ lettres EFTZ (voir {\ttfamily\upshape\boi LettrineTestString}),
+ dans le cas de la police Rothdn ça donne ceci pour A :
+}
+
+\verb+\lettrine[lines=3]{A}{u} bord du marais+
+
+\lettrine[lines=3]{A}{u} bord du marais de la Souteyranne, à quelques
+kilomètres au nord d'Aigues-Mortes, se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody.
+
+\vspace{.5\baselineskip}
+\textit{L’option {\ttfamily\upshape refstring} donne une taille correcte à la
+ lettrine (le calcul est fait sur la base du A lui-même et non de EFTZ%
+ \footnote{Le F de la police Rothdn a une hauteur supérieure à celles des
+ autres lettres.} :
+}
+
+\verb+\lettrine[refstring, lines=3]{A}{u} bord du marais+
+
+\lettrine[refstring, lines=3]{A}{u} bord du marais de la Souteyranne,
+à quelques kilomètres au nord d'Aigues-Mortes, se trouve la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody.
+
+
+\vspace{.5\baselineskip}
+\textit{Il suffit maintenant de remonter un peu la lettrine
+ ({\ttfamily\upshape lraise=0.15}) pour compenser sa profondeur :
+}
+
+\verb+\lettrine[refstring, lraise=0.15, lines=3]{A}{u} bord du marais+
+
+\lettrine[refstring, lraise=0.15, lines=3]{A}{u} bord du marais de la
+Souteyranne, à quelques kilomètres au nord d'Aigues-Mortes, se trouve
+la Tour Carbonnière.
+Construite au XIII\ieme~siècle, elle contrôlait l'unique voie d'accès
+terrestre de la ville fortifiée, celle qui menait à Psalmody.
+
+\newpage
+\restoregeometry
+\begin{center}
+\large\bfseries Utilisation d'une image comme lettrine
+\end{center}
+
+\vspace{\baselineskip}
+Si la lettrine souhaitée n'est pas un caractère d'une fonte mais une
+image, \verb+\lettrine+ peut encore être utilisée, il suffit
+d'utiliser le booléen \texttt{image}, exemple :
+
+\begin{otherlanguage}{german}
+\renewcommand{\LettrineTextFont}{\relax}
+\fontfamily{yfrak}\selectfont\Large
+\lettrine[image=true,lhang=.2, loversize=.25, findent=0.1em]
+{W}{er} reitet so spät durch Nacht und Wind?\\
+Es ist der Vater mit seinem Kind;\\
+Er hat den Knaben wohl in dem Arm,\\
+Er faßt ihn sicher, er hält ihn warm.\par
+\end{otherlanguage}
+
+\vspace{.5\baselineskip}
+Et voici le code \LaTeX{} correspondant ;
+le premier argument de \verb+\lettrine+ étant \verb+W+,
+\verb+\lettrine+ fait appel au fichier \verb+W.pdf+, \verb+W.jpg+, etc. en
+pdfLaTeX (omission possible du suffixe \verb+.eps+, \verb+.pdf+, propriété
+de \verb+graphicx.sty+).
+
+\begin{verbatim}
+\begin{otherlanguage}{german}
+ \fontfamily{yfrak}\selectfont\Large
+ \renewcommand{\LettrineTextFont}{\relax}
+ \lettrine[image=true,lhang=.2, loversize=.25, findent=0.1em]
+ {W}{er} reitet so spät durch Nacht und Wind?\\
+ Es ist der Vater mit seinem Kind;\\
+ Er hat den Knaben wohl in dem Arm,\\
+ Er faßt ihn sicher, er hält ihn warm.\par
+\end{otherlanguage}
+\end{verbatim}
+
+Cet exemple fait appel aux fichiers suivants :
+\begin{itemize}
+\item \texttt{graphicx.sty} (extension standard \LaTeXe{}),
+\item \texttt{blackletter1} de Thorsten~\textsc{Bronger} (disponible sur CTAN),
+\item les fontes gothiques « Fraktur » de Yannis~\textsc{Haralambous} type\,1
+ \texttt{yfrak.pfb} disponibles sur CTAN).
+\end{itemize}
+L'initiale gothique « W » utilisée dans
+cet exemple a été créée par \MP{} (fichier \texttt{W.pdf} ci-joint)
+à partir du source \MF{} \texttt{yinitW.mf} de Yannis grâce aux précieuses
+indications de Denis~\textsc{Roegel} que je remercie bien vivement.
+
+\vspace{.5\baselineskip}
+Une solution plus simple s’offre aux utilisateurs de LuaLaTeX ou XeLaTeX pour
+reproduire le poème ci-dessus : il suffit d’utiliser la police OpenType Yinit
+pour la lettrine et par exemple une des polices OpenType UnifrakturMaguntia
+pour le texte, voir \url{http://unifraktur.sourceforge.net/maguntia.html}.
+
+Le codage est identique à ceci près que l’option \texttt{image=true} est
+supprimée et l’appel à la police \texttt{yfrak} remplacé par :\\
+\verb+\setmainfont{UnifrakturMaguntia19}\Large+\\
+\verb+\renewcommand{\LettrineFontHook}{\setmainfont{Yinit}}+
+
+\vfill
+\begin{flushright}
+ Daniel \textsc{Flipo}\\
+ \texttt{daniel.flipo@free.fr}\\
+ avril 2019.
+\end{flushright}
+
+\end{document}
+
+%%% Local Variables:
+%%% mode: latex
+%%% coding: utf-8
+%%% TeX-master: t
+%%% End:
diff --git a/macros/latex/contrib/lettrine/doc/lettrine.pdf b/macros/latex/contrib/lettrine/doc/lettrine.pdf
new file mode 100644
index 0000000000..9d206d0d65
--- /dev/null
+++ b/macros/latex/contrib/lettrine/doc/lettrine.pdf
Binary files differ