diff options
author | Karl Berry <karl@freefriends.org> | 2018-03-29 21:45:05 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-03-29 21:45:05 +0000 |
commit | ee70ec1718bfc3e9dd1021d34464b4610c527d71 (patch) | |
tree | 433b4028c8637c3fae99e2a49c1cdb7d94206d2c /Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex | |
parent | 37790d770bf6f565c1520a99adbd2dc8533dba7c (diff) |
biblatex-ext (29mar18)
git-svn-id: svn://tug.org/texlive/trunk@47175 c570f23f-e606-0410-a88d-b1316a301751
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.tex | 124 |
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} |