diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-21 20:32:12 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-21 20:32:12 +0000 |
commit | 727a4f56d4f9d5062476989f3bb1df753db96458 (patch) | |
tree | 53703befe10aaea290400b2ec201967031ba639f /Master/texmf-dist/doc | |
parent | 807a6a930a6080b9d7914fb097079c995c930f87 (diff) |
biblatex-iso690 (21mar22) (branch)
git-svn-id: svn://tug.org/texlive/branches/branch2021.final@62867 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-iso690/README.md | 26 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690-examples.bib (renamed from Master/texmf-dist/doc/latex/biblatex-iso690/mybib.bib) | 94 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf | bin | 258286 -> 277123 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex | 122 |
4 files changed, 217 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/README.md b/Master/texmf-dist/doc/latex/biblatex-iso690/README.md index cdf10a48922..26f6e2ac1c2 100644 --- a/Master/texmf-dist/doc/latex/biblatex-iso690/README.md +++ b/Master/texmf-dist/doc/latex/biblatex-iso690/README.md @@ -41,10 +41,21 @@ here. You should be able to use `biblatex-iso690` now. \usepackage[english,czech]{babel} % the main document language is the last one \usepackage[ backend=biber, % if we want unicode and many other features (biber is already by default) - style=iso-authoryear, % or iso-numeric for numeric citation method + style=iso-authoryear, % or another iso-<style> ]{biblatex} ``` +### Citation and bibliography styles + +`biblatex-iso690` provides the following styles (both for citations +and bibliographies). You can select one with `style` keyword in the +package options of `biblatex`. + +* `iso-alphabetic` +* `iso-authortitle` +* `iso-authoryear` +* `iso-numeric` + ### Custom options Above and beyond the scope of package options provided by `biblatex` itself, @@ -89,6 +100,15 @@ here are also some more. Default values are in **bold**. `publisher` fields) for an `@article` entry type * [true] Journal of Money, Credit and Banking. Ohio State University Press, vol. 38, no. 1, pp. 119–140. * **[false]** Journal of Money, Credit and Banking. Vol. 38, no. 1, pp. 119–140. +* `currentlang` + print localization bibliography strings in the currently selected language + * [true] `context dependent` + * **[false]** `context dependent` +* `noenddot` + enable or disable printing an end dot at the very end of + bibliography entries + * [true] ... ISSN 1082-9873. Available from DOI : 10.1045/july2005-lynch + * **[false]** ... ISSN 1082-9873. Available from DOI : 10.1045/july2005-lynch. ### Bibliographic fields @@ -135,7 +155,7 @@ supervisor = {Petr Sojka}, dateaddon = {\mkbibbrackets{16th century}}, ``` -For more details see the example bibliography file [mybib.bib](./mybib.bib). +For more details see the example bibliography file [biblatex-iso690-examples.bib](./biblatex-iso690-examples.bib). ## Contributing @@ -151,7 +171,7 @@ If the `<langid>.lbx` is already included in `biblatex`, adding a of this package. Otherwise, please consider [a contribution to the `biblatex` package](https://github.com/plk/biblatex/#translation) first. -If you also aim to add new localisation strings, you have to define them via +If you also aim to add new localization strings, you have to define them via `\NewBibliographyString` command at the beginning of the [iso.bbx](iso.bbx) file. diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/mybib.bib b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690-examples.bib index f87684085f3..0d123236e42 100644 --- a/Master/texmf-dist/doc/latex/biblatex-iso690/mybib.bib +++ b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690-examples.bib @@ -187,6 +187,35 @@ crossref = {tugboat1980}, } +% Book with volume field example +@book{knuth1998sorting, + author = {Knuth, Donald E.}, + maintitle = {The Art of Computer Programming}, + title = {Sorting and Searching}, + date = {1998}, + volume = {3}, + edition = {2}, + publisher = {Addison–Wesley}, + isbn = {978-0-201-89685-5}, +} + +% Multi-volume book example (volumes field) +% Gratefully borrowed from biblatex-examples.bib +@mvbook{knuth:ct, + author = {Knuth, Donald E.}, + title = {Computers \& Typesetting}, + date = {1984/1986}, + volumes = 5, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + langid = {english}, + langidopts = {variant=american}, + sorttitle = {Computers & Typesetting}, + indexsorttitle = {Computers & Typesetting}, + annotation = {A five-volume book cited as a whole. This is a \texttt{mvbook} + entry, note the \texttt{volumes} field}, +} + % Made-up bib entry @collection{sbornik2007, title = {Mimořádně užitečný sborník}, @@ -229,17 +258,31 @@ } @patent{groll2008method, - author = {Clad Metals LLC Canonsburg, PA 15317 (US)}, + holder = {{Clad Metals LLC Canonsburg, PA 15317 (US)}}, title = {Method of making a copper core five-ply composite and cooking vessel}, - editora = {Groll, W. A.}, - editoratype = {inventor}, + author = {Groll, W. A.}, publisher = {Google Patents}, number = {EP 1 094 937 B1}, type = {patenteu}, date = {2008-07-30}, + origdate = {1999-05-04}, url = {https://patents.google.com/patent/EP1094937B1}, } +@patent{winget1967detachable, + holder = {{Winget Ltd}}, + title = {Detachable bulldozer attachment for dumper vehicles}, + author = {Reginald John England}, + number = {1060631}, + type = {patentuk}, + date = {1967-03-08}, + origdate = {1963-06-10}, + note = {Int\adddotspace CI\addcolon\addabbrvspace E02F 3/76\adddotspace + GB\addabbrvspace CI\addcolon\addabbrvspace E1F 12}, + url = {https://patents.google.com/patent/GB1060631}, + langid = {english}, +} + % Made-up bib entry % No date example @book{applebyND, @@ -329,7 +372,7 @@ options = {useeditor=false},% title first } -% Movie type exaple #2 +% Movie type example #2 % Someone has a dominant role (e.g. clearly responsible for the intellectual % content) ==> given as the creator at the first place @movie{vlacil1967marketa, @@ -409,7 +452,48 @@ urldate = {2020-03-25}, } +% Organization (corporate name) as author example +% Organization bib field example +@manual{dialog1985enhancements, + author = {{Dialog Information Services}}, + title = {Enhancements to the DIALOG Search System}, + subtitle = {DIALOG version 2 (user manual update)}, + date = {1985-11}, + location = {Palo Alto (California)}, + organization = {Dialog}, + note = {Technical Memo 5}, +} + +% currentlang package option example 1 +@article{tex:zpravodajchlebikova91, + author = {Chlebíková, Jana}, + title = {Ako rozděliť (slovo) Československo}, + journal = {Zpravodaj CSTUG}, + volume = 1, + number = 4, + year = 1991, + month = {04}, + pages = {10-13}, + doi = {10.5300/1991-4/10}, + note = {No langid}, +} + +% currentlang package option example 2 +@article{tex:zpravodajchlebikova91cz, + author = {Chlebíková, Jana}, + title = {Ako rozděliť (slovo) Československo}, + journal = {Zpravodaj CSTUG}, + volume = 1, + number = 4, + year = 1991, + month = {04}, + pages = {10-13}, + doi = {10.5300/1991-4/10}, + langid = {czech}, + note = {Czech langid}, +} + % Made-up ISBNs generated by https://generate.plus/en/number/isbn -% biber --tool --validate-datamodel --tool-fieldcase=lower --output-align mybib.bib +% biber --tool --validate-datamodel --tool-fieldcase=lower --output-align biblatex-iso690-examples.bib % + sort fields in the meaningful order diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf Binary files differindex 9a9386f5c73..027d98e299b 100644 --- a/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex index 92fa8bd246e..18a49018e4f 100644 --- a/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex +++ b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex @@ -32,8 +32,9 @@ % but the main document language is English pagetotal=true, ]{biblatex} +\usepackage{expl3} -\addbibresource{mybib.bib} +\addbibresource{biblatex-iso690-examples.bib} % Support diacritics in Czech examples % ref.: https://stackoverflow.com/a/16084246 @@ -77,8 +78,8 @@ url={https://github.com/michal-h21/biblatex-iso690}, author={Michal Hoftich}, email={michal.h21@gmail.com}, - revision={0.4.0}, - date={\DTMDate{2020-03-25}}} + revision={0.4.1}, + date={\DTMDate{2022-03-20}}} \hypersetup{% pdftitle={ISO~690 \biblatex style}, @@ -144,13 +145,11 @@ so feel free to use the possibilities provided there for reporting issues and th A minimal working example for \t|babel| package: \begin{ltxexample} \documentclass{article} -\usepackage[utf8]{inputenc} \usepackage[english,czech]{babel} -% \usepackage[main=czech,english]{babel} \usepackage{csquotes} \usepackage[style=iso-authoryear]{biblatex} -\addbibresource{mybib.bib} +\addbibresource{biblatex-iso690-examples.bib} \begin{document} \cite{knuth1990virtual} @@ -162,14 +161,13 @@ A minimal working example for \t|babel| package: A minimal working example for \t|polyglossia| package: \begin{ltxexample} \documentclass{article} -\usepackage[utf8]{inputenc} \usepackage{polyglossia} \setmainlanguage{czech} \setotherlanguage{english} \usepackage{csquotes} \usepackage[style=iso-authoryear]{biblatex} -\addbibresource{mybib.bib} +\addbibresource{biblatex-iso690-examples.bib} \begin{document} \cite{knuth1990virtual} @@ -185,6 +183,15 @@ per-entry basis in a resource (\t|.bib|) file. In addition, all of the languages specified in these fields have to be loaded by the \t|babel| or \t|polyglossia| package respectively. +The affected fields that should be printed as they appear in the +original source (in the language of resource, using the \t|langid| +field) are, e.g. numeration information (volume, number, edition, +etc.), while availability and access information (\textit{available +from}), medium designation (\t|howpubished| field), pages range, or +the relations of subsidiary creators (\textit{translated by}, +\textit{revised by}, etc.) are examples of using the main document +language. + Note that for correct support of localization functionality, the \t|babel| or \t|polyglossia| package should be used. The main document language is: @@ -198,6 +205,50 @@ is: \cmd{setotherlanguage}) (see MWE above) \end{description} +\subsubsection{Switching multiple languages} +\label{sec:general:currentlang} + +Sometimes the main document language is selected in the document +class, and the user can only switch the active language, not the main +language. This is usually a case of journals/collections of articles +that can be prepared (in their entirety) in one main language, but +where individual articles might also be written in a different +language (e.g., this is the case with \t|csbulletin| class). Then you +can use \t|currentlang| option (see also~\ref{sec:pkg:opt:iso690}), +which allows switching to the active surrounding language, and print +\biblatex localization strings accordingly to this currently selected +language, not the main language. + +The following MWE illustrates switching the active languages (English +and German over the main Czech language) on two bibliography entries, +one with the Czech \t|langid| field and the other without specified +language. + +\begin{ltxexample} + \documentclass{article} + \usepackage[T1]{fontenc} + \usepackage[main=czech,english,ngerman]{babel} + \usepackage{csquotes} + + \usepackage[style=iso-numeric,currentlang]{biblatex} + \addbibresource{biblatex-iso690-examples.bib} + + \begin{document} + + \nocite{tex:zpravodajchlebikova91} + \nocite{tex:zpravodajchlebikova91cz} + \printbibliography + + \selectlanguage{english} + \printbibliography + + \selectlanguage{ngerman} + \printbibliography + + \end{document} +\end{ltxexample} + + \subsection{Citation systems} \label{sec:citation:systems} @@ -380,6 +431,19 @@ Enable or disable printing publication information (\t|location| and \t|false| since it is very unusual behavior and rarely used by either other citation styles or citation managers. +\boolitem[false]{currentlang} + +By default, the main document language is used for printing of bibliography +strings. Some classes load the \t|babel| package and user cannot select the main +document language easily. With this option, the currently selected language +will be used instead (see also~\ref{sec:general:currentlang}). + +\boolitem[false]{noenddot} + +Enable or disable printing an end dot at the very end of bibliography +entries. The default value is \t|false|, meaning a dot is printed at +the end. + \end{optionlist} @@ -566,12 +630,12 @@ supervisor and school (institution) can be entered into the fields \paragraph{Patent}\hfill\\ \label{sec:patent} +The dominant role as an author has the holder of a patent (\t|holder| +field). The subsidiary author is an inventor (if known) of the patent +(\t|author| field). Application date fits in the \t|origdate| field, +while date of publication in the \t|date| field. The field \t|number| is available for the patent classification or request number. -If the inventor is also known, we can use \t|editora| and \t|editoratype| -fields to specify that. Use an additionally created role \t|inventor| for the -\t|editoratype| field; it is the key that translates based on the localization -strings. For the patent type, we can use localization strings as well, e.g. \t|patenteu|. \newline @@ -579,15 +643,15 @@ For the patent type, we can use localization strings as well, e.g. \c{groll2008method} \begin{ltxexample} @patent{groll2008method, - author = {Clad Metals LLC Canonsburg, PA 15317 (US)}, + holder = {{Clad Metals LLC Canonsburg, PA 15317 (US)}}, title = {Method of making a copper core five-ply composite and cooking vessel}, - editora = {Groll, W. A.}, - editoratype = {inventor}, + author = {Groll, W. A.},% <---------- inventor publisher = {Google Patents}, number = {EP 1 094 937 B1}, type = {patenteu}, - date = {2008-07-30}, + date = {2008-07-30},% <------------ publication date + origdate = {1999-05-04},% <------------ application date url = {https://patents.google.com/patent/EP1094937B1}, } \end{ltxexample} @@ -605,7 +669,16 @@ to the \biblatex documentation. \subsubsection{Creators} The persons or organizations responsible for the cited work should be -primarily given in the \t|author| field. If it is not appropriate, +primarily given in the \t|author| field. Please note that organization +names (so-called corporate authors) need to be protected with doubled +curly braces to avoid being (mis)parsed into family/given names +(resulting in wrong order and formatting). + +\begin{ltxexample} + author = {{Dialog Information Services}}, +\end{ltxexample} + +If the \t|author| is not appropriate, other fields like \t|editor| and \t|editorX| family fields or some specific ones (e.g. \t|translator|) can be used. Note also the field \t|editortype| and \t|editortypeX| family fields which can be used @@ -765,6 +838,21 @@ see~\parencite{gosse1912garden}. \begin{changelog} +\begin{release}{0.4.1}{2022-03-20} +\item Added \t|currentlang| package option.\see{sec:pkg:opt:iso690} +\item Added mapping from \t|ngerman| to \t|german| language. +\item Added Spanish language support. +\item Removed \t|inputenc| package from examples. +\item Added \t|expl3| package in the documentation to fix compilation error. +\item Prevent capitalisation of the \t|[online]| bibliography string.\see{sec:howpublished} +\item Fix punctuation before \t|urldate| if publisher info is missing. +\item Print \t|organization| field in publisher \t|location+publisher| list. +\item Improved support for \t|@patent| entries.\see{sec:patent} +\item Improved documentation. +\item Fixed missing \t|volume| and \t|volumes| fields. +\item Added \t|noenddot| package option.\see{sec:pkg:opt:iso690} +\end{release} + \begin{release}{0.4.0}{2020-03-25} \item Fixed deprecated name handling \item Declared mapping suffix (\t|<lang>-iso.lbx|) for localization files |