summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/csquotes/csquotes.cfg
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-03-03 01:11:03 +0000
committerKarl Berry <karl@freefriends.org>2008-03-03 01:11:03 +0000
commit96fe190fce65fb756cc744a603c490529dd95a04 (patch)
tree13250926a7f5b654894ca377e14b91e50933383f /Master/texmf-dist/tex/latex/csquotes/csquotes.cfg
parent26b5af90d7132dc6c5d514d589adfca8502d62c0 (diff)
csquotes 4.0 (2mar08)
git-svn-id: svn://tug.org/texlive/trunk@6810 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/csquotes/csquotes.cfg')
-rw-r--r--Master/texmf-dist/tex/latex/csquotes/csquotes.cfg180
1 files changed, 160 insertions, 20 deletions
diff --git a/Master/texmf-dist/tex/latex/csquotes/csquotes.cfg b/Master/texmf-dist/tex/latex/csquotes/csquotes.cfg
index 84a4bd9c207..de4e57f7cf1 100644
--- a/Master/texmf-dist/tex/latex/csquotes/csquotes.cfg
+++ b/Master/texmf-dist/tex/latex/csquotes/csquotes.cfg
@@ -1,6 +1,6 @@
-% $Id: csquotes.cfg,v 3.8 2008/01/05 17:58:56 lehman stable $
+% $Id: csquotes.cfg,v 4.0 2008/03/02 15:07:53 lehman stable $
-\ProvidesFile{csquotes.cfg}[2008/01/05 v3.8 quotation configuration]
+\ProvidesFile{csquotes.cfg}[2008/03/02 v4.0 csquotes configuration]
% Put your definitions here.
@@ -14,14 +14,16 @@
% Use \ExecuteQuoteOptions to preset package options if you are not
% satisfied with the built-in defaults. Options given here will be
-% processed before any options specified in the document preamble.
+% processed before any options specified in the document preamble,
+% so you can still override them in the preamble.
\ExecuteQuoteOptions{strict=true,babel=tryonce}
% CHANGING THE DEFAULT PARAMETERS
-% All preset values may be changed in the document preamble as
-% usual. The following values are the built-in defaults:
+% Even if you modify the package defaults here, all preset values
+% may still be changed in the document preamble as usual. The
+% following values are the built-in package defaults:
\SetBlockEnvironment{quote}
\SetBlockThreshold{3}
@@ -29,7 +31,8 @@
% SETTING UP A NEW QUOTE STYLE
-% Defining a new style with several variants:
+% Here's an example of a new quote style with several variants (look
+% up \DeclareQuoteStyle in the manual for all the details):
\DeclareQuoteStyle[quotes]{example}% [variant]{style}
{\textquotedblleft}% opening outer mark
@@ -49,18 +52,6 @@
{\textquotedblleft}
[\textquoteleft]% middle inner mark
{\textquotedblright}
-\DeclareQuoteStyle[everyline]{example}
- [\seteverylineleft{\guillemotleft}]% requires Omega
- {\guillemotleft}
- {\guillemotright}
- {\guilsinglleft}
- {\guilsinglright}
-\DeclareQuoteStyle[everyline*]{example}
- [\seteverylineright{\guillemotright}]% requires Omega
- {\guillemotleft}
- {\guillemotright}
- {\guilsinglleft}
- {\guilsinglright}
% Defining the default variant of the style:
@@ -70,15 +61,164 @@
\DeclareQuoteAlias{example}{demo}
-% Adding a package option for a style:
+% Adding a package option for the style:
\DeclareQuoteOption{example}
+% DEFINING SHORT COMMAND NAMES
+
+% The names of all macros which csquotes provides by default are
+% rather verbose. They are meant to be self-explanatory. You may
+% find names like \hyphentextquote a bit too verbose, however,
+% especially if you use them frequently. It is very easy to define
+% shorter command names on top of the verbose ones. The trick is to
+% exclude the arguments such that the short definition is a simple
+% pointer to the full name:
+%
+% \newcommand*{\htquote}{\hyphentextquote}
+%
+% Here are a few useful shorthands:
+
+\newcommand*{\tquote}{\textquote}
+\newcommand*{\tcquote}{\textcquote}
+
+\newcommand*{\bquote}{\blockquote}
+\newcommand*{\bcquote}{\blockcquote}
+
+% You can even include language switches in the definition of the
+% short command form:
+%
+% \newcommand*{\usquote}{\hyphentextquote{american}}
+%
+% That, however, will not work as expected if you try to use the
+% starred version because
+%
+% \usquote*{quotation}
+%
+% will not yield
+%
+% \hyphentextquote*{american}{quotation}
+%
+% but rather
+%
+% \hyphentextquote{american}*{quotation}
+%
+% which is invalid syntax. The following little macro takes care of
+% that. If you prefix a definition which consists of a macro name
+% and one argument with \@checkstar, it will check if the starred
+% version of the command was requested and rearrange the syntax
+% accordingly:
+
+\newrobustcmd*{\@checkstar}[2]{%
+ \@ifstar{#1*{#2}}{#1{#2}}}
+
+% If we define our \usquote shorthand like that:
+%
+% \newcommand*{\usquote}{\@checkstar\hyphentextquote{american}}
+%
+% then
+%
+% \usquote*{quotation}
+%
+% will correctly yield
+%
+% \hyphentextquote*{american}{quotation}
+%
+% Here are a few useful shorthands:
+
+\newrobustcmd*{\dequote}{%
+ \@checkstar\hyphenquote{german}}
+\newrobustcmd*{\frquote}{%
+ \@checkstar\hyphenquote{french}}
+\newrobustcmd*{\ukquote}{%
+ \@checkstar\hyphenquote{british}}
+\newrobustcmd*{\usquote}{%
+ \@checkstar\hyphenquote{american}}
+
+\newrobustcmd*{\detquote}{%
+ \@checkstar\hyphentextquote{german}}
+\newrobustcmd*{\frtquote}{%
+ \@checkstar\hyphentextquote{french}}
+\newrobustcmd*{\uktquote}{%
+ \@checkstar\hyphentextquote{british}}
+\newrobustcmd*{\ustquote}{%
+ \@checkstar\hyphentextquote{american}}
+
+\newrobustcmd*{\debquote}{%
+ \@checkstar\hyphenblockquote{german}}
+\newrobustcmd*{\frbquote}{%
+ \@checkstar\hyphenblockquote{french}}
+\newrobustcmd*{\ukbquote}{%
+ \@checkstar\hyphenblockquote{british}}
+\newrobustcmd*{\usbquote}{%
+ \@checkstar\hyphenblockquote{american}}
+
+\newrobustcmd*{\detcquote}{%
+ \@checkstar\hyphentextcquote{german}}
+\newrobustcmd*{\frtcquote}{%
+ \@checkstar\hyphentextcquote{french}}
+\newrobustcmd*{\uktcquote}{%
+ \@checkstar\hyphentextcquote{british}}
+\newrobustcmd*{\ustcquote}{%
+ \@checkstar\hyphentextcquote{american}}
+
+\newrobustcmd*{\debcquote}{%
+ \@checkstar\hyphenblockcquote{german}}
+\newrobustcmd*{\frbcquote}{%
+ \@checkstar\hyphenblockcquote{french}}
+\newrobustcmd*{\ukbcquote}{%
+ \@checkstar\hyphenblockcquote{british}}
+\newrobustcmd*{\usbcquote}{%
+ \@checkstar\hyphenblockcquote{american}}
+
+% It is also possible to define shorter environment names. In this
+% case, the opening part of the environment definition should be the
+% verbose environment name with a backslash; the closing definition
+% should be the verbose name preceded by 'end' plus a backslash:
+
+\newenvironment*{dquote}
+ {\displayquote}
+ {\enddisplayquote}
+
+\newenvironment*{dcquote}
+ {\displaycquote}
+ {\enddisplaycquote}
+
+% Short environment definitions may also include language switches.
+% In this case, the language name is included in the opening part of
+% the environment definition. Here are a few useful examples:
+
+\newenvironment*{dedquote}
+ {\hyphendisplayquote{german}}
+ {\endhyphendisplayquote}
+\newenvironment*{frdquote}
+ {\hyphendisplayquote{french}}
+ {\endhyphendisplayquote}
+\newenvironment*{ukdquote}
+ {\hyphendisplayquote{british}}
+ {\endhyphendisplayquote}
+\newenvironment*{usdquote}
+ {\hyphendisplayquote{american}}
+ {\endhyphendisplayquote}
+
+\newenvironment*{dedcquote}
+ {\hyphendisplaycquote{german}}
+ {\endhyphendisplaycquote}
+\newenvironment*{frdcquote}
+ {\hyphendisplaycquote{french}}
+ {\endhyphendisplaycquote}
+\newenvironment*{ukdcquote}
+ {\hyphendisplaycquote{british}}
+ {\endhyphendisplaycquote}
+\newenvironment*{usdcquote}
+ {\hyphendisplaycquote{american}}
+ {\endhyphendisplaycquote}
+
% DEFINING ENVIRONMENTS FOR PARAGRAPH QUOTATIONS
% Here are some alternative environments for paragraph quotations
% (block and display), as discussed in the tutorial. The first one
-% decreases the font size of the `quote' environment by one step:
+% decreases the font size of the 'quote' environment by one step:
\RequirePackage{relsize}