From 8666a5c570484d7ca977190121a5d82f6c50d235 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 25 Feb 2024 21:06:50 +0000 Subject: crefthe (25feb24) git-svn-id: svn://tug.org/texlive/trunk@70156 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/crefthe/README.md | 6 +++--- Master/texmf-dist/doc/latex/crefthe/crefthe-doc.pdf | Bin 66538 -> 71860 bytes Master/texmf-dist/doc/latex/crefthe/crefthe-doc.tex | 19 +++++++++++-------- 3 files changed, 14 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc/latex/crefthe') diff --git a/Master/texmf-dist/doc/latex/crefthe/README.md b/Master/texmf-dist/doc/latex/crefthe/README.md index 745432cfbc1..3fff1e4ecf4 100644 --- a/Master/texmf-dist/doc/latex/crefthe/README.md +++ b/Master/texmf-dist/doc/latex/crefthe/README.md @@ -1,12 +1,12 @@ -# crefthe - cross referencing with proper definite articles +# crefthe — cross referencing with proper definite articles and declensions -"crefthe" is a LaTeX package aimed at helping `\cref` addressing the definite articles properly (especially for the article contractions in many European languages). +"crefthe" is a LaTeX package aimed at helping `\cref` to handle the definite articles and declensions properly (especially for the phenomenon of article contractions in many European languages, such as French and German). ## Motivation -By default, when using cleveref's `\cref` to reference theorem-like environments, the names do not contain definite articles. This may be acceptable for English, but certainly not good enough for languages such as French, Italian, Portuguese, Spanish, etc. -- in these cases there shall be grammatical errors and would give you a strong feeling that it is machine-generated. +By default, when using cleveref's `\cref` to reference theorem-like environments, the names do not contain definite articles. This may be acceptable for English, but certainly not good enough for languages such as French, Italian, Portuguese, Spanish, etc. — in these cases there shall be grammatical errors and would give you a strong feeling that it is machine-generated. As an example, if we define the French names to be: ```latex diff --git a/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.pdf b/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.pdf index be4864d5330..967c29d78f0 100644 Binary files a/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.pdf and b/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.tex b/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.tex index 81a11edab9b..35f98e753e0 100644 --- a/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.tex +++ b/Master/texmf-dist/doc/latex/crefthe/crefthe-doc.tex @@ -5,6 +5,8 @@ \usepackage{ProjLib} +\setmonofont[Scale=.9]{Iosevka} + %%================================ %% For typesetting code %%================================ @@ -26,7 +28,7 @@ breaklines = true, frame = lines, backgroundcolor = \color{code-background}, - flexiblecolumns = true, + basewidth = .5em, escapeinside = {(*}{*)}, alsoletter = {_,:}, % numbers = left, @@ -69,8 +71,8 @@ \lstnewenvironment{code}{\setstretch{1.05}\LocallyStopLineNumbers}{\ResumeLineNumbers\vspace{-.3\baselineskip}\vspace{-.5\parskip}} \lstnewenvironment{code*}{\setstretch{1.05}\lstset{numbers=left}\LocallyStopLineNumbers}{\ResumeLineNumbers\vspace{-.3\baselineskip}\vspace{-.5\parskip}} -\newcommand{\packageoption}[1]{\texttt{\textcolor{code-option}{#1}}} -\newcommand{\commandoption}[1]{\texttt{\textcolor{code-keys}{#1}}} +\newcommand{\packageoption}[1]{\textcolor{code-option}{\texttt{#1}}} +\newcommand{\commandoption}[1]{\textcolor{code-keys}{\texttt{#1}}} %%================================ %% tip @@ -120,19 +122,19 @@ \begin{document} -\def\PackageVersion{2024/02/24} +\def\PackageVersion{2024/02/25} \def\PackageSubVersion{} -\title{\crefthepackage{}\\\smallskip\itshape Cross referencing with proper definite articles} +\title{\crefthepackage{}\\\smallskip\itshape Cross referencing with proper definite articles and declensions} \author{Jinwen XU} -\thanks{Corresponding to: \texttt{\crefthepackage{} \PackageVersion\PackageSubVersion}} +\thanks{Corresponding to: \texttt{\crefthepackage{} \PackageVersion\PackageSubVersion}.} \date{\TheDate{\PackageVersion}[only-year-month], in Paris} \maketitle \begin{abstract} \raggedleft - The package \crefthepackage{} provides a command \lstinline|\crefthe| parallel to \textsf{cleveref}'s \lstinline|\cref| for handling definite articles properly (especially for the article contractions in some European languages). + The package \crefthepackage{} provides a command \lstinline|\crefthe| parallel to \textsf{cleveref}'s \lstinline|\cref| for handling definite articles and declensions properly (especially for the phenomenon of article contractions in some European languages, such as French and German). \end{abstract} \section{The motivation} @@ -224,6 +226,7 @@ Then you can use the command \lstinline|\crefthe| as follows: % \end{code} +\enlargethispage*{\baselineskip} \section{Example} Let us come back to the example at the beginning, now you can do this: @@ -310,7 +313,7 @@ Then, when referencing, you can use the command option \commandoption{abbr.} to \section{Regarding the upper and lower cases} -As in \textsf{cleveref}, these commands have corresponding uppercased version: \lstinline|\Crefthename|,\linebreak \lstinline|\Crefthe|, \lstinline|\nameCrefthe|, \lstinline|\nameCrefsthe| and \lstinline|\Cpagerefthe|, similar to \lstinline|\Crefname|,\linebreak \lstinline|\Cref|, \lstinline|\nameCref|, \lstinline|\nameCrefs| and \lstinline|\Cpageref|, reserved for using at the beginning of a sentence. Their usage is essentially the same as the corresponding lowercase version. +As with \textsf{cleveref}, these commands have corresponding uppercased version: \lstinline|\Crefthename|, \lstinline|\Crefthe|, \lstinline|\nameCrefthe|, \lstinline|\nameCrefsthe| and \lstinline|\Cpagerefthe|, similar to \lstinline|\Crefname|, \lstinline|\Cref|, \lstinline|\nameCref|, \lstinline|\nameCrefs| and \lstinline|\Cpageref|, reserved for using at the beginning of a sentence. Their usage is essentially the same as the corresponding lowercase version. For languages with declensions, such as German, there is also a \lstinline|\Crefthevariantname| (or equivalently, \lstinline|\setCrefname|), corresponding to the above \lstinline|\crefthevariantname|. -- cgit v1.2.3