summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex124
1 files changed, 79 insertions, 45 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
index 3b12f971709..34d2d4eb4c7 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
@@ -196,15 +196,17 @@
\BeforeStartingTOC[toc]{\begin{multicols}{2}}
\AfterStartingTOC[toc]{\end{multicols}}
-\newrobustcmd*{\tex}{TeX}
+\newrobustcmd*{\tex}{\TeX}
\newrobustcmd*{\etex}{\mbox{e-TeX}}
\newrobustcmd*{\pdftex}{pdf\-\tex}
\newrobustcmd*{\xetex}{Xe\-\tex}
\newrobustcmd*{\luatex}{Lua\-\tex}
-\newrobustcmd*{\latex}{La\kern-0.07em TeX}
+\newrobustcmd*{\latex}{\LaTeX}%{La\kern-0.07em TeX}
\newrobustcmd*{\pdflatex}{pdf\-\latex}
\newrobustcmd*{\xelatex}{Xe\-\latex}
\newrobustcmd*{\lualatex}{Lua\-\latex}
+\newrobustcmd*{\miktex}{Mik\-\tex}
+\newrobustcmd*{\texlive}{\tex~live}
\newrobustcmd*{\bibtex}{Bib\kern-0.07em TeX}
\newrobustcmd*{\lppl}{\latex{} Project Public License}
\newrobustcmd*{\pdf}{\acr{PDF}}
@@ -315,7 +317,7 @@
\newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext}
-\newcommand*{\extblxversion}{0.1a}
+\newcommand*{\extblxversion}{0.2}
\newcommand*{\biber}{Biber}
\newcommand*{\gitissuelink}[1]{%
\href{\gitbaseurl/issues/#1}{issue \##1 on github}}
@@ -327,7 +329,7 @@
author = {Moritz Wemheuer},
link = {mwemheu@gmail.com},%
revision = {\extblxversion},
- date = {\DTMDate{2018-03-20}},
+ date = {\DTMDate{2018-03-28}},
}
\hypersetup{%
@@ -346,6 +348,7 @@
bib-close-paren
bib-open-bracket
bib-close-bracket
+ main-title-after-title
}
\begin{document}
@@ -427,14 +430,30 @@ that version is required for the styles to work properly.
A warning will be issued if you use an older version.
You may choose to ignore that warning, but the styles can not be guaranteed to
work properly in that case:
-you might get other warnings, errors or some features of the style might just
-fail silently.
+you might get other warnings or errors, and some features of the style might
+just fail silently.
Use of the \biber{} backend is strongly encouraged.
Most of the new features of this bundle do not require \biber{} explicitly in
their implementation, but many \sty{biblatex} standard features only work
properly with \biber{}.
+\subsection{Installation}\label{sec:install}
+This style bundle is available on \mkbibacro{CTAN}.%
+\fnurl{https://ctan.org/pkg/biblatex-ext}
+The current release is also available in \miktex{} and \texlive{} 2018 or
+newer.
+If at all possible you should install this bundle via your \tex{} distribution
+(using \miktex{} Console\fnurl{https://miktex.org/howto/miktex-console} or
+\sty{tlmgr} for \texlive\fnurl{https://www.tug.org/texlive/pkginstall.html}).
+If you must install this package manually, get the files from \mkbibacro{CTAN}
+and install the \sty{.bbx}, \sty{.cbx} and \sty{.def} files preferably to
+\path{tex/latex/biblatex-ext} of your local or home \TeX{} tree, the other
+files (\path{CHANGES.md}, \path{README.md}, \path{biblatex-ext.tex},
+\path{biblatex-ext.pdf} and \path{biblatex-ext-examples.bib}) go to
+\path{doc/latex/biblatex-ext}, you may have to refresh your file name database
+afterwards, so \tex{} can find the files.
+
\subsection{License}\label{sec:license}
Permission is granted to copy, distribute and\slash or modify this software
under the terms of the \lppl, version 1.3c%
@@ -481,16 +500,15 @@ The \texttt{ext-} styles only build on top of the standard files.
An extended version of the standard \sty{numeric} style for citations with
numeric labels.
\begin{bibexample}[]
-[1, 2, 3, 5, 6, 7]
+[1, 2, 5, 6, 7]
\end{bibexample}
\styleitem{ext-numeric-comp}
An extended version of the standard \sty{numeric-comp} style.
Similar to \sty{ext-numeric}, but citation labels are
-compressed to give \enquote{[1--3, 5--7]} instead of
-\enquote{[1, 2, 3, 5, 6, 7]}.
+compressed to give \enquote{[1--3]} instead of \enquote{[1, 2, 3]}.
\begin{bibexample}[]
-[1--3, 5--7]
+[1, 2, 5--7]
\end{bibexample}
\styleitem{ext-numeric-verb}
@@ -498,7 +516,7 @@ An extended version of the standard \sty{numeric-verb} style.
This style is similar to the \sty{numeric} style, but each citation label
is in its own set of brackets: \enquote{[1], [2], [3]}.
\begin{bibexample}[]
-[1], [2], [3], [5], [6], [7]
+[1], [3], [5], [6], [7]
\end{bibexample}
\styleitem{ext-alphabetic}
@@ -1035,7 +1053,7 @@ labels in a \sty{numeric} bibliography.
\begingroup
\togglefalse{bbx:doi}
-\setlength{\introcitewidth}{5.8\biblabelsep}
+\setlength{\introcitewidth}{5.5\biblabelsep}
\DeclareFieldFormat{bbx:introcite}{\highlight{#1}}
\renewcommand*{\introcitepunct}{\highlight{\addcolon}\space}
\makeatletter
@@ -1059,12 +1077,11 @@ labels in a \sty{numeric} bibliography.
\makeatother
\endgroup
+The label produced by the \opt{plain} option can be customised as follows.
\begin{ltxsyntax}
-\csitem{introcitepunct} The \opt{plain} option inserts the punctuation
-given in \cmd{introcitepunct} between the label and the rest of the entry.
-The default value is a colon followed by a space.
-
-
+\csitem{introcitepunct} The punctuation insterted between the label and the
+ rest of the entry with \kvopt{introcite}{plain}.
+ The default value is a colon followed by a space.
\begin{bibexample}
\togglefalse{bbx:doi}
\renewcommand*{\introcitepunct}{\highlight{\textbf{\addcolon}\textvisiblespace}}
@@ -1072,39 +1089,40 @@ The default value is a colon followed by a space.
\csletcs{extblx@introcite}{extblx@opt@introcite@plain}
\printbibliography[heading=none, category=sigfridsson]
\end{bibexample}
+\end{ltxsyntax}
The \opt{label} option can be configured to not allow the label to run into
the remaining bibliography entry thus creating the appearance of a tabular-like
bibliography.
The citation label is not broken across lines, instead it moves the entry text
-into the next line with \cmd{introcitebreak} if the width of the citation label
-plus the buffer length \len{introcitesep} is greater than \len{introcitewidth}.
+into the next line with \cmd{introcitebreak} if the width of the citation is
+greater than \len{introcitewidth}.
-
-\lenitem{introcitewidth} This length controls the margin of the bibliography.
+\begin{ltxsyntax}
+\lenitem{introcitewidth} The maximum width of the citation label.
The initial value is 8 times \len{biblabelsep}.
\lenitem{introcitesep} This length sets the minimal space between the end of the
citation label and the beginning of the rest of the entry.
- If the citation label does not leave at least \len{introcitesep} to the
- beginning of the entry, the entry is broken to the next line by inserting
- \cmd{introcitebreak}.
- The initial value is half of \len{biblabelsep}.
+ The initial value is \len{biblabelsep}.
+\csitem{introcitebreak} The command to execute if a citation label exceeds
+ \len{introcitewidth}. The default is \cs{leavevmode}\cs{newline}.
\end{ltxsyntax}
\makeatletter
\togglefalse{bbx:doi}
\begingroup
-\setlength{\introcitewidth}{8\biblabelsep}
+\setlength{\introcitewidth}{4.2\biblabelsep}
\setlength{\introcitesep}{3.8\biblabelsep}
\begin{bibexample}[enhanced, title={Lengths for \kvopt{introcite}{label}},
overlay={%
- \draw[highlight1, line width=.24mm,|-|] (frame.west)++(16pt,-2.47cm) --
- node [midway,below=2pt] {\len{introcitewidth}} ++ (\introcitewidth-1pt,0);
- \draw[highlight2, line width=.24mm,|-|] (frame.west)++(16pt,-.8mm)++
- (\introcitewidth-1pt,0) -- node [above=4pt,at end] {\len{introcitesep}} ++
- (-\introcitesep,0);
- \draw[highlight2, line width=.24mm,|-|] (frame.west)++(16pt,2.32cm)++
- (\introcitewidth-1pt,0) -- ++ (-\introcitesep,0);
+ \draw[highlight1, line width=.24mm,|-|] (frame.west)++(5.5mm,-.38cm) --
+ node [at end, below=1pt] {\len{introcitewidth}} ++
+ (\introcitewidth,0);
+ \draw[highlight2, line width=.24mm,|-|] (frame.west)++
+ (5.5mm+\introcitewidth,-.8mm) -- node [at start, above=2pt]
+ {\len{introcitesep}} ++ (\introcitesep,0);
+ \draw[highlight2, line width=.24mm,|-|] (frame.west)++
+ (5.5mm+\introcitewidth,2.32cm) -- ++ (\introcitesep,0);
}
]
\csuse{extblx@opt@dashed@false}
@@ -1113,18 +1131,18 @@ overlay={%
\end{bibexample}
\endgroup
-\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with
- $\len{introcitesep}=-\len{introcitewidth}$}]
-\setlength{\introcitewidth}{27mm}
-\setlength{\introcitesep}{-\introcitewidth}
+\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with empty
+ \cs{introcitebreak}}]
+\renewcommand*{\introcitebreak}{}
+\setlength{\introcitewidth}{1.8cm}
\csuse{extblx@opt@dashed@false}
\csletcs{extblx@introcite}{extblx@opt@introcite@label}
\printbibliography[heading=none, category=introcite:lengths, nottype=article]
\end{bibexample}
\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with
- $\len{introcitesep}=\len{introcitewidth}=\len{bibhang}$}]
-\setlength{\introcitewidth}{\bibhang}
+ $\len{introcitewidth}=0$ and $\len{introcitesep}=\len{bibhang}$}]
+\setlength{\introcitewidth}{0pt}
\setlength{\introcitesep}{\bibhang}
\csuse{extblx@opt@dashed@false}
\csletcs{extblx@introcite}{extblx@opt@introcite@label}
@@ -1190,11 +1208,22 @@ The punctuation commands should be redefined with \cmd{renewcommand}.
\csitem{maintitletitledelim}
The punctuation between the \bibfield{maintitle} and \bibfield{title} or
\bibfield{booktitle} of a work if \opt{maintitleaftertitle} is \opt{false}.
+The default is \cs{newunitpunct}.
+\begin{bibexample}
+\togglefalse{bbx:isbn}
+\renewcommand*{\maintitletitledelim}{\highlight{\textbf{\addperiod}%
+ \textvisiblespace}\bibsentence}
+\fullcite{knuth:ct:a}
+\end{bibexample}
+
+\csitem{voltitledelim}
+The punctuation between the \bibfield{volume} and \bibfield{title} or
+\bibfield{booktitle} of a work if \opt{maintitleaftertitle} is \opt{false}.
The default is a colon followed by a space.
\begin{bibexample}
\togglefalse{bbx:isbn}
-\renewcommand*{\maintitletitledelim}{\highlight{\textbf{\addcolon}%
- \textvisiblespace}}
+\renewcommand*{\voltitledelim}{\highlight{\textbf{\addcolon}%
+ \textvisiblespace}\bibsentence}
\fullcite{knuth:ct:a}
\end{bibexample}
@@ -1344,7 +1373,7 @@ This means that the commands discussed here can be used to place the citations
between delimiters, but not natively to pass the result of a citation to a
wrapper command as an argument.
-\begin{table}[bthp]
+\begin{table}[btph]
\centering
\caption[Outer and inner citation delimiters by style]{\highlight[1]{Outer} and
\highlight[2]{inner} citation delimiters by style. If the style does not use
@@ -1563,13 +1592,18 @@ The GitHub repository of this project uses release tags, so you can compare
the changes in source code there.\footnote{\url{\gitbaseurl/compare/}}
See also \sty{CHANGES.md}.
\begin{changelog}
+\begin{release}{0.2}{2018-03-28}
+\item Rework lengths for \kvopt{introcite}{label}\see{sec:opt:style}
+\item Fixed meaning of \cs{maintitletitledelim}\see{sec:opt:punct}
+\item Added \cs{voltitledelim}\see{sec:opt:punct}
+\end{release}
\begin{release}{0.1a}{2018-03-20}
\item Fixed inner citation delimiters for \sty{ext-authoryear},
- \sty{ext-authortitle} and their \sty{-ibid} versions.
-\item Fixed \cmd{smartcite} delimiters.
+ \sty{ext-authortitle} and their \sty{-ibid} versions\see{sec:opt:citedelims}
+\item Fixed \cmd{smartcite} delimiters\see{sec:opt:citedelims}
\end{release}
\begin{release}{0.1}{2018-03-18}
-\item First public release.
+\item First public release
\end{release}
\end{changelog}