summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-iso690/README.md26
-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.pdfbin258286 -> 277123 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex122
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
index 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
Binary files differ
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