diff options
Diffstat (limited to 'macros/latex/contrib')
-rw-r--r-- | macros/latex/contrib/apa7/apa7.dtx | 24 | ||||
-rw-r--r-- | macros/latex/contrib/apa7/apa7.pdf | bin | 530694 -> 530950 bytes | |||
-rw-r--r-- | macros/latex/contrib/apa7/samples/longsample.pdf | bin | 196588 -> 196588 bytes | |||
-rw-r--r-- | macros/latex/contrib/apa7/samples/shortsample.pdf | bin | 65352 -> 65352 bytes | |||
-rw-r--r-- | macros/latex/contrib/fontsize/fontsize.dtx | 109 | ||||
-rw-r--r-- | macros/latex/contrib/fontsize/fontsize.pdf | bin | 351443 -> 393943 bytes | |||
-rw-r--r-- | macros/latex/contrib/lipsum/README.txt | 34 | ||||
-rw-r--r-- | macros/latex/contrib/lipsum/lipsum.dtx | 283 | ||||
-rw-r--r-- | macros/latex/contrib/lipsum/lipsum.ins | 55 | ||||
-rw-r--r-- | macros/latex/contrib/lipsum/lipsum.pdf | bin | 805942 -> 812071 bytes |
10 files changed, 281 insertions, 224 deletions
diff --git a/macros/latex/contrib/apa7/apa7.dtx b/macros/latex/contrib/apa7/apa7.dtx index 9819cca02b..85bcdc5e88 100644 --- a/macros/latex/contrib/apa7/apa7.dtx +++ b/macros/latex/contrib/apa7/apa7.dtx @@ -4,11 +4,11 @@ % % % CHANGE THESE VALUES WITH EACH NEW RELEASE: % % % -%<class>\ProvidesClass{apa7}[2021/03/03 v2.09 APA formatting (7th edition)] +%<class>\ProvidesClass{apa7}[2021/03/04 v2.10 APA formatting (7th edition)] % % %<*internal> % -\def\apaSevenVersionDate{2021/03/03} -\def\apaSevenVersionNumber{2.09} +\def\apaSevenVersionDate{2021/03/04} +\def\apaSevenVersionNumber{2.10} % % % % % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -267,6 +267,8 @@ and the derived files apa7.ins, % % \changes{v2.09}{2021/03/03}{Updated APA7endfloat.cfg file to use more modern DeclareDelayedFloatFlavor. This fixes the bug where longtable can be shown on the same page as another table. } % +% \changes{v2.10}{2021/03/04}{Update BibLaTex instructions to remove DeclareLanguageMapping and remove commands that are no longer required. } +% % \begin{abstract} % The \textit{Publication Manual} of the American Psychological % Association is widely used in the social sciences. The most @@ -788,9 +790,8 @@ and the derived files apa7.ins, % \textit{\textbf{Note:} This is the recommended method for 7th edition citations and references.} \\ % Biblatex is the most APA-compliant bibiliography package. The % \DescribeMacro{biblatex}|biblatex| option directs \textsf{apa7} to -% load the \textsf{biblatex} package with the following options: -% style=apa,sortcites=true,sorting=nyt; however, the -% |\DeclareLanguageMapping| and |\addbibresource| commands will need +% load the \textsf{biblatex} package with the following option: +% style=apa; however, the |\addbibresource| command will need % to be specified by the user within the document preamble. In the % absence of bibliographic options, \textsf{apa7} will mask references % using \textsf{biblatex} commands if the |mask| option is specified. @@ -915,8 +916,7 @@ and the derived files apa7.ins, \usepackage[american]{babel} \usepackage{csquotes} - \usepackage[style=apa,sortcites=true,sorting=nyt,backend=biber]{biblatex} - \DeclareLanguageMapping{american}{american-apa} + \usepackage[style=apa,backend=biber]{biblatex} \addbibresource{bibliography.bib} \title{Sample APA-Style Document Using the \textsf{apa7} Package} @@ -1235,7 +1235,7 @@ and the derived files apa7.ins, \ClassInfo{apa7}{No bibliography package was specified; defaulting to (but not loading) Biblatex} }{% \def\def@biblatex{\@biblatexmode}% the selected bibliography package is Biblatex - \RequirePackage[style=apa,sortcites=true,sorting=nyt,backend=biber]{biblatex} + \RequirePackage[style=apa,backend=biber]{biblatex} \@ifundefined{def@man}{% \defbibheading{bibliography}[\refname]{\section*{\normalfont\textbf{#1}}}% }{% @@ -3411,8 +3411,7 @@ and the derived files apa7.ins, \usepackage[american]{babel} \usepackage{csquotes} -\usepackage[style=apa,sortcites=true,sorting=nyt,backend=biber]{biblatex} -\DeclareLanguageMapping{american}{american-apa} +\usepackage[style=apa,backend=biber]{biblatex} \addbibresource{bibliography.bib} \title{Sample APA-Style Document Using the \textsf{apa7} Package} @@ -3528,8 +3527,7 @@ skill in interpreting the results for the masses. \usepackage[american]{babel} \usepackage{csquotes} -\usepackage[style=apa,sortcites=true,sorting=nyt,backend=biber]{biblatex} -\DeclareLanguageMapping{american}{american-apa} +\usepackage[style=apa,backend=biber]{biblatex} \addbibresource{bibliography.bib} \title{Sample APA-Style Document Using the \textsf{apa7} Package} diff --git a/macros/latex/contrib/apa7/apa7.pdf b/macros/latex/contrib/apa7/apa7.pdf Binary files differindex 342cc96d43..fcfd0c2041 100644 --- a/macros/latex/contrib/apa7/apa7.pdf +++ b/macros/latex/contrib/apa7/apa7.pdf diff --git a/macros/latex/contrib/apa7/samples/longsample.pdf b/macros/latex/contrib/apa7/samples/longsample.pdf Binary files differindex 52c3461ee0..35f4b63630 100644 --- a/macros/latex/contrib/apa7/samples/longsample.pdf +++ b/macros/latex/contrib/apa7/samples/longsample.pdf diff --git a/macros/latex/contrib/apa7/samples/shortsample.pdf b/macros/latex/contrib/apa7/samples/shortsample.pdf Binary files differindex 63b1d5be79..135d919beb 100644 --- a/macros/latex/contrib/apa7/samples/shortsample.pdf +++ b/macros/latex/contrib/apa7/samples/shortsample.pdf diff --git a/macros/latex/contrib/fontsize/fontsize.dtx b/macros/latex/contrib/fontsize/fontsize.dtx index b13a571f55..a7a75d6db6 100644 --- a/macros/latex/contrib/fontsize/fontsize.dtx +++ b/macros/latex/contrib/fontsize/fontsize.dtx @@ -56,14 +56,15 @@ This work has the LPPL maintenance status "author-maintained". %<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01] %<package>\ProvidesPackage{fontsize} %<*package> - [2021/02/10 v0.7 'fontsize' package. Set main font sizes (Ivan Valbusa)] + [2021/03/04 v0.8 'fontsize' package. Set main font sizes (Ivan Valbusa)] %</package> %<*driver> \documentclass[12pt]{ltxdoc} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc} \usepackage[fontsize=12pt]{fontsize} -\usepackage{array,booktabs,siunitx,tabu} +\usepackage{array,booktabs,tabu} +\usepackage{siunitx} \usepackage{multicol} %-------------------------------------------------------- % GRAPHICS @@ -214,6 +215,7 @@ This work has the LPPL maintenance status "author-maintained". % Right brace \} Tilde \~} % % +% \changes{v0.8}{2021/03/04}{Corrected a bug occuring when the line spacing is grater than \SI{163.84}{pt}.} % \changes{v0.7}{2021/02/10}{New font sizing commands \cmd{HUGE}, \cmd{HUGEr}, \cmd{HUGErr}, \cmd{HUGErrr}. Changed default name for the \file{.clo} file to \opt{fontsize}. Updated documentation.} % \changes{v0.6}{2021/02/06}{New font sizing commands from \cmd{small} down. Updated documentation.} % \changes{v0.5}{2021/01/31}{New font sizing commands from \cmd{normalsize} up. New command \cmd{printsamples}. Updated documentation.} @@ -260,8 +262,18 @@ This work has the LPPL maintenance status "author-maintained". %}; % \end{tikzpicture} % \clearpage\thispagestyle{empty} +% \null\vspace{1cm} % -% \null\vfill +%\hfill\begin{minipage}{.5\textwidth} +% \raggedleft\footnotesize +% The serif typeface is Cochineal, created by Michael Sharpe +% on the basis of Sebastian Kosch's Crimson. +% The \texttt{typewriter} font is Inconsolata, +% designed by Raph Levien and the \textsf{sans serif} text +% is typeset in Linux Biolinum, created by Philipp H.~Pol. +%\end{minipage} +% +% \vfill % % ^^A ---------------------------------------------------------------- % ^^A @@ -274,7 +286,7 @@ This work has the LPPL maintenance status "author-maintained". % % \noindent This package is author-maintained. % Permission is granted to copy, distribute and/or modify this software -% under the terms of the \LaTeX{} Project Public License, version 1.3 or +% under the terms of the \hologo{LaTeX} Project Public License, version 1.3 or % later (\url{http://latex-project.org/lppl}). % This software is provided ``as is'', without warranty of any kind, % either expressed or implied, including, but not limited to, the implied @@ -429,10 +441,14 @@ This work has the LPPL maintenance status "author-maintained". %^^A Defines the \meta{text} to be used by \cmd{printsamples}. % % \end{ltxsyntax} +% %^^A--------------------------------------------------------------------- -% \section{New font sizing commands}\label{sec:sizingcmd} +% \subsection{New font sizing commands}\label{sec:sizingcmd} %^^A-------------------------------------------------------------------- -% The package provides three additional font sizing commands for each standard size: +% +% The package provides three additional font sizing commands for each standard size. +% The value of these new sizes (rounded to the second decimal place) are shown in +% table \ref{tab:sizes}. % \medskip % %\def\fshw{Lipsum} @@ -489,11 +505,17 @@ This work has the LPPL maintenance status "author-maintained". % } %\medskip % -% \begin{normalsize} +% \begin{footnotesize} %\alert If you want these commands to work as expected, the font must be -% smoothly scalable. This is the case of many Type 1 and Open Type fonts. -% Anyway, if the font has optical sizes, unusual things can happen: -% some larger sizes may appear smaller. For example, with the Latin Modern 12\,pt typeface a similar situation can be encountered:\medskip +% smoothly scalable. +% This is the case of many Type 1 and Open Type fonts such as Cochineal +% used in this document \parencite{cochineal}, but +% if the font has optical sizes, unusual things can happen: +% some larger sizes may appear smaller. In any case, with the \LaTeX\ +% default font (i.e. Computer Modern) I recommend loading +% \cmd{RequirePackage}|{fix-cm}| just before \cmd{documentclass}. +% For example, with the Latin Modern 12\,pt typeface \parencite{lm} +% a similar situation can be encountered:\medskip % % \begingroup % \centering @@ -509,7 +531,6 @@ This work has the LPPL maintenance status "author-maintained". % \scalebox{3}{\large H} \scalebox{3}{\larger H} \scalebox{3}{\largerr H} % % \endgroup -% \end{normalsize} % \medskip % % In fact the font used for the \cmd{larger} `Hello world' is bigger than @@ -517,7 +538,9 @@ This work has the LPPL maintenance status "author-maintained". % thickness of the stems, which makes the words appear shorter and clearer, % but not less high (as you can see in the figure on the % right which shows the letter H appropriately scaled to see the -% differences better). +% differences better). +% +% \end{footnotesize} % % \clearpage\thispagestyle{empty} % \def\ivalbmidrule{\arrayrulecolor{black!40}\midrule\rowfont{\color{philA}}} @@ -526,7 +549,7 @@ This work has the LPPL maintenance status "author-maintained". % \centering % \centerline{% % \begin{tabu}{lSSSSSSSSS} -%\toprule +%\toprule\rowfont{\color{philA}} % \tcmd{tiny} & 4.00 & 4.25 & 4.50 & 4.75 & 5.00 & 5.25 & 5.50 & 5.75 & 6.00 \\ % \cmd{tinyr} & 4.33 & 4.60 & 4.88 & 5.15 & 5.42 & 5.69 & 5.96 & 6.23 & 6.50 \\ % \cmd{tinyrr} & 4.67 & 4.96 & 5.25 & 5.54 & 5.83 & 6.12 & 6.42 & 6.71 & 7.00 \\ @@ -589,18 +612,14 @@ This work has the LPPL maintenance status "author-maintained". %\clearpage\thispagestyle{plain} % %^^A--------------------------------------------------------------------- +% % \section{Some text samples}\label{sec:example} % %^^A-------------------------------------------------------------------- % The following examples are obtained with the \cmd{printsamples} command (see section \ref{sec:commands}). % -%^^A Below you can see some text samples scaled proportionally -%^^A to match the different values of the selected normal size and line spacing. -% % \printsamples{13.2pt}{11.2pt}[normalsizer,normalsizerr,normalsizerrr,large,larger] % \printsamples{13.4pt}{11.7pt}[normalsizer,normalsizerr,normalsizerrr,large,larger] -% -% \nocite{xkeyval,etoolbox} % % \StopEventually{% % \printbibliography[heading=bibintoc] @@ -614,7 +633,7 @@ This work has the LPPL maintenance status "author-maintained". %^^A--------------------------------------------------------------------- %\textcolor{DarkBlue}{The parts added to the basic code of \file{scrextend} and \file{scrfontsizes} are highlighted in blue.} % -%\noindent All the options of the package are defined via \sty{xkeyval}. +%\noindent All the options of the package are defined via \sty{xkeyval} \parencite{xkeyval}. Only a new package option called \opt{cloname} is defined. % \baddition % \begin{macrocode} \@ifpackageloaded{xkeyval}{}{\RequirePackage{xkeyval}} @@ -624,7 +643,8 @@ This work has the LPPL maintenance status "author-maintained". % % \paragraph{Excerpt from \file{scrextend.sty}} % -% Here the \sty{scrextend} code begins. Only a few names have been changed. +% Here the \sty{scrextend} code begins. All the KOMA related codes have +% been removed and only a few names have been changed. % The value of \cmd{|@|fontsizefilebase} is set to \texttt{fontsize} instead of \texttt{scrsize}. % \begin{macrocode} \DeclareOptionX{fontsize}[10]{% @@ -700,7 +720,25 @@ This work has the LPPL maintenance status "author-maintained". \addtolength{\@tempdimc}{-10\p@}% \edef\@ptsize{\strip@pt\@tempdimc}% \@defaultunits\@tempdimb#1pt\relax\@nnil - \setlength{\@tempdimc}{\dimexpr (100\@tempdimb / \@tempdima * \p@)}% +% \end{macrocode} +% The value of \cmd{@tempdimc} set in \sty{scrextend.sty} +% \begin{center}\footnotesize +% |\setlength{\@tempdimc}{\dimexpr (100\@tempdimb / \@tempdima * \p@)}| +% \end{center} +% returns an error when the the line spacing is greater than \SI{163.84}{pt} +% or the value passed to the \opt{fontsize} option is grater than \SI{136.53}{pt}. +% This is due to the intermediate calculation: +% $100 \verb!\@tempdimb! = \SI{16384}{pt}$, which is +% the maximum dimension that may be stored in plain +% \TeX\ and \LaTeX. +% The problem, which is probably more theoretical than practical, +% can be solved simply by changing it to this (thanks to Claudio Beccari): +% \baddition +% \begin{macrocode} + \setlength{\@tempdimc}{100\dimexpr (\@tempdimb * \p@ / \@tempdima)} +% \end{macrocode} +% \eaddition +% \begin{macrocode} \edef\@tempb{\the\@tempdimc}% \setlength{\@tempdimc}{\@tempdima}% \def\@tempa##1##2##3##4##5\@nnil{\def##1{##2.##3##4}}% @@ -1075,19 +1113,19 @@ This work has the LPPL maintenance status "author-maintained". \noexpand\@setfontsize\noexpand\HUGE {\the\@tempdima}{\the\@tempdimb}% }% - \setlength{\@tempdima}{3,155\@tempdimc}% + \setlength{\@tempdima}{3.155\@tempdimc}% \setlength{\@tempdimb}{\@tempb\@tempdima}% \edef\HUGEr{% \noexpand\@setfontsize\noexpand\HUGEr {\the\@tempdima}{\the\@tempdimb}% }% - \setlength{\@tempdima}{3,304\@tempdimc}% + \setlength{\@tempdima}{3.304\@tempdimc}% \setlength{\@tempdimb}{\@tempb\@tempdima}% \edef\HUGErr{% \noexpand\@setfontsize\noexpand\HUGErr {\the\@tempdima}{\the\@tempdimb}% }% - \setlength{\@tempdima}{3,453\@tempdimc}% + \setlength{\@tempdima}{3.453\@tempdimc}% \setlength{\@tempdimb}{\@tempb\@tempdima}% \edef\HUGErrr{% \noexpand\@setfontsize\noexpand\HUGErrr @@ -1266,7 +1304,7 @@ This work has the LPPL maintenance status "author-maintained". % % \paragraph{Excerpt from \file{scrfontsizes.sty}} % -% Here is a portion of the \sty{scrfontsizes} package. It simply provides the \cmd{generateclofile} command, without the KOMA-related definitions. There are no reserved names for the \file{.clo} files. The command name is a new name for the KOMA \cmd{generatefontfile}. In fact what the command generates is a \file{.clo} file. +% Here is a portion of the \sty{scrfontsizes} package. It simply provides the \cmd{generateclofile} command, without the KOMA related definitions. There are no reserved names for the \file{.clo} files. The command name is a new name for the KOMA \cmd{generatefontfile}. In fact what the command generates is a \file{.clo} file. % \begin{macrocode} \newcommand*{\generateclofile}[1]{% \kernel@ifnextchar [{\@generatefontfile{#1}}{\@@generatefontfile{#1}}% @@ -1850,7 +1888,8 @@ This work has the LPPL maintenance status "author-maintained". % \end{macrocode} % We will now define some internal commands to test the package functions. % Since version 0.6 I have been using the \LaTeX 3 solution provided by -% Enrico Gregorio in place of the previous macros based on \sty{etoolbox}. +% Enrico Gregorio in place of the previous macros based on +% \sty{etoolbox} \parencite{etoolbox}. % \baddition % \begin{macrocode} \def\fontsizelipsum{% @@ -1951,6 +1990,24 @@ This work has the LPPL maintenance status "author-maintained". date = {2020-04-19}, version = {3.30} } + +@manual{lm, + title = {The Latin Modern (LM) Family of Fonts}, + author = {B. Jackowski and J.M. Nowacki}, + url = {http://www.ctan.org/pkg/lm}, + urldate = {2021-03-04}, + date = {2009-10-30}, + version = {2.004} +} + +@manual{cochineal, + title = {The Cochineal Font Package}, + author = {Michael Sharpe}, + url = {http://www.ctan.org/pkg/cochineal}, + urldate = {2021-03-04}, + date = {2020-12-19}, + version = {1.065 } +} %</bib> % \fi % \Finale diff --git a/macros/latex/contrib/fontsize/fontsize.pdf b/macros/latex/contrib/fontsize/fontsize.pdf Binary files differindex e869a963f4..5642de57f8 100644 --- a/macros/latex/contrib/fontsize/fontsize.pdf +++ b/macros/latex/contrib/fontsize/fontsize.pdf diff --git a/macros/latex/contrib/lipsum/README.txt b/macros/latex/contrib/lipsum/README.txt index 455ea0f1fb..6cd309b680 100644 --- a/macros/latex/contrib/lipsum/README.txt +++ b/macros/latex/contrib/lipsum/README.txt @@ -1,9 +1,11 @@ -lipsum +lipsum Access to 150 paragraphs of ``Lorem ipsum'' dummy text. Patrick Happel (patrick.happel@rub.de) -https://github.com/patta42/lipsum + +Currently maintained by Phelype Oleinik +https://github.com/PhelypeOleinik/lipsum ============================================================ @@ -13,7 +15,7 @@ https://github.com/patta42/lipsum -------------------------- lipsum.dtx - lipsum.ins + lipsum.ins lipsum.pdf README.txt (this file) @@ -25,39 +27,39 @@ https://github.com/patta42/lipsum - Run lipsum.ins through latex - Move the resulting .sty file and the resulting .ltd.tex files - to a place where latex finds it. - On a TDS compliant system this should be (substitute $TEXMF + to a place where latex finds it. + On a TDS compliant system this should be (substitute $TEXMF with your local or home texmf directory): - + $TEXMF/tex/latex/lipsum/ - - If you want to produce your own documentation file (maybe + - If you want to produce your own documentation file (maybe dvi instead of pdf) run lipsum.dtx through latex. - - Move the documentation (lipsum.pdf, if you haven't produced - your own file in a different format) in a TDS compliant + - Move the documentation (lipsum.pdf, if you haven't produced + your own file in a different format) in a TDS compliant system to: - $TEXMF/doc/latex/lipsum + $TEXMF/doc/latex/lipsum - If you like to, move the source files (.dtx and .ins) in a source directory of your system. - - - Update your filename database. How to achieve this depends + + - Update your filename database. How to achieve this depends on your system. For teTeX and texlive, `texhash' will work. - - If you are using a non TDS compliant system take a look in + - If you are using a non TDS compliant system take a look in the documentation how to install new packages. 3. License -------------------------- -This material is subject to the LaTeX Project Public License 1.3. See - +This material is subject to the LaTeX Project Public License 1.3. See + https://www.latex-project.org/lppl/ -for the details of that license. +for the details of that license. diff --git a/macros/latex/contrib/lipsum/lipsum.dtx b/macros/latex/contrib/lipsum/lipsum.dtx index 9160311869..233b5c359e 100644 --- a/macros/latex/contrib/lipsum/lipsum.dtx +++ b/macros/latex/contrib/lipsum/lipsum.dtx @@ -12,15 +12,17 @@ % and version 1.3 or later is part of all distributions of LaTeX % version 2005/12/01 or later. % -% Please send error reports and suggestions for improvements to -% Patrick Happel <patrick.happel@rub.de>. -% -% Alternatively, use github: -% https://github.com/patta42/lipsum +% Please send error reports and suggestions for improvements to +% https://github.com/PhelypeOleinik/lipsum % +\def\lipsumversion{2.3} +\def\lipsumdate{2021-03-03} %<*driver> -\ProvidesFile{lipsum.dtx}[2019/01/02 v2.2 Access to 150 of Lorem Ipsum dummy text] +\ProvidesFile{lipsum.dtx}% + [\lipsumdate\space v\lipsumversion\space + Access to 150 of Lorem Ipsum dummy text] \documentclass{l3doc} +\usepackage{xcolor} \usepackage[a4paper, top=2cm, left=8.8cm, right=2cm, bottom=3cm, marginparwidth=6.3cm, marginparsep=.5cm, @@ -35,13 +37,13 @@ middlelinewidth=0pt } \newmdenv[style=expl]{explbox} - + \newmdenv[% style=expl, subtitlebackgroundcolor=yellow!5!white, frametitlebackgroundcolor=yellow!5!white, frametitle={Code}, -] {exploutputbox} +] {exploutputbox} \usepackage{lipsum,multicol} \usepackage[latin, english]{babel} @@ -52,7 +54,7 @@ \renewcommand\maketitle[1]{ \noindent \hspace{-\fullmargin}% - \begin{minipage}{\textwidth+\fullmargin} + \begin{minipage}{\textwidth+\fullmargin} \renewcommand\thefootnote{\fnsymbol{footnote}} \let\thanks\footnote { @@ -111,23 +113,30 @@ \RequirePackage{xparse} \ProvidesExplPackage {lipsum} - {2019/01/02} - {2.2} + {\lipsumdate} + {\lipsumversion} {150 paragraphs of Lorem Ipsum dummy text} %</package> %<*lipsum> -\ProvidesFile{lipsum.ltd.tex}[2019/01/02 v2.2 The Lorem ipsum dummy text] +\ProvidesFile{lipsum.ltd.tex}% + [\lipsumdate\space v\lipsumversion\space + The Lorem ipsum dummy text] %</lipsum> %<*cicero> -\ProvidesFile{cicero.ltd.tex}[2019/01/02 v2.2 Text of Cicero's speech] +\ProvidesFile{cicero.ltd.tex}% + [\lipsumdate\space v\lipsumversion\space + Text of Cicero's speech] -%</cicero> +%</cicero> % \fi % % \title{\pkg{lipsum}} % \subtitle{Access to 150 paragraphs of Lorem Ipsum dummy -% text\thanks{Version: 2.2}} +% text\thanks{Version: \lipsumversion}^^A +% \thanks{Since March 2021, Phelype Oleinik maintains this package +% (\href{mailto:phelype.oleinik@latex-project.org} +% {phelype.oleinik\meta{at}latex-project.org}).}} % \author{Patrick Happel\thanks{patrick.happel@rub.de}} % \date{\today} % \RecordChanges @@ -139,7 +148,7 @@ % \changes{v1.3}{2014/07/19}{Introduced some improvements and provided some % new macros (thanks to tex.stackexchange user egreg).} % \changes{v1.3a}{2017/08/10}{Fixed a type in the documentation (thanks to -% Vincent Belaïche). This version never made its way on CTAN due to some +% Vincent Belaïche). This version never made its way on CTAN due to some % version naming conflicts. Since the change here was only in the % documentation, I first didn't want it to be 1.3a and later had no time to % update it properly.} @@ -153,6 +162,9 @@ % \changes{v2.2}{2018/12/25}{replaced \cs{tex_par:D} by \cs{par} to avoid % incompatibilities with \LaTeX2e's |list|-environment. Thanks to Karl Hagen % for reporting. See \url{ttps://github.com/patta42/lipsum/issues/12}.} +% \changes{v2.3}{2021/03/03}{Remove dependency on an \pkg{xparse} internal +% macro. \pkg{lipsum}'s new home at +% \url{https://github.com/PhelypeOleinik/lipsum}} % % \maketitle{\pkg{lipsum} is a \LaTeX{} package that produces dummy text % to be used in test documents or examples. The paragraphs are taken with @@ -164,16 +176,16 @@ % % \hspace{1em} Please, file bug reports, typos in the documentation or % feature requests as an issue on -% \url{https://github.com/patta42/lipsum/issues}.} +% \url{https://github.com/PhelypeOleinik/lipsum/issues}.} % \begin{documentation} % % \section{Quick usage overview} -% To load the package specify +% To load the package specify % \begin{verbatim} % \usepackage{lipsum} % \end{verbatim} % in the preamble of your document. This package provides several -% macros. \DescribeMacro{\lipsum}The most important one is +% macros. \DescribeMacro{\lipsum}The most important one is % \cs{lipsum}. This macro typesets the \emph{Lorem ipsum} % paragraphs. It has two optional arguments. The first one allows to specify the range % of the paragraphs. For example, \verb|\lipsum[4-57]| typesets the paragraphs 4 to @@ -187,7 +199,7 @@ % % \section{Foreword to Version 2.0}\label{sec:foreword2.0} % Version 2.0 of \pkg{lipsum} is a complete (well, nearly complete) rewrite -% of the code in \pkg{expl3} +% of the code in \pkg{expl3} % syntax. I have never used \pkg{expl3} before and thus the code might be too % complicated, might use wrong or badly chosen data types or weird function % names. I am happy to receive comments on this. @@ -198,7 +210,7 @@ % documents is not a big issue here. The changes are: % \begin{itemize} % \item The package option \opt{nopar} now uses a \cs{space} as terminator, -% instead of \cs{relax}. +% instead of \cs{relax}. % \item The commands \cs{UnpackLipsum} and \cs{UnpackLipsum*} are no longer % available. The effect of \cs{UnpackLipsum} now is default for % \cs{unpacklipsum} (or \cs{unpacklipsum*}, depending on the package @@ -213,8 +225,8 @@ % % \begin{document} % \renewcommand\foo{\color{.!75!red}} -% { \lipsumexp } -% +% { \lipsumexp } +% % \newcounter{mycnt}\setcounter{mycnt}{1} % \renewcommand\foo{% % (\themycnt)\stepcounter{mycnt}} @@ -232,15 +244,15 @@ % \section{Foreword to version 2.2} % As of version 2.2, \pkg{lipsum} provides a simple interface to define other % texts to be used as output of the \cs{lipsum}-family of commands. This was -% heavily inspired by an issue raised by +% heavily inspired by an issue raised by % \emph{svenper} on % github\footnote{\url{https://github.com/patta42/lipsum/issues/13}}. However, % the implementation of this interface might not match the needs of everyone % who wants to provide a dummy text in another language. Comments and -% suggestions on this are very welcome. +% suggestions on this are very welcome. +% +% Please note that the documentation still only refers to the \lips-text. % -% Please note that the documentation still only refers to the \lips-text. -% % \section{Usage} % \pkg{lipsum} was intended to quickly provide a way to fill a page or two to % analyze the page @@ -258,7 +270,7 @@ % \item[\opt{nopar}:] Instead of \cs{par}, \cs{space} is used to % separate the paragraphs. % \end{description} -% +% % \subsection{User Commands} % \DescribeMacro{\lipsum}\DescribeMacro{\lipsum*} % \begin{quote} @@ -276,7 +288,7 @@ % below). \cs{lipsum} terminates every paragraph depending on the package % option (using \cs{par} is the default). \cs{lipsum*} does the same, but % uses a different termination (default is to use a blank space) for each -% paragraph. \emph{As a simplified rule of thumb, \cs{lipsum} prints the +% paragraph. \emph{As a simplified rule of thumb, \cs{lipsum} prints the % paragraphs as multiple paragraphs, \cs{lipsum*} prints them as a single % paragraph}. % @@ -286,7 +298,7 @@ % |\lipsum*[9-12]|, which will output the paragraphs nine to % twelve. \pkg{lipsum} provides 150 paragraphs of \lips\, thus |150| is the % maximum that should be specified. -% +% % \subsection{Outputting Sentences instead of Paragraphs} % Starting with \pkg{lipsum} v2.0, \cs{lipsum} and \cs{lipsum*} allow to % output sentences of the \lips\ dummy text instead of paragraphs. To retrieve @@ -318,7 +330,7 @@ % sentences since paragraph \#104 consists only of 10 sentences. For the % same reason, |\lipsum[104][11-20]| will output nothing. % \item If you need a lot of sentences, consider the \opt{space} option and -% |\lipsum[1-150]|. This should be faster. +% |\lipsum[1-150]|. This should be faster. % \end{itemize} % % \section{Advanced or Developer Macros} @@ -333,7 +345,7 @@ % % \DescribeMacro{\SetLipsumDefault} In order to change the default range of % paragraphs that is used by \cs{lipsum} and friends, specify -% |\SetLipsumDefault{8}| or |\SetLipsumDefault{123-145}|. +% |\SetLipsumDefault{8}| or |\SetLipsumDefault{123-145}|. % % \DescribeMacro{\LipsumPar} To get a single paragraph of the \lips\ dummy % text, use |\LipsumPar{8}| (for the eighth paragraph). This is similar to @@ -397,8 +409,8 @@ % lists of sentences (also indicated by the labelled arrows in the middle). } % \label{fig:tokens} % \end{multicols} -% -% +% +% % \end{widefigure} % \DescribeMacro{\SetLipsumParListStart}\DescribeMacro{\SetLipsumParListStart*} % \DescribeMacro{\SetLipsumParListEnd}\DescribeMacro{\SetLipsumParListEnd*} @@ -407,13 +419,13 @@ % \pkg{lipsum} allows to specify all of the tokens in the list indicated % above except for the item-specific inner and outer \meta{items} (shown as % \meta{item_N_,_s-outer/inner}, \meta{item_N_,_e-outer/inner} above), which -% remain to be implemented. +% remain to be implemented. % % The macros that enable setting these tokens are all available in a normal -% and in a starred version, they apply to \cs{lipsum} and \cs{unpacklipsum} or -% \cs{lipsum*} and \cs{unpacklipsum*}, respectively. +% and in a starred version, they apply to \cs{lipsum} and \cs{unpacklipsum} or +% \cs{lipsum*} and \cs{unpacklipsum*}, respectively. +% % -% % The macro \cs{SetLipsumParListStart}\Arg{tokens} and its starred variant % insert \meta{tokens} at the very beginning of the list of paragraphs % (\meta{list_s} in Figure~\ref{fig:tokens}). \cs{SetLipsumSentenceListStart} @@ -451,12 +463,12 @@ % commands that allow to set a pair of \meta{tokens} to surround every item: % \begin{macrolist} % \item \cs{SetLipsumParListItemSurrounders}\Arg{start}\Arg{end}\DescribeMacro{\SetLipsumParListItemSurrounders} -% \item \cs{SetLipsumParListItemSurrounders*}\Arg{start}\Arg{end}\DescribeMacro{\SetLipsumParListItemSurrounders*} +% \item \cs{SetLipsumParListItemSurrounders*}\Arg{start}\Arg{end}\DescribeMacro{\SetLipsumParListItemSurrounders*} % \item \cs{SetLipsumSentenceListItemSurrounders}\Arg{start}\Arg{end}\DescribeMacro{\SetLipsumSentenceListItemSurrounders} % \item \DescribeMacro{\SetLipsumSentenceListItemSurrounders*} \cs{SetLipsumSentenceListItemSurrounders*}\Arg{start}\Arg{end} -% +% % \end{macrolist} -% +% % \DescribeMacro{\SetLipsumParListItemSeparator} % \DescribeMacro{\SetLipsumParListItemSeparator*} % \DescribeMacro{\SetLipsumSentenceListItemSeparator} @@ -478,7 +490,7 @@ % \begin{widefigure} % \begin{exploutputbox} % \begin{verbatim} -% +% % \SetLipsumSentenceListSurrounders{\begin{itemize}}{\end{itemize}} % \SetLipsumSentenceListItemStart{\item} % \lipsum[10][1-2] @@ -503,7 +515,7 @@ % \cs{LipsumRestoreParList} (for lists of paragraphs), % \DescribeMacro{\LipsumRestoreSentenceList} \cs{LipsumRestoreSentenceList} (for lists of % sentences) and \DescribeMacro{\LipsumRestoreAll} \cs{LipsumRestoreAll} for -% both lists. +% both lists. % \begin{widefigure} % \begin{exploutputbox} % \begin{verbatim} @@ -572,7 +584,7 @@ % \mdfsubtitle{Output} % \lipsum[1][1] % \MakePercentComment\SetLipsumText{cicero}\MakePercentIgnore -% \selectlanguage{latin} +% \selectlanguage{latin} % \hspace*{1em}\lipsum[1] % \end{exploutputbox} % \MakePercentComment\SetLipsumText{lipsum}\MakePercentIgnore @@ -607,7 +619,7 @@ % \begin{verbatim} % \ProvidesPackage{mydummytext} % \RequirePackage{lipsum} -% \SetLipsumText{mydummytext} +% \SetLipsumText{mydummytext} % \end{verbatim} % To make the text accesible via a command \cs{mydummytext}, simply use % \cs{let} to copy the definition of \cs{lipsum}: @@ -655,36 +667,25 @@ % can either be a range as specified above, or a token list containing a % range. Thus, the argument has to be expanded before it is analyzed. This use % case is not available in \pkg{xparse} (at least not in the release -% 2018-10-17). Thus, we have to touch \pkg{xparse}'s internal and generate -% such a variant. We copy it to a \pkg{lipsum} internal variant to avoid name -% clashes with future versions of \pkg{xparse}. -% \begin{function}{\__lipsum_split_argument_expanded:nne -% ,\__xparse_split_argument:nne} +% 2018-10-17). We copy it to a \pkg{lipsum} internal variant to be able to +% generate a variant. +% \begin{function}{\@@_split_argument_expanded:nnn +% ,\@@_split_argument_expanded:nne} % \begin{syntax} -% \cs{__lipsum_split_argument_expanded:nne}\Arg{number}\Arg{token}\Arg{argument} +% \cs{@@_split_argument_expanded:nne}\Arg{number}\Arg{token}\Arg{argument} % \end{syntax} % \begin{arguments} % \item See documentation for \cs{SplitArgument} in % \pkg{xparse} -% \item See documentation for \cs{SplitArgument} in -% \pkg{xparse} % \item The argument fed to the function, which is expanded -% in this case +% in this case. % \end{arguments} % \begin{macrocode} -\cs_generate_variant:Nn \__xparse_split_argument:nnn {nne} -\cs_new_eq:NN - \__lipsum_split_argument_expanded:nne - \__xparse_split_argument:nne +\cs_new_eq:NN \@@_split_argument_expanded:nnn \SplitArgument +\cs_generate_variant:Nn \@@_split_argument_expanded:nnn { nne } % \end{macrocode} % \end{function} -% \begin{function}{str_if_eq:VnTF} -% Allows to compare a string value and a string: -% \begin{macrocode} -\cs_generate_variant:Nn \str_if_eq:nnTF {VnTF} -% \end{macrocode} -% \end{function} -% +% % \subsection{Messages} % Starting from \pkg{lipsum}2.0, some commands from previous versions are % considered deprecated and issue a warning when used. This is the @@ -699,48 +700,48 @@ \string#1~might~not~be~available~in~a~ future~version~of~lipsum.sty.} % \end{macrocode} -% +% % \subsection{Variables} -% \begin{variable}{\g_lipsum_paragraph_seq} +% \begin{variable}{\g_@@_paragraph_seq} % The sequence that stores all the paragraphs. % \begin{macrocode} -\seq_new:N\g_lipsum_paragraph_seq +\seq_new:N\g_@@_paragraph_seq % \end{macrocode} % \end{variable} % \begin{variable}{\g_lipsum_default_range_tl} % The default range for lipsum paragraphs. % \begin{macrocode} -\tl_new:N \g_lipsum_default_range_tl % +\tl_new:N \g_lipsum_default_range_tl % % \end{macrocode} % \end{variable} -% \begin{variable}{\l__lipsum_pars_tl} +% \begin{variable}{\l_@@_pars_tl} % This variables is used to store the token list containing the selected paragraphs. % \begin{macrocode} -\tl_new:N \l__lipsum_pars_tl +\tl_new:N \l_@@_pars_tl % \end{macrocode} % \end{variable} -% \begin{variable}{\l__lipsum_sentences_tl} +% \begin{variable}{\l_@@_sentences_tl} % This variables is used to store the token list containing the selected sentences. % \begin{macrocode} -\tl_new:N \l__lipsum_sentences_tl +\tl_new:N \l_@@_sentences_tl % \end{macrocode} % \end{variable} -% \begin{variable}{ -% \l__lipsum_sentences_seq +% \begin{variable}{ +% \l_@@_sentences_seq % } -% In this sequence, the sentence list is stored. +% In this sequence, the sentence list is stored. % \begin{macrocode} -\seq_new:N \l__lipsum_sentences_seq +\seq_new:N \l_@@_sentences_seq % \end{macrocode} % \end{variable} % \begin{variable}{\l_@@_par_list_start_nostar_tl, % \l_@@_par_list_end_nostar_tl, \l_@@_sentence_list_start_nostar_tl, % \l_@@_sentence_list_end_nostar_tl, \l_@@_par_list_start_star_tl, % \l_@@_par_list_end_star_tl, \l_@@_sentence_star_list_start_tl, -% \l_@@_sentence_star_list_end_tl} +% \l_@@_sentence_star_list_end_tl} % Next are the variables used to store the tokens between the list items for -% lists of paragraph and lists of sentences. -% +% lists of paragraph and lists of sentences. +% % \begin{macrocode} \tl_new:N \l_@@_par_list_start_nostar_tl \tl_new:N \l_@@_par_list_end_nostar_tl @@ -772,7 +773,7 @@ % \l_@@_par_list_itemend_nostar_tl, \l_@@_sentence_list_itemstart_nostar_tl, % \l_@@_sentence_list_itemend_nostar_tl, \l_@@_par_list_itemstart_star_tl, % \l_@@_par_list_itemend_star_tl, \l_@@_sentence_list_itemstart_star_tl, -% \l_@@_sentence_list_itemend_star_tl} +% \l_@@_sentence_list_itemend_star_tl} % The variables that surround each single item of a paragraph or sentence list. % \begin{macrocode} \tl_new:N \l_@@_par_list_itemstart_nostar_tl @@ -787,7 +788,7 @@ % \end{macrocode} % \end{variable} -% \begin{variable}{\l_@@_par_list_start_tl, +% \begin{variable}{\l_@@_par_list_start_tl, % \l_@@_par_list_end_tl, % \l_@@_sentence_list_start_tl, % \l_@@_sentence_list_end_tl, @@ -813,7 +814,7 @@ \tl_new:N\l_@@_sentence_list_itemstart_tl \tl_new:N\l_@@_sentence_list_itemend_tl % \end{macrocode} -% +% % \end{variable} % \begin{variable}{\g_@@_text_str} % Holds the current text loaded for the output of \cs{lipsum} and @@ -822,7 +823,7 @@ \str_new:N\g_@@_text_str % \end{macrocode} % \end{variable} -% +% % \subsection{Developer interface} % \begin{function}{\lipsum_store_as_temp_ints:nn} % \begin{syntax} @@ -853,7 +854,7 @@ % \lipsum_get_terminated_par:n} % These two commands are used to retrieve paragraph \meta{number} from the % \lips\ dummy text. \cs{lipsum_get_terminated_par:n} additionally adds -% \cs{par}. +% \cs{par}. % % \begin{syntax} % \cs{lipsum_get_non_terminated_par:n} \Arg{number}\\ @@ -865,33 +866,33 @@ % paragraphs were stored in \cs{lipsum@i}, \cs{lipsum@ii}, \ldots. % \begin{macrocode} \cs_new:Npn \lipsum_get_non_terminated_par:n #1{ - \seq_item:Nn \g_lipsum_paragraph_seq{#1} + \seq_item:Nn \g_@@_paragraph_seq{#1} } \cs_new:Npn \lipsum_get_terminated_par:n #1 { \lipsum_get_non_terminated_par:n{#1}\par } - + % \end{macrocode} % \end{function} % \begin{function}{\lipsum_add_to_tokenlist:n} % Adds a paragraph \meta{item} to the list of paragraphs % (\cs{l_@@_pars_tl}) and surrounds it by % the user-defined \meta{tokens} -% . +% . % \begin{syntax} % \cs{lipsum_add_to_tokenlist:n}\Arg{number} % \end{syntax} % \begin{macrocode} \cs_new:Npn \lipsum_add_to_tokenlist:n #1 { \tl_put_right:NV - \l__lipsum_pars_tl - \l_@@_par_list_itemstart_tl - \tl_put_right:Nn \l__lipsum_pars_tl { + \l_@@_pars_tl + \l_@@_par_list_itemstart_tl + \tl_put_right:Nn \l_@@_pars_tl { \lipsum_get_non_terminated_par:n{#1} } \tl_put_right:NV - \l__lipsum_pars_tl + \l_@@_pars_tl \l_@@_par_list_itemend_tl } \cs_generate_variant:Nn @@ -903,7 +904,7 @@ % \cs{lipsum_range_to_tokenlist:VV}\Arg{number_1}\Arg{number_2} % \end{syntax} % Adds the paragraphs specified by \meta{number_1} to \meta{number_2} -% to the token list \cs{l_@@_pars_tl}. +% to the token list \cs{l_@@_pars_tl}. % \begin{macrocode} \cs_new:Npn \lipsum_range_to_tokenlist:nn #1#2 { \tl_clear:N \l_@@_pars_tl @@ -921,7 +922,7 @@ \l_@@_pars_tl \l_@@_par_list_itemseparator_tl } - \lipsum_add_to_tokenlist:V {\l_tmpa_int} + \lipsum_add_to_tokenlist:V {\l_tmpa_int} \int_incr:N\l_tmpa_int } \tl_put_right:NV @@ -929,8 +930,8 @@ \l_@@_par_list_end_tl } \cs_generate_variant:Nn - \lipsum_range_to_tokenlist:nn { VV } -% + \lipsum_range_to_tokenlist:nn { VV } +% % \end{macrocode} % \end{function} % \begin{function}{\@@_expanded_paragraphs_terminated_with_space:} @@ -947,9 +948,9 @@ % \end{syntax} % Puts the sentences specified by \meta{sentence range} from the paragraphs % specified by \meta{paragraph range} on the token list -% \cs{l_@@_sentences_tl} and surrounds the \meta{tokens} set by the user. +% \cs{l_@@_sentences_tl} and surrounds the \meta{tokens} set by the user. % \begin{macrocode} -% +% \cs_new:Npn \lipsum_sentences_to_tokenlist:nnn #1#2#3{ % \end{macrocode} % Now, we only need to put the sentences within \meta{sentence range} into @@ -957,8 +958,8 @@ % the token list. % \begin{macrocode} - \tl_clear:N \l__lipsum_sentences_tl - + \tl_clear:N \l_@@_sentences_tl + % \end{macrocode} % Using a regexp turned out to be rather slow for large \meta{paragraph % range}s. Thus, I use a loop similar to the one used by @@ -969,7 +970,7 @@ % \begin{macrocode} \int_compare:nT {#2 >= #1} { - \__lipsum_put_sentence_on_tokenlist:nnnw + \@@_put_sentence_on_tokenlist:nnnw {#1} {#2} {1} @@ -1024,8 +1025,8 @@ \use_none_delimit_by_q_stop:w } { % Not yet list end - \int_compare:nNnTF{#3} > {#2} - { % Counter > End: Leave loop + \int_compare:nNnTF{#3} > {#2} + { % Counter > End: Leave loop \use_none_delimit_by_q_stop:w } { % Counter <= End: Proceed @@ -1037,7 +1038,7 @@ \l_@@_sentences_tl \l_@@_sentence_list_itemseparator_tl } % End Counter < Start true - % Put item on list + % Put item on list \tl_put_right:NV \l_@@_sentences_tl \l_@@_sentence_list_itemstart_tl @@ -1048,7 +1049,7 @@ \l_@@_sentences_tl \l_@@_sentence_list_itemend_tl } % End Counter >= Start: Put item on list - % Call loop again + % Call loop again \exp_args:Nnnf \@@_put_sentence_on_tokenlist:nnnw {#1} @@ -1116,7 +1117,7 @@ % \begin{syntax} % \cs{@@_set_surrounding_tokens_nostar:} % \end{syntax} -% +% % As \cs{@@_set_surrounding_tokens_star:}, but for calls of the non-starred % version of \cs{lipsum} and \cs{unpacklipsum}. % \begin{macrocode} @@ -1177,14 +1178,14 @@ \l_@@_par_list_start_tl{} \tl_set:No \l_@@_par_list_end_tl{} - } + } % \end{macrocode} % \end{function} % \subsection{User- and developer-level commands}\label{sec:code:commands} % \begin{macro}{\NewLipsumPar} % Developer-Level macro to add a paragraph to the dummy text used by % \cs{lipsum} and related commands. To specify a new dummy text, see -% section~\ref{sec:other-texts}. +% section~\ref{sec:other-texts}. % \begin{syntax} % \cs{NewLipsumPar}\Arg{content} % \end{syntax} @@ -1197,7 +1198,7 @@ % \begin{macrocode} \NewDocumentCommand\NewLipsumPar{m}{ - \seq_gput_right:Nn{\g_lipsum_paragraph_seq}{#1} + \seq_gput_right:Nn{\g_@@_paragraph_seq}{#1} } % \end{macrocode} % \end{macro} @@ -1231,7 +1232,7 @@ % % \begin{arguments} % \item \meta{tokens} to be inserted at the beginning of the -% paragraph or sentence list. +% paragraph or sentence list. % \end{arguments} % % \begin{macrocode} @@ -1285,7 +1286,7 @@ \tl_set:No\l_@@_sentence_list_end_star_tl{#2} } { - \tl_set:No\l_@@_sentence_list_end_nostar_tl{#2} + \tl_set:No\l_@@_sentence_list_end_nostar_tl{#2} } } % \end{macrocode} @@ -1407,11 +1408,11 @@ \l_@@_sentence_list_itemend_nostar_tl{#2} } } -% \end{macrocode} +% \end{macrocode} % \end{macro} % \begin{macro}{\SetLipsumParListItemSurrounders, % \SetLipsumParListItemSurrounders*, \SetLipsumSentenceListItemSurrounders, -% \SetLipsumSentenceListItemSurrounders*} +% \SetLipsumSentenceListItemSurrounders*} % Short-hands for setting the \meta{token}s surrounding a single list \meta{item}. % \begin{syntax} % \cs{SetLipsumParListItemSurrounders}\Arg{start}\Arg{end}\\ @@ -1459,12 +1460,12 @@ % \end{syntax} % \begin{arguments} % \item \meta{tokens} to be inserted between two \meta{item}s of a paragraph -% or sentence list. +% or sentence list. % \end{arguments} % \begin{macrocode} \NewDocumentCommand\SetLipsumParListItemSeparator{s+m}{ \IfBooleanTF{#1} - { + { \tl_set:No \l_@@_par_list_itemseparator_star_tl{#2} } @@ -1485,7 +1486,7 @@ } } % \end{macrocode} -% +% % \end{macro} % \begin{macro}{\SetLipsumProtect} % \begin{syntax} @@ -1504,7 +1505,7 @@ % \begin{macro}{\SetLipsumDefault, \setlipsumdefault} % Command to change the default range used by \cs{lipsum} and friends. Note % that the use of \cs{setlipsumdefault} is considered deprecated starting from -% \pkg{lipsum}2.0. +% \pkg{lipsum}2.0. % \begin{syntax} % \cs{SetLipsumDefault}\Arg{range} % \end{syntax} @@ -1530,7 +1531,7 @@ % \end{macrocode} % \end{macro} % The following macros are considered to be user-level commands and thus all -% lower-case. +% lower-case. % \begin{macro}{\lipsum, \lipsum*} % \begin{syntax} % \cs{lipsum}\oarg{paragraph range}\oarg{sentence range} @@ -1575,7 +1576,7 @@ { \lipsum_range_to_tokenlist:VV { \l_tmpa_int }{ \l_tmpb_int } - \tl_use:N \l__lipsum_pars_tl + \tl_use:N \l_@@_pars_tl } { \@@_ensure_parsable_output: @@ -1584,12 +1585,12 @@ \lipsum_store_as_temp_ints:nn #3 \cs_gset_nopar:Nx \@@_expanded_paragraphs_terminated_with_space: - {\tl_use:N\l__lipsum_pars_tl} + {\tl_use:N\l_@@_pars_tl} \lipsum_sentences_to_tokenlist:VVf { \l_tmpa_int } { \l_tmpb_int } - \__lipsum_expanded_paragraphs_terminated_with_space: - \tl_use:N \l__lipsum_sentences_tl + \@@_expanded_paragraphs_terminated_with_space: + \tl_use:N \l_@@_sentences_tl } \group_end: } @@ -1597,13 +1598,13 @@ % \end{macro} % \begin{macro}{\lipsumexp} % The following macros store their results in the macro \cs{lipsumexp}. I -% create it first using \pkg{xparss} before it is overwritten. Don't know if +% create it first using \pkg{xparse} before it is overwritten. Don't know if % this makes sense. % \begin{macrocode} \NewDocumentCommand\lipsumexp{}{} % \end{macrocode} % \end{macro} -% +% % \begin{macro}{\unpacklipsum, \unpacklipsum*} % These two commands do the same as \cs{lipsum} and \cs{lipsum*}, but instead % of typesetting the paragraphs or sentences, they store the expanded content @@ -1611,7 +1612,7 @@ % \opt{space} or by using the \cs{SetLipsum...List} commands, the % corresponding \meta{tokens} between the single items of the list are % expandable, they are expanded. If they arenot expandable, they are---of -% course---not. +% course---not. % \begin{syntax} % \cs{unpacklipsum}\oarg{paragraph range}\oarg{sentence range}\\ % \cs{unpacklipsum*}\oarg{paragraph range}\oarg{sentence range}\\ @@ -1619,18 +1620,18 @@ % \cs{lipsumexp} % \end{syntax} % \begin{macrocode} -\cs_new:Nn \__lipsum_expanded: {} +\cs_new:Nn \@@_expanded: {} \NewDocumentCommand \unpacklipsum { s - >{\__lipsum_split_argument_expanded:nne{1}{-}} + >{\@@_split_argument_expanded:nne{1}{-}} O{\g_lipsum_default_range_tl} - >{\__lipsum_split_argument_expanded:nne{1}{-}} + >{\@@_split_argument_expanded:nne{1}{-}} o } { - + \group_begin: \lipsum_store_as_temp_ints:nn #2 \IfBooleanTF {#1} @@ -1645,9 +1646,9 @@ \lipsum_range_to_tokenlist:VV { \l_tmpa_int } { \l_tmpb_int } \cs_gset:Nx - \__lipsum_expanded: {\tl_use:N\l__lipsum_pars_tl} + \@@_expanded: {\tl_use:N\l_@@_pars_tl} \cs_gset_eq:NN - \lipsumexp \__lipsum_expanded: + \lipsumexp \@@_expanded: } { \@@_ensure_parsable_output: @@ -1655,7 +1656,7 @@ { \l_tmpa_int } { \l_tmpb_int } \cs_gset_nopar:Nx \@@_expanded_paragraphs_terminated_with_space: - { \tl_use:N\l__lipsum_pars_tl } + { \tl_use:N\l_@@_pars_tl } \lipsum_store_as_temp_ints:nn #3 \lipsum_sentences_to_tokenlist:VVf { \l_tmpa_int } @@ -1663,11 +1664,11 @@ \@@_expanded_paragraphs_terminated_with_space: \cs_gset:Nx \@@_expanded: - { \tl_use:N\l__lipsum_sentences_tl } + { \tl_use:N\l_@@_sentences_tl } \cs_gset_eq:NN - \lipsumexp \__lipsum_expanded: + \lipsumexp \@@_expanded: } - \group_end: + \group_end: } % \end{macrocode} % \end{macro} @@ -1692,19 +1693,19 @@ % Used to select and load the text output by \cs{lipsum} and friends. See the % section on loading and defining new outputs for \cs{lipsum} % (section~\ref{sec:other-texts}). It first checks whether the requested text -% is already loaded, and if not, it clears \cs{g_lipsum_paragraph_seq} and +% is already loaded, and if not, it clears \cs{g_@@_paragraph_seq} and % loads the corresponding lipsum text definition file. % \begin{macrocode} \NewDocumentCommand\SetLipsumText{m}{% \IfLipsumText{#1}{}{ - \seq_clear:N\g_lipsum_paragraph_seq + \seq_gclear:N\g_@@_paragraph_seq \file_input:n{#1.ltd} - \str_set:Nn\g_lipsum_text_str{#1} + \str_gset:Nn\g_@@_text_str{#1} } } % \end{macrocode} -% +% % \end{macro} % \subsection{Package options and defaults} % \begin{macrocode} @@ -3451,14 +3452,14 @@ % \newpage % \subsection{The text of Cicero's speech} % \begin{macrocode} -%<*cicero> +%<*cicero> % \end{macrocode} % \begin{macrocode} %% %% This text was provided by github-user %% svenper. See https://github.com/patta42/lipsum/issues/13 -%% +%% \NewLipsumPar{Non eram nescius, Brute, cum, quae summis ingeniis exquisitaque doctrina philosophi Graeco sermone tractavissent, ea Latinis litteris diff --git a/macros/latex/contrib/lipsum/lipsum.ins b/macros/latex/contrib/lipsum/lipsum.ins index 7ffaf5e5bf..a2c3bc6519 100644 --- a/macros/latex/contrib/lipsum/lipsum.ins +++ b/macros/latex/contrib/lipsum/lipsum.ins @@ -1,18 +1,20 @@ -%% -%% Copyright (C) 2018 by Patrick Happel -%% -%% This file may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either -%% version 1.3 of this license or (at your option) any later -%% version. The latest version of this license is in: -%% -%% http://www.latex-project.org/lppl.txt -%% -%% and version 1.3 or later is part of all distributions of +%% +%% Copyright (C) 2014-2019 by Patrick Happel +%% Copyright (C) 2021 by Phelype Oleinik +%% +%% This file may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3 of this license or (at your option) any later +%% version. The latest version of this license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.3 or later is part of all distributions of %% LaTeX version 2005/12/01 or later. %% \input l3docstrip.tex \askforoverwritefalse +\keepsilent \preamble This file is part of the package lipsum for use with LaTeX2e. @@ -27,11 +29,8 @@ The latest version of this license is in and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later. -Please send error reports and suggestions for improvements to - Patrick Happel <patrick.happel@rub.de> - -Alternatively, use github: - https://github.com/patta42/lipsum +Please send error reports and suggestions for improvements to + https://github.com/PhelypeOleinik/lipsum \endpreamble \postamble @@ -42,21 +41,21 @@ Alternatively, use github: \generate{\file{cicero.ltd.tex}{\from{lipsum.dtx}{cicero}}} \obeyspaces -\Msg{****************************************************} -\Msg{* *} -\Msg{* To finish the installation you have to move the *} +\Msg{****************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the *} \Msg{* following files into a directory searched *} -\Msg{* by TeX: } -\Msg{* *} +\Msg{* by TeX: *} +\Msg{* *} \Msg{* lipsum.sty *} \Msg{* lipsum.ltd.tex *} -\Msg{* cicero.ltd.tex *} -\Msg{* *} -\Msg{* To produce the documentation run the file *} -\Msg{* lipsum.dtx through XeLaTeX or luaLaTeX. *} -\Msg{* *} -\Msg{* Happy TeXing! *} -\Msg{* *} +\Msg{* cicero.ltd.tex *} +\Msg{* *} +\Msg{* To produce the documentation run the file *} +\Msg{* lipsum.dtx through XeLaTeX or luaLaTeX. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} \Msg{****************************************************} \endbatchfile diff --git a/macros/latex/contrib/lipsum/lipsum.pdf b/macros/latex/contrib/lipsum/lipsum.pdf Binary files differindex adb7b3c1e8..df4fe78450 100644 --- a/macros/latex/contrib/lipsum/lipsum.pdf +++ b/macros/latex/contrib/lipsum/lipsum.pdf |