From 6f88c37dfff5fa99c6f380ffe0de936ba176f009 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 25 Sep 2022 20:19:12 +0000 Subject: lettrine (25sep22) git-svn-id: svn://tug.org/texlive/trunk@64511 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/lettrine/README.md | 6 +- Master/texmf-dist/doc/latex/lettrine/W.pdf | Bin 0 -> 14470 bytes Master/texmf-dist/doc/latex/lettrine/demo-de.pdf | Bin 57807 -> 0 bytes Master/texmf-dist/doc/latex/lettrine/demo-de.tex | 245 ----------------- Master/texmf-dist/doc/latex/lettrine/demo-fr.pdf | Bin 62734 -> 0 bytes Master/texmf-dist/doc/latex/lettrine/demo-fr.tex | 302 --------------------- Master/texmf-dist/doc/latex/lettrine/demo-lua.pdf | Bin 74166 -> 0 bytes Master/texmf-dist/doc/latex/lettrine/demo-lua.tex | 116 -------- .../doc/latex/lettrine/lettrine-demo-de.pdf | Bin 0 -> 57736 bytes .../doc/latex/lettrine/lettrine-demo-de.tex | 245 +++++++++++++++++ .../doc/latex/lettrine/lettrine-demo-fr.pdf | Bin 0 -> 62638 bytes .../doc/latex/lettrine/lettrine-demo-fr.tex | 302 +++++++++++++++++++++ .../doc/latex/lettrine/lettrine-demo-lua.pdf | Bin 0 -> 73141 bytes .../doc/latex/lettrine/lettrine-demo-lua.tex | 116 ++++++++ Master/texmf-dist/doc/latex/lettrine/lettrine.pdf | Bin 89941 -> 97444 bytes .../texmf-dist/source/latex/lettrine/lettrine.dtx | 187 +++++++------ .../texmf-dist/source/latex/lettrine/lettrine.ins | 2 +- Master/texmf-dist/tex/latex/lettrine/lettrine.cfg | 1 - Master/texmf-dist/tex/latex/lettrine/lettrine.sty | 33 ++- 19 files changed, 794 insertions(+), 761 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/lettrine/W.pdf delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-de.pdf delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-de.tex delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-fr.pdf delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-fr.tex delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-lua.pdf delete mode 100644 Master/texmf-dist/doc/latex/lettrine/demo-lua.tex create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.pdf create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.tex create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.pdf create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.tex create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.pdf create mode 100644 Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.tex diff --git a/Master/texmf-dist/doc/latex/lettrine/README.md b/Master/texmf-dist/doc/latex/lettrine/README.md index 73d10c67737..f62a7c20c66 100644 --- a/Master/texmf-dist/doc/latex/lettrine/README.md +++ b/Master/texmf-dist/doc/latex/lettrine/README.md @@ -31,9 +31,9 @@ Installation This bundle is included in most TeX distributions, but if you need to install it by yourself -1. run lualatex on lettrine.dtx to get the documentation (lettrine.pdf), +1. run lualatex on lettrine.dtx to get the documentation (lettrine.pdf); 2. run luatex on lettrine.ins to strip the comments and create - lettrine.sty and lettrine.cfg + lettrine.sty and lettrine.cfg; 3. run luatex on contrib.dtx to produce the *.cfl files. Files lettrine.sty, lettrine.cfg, lettrine-*.sty and *.cfl go to to @@ -46,5 +46,5 @@ Files *.dtx, *.ins go to a source directory, typically $TEXMF/source/latex/lettrine -- -Copyright 1999--2020 Daniel Flipo +Copyright 1999--2022 Daniel Flipo E-mail: daniel (dot) flipo (at) free (dot) fr diff --git a/Master/texmf-dist/doc/latex/lettrine/W.pdf b/Master/texmf-dist/doc/latex/lettrine/W.pdf new file mode 100644 index 00000000000..5fd9502f083 Binary files /dev/null and b/Master/texmf-dist/doc/latex/lettrine/W.pdf differ diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-de.pdf b/Master/texmf-dist/doc/latex/lettrine/demo-de.pdf deleted file mode 100644 index 3c7102a8985..00000000000 Binary files a/Master/texmf-dist/doc/latex/lettrine/demo-de.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-de.tex b/Master/texmf-dist/doc/latex/lettrine/demo-de.tex deleted file mode 100644 index 204841e854f..00000000000 --- a/Master/texmf-dist/doc/latex/lettrine/demo-de.tex +++ /dev/null @@ -1,245 +0,0 @@ - -\documentclass[a4paper,12pt,german]{article} -\usepackage{iftex} -\iftutex - \usepackage{fontspec} - \setmainfont{erewhon} % erewhon (Utopia) -\else - \usepackage{fourier} % fourier (Utopia) und - \renewcommand{\ttdefault}{lmtt} % Latin Modern Typewriter fonts -\fi - -\usepackage[a4paper,text={150mm,240mm},centering]{geometry} -\usepackage{microtype} - -\usepackage{lettrine} -\usepackage{graphicx,color} -\usepackage{lettrine} - -\usepackage{babel} - -\newcommand{\MF}{{\small\scshape metafont}} -\newcommand{\MP}{{\small\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,findent= .3em,nindent=0pt,lines=3]{V}{erschieben}+ - -\lettrine[lhang=1,findent= .3em,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 15\% wegen des {\glqq}Q{\grqq}}:\\ -\verb+\lettrine[lines=4, loversize=-.15, lraise=.15]{Q}{ualität}+ - -\lettrine[lines=4, loversize=-.15, lraise=.15]{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, findent=.5em,nindent=0pt]+\\ -\verb+ {V}{iel} ist...+ - -\lettrine[lines=4, slope=-0.5em, lhang=0.5, findent=.5em, 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}\fontencoding{T1}%+\\ -\verb+ \fontseries{bx}\fontshape{it}}+\\ -\verb+\lettrine[findent=.3em]{A}{uch} ein Wechsel...+ - -{% (Ändern des lokalen fonts) -\renewcommand{\LettrineFontHook}{\fontfamily{pag}\fontencoding{T1}\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}\fontencoding{T1}+\\ -\verb+ \color[gray]{0.5}}\lettrine[loversize=0.1]{A}{uch}...+ - -{% (Aendern des lokalen fonts) -\renewcommand{\LettrineFontHook}{\fontfamily{yfrak}\fontencoding{T1} - \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}\fontencoding{T1}\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{\ss}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}\fontencoding{T1}\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{\ss}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 -%%% coding: utf-8 -%%% TeX-master: t -%%% TeX-engine: xetex -%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-fr.pdf b/Master/texmf-dist/doc/latex/lettrine/demo-fr.pdf deleted file mode 100644 index dc308808609..00000000000 Binary files a/Master/texmf-dist/doc/latex/lettrine/demo-fr.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-fr.tex b/Master/texmf-dist/doc/latex/lettrine/demo-fr.tex deleted file mode 100644 index 21e525ed061..00000000000 --- a/Master/texmf-dist/doc/latex/lettrine/demo-fr.tex +++ /dev/null @@ -1,302 +0,0 @@ - -\documentclass[paper=a4,12pt,german,french]{scrartcl} -\usepackage{iftex} -\iftutex - \usepackage{fontspec} - \setmainfont{erewhon} -\else - \usepackage[utf8]{inputenc} - \usepackage{fourier} - \renewcommand{\ttdefault}{lmtt} % Courier chasse trop ! -\fi -\usepackage{microtype} -\usepackage{Rothdn, Typocaps} % cfr-initials (p. 3) - -\usepackage{graphicx,color} -\usepackage{lettrine} -\usepackage{babel} -\frenchbsetup{AutoSpacePunctuation=false,og=«,fg=»} - -\newcommand*{\MF}{{\small\scshape metafont}} -\newcommand*{\MP}{{\small\scshape metapost}} -\newcommand*{\file}[1]{\texttt{#1}} -\newcommand*{\cs}[1]{\texttt{\boi#1}} - -\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. - -\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» 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. - -\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 ---~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 « À » :\\ -\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, findent=.5em, nindent=0pt]+\\ -\verb+ {V}{oici} à...+ - -\lettrine[lines=4, slope=-0.5em, lhang=0.5, findent=.5em, 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 distant de quelques kilomètres à peine. - -\newpage - -\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 normalement comme - référence les lettres EFTZ (voir {\upshape\cs{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, -l'une des « abbayes de sel» dont il ne reste que quelques vestiges. - -\vspace{\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, -l'une des « abbayes de sel» dont il ne reste que quelques vestiges. - - -\vspace{\baselineskip} -\textit{Il suffit maintenant de remonter 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, -l'une des « abbayes de sel» dont il ne reste que quelques vestiges. - -\newpage -\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}\fontencoding{T1}\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{\ss}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}\fontencoding{T1}\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{\ss}t ihn sicher, er hält ihn warm.\par -\end{otherlanguage} -\end{verbatim} - -Pour la compilation en pdfLaTeX 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 le fichier \file{demo-lua.pdf}. - -\vfill -\begin{flushright} - Daniel \textsc{Flipo}\\ - \texttt{daniel.flipo@free.fr}\\ - mars 2020. -\end{flushright} - -\end{document} - -%%% Local Variables: -%%% mode: latex -%%% coding: utf-8 -%%% TeX-master: t -%%% TeX-engine: xetex -%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-lua.pdf b/Master/texmf-dist/doc/latex/lettrine/demo-lua.pdf deleted file mode 100644 index f0e6257e6ea..00000000000 Binary files a/Master/texmf-dist/doc/latex/lettrine/demo-lua.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/lettrine/demo-lua.tex b/Master/texmf-dist/doc/latex/lettrine/demo-lua.tex deleted file mode 100644 index 4492ade68e1..00000000000 --- a/Master/texmf-dist/doc/latex/lettrine/demo-lua.tex +++ /dev/null @@ -1,116 +0,0 @@ -\documentclass[12pt,paper=a4,german,french,british]{scrartcl} - -\usepackage{lettrine} -\usepackage[dvipsnames]{xcolor} -\usepackage[colorlinks, urlcolor=ForestGreen, linkcolor=blue]{hyperref} - -%%% Linux Libertine fonts... -\usepackage{fontspec} -\setmainfont{Linux Libertine O} -%\setsansfont{TeX Gyre Heros}[Scale=MatchLowercase] -\setmonofont{Latin Modern Mono}[Scale=MatchLowercase] - -\usepackage{Typocaps} - -\usepackage{babel} -\frenchbsetup{AutoSpacePunctuation=false, og=«,fg=»} -\babeltags{fr=french, de=german, uk=british} - -\newcommand*{\file}[1]{\texttt{#1}} -\newcommand*{\cs}[1]{\texttt{\boi#1}} -\newcommand*{\MF}{{\small\scshape metafont}} - -\setlength{\parindent}{0pt} -\sloppy - -\begin{document} -\thispagestyle{empty} -\enlargethispage{2\baselineskip} - -\begin{center} -\large\bfseries Some LuaLaTeX examples -\end{center} - -Both files \file{demo-fr.tex} and \file{demo-de.tex} can be compiled either with -pdfLaTeX or with LuaLaTeX or XeLaTeX. The purpose of the next examples is to -show how easy it is to change the font for the dropped initial with Unicode -engines: no need to care about the low-level NFSS syntax, a simple -\cs{fontspec} call will do the trick. - -\vspace{.5\baselineskip} -In the first example, \textit{ Linux Libertine Initials} is used for the -dropped capital:\\ -\verb+\renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}}+\\ -\verb+\lettrine[lines=3]{E}{n plein marais de la Souteyranne...}+ - -\begin{fr} - \renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}} - \lettrine[lines=3]{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.\par -\end{fr} - -\vspace{.5\baselineskip} -Of course, it is still possible to use Type\,1 fonts for the dropped capitals, -here \textit{Typocaps} (red):\\ -\verb+\renewcommand{\LettrineFontHook}{\Typocapsfamily\color{red}}+\\ -\verb+\lettrine[findent=.3em]{E}{n plein marais de la Souteyranne}...+ - -\begin{fr} -\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 -\end{fr} - -\vspace{.5\baselineskip} -OpenType and TrueType free fonts are available for Old German, here is an example -featuring the \textit{Yinit} OpenType font% -\footnote{produced by Élie Roux from Yannis Haralambous’ Gothic Initials - originally in \MF.} -for the initial and \textit{UnifrakturMaguntia} TrueType font% -\footnote{\url{http://unifraktur.sourceforge.net/maguntia.html}} -for the running text. The later has several nice \textit{optional features}, -(here long s and old umlaut variant): - -\verb+\setmainfont{UnifrakturMaguntia.ttf}[StylisticSet=11,CharacterVariant=15]+\\ -\verb+\renewcommand{\LettrineTextFont}{\relax} % No small caps here!+ \\ -\verb+\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}}+\\ -\verb+\lettrine[lhang=.2, loversize=.25, findent=0.1em]{W}{er} reitet+ - -\begin{de}\Large -\setmainfont{UnifrakturMaguntia.ttf}[StylisticSet=11,CharacterVariant=15] -\renewcommand{\LettrineTextFont}{\relax} -\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}} -\lettrine[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{de} - -\vspace{.5\baselineskip} -Without the \textit{optional features}, the output looks more modern: - -\begin{otherlanguage}{german}\Large -\setmainfont{UnifrakturMaguntia.ttf} -\renewcommand{\LettrineTextFont}{\relax} -\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}} -\lettrine[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{document} - -%%% Local Variables: -%%% mode: latex -%%% coding: utf-8 -%%% TeX-master: t -%%% TeX-engine: luatex -%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.pdf b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.pdf new file mode 100644 index 00000000000..f27982ed419 Binary files /dev/null and b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.pdf differ diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.tex b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.tex new file mode 100644 index 00000000000..204841e854f --- /dev/null +++ b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-de.tex @@ -0,0 +1,245 @@ + +\documentclass[a4paper,12pt,german]{article} +\usepackage{iftex} +\iftutex + \usepackage{fontspec} + \setmainfont{erewhon} % erewhon (Utopia) +\else + \usepackage{fourier} % fourier (Utopia) und + \renewcommand{\ttdefault}{lmtt} % Latin Modern Typewriter fonts +\fi + +\usepackage[a4paper,text={150mm,240mm},centering]{geometry} +\usepackage{microtype} + +\usepackage{lettrine} +\usepackage{graphicx,color} +\usepackage{lettrine} + +\usepackage{babel} + +\newcommand{\MF}{{\small\scshape metafont}} +\newcommand{\MP}{{\small\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,findent= .3em,nindent=0pt,lines=3]{V}{erschieben}+ + +\lettrine[lhang=1,findent= .3em,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 15\% wegen des {\glqq}Q{\grqq}}:\\ +\verb+\lettrine[lines=4, loversize=-.15, lraise=.15]{Q}{ualität}+ + +\lettrine[lines=4, loversize=-.15, lraise=.15]{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, findent=.5em,nindent=0pt]+\\ +\verb+ {V}{iel} ist...+ + +\lettrine[lines=4, slope=-0.5em, lhang=0.5, findent=.5em, 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}\fontencoding{T1}%+\\ +\verb+ \fontseries{bx}\fontshape{it}}+\\ +\verb+\lettrine[findent=.3em]{A}{uch} ein Wechsel...+ + +{% (Ändern des lokalen fonts) +\renewcommand{\LettrineFontHook}{\fontfamily{pag}\fontencoding{T1}\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}\fontencoding{T1}+\\ +\verb+ \color[gray]{0.5}}\lettrine[loversize=0.1]{A}{uch}...+ + +{% (Aendern des lokalen fonts) +\renewcommand{\LettrineFontHook}{\fontfamily{yfrak}\fontencoding{T1} + \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}\fontencoding{T1}\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{\ss}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}\fontencoding{T1}\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{\ss}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 +%%% coding: utf-8 +%%% TeX-master: t +%%% TeX-engine: xetex +%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.pdf b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.pdf new file mode 100644 index 00000000000..0d311f197b7 Binary files /dev/null and b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.pdf differ diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.tex b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.tex new file mode 100644 index 00000000000..21e525ed061 --- /dev/null +++ b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-fr.tex @@ -0,0 +1,302 @@ + +\documentclass[paper=a4,12pt,german,french]{scrartcl} +\usepackage{iftex} +\iftutex + \usepackage{fontspec} + \setmainfont{erewhon} +\else + \usepackage[utf8]{inputenc} + \usepackage{fourier} + \renewcommand{\ttdefault}{lmtt} % Courier chasse trop ! +\fi +\usepackage{microtype} +\usepackage{Rothdn, Typocaps} % cfr-initials (p. 3) + +\usepackage{graphicx,color} +\usepackage{lettrine} +\usepackage{babel} +\frenchbsetup{AutoSpacePunctuation=false,og=«,fg=»} + +\newcommand*{\MF}{{\small\scshape metafont}} +\newcommand*{\MP}{{\small\scshape metapost}} +\newcommand*{\file}[1]{\texttt{#1}} +\newcommand*{\cs}[1]{\texttt{\boi#1}} + +\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. + +\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» 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. + +\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 ---~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 « À » :\\ +\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, findent=.5em, nindent=0pt]+\\ +\verb+ {V}{oici} à...+ + +\lettrine[lines=4, slope=-0.5em, lhang=0.5, findent=.5em, 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 distant de quelques kilomètres à peine. + +\newpage + +\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 normalement comme + référence les lettres EFTZ (voir {\upshape\cs{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, +l'une des « abbayes de sel» dont il ne reste que quelques vestiges. + +\vspace{\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, +l'une des « abbayes de sel» dont il ne reste que quelques vestiges. + + +\vspace{\baselineskip} +\textit{Il suffit maintenant de remonter 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, +l'une des « abbayes de sel» dont il ne reste que quelques vestiges. + +\newpage +\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}\fontencoding{T1}\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{\ss}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}\fontencoding{T1}\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{\ss}t ihn sicher, er hält ihn warm.\par +\end{otherlanguage} +\end{verbatim} + +Pour la compilation en pdfLaTeX 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 le fichier \file{demo-lua.pdf}. + +\vfill +\begin{flushright} + Daniel \textsc{Flipo}\\ + \texttt{daniel.flipo@free.fr}\\ + mars 2020. +\end{flushright} + +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% coding: utf-8 +%%% TeX-master: t +%%% TeX-engine: xetex +%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.pdf b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.pdf new file mode 100644 index 00000000000..e8c19c69d44 Binary files /dev/null and b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.pdf differ diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.tex b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.tex new file mode 100644 index 00000000000..4492ade68e1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/lettrine/lettrine-demo-lua.tex @@ -0,0 +1,116 @@ +\documentclass[12pt,paper=a4,german,french,british]{scrartcl} + +\usepackage{lettrine} +\usepackage[dvipsnames]{xcolor} +\usepackage[colorlinks, urlcolor=ForestGreen, linkcolor=blue]{hyperref} + +%%% Linux Libertine fonts... +\usepackage{fontspec} +\setmainfont{Linux Libertine O} +%\setsansfont{TeX Gyre Heros}[Scale=MatchLowercase] +\setmonofont{Latin Modern Mono}[Scale=MatchLowercase] + +\usepackage{Typocaps} + +\usepackage{babel} +\frenchbsetup{AutoSpacePunctuation=false, og=«,fg=»} +\babeltags{fr=french, de=german, uk=british} + +\newcommand*{\file}[1]{\texttt{#1}} +\newcommand*{\cs}[1]{\texttt{\boi#1}} +\newcommand*{\MF}{{\small\scshape metafont}} + +\setlength{\parindent}{0pt} +\sloppy + +\begin{document} +\thispagestyle{empty} +\enlargethispage{2\baselineskip} + +\begin{center} +\large\bfseries Some LuaLaTeX examples +\end{center} + +Both files \file{demo-fr.tex} and \file{demo-de.tex} can be compiled either with +pdfLaTeX or with LuaLaTeX or XeLaTeX. The purpose of the next examples is to +show how easy it is to change the font for the dropped initial with Unicode +engines: no need to care about the low-level NFSS syntax, a simple +\cs{fontspec} call will do the trick. + +\vspace{.5\baselineskip} +In the first example, \textit{ Linux Libertine Initials} is used for the +dropped capital:\\ +\verb+\renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}}+\\ +\verb+\lettrine[lines=3]{E}{n plein marais de la Souteyranne...}+ + +\begin{fr} + \renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}} + \lettrine[lines=3]{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.\par +\end{fr} + +\vspace{.5\baselineskip} +Of course, it is still possible to use Type\,1 fonts for the dropped capitals, +here \textit{Typocaps} (red):\\ +\verb+\renewcommand{\LettrineFontHook}{\Typocapsfamily\color{red}}+\\ +\verb+\lettrine[findent=.3em]{E}{n plein marais de la Souteyranne}...+ + +\begin{fr} +\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 +\end{fr} + +\vspace{.5\baselineskip} +OpenType and TrueType free fonts are available for Old German, here is an example +featuring the \textit{Yinit} OpenType font% +\footnote{produced by Élie Roux from Yannis Haralambous’ Gothic Initials + originally in \MF.} +for the initial and \textit{UnifrakturMaguntia} TrueType font% +\footnote{\url{http://unifraktur.sourceforge.net/maguntia.html}} +for the running text. The later has several nice \textit{optional features}, +(here long s and old umlaut variant): + +\verb+\setmainfont{UnifrakturMaguntia.ttf}[StylisticSet=11,CharacterVariant=15]+\\ +\verb+\renewcommand{\LettrineTextFont}{\relax} % No small caps here!+ \\ +\verb+\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}}+\\ +\verb+\lettrine[lhang=.2, loversize=.25, findent=0.1em]{W}{er} reitet+ + +\begin{de}\Large +\setmainfont{UnifrakturMaguntia.ttf}[StylisticSet=11,CharacterVariant=15] +\renewcommand{\LettrineTextFont}{\relax} +\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}} +\lettrine[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{de} + +\vspace{.5\baselineskip} +Without the \textit{optional features}, the output looks more modern: + +\begin{otherlanguage}{german}\Large +\setmainfont{UnifrakturMaguntia.ttf} +\renewcommand{\LettrineTextFont}{\relax} +\renewcommand{\LettrineFontHook}{\fontspec{Yinit.otf}} +\lettrine[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{document} + +%%% Local Variables: +%%% mode: latex +%%% coding: utf-8 +%%% TeX-master: t +%%% TeX-engine: luatex +%%% End: diff --git a/Master/texmf-dist/doc/latex/lettrine/lettrine.pdf b/Master/texmf-dist/doc/latex/lettrine/lettrine.pdf index 5660e16e1b2..68706827128 100644 Binary files a/Master/texmf-dist/doc/latex/lettrine/lettrine.pdf and b/Master/texmf-dist/doc/latex/lettrine/lettrine.pdf differ diff --git a/Master/texmf-dist/source/latex/lettrine/lettrine.dtx b/Master/texmf-dist/source/latex/lettrine/lettrine.dtx index c357e97aba5..65f301e6afc 100644 --- a/Master/texmf-dist/source/latex/lettrine/lettrine.dtx +++ b/Master/texmf-dist/source/latex/lettrine/lettrine.dtx @@ -1,8 +1,6 @@ -% \CheckSum{650} -% % \iffalse meta-comment % -% Copyright © 1999-2020 Daniel Flipo. +% Copyright © 1999-2022 Daniel Flipo. % % This program can be distributed and/or modified under the terms % of the LaTeX Project Public License either version 1.3c of this @@ -26,7 +24,7 @@ \ProvidesFile{lettrine.dtx} % %<*!cfg> - [2020-03-14 v2.23 (Daniel Flipo)] + [2022-09-25 v2.30 (Daniel Flipo)] % % % Lettrine package for LaTeX version 2e @@ -36,6 +34,8 @@ % Please report errors to: daniel (dot) flipo (at) free (dot) fr % %<*driver> +\RequirePackage{pdfmanagement-testphase} +\DeclareDocumentMetadata{pdfstandard=A-2b, lang=en-US} \documentclass[a4paper]{ltxdoc} \usepackage[dvipsnames]{xcolor} \usepackage{unicode-math} @@ -48,7 +48,10 @@ \usepackage[expansion=true,protrusion=true]{microtype} \usepackage{url} \usepackage[numbered]{hypdoc} -\hypersetup{colorlinks,urlcolor=blue,unicode} +\hypersetup{pdftitle={Lettrine User’s Guide}, + pdfauthor={Daniel FLIPO}, + colorlinks + } \usepackage{lettrine} \usepackage{tikz} \usetikzlibrary{shapes.arrows} @@ -92,15 +95,16 @@ % % \changes{v2.23}{2020/03/14}{Documentation cleanup.} % -% Adding |\usepackage{lettrine}| in the preamble of a document +% Adding |\usepackage{lettrine}| in the preamble of a document % defines the command |\lettrine|, the simplest use of which is % |\lettrine{|\meta{letter}|}{|\meta{text}|}|. % It produces a dropped capital \meta{letter} (2 lines high), % followed by \meta{text} typeset in small caps, and the rest % of the paragraph is wrapped around the dropped capital. % -% Various parameters are provided to control the size and layout -% of the dropped capital and match the requirements described +% The |\lettrine[|\meta{options}|]{|\meta{letter}|}{|\meta{text}|}| +% command accepts various optional arguments to control the size and +% layout of the dropped capital and match the requirements described % in the books % \begin{itemize} % \item ``Lexique des règles typographiques en usage à @@ -149,7 +153,7 @@ % \changes{v1.6}{2004/05/22}{Add a flag to switch to % images in eps or pdf format. Suggested by Bill Jetzer.} % -% \item \lopt{image=true} will force |\lettrine| to replace the letter +% \item \lopt{image[=true]} will force |\lettrine| to replace the letter % normally used as dropped capital by an image in eps format (latex) % or in pdf, jpg, etc.\ format (pdflatex, xelatex, lualatex); % this requires the |graphicx| package to be loaded in the preamble. @@ -163,13 +167,13 @@ % \changes{v1.8}{2015/02/06}{Added two keyval options: % `grid’ (true/false) and `novskip’ to override \cs{DiscardVskip}.} % -% \item \lopt{grid=true} will force the vertical skip added above the +% \item \lopt{grid[=true]} will force the vertical skip added above the % paragraph starting with |\lettrine| to be rounded up to an integer % number of |\baselineskip|. This option is meant for grid % typesetting. % \item \lopt{novskip=}\meta{dimen} overrides |\DiscardVskip| % (default=0.2pt). In some cases (see options \lopt{lraise}, -% \lopt{loversize} or accentuated dropped capitals,\dots) the top of +% \lopt{loversize} or accentuated dropped capitals,…) the top of % the dropped capital will raise above the top of following text % (usually in small caps), this will trigger a corresponding vertical % skip above the paragraph starting with |\lettrine|, \emph{only if} @@ -180,7 +184,7 @@ % \changes{v1.9}{2015/08/31}{New keyval option: `realheight’ % (true/false) and new global flag \cs{ifLettrineRealHeight}.} % -% \item \lopt{realheight=true} will compute the default height of the +% \item \lopt{realheight[=true]} will compute the default height of the % initial so that the top of it is exactly aligned with the top of % the text entered as second mandatory argument of |\lettrine| % taking possible accents into account. Otherwise, the default @@ -212,7 +216,7 @@ % \lopt{refstring=}\meta{string} to override \cs{LettrineTestString} % locally.} is meant for fancy initials with % irregular heights (i.e.\ taken in fonts like Yinit (OpenType), -% \file{cfr-initials},\dots). \lopt{refstring} forces the +% \file{cfr-initials},…). \lopt{refstring} forces the % |\fontsize| computations to be run on the initial given as % |\lettrine|’s first mandatory argument instead of the reference % string |\LettrineTestString|. In most cases, this option should @@ -224,7 +228,7 @@ % Example: |\lettrine[lines=4, lraise=0.1, nindent=0em, |% % |slope=-.5em]%|\\ % \mbox{}\phantom{\tt Example: lettrine}% -% |{V}{oici} un exemple |\dots +% |{V}{oici} un exemple |… % % Coloured initials are possible in conjonction with package % \file{color}, examples: \\ @@ -237,46 +241,54 @@ % Three dimensions, |\LettrineWidth|, |\LettrineHeight| and % |\LettrineDepth|, store the final size of the initial. % -% Once \file{lettrine.sty} will be installed (run \texttt{lualatex} -% on \file{lettrine.ins} to extract it), compile \file{demo-fr.tex} -% and \file{demo-lua.tex} print the resulting PDFs to see the +% Have a look at files \file{demo-fr.tex} and \file{demo-lua.tex} +% and at the resulting PDFs in the \file{doc} folder to see the % possible usage of these parameters. % % \changes{v1.9}{2015/08/31}{New customisable string % \cs{LettrineSecondString} to tune the initial’s height.} % -% The default settings can be customized either in a config file -% \file{lettrine.cfg} (for a global usage), or on a per document -% basis, in the preamble of each document. The following list -% shows the syntax to set them and their default values: +% Starting with version~2.30, the default settings can be +% specified as options passed to the \pkg{lettrine} \emph{package}. +% These options are the same as those of the |\lettrine| command% +% \footnote{With one exception: \lopt{refstring} is available only +% for the \cs{lettrine} command.}: +% f.i. |\usepackage[lines=3]{lettrine}| will set the default to three +% lines of text. Options passed to the \pkg{lettrine} package override +% the defaults set in the \file{lettrine.cfg} file (see below) and will +% be overriden by options passed to the |\lettrine| command. +% +% The default settings can be customized in a config file +% \file{lettrine.cfg} for a global usage. The following list shows +% the syntax to set them and their default values: % \begin{itemize} % \item |\setcounter{DefaultLines}{2}|, % \item |\setcounter{DefaultDepth}{0}|, % \item |\renewcommand*{\DefaultLoversize}{0}|, % \item |\renewcommand*{\DefaultLraise}{0}|, % \item |\renewcommand*{\DefaultLhang}{0}|, -% \item |\LettrineImagefalse|, -% \item |\LettrineOnGridfalse|, -% \item |\LettrineRealHeightfalse|, -% \item |\LettrineSelfReffalse|, % \item |\setlength{\DefaultFindent}{0pt}|, % \item |\setlength{\DefaultNindent}{0.5em}|, % \item |\setlength{\DefaultSlope}{0pt}|. -% \item |\setlength{\DiscardVskip}{0.2pt}|. +% \item |\setlength{\DiscardVskip}{0.2pt}|, +% \item |\LettrineImagefalse|, +% \item |\LettrineOnGridfalse|, +% \item |\LettrineRealHeightfalse|. % \end{itemize} % % Instead of giving optional parameters to the |\lettrine| command, -% it is possible, from version 1.5, to set them on a per character +% it is possible to set them on a per character % basis in a second config file (suggested by Pascal Kockaert): -% |\renewcommand{\DefaultOptionsFile}{|\textit{filename}|}| +% |\renewcommand{\DefaultOptionsFile}{|\meta{filename}|}| % in the preamble (or anywhere in the document) will -% force each call to |\lettrine| to read the file \textit{filename}. -% See examples of such config files in the subdirectory -% \file{contrib}. +% force each call to |\lettrine| to read the file \meta{filename}. +% Alternatively, |\usepackage[optionsfile=|\meta{filename}|]{lettrine}| +% produces the same effect. +% See examples of such config files in the subdirectory \file{contrib}. % % The dimensional parameters \lopt{findent}, \lopt{nindent} and -% \lopt{slope}, can be set in \textit{filename} relative to -% |\LettrineWidth| if needed. The settings read from this file +% \lopt{slope}, can be set relative to |\LettrineWidth| if needed, +% \emph{in \meta{filename} only}. The settings read from this file % will be overridden by the optional arguments eventually given to % |\lettrine|. % @@ -299,13 +311,13 @@ % low-level font interface (see LaTeX Companion, p.187--192), % the |\selectfont| command is issued by |\LettrineFont|:\\ % |\renewcommand{\LettrineFontHook}{\fontfamily{ppl}|\ignorespaces -% |\fontseries{bx}}%|\\ -% | \fontshape{sl}}|,\\ +% |\fontseries{bx}%|\\ +% | \fontshape{sl}}|\\ % selects Palatino bold expanded slanted for the dropped capital. % % With LuaLaTeX or XeLaTeX changing the lettrine’s font is % even easier, simply use the |\fontspec| command:\\ -% |\renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}|\\ +% |\renewcommand{\LettrineFontHook}{\fontspec{LinLibertine_I.otf}}|\\ % will switch to Linux Libertine Initials. % % |\LettrineFontHook| can also be used to change the colour of @@ -346,7 +358,7 @@ % hyphenation). % % You can also consider using one of the standard PostScript fonts -% (Palatino, Times, Utopia\dots), or any OpenType font, they are +% (Palatino, Times, Utopia…), or any OpenType font, they are % fully scalable too! % % \newpage{} @@ -419,10 +431,10 @@ % \end{macrocode} % % This package only runs with LaTeX and requires files -% \file{keyval.sty} and \file{minifp.sty}. +% \file{xkeyval.sty} and \file{minifp.sty}. % % \begin{macrocode} -\RequirePackage{keyval,minifp} +\RequirePackage{xkeyval,minifp} % \end{macrocode} % % Default initializations: define the necessary counters, lengths, @@ -442,8 +454,7 @@ % \changes{v2.1}{2018/08/14}{Newif \cs{ifLettrineVone} and % new option `Vone’ (removed in v2.2, rollback prefered).} % -% \changes{v2.1}{2018/08/14}{New option `refstring’ and newif -% \cs{ifLettrineSelfRef}.} +% \changes{v2.1}{2018/08/14}{New option `refstring’.} % % \begin{macrocode} \newcounter{DefaultLines} @@ -464,9 +475,44 @@ \newif\ifLettrineImage \newif\ifLettrineOnGrid \newif\ifLettrineRealHeight -\newif\ifLettrineSelfRef % \end{macrocode} % +% Load a local config file if present in LaTeX’s search path. +% \begin{macrocode} +\InputIfFileExists{lettrine.cfg} + {\typeout{Loading lettrine.cfg}} + {\typeout{lettrine.cfg not found, using default values}} +% \end{macrocode} +% +% \changes{v2.30}{2022/09/23}{Added global options to package +% \pkg{lettrine}.} +% +% Global package options enable to override the default values given +% above to generic parameters. These may be overriden again by +% options passed to the |\lettrine[]{}{}| command. +% \begin{macrocode} +\DeclareOptionX{lines}[\value{DefaultLines}]{\setcounter{DefaultLines}{#1}} +\DeclareOptionX{depth}[\value{DefaultDepth}]{\setcounter{DefaultDepth}{#1}} +\DeclareOptionX{lhang}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLhang}{#1}\fi} +\DeclareOptionX{loversize}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLoversize}{#1}\fi} +\DeclareOptionX{lraise}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLraise}{#1}} +\DeclareOptionX{findent}[\the\DefaultFindent]{% + \setlength{\DefaultFindent}{#1}} +\DeclareOptionX{nindent}[\the\DefaultNindent]{% + \setlength{\DefaultNindent}{#1}} +\DeclareOptionX{slope}[\the\DefaultSlope]{\setlength{\DefaultSlope}{#1}} +\DeclareOptionX{image}[true]{\csname LettrineImage#1\endcsname} +\DeclareOptionX{grid}[true]{\csname LettrineOnGrid#1\endcsname} +\DeclareOptionX{novskip}[\the\DiscardVskip]{\setlength{\DiscardVskip}{#1}} +\DeclareOptionX{realheight}[true]{\csname LettrineRealHeight#1\endcsname} +\DeclareOptionX{optionsfile}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultOptionsFile}{#1}\fi} +\ProcessOptionsX +% \end{macrocode} + % Then let’s define the necessary internal counters, lengths, % and commands. % @@ -653,10 +699,11 @@ % \changes{v2.22}{2018/09/14}{Warn if \cs{fontsize} computation fails % due to division by 0.} % -% When optional argument \lopt{selfref} is \lopt{true} the initial -% itself is taken as reference to compute |\fontsize|, this can be -% handy when working with fancy fonts (i.e.\ cfr-initials, Yinit). -% In most cases, the default is a better choice. +% The conditional |\ifL@selfref| is set to \lopt{true} by |\lettrine| +% option \lopt{refstring}, then the initial itself is taken as +% reference to compute |\fontsize|, this can be handy when working +% with fancy fonts (i.e.\ cfr-initials, Yinit). In most cases, the +% default is a better choice. % \begin{macrocode} \def\compute@fontsize{% \ifL@selfref @@ -700,10 +747,10 @@ % \begin{macro}{\LettrineImage} % The following definition is for use with dropped capitals defined % as images: EPS, PDF, JPG, PNG files (see examples in demo-fr.tex). -% Its use requires the |graphicx| package to be loaded in the -% preamble with |\usepackage{graphicx}|. The required size is -% computed just as in the standard case, |\includegraphics| -% prints the image at this size. +% Its requires the |graphicx| package to be loaded in the +% preamble with |\usepackage{graphicx}|. The image’s height is +% computed just as in the standard case and passed to +% |\includegraphics|. % % \changes{v1.6}{2004/05/22}{Added \cs{LettrineFontHook} % to \cs{LettrineFontEPS}. This is needed for color options.} @@ -731,7 +778,7 @@ % \end{macrocode} % \end{macro} % -% Set up keyval initializations. +% Set up keyval initializations for the |\lettrine| command. % % \begin{macrocode} \define@key{L}{lines}{\setcounter{L@lines}{#1}} @@ -797,7 +844,6 @@ \ifLettrineImage\L@imagetrue\else\L@imagefalse\fi \ifLettrineOnGrid\L@gridtrue\else\L@gridfalse\fi \ifLettrineRealHeight\L@realhtrue\else\L@realhfalse\fi - \ifLettrineSelfRef\L@selfreftrue\else\L@selfreffalse\fi % \end{macrocode} % % The final initial size depends on the height of |\L@tbox|; the @@ -831,7 +877,7 @@ % |\DefaultOptionsFile|), do this inside a group, and define a % global command |\l@LOKeys| which will expand to the list of % options given by |\LettrineOptionsFor| for the current initial -% (defined by |#2|)\dots +% (defined by |#2|)… % \begin{macrocode} \if\DefaultOptionsFile\relax \else @@ -1005,7 +1051,7 @@ % % \changes{v1.1}{1999/08/18}{Add \cs{rightmargin} to % \cs{L@Pindent} for \cs{Lettrine} to work properly in quote, -% quotation, abstract environments\dots{} but do not change +% quotation, abstract environments… but do not change % \cs{linewidth} which is set by these environments.} % % \changes{v1.4}{2002/10/26}{\cs{lettrine} still didn’t @@ -1017,7 +1063,7 @@ % \changes{v2.22}{2019/04/04}{\cs{@totalleftmargin} is the correct % indentation for quote, quotation and abstract environments.} % -% This is for quotation, quote, abstract\dots{} environments: +% This is for quotation, quote, abstract… environments: % |\linewidth| is set by these environments, all we have to do % is to shift our text left by |\@totalleftmargin|. % \begin{macrocode} @@ -1080,12 +1126,6 @@ } % \end{macrocode} % -% Load a local config file if present in LaTeX’s search path. -% \begin{macrocode} -\InputIfFileExists{lettrine.cfg} - {\typeout{Loading lettrine.cfg}} - {\typeout{lettrine.cfg not found, using default values}} -% \end{macrocode} % \iffalse % % \fi @@ -1123,7 +1163,6 @@ %%\LettrineImagefalse %%\LettrineOnGridfalse %%\LettrineRealHeightfalse -%%\LettrineSelfReffalse %% %% Theses are *commands* (value=string, only height matters): %%\renewcommand*{\LettrineTestString}{EFTZ} @@ -1137,30 +1176,6 @@ % % \fi % -% \iffalse -%<*dtx> -% \fi -%% -%% \CharacterTable -%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z -%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z -%% Digits \0\1\2\3\4\5\6\7\8\9 -%% Exclamation \! Double quote \" Hash (number) \# -%% Dollar \$ Percent \% Ampersand \& -%% Acute accent \' Left paren \( Right paren \) -%% Asterisk \* Plus \+ Comma \, -%% Minus \- Point \. Solidus \/ -%% Colon \: Semicolon \; Less than \< -%% Equals \= Greater than \> Question mark \? -%% Commercial at \@ Left bracket \[ Backslash \\ -%% Right bracket \] Circumflex \^ Underscore \_ -%% Grave accent \` Left brace \{ Vertical bar \| -%% Right brace \} Tilde \~} -%% -% \iffalse -% -% \fi -% % \Finale \endinput diff --git a/Master/texmf-dist/source/latex/lettrine/lettrine.ins b/Master/texmf-dist/source/latex/lettrine/lettrine.ins index 8c605c8aad9..4c0c40bc7b5 100644 --- a/Master/texmf-dist/source/latex/lettrine/lettrine.ins +++ b/Master/texmf-dist/source/latex/lettrine/lettrine.ins @@ -1,5 +1,5 @@ %% -%% Copyright (C) 1999-2020 Daniel Flipo. +%% Copyright (C) 1999-2022 Daniel Flipo. %% %% This file will generate fast loadable files and documentation %% driver files from the doc files in this package when run through diff --git a/Master/texmf-dist/tex/latex/lettrine/lettrine.cfg b/Master/texmf-dist/tex/latex/lettrine/lettrine.cfg index 900ad83fbb6..30938553468 100644 --- a/Master/texmf-dist/tex/latex/lettrine/lettrine.cfg +++ b/Master/texmf-dist/tex/latex/lettrine/lettrine.cfg @@ -25,7 +25,6 @@ %%\LettrineImagefalse %%\LettrineOnGridfalse %%\LettrineRealHeightfalse -%%\LettrineSelfReffalse %% %% Theses are *commands* (value=string, only height matters): %%\renewcommand*{\LettrineTestString}{EFTZ} diff --git a/Master/texmf-dist/tex/latex/lettrine/lettrine.sty b/Master/texmf-dist/tex/latex/lettrine/lettrine.sty index 92486bbac83..ab3e863b28d 100644 --- a/Master/texmf-dist/tex/latex/lettrine/lettrine.sty +++ b/Master/texmf-dist/tex/latex/lettrine/lettrine.sty @@ -27,7 +27,7 @@ %% \NeedsTeXFormat{LaTeX2e}[2018-04-01] \ProvidesFile{lettrine.sty} - [2020-03-14 v2.23 (Daniel Flipo)] + [2022-09-25 v2.30 (Daniel Flipo)] \ifdefined\DeclareRelease \DeclareRelease{v1.6}{1999-03-03}{lettrine-2006-03-17.sty} \DeclareRelease{v1.9}{2012-07-20}{lettrine-2015-08-31.sty} @@ -40,7 +40,7 @@ \MessageBreak your LaTeX kernel (2018-04-01 or newer),% \MessageBreak otherwise you are fine; reported} \fi -\RequirePackage{keyval,minifp} +\RequirePackage{xkeyval,minifp} \newcounter{DefaultLines} \setcounter{DefaultLines}{2} \newcounter{DefaultDepth} @@ -59,7 +59,30 @@ \newif\ifLettrineImage \newif\ifLettrineOnGrid \newif\ifLettrineRealHeight -\newif\ifLettrineSelfRef +\InputIfFileExists{lettrine.cfg} + {\typeout{Loading lettrine.cfg}} + {\typeout{lettrine.cfg not found, using default values}} +\DeclareOptionX{lines}[\value{DefaultLines}]{\setcounter{DefaultLines}{#1}} +\DeclareOptionX{depth}[\value{DefaultDepth}]{\setcounter{DefaultDepth}{#1}} +\DeclareOptionX{lhang}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLhang}{#1}\fi} +\DeclareOptionX{loversize}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLoversize}{#1}\fi} +\DeclareOptionX{lraise}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultLraise}{#1}} +\DeclareOptionX{findent}[\the\DefaultFindent]{% + \setlength{\DefaultFindent}{#1}} +\DeclareOptionX{nindent}[\the\DefaultNindent]{% + \setlength{\DefaultNindent}{#1}} +\DeclareOptionX{slope}[\the\DefaultSlope]{\setlength{\DefaultSlope}{#1}} +\DeclareOptionX{image}[true]{\csname LettrineImage#1\endcsname} +\DeclareOptionX{grid}[true]{\csname LettrineOnGrid#1\endcsname} +\DeclareOptionX{novskip}[\the\DiscardVskip]{\setlength{\DiscardVskip}{#1}} +\DeclareOptionX{realheight}[true]{\csname LettrineRealHeight#1\endcsname} +\DeclareOptionX{optionsfile}[]{\ifx#1\@empty\else + \renewcommand*{\DefaultOptionsFile}{#1}\fi} +\ProcessOptionsX + \newsavebox{\L@lbox} \newsavebox{\L@tbox} \newcounter{L@lines} @@ -175,7 +198,6 @@ \ifLettrineImage\L@imagetrue\else\L@imagefalse\fi \ifLettrineOnGrid\L@gridtrue\else\L@gridfalse\fi \ifLettrineRealHeight\L@realhtrue\else\L@realhfalse\fi - \ifLettrineSelfRef\L@selfreftrue\else\L@selfreffalse\fi \setkeys{L}{#1}% \sbox{\L@tbox}{\LettrineTextFont{\LettrineSecondString}}% \ifL@realh @@ -293,9 +315,6 @@ \let\everypar\Llist@everypar }% } -\InputIfFileExists{lettrine.cfg} - {\typeout{Loading lettrine.cfg}} - {\typeout{lettrine.cfg not found, using default values}} \endinput %% %% End of file `lettrine.sty'. -- cgit v1.2.3