summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-iso690
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-05-14 22:10:23 +0000
committerKarl Berry <karl@freefriends.org>2016-05-14 22:10:23 +0000
commite28c751e2974cde2d2ccdd4f9c2710a31b918838 (patch)
treecd85030e0c477742571b53aab7a1590c399e6595 /Master/texmf-dist/doc/latex/biblatex-iso690
parent0892468520b6036f55c4e0dbcf6b6da48222a183 (diff)
biblatex-iso690 (14may16)
git-svn-id: svn://tug.org/texlive/trunk@41126 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-iso690')
-rwxr-xr-xMaster/texmf-dist/doc/latex/biblatex-iso690/README74
-rwxr-xr-xMaster/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdfbin0 -> 165553 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex516
3 files changed, 590 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/README b/Master/texmf-dist/doc/latex/biblatex-iso690/README
new file mode 100755
index 00000000000..88f6ab05d02
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-iso690/README
@@ -0,0 +1,74 @@
+Style ISO 690 for biblatex
+==========================
+
+Biblatex is bibliography and citation tool for LaTeX. This project provides
+support for citations in ISO 690 style. As the norm is a little bit ambiguous
+in some details regarding formatting of records, we largely follow
+requirements of Czech interpretation, as it is required form in many Czech
+universities. Style can be used in other languages as well, of course.
+
+Install
+-------
+
+Open the terminal and find location of your TEXMFHOME directory with this command.
+
+ kpsewhich -var-value TEXMFHOME
+
+Open this directory using and check that directory $TEXMFHOME/tex/latex exists.
+If it doesn't exist, you must create it. You can do this from the
+command line or using a file manager. Open the $TEXMFHOME/tex/latex directory and either
+run command
+
+ git clone git@github.com:michal-h21/biblatex-iso690.git
+
+or unzip file
+
+ https://github.com/michal-h21/biblatex-iso690/archive/master.zip
+
+here. You should be able to use biblatex-iso690 now.
+
+
+
+Usage:
+------
+...
+\usepackage[english,czech]{babel} % main language of the document must be last
+\usepackage[
+ backend=biber % if we want unicode
+ ,style=iso-authoryear % or iso-numeric for numeric citation method
+ ,autolang=other % to support multiple languages in bibliography
+ ,sortlocale=cs_CZ % locale of main language, it is for sorting
+ ,bibencoding=UTF8 % this is necessary only if bibliography file is in different encoding than main document
+]{biblatex}
+...
+
+Custom options:
+ spacecolon
+ add space before colon in publisher and title:
+ [true] Praha : Academia
+ [false] Praha: Academia
+
+Bibliographic fields:
+Some fields have different meaning than in plain BibTeX.
+
+1. if publication is written in other language than the main document is, it should have filled "langid" field
+
+ langid = {czech}
+
+2. publications with online versions should have "urldate" field. it is date when you last checked publication online
+
+ urldate = {2011-01-12},
+
+3. if publication has more isbn or issn numbers, use just one of them
+
+4. publisher and place
+
+ location = {Praha},
+ publisher = {Academia}
+
+For more details see file mybib.bib
+
+License
+-------
+
+GNU/GPL 3
diff --git a/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.pdf
new file mode 100755
index 00000000000..a27b9dac17c
--- /dev/null
+++ 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
new file mode 100755
index 00000000000..5e397a77c2e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-iso690/biblatex-iso690.tex
@@ -0,0 +1,516 @@
+\documentclass[a4paper,10pt]{ltxdockit}
+\usepackage[czech,english]{babel}
+\usepackage[utf8]{inputenc}
+%\usepackage{tgpagella}
+\usepackage[T1]{fontenc}
+\usepackage{microtype}
+\usepackage{hanging}
+
+
+\def\t|#1|{\texttt{#1}}
+\def\c#1{%
+\hangpara{3em}{1}%
+\fullcite{#1}}
+
+\newcommand*{\biber}{\sty{biber}\xspace}
+\newcommand*{\biblatex}{\sty{biblatex}\xspace}
+
+\usepackage[
+ backend=biber
+ ,style=iso-authoryear
+ ,autolang=other
+ ,pagetotal=true
+ ,sortlocale=cs_CZ
+ ,bibencoding=UTF8
+ ,spacecolon=false
+ %,block=ragged
+]{biblatex}
+
+\addbibresource{mybib.bib}
+
+\titlepage{%
+ title={ISO~690 \biblatex style},
+ subtitle={},
+ url={https://github.com/michal-h21/biblatex-iso690},
+ author={Michal Hoftich},
+ email={michal.h21@gmail.com},
+ revision={0.3.1},
+ date={\today}}
+
+\hypersetup{%
+ pdftitle={ISO~690 \biblatex style},
+ pdfsubject={Bibliography References and Citations by ISO~690},
+ pdfauthor={Michal Hoftich with Johannes Böttcher, Moewew and Dávid Lupták},
+ pdfkeywords={tex, latex, bibtex, biblatex, bibliography, references, citation}}
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+\section{Introduction}
+
+\subsection{About}
+
+\biblatex is a bibliography and citation tool for \LaTeX. This project provides
+support for citations and references according to the ISO~690 international standard.
+As the norm ISO~690 is a little bit ambiguous in some details regarding formatting of records,
+we largely follow requirements of Czech interpretation, as it is required form
+in many Czech universities. Of course, style can be used in other languages as well.
+
+\subsection{Requirements}
+
+Basically, \biblatex $\geq$ 3.4 with \biber $\geq$ 2.5 is all you need to use this package.
+No special packages different from those required by \biblatex package are used. For complete
+list of such packages, please refer to the \biblatex documentation.
+
+\subsection{License}
+
+This project is released under GNU/GPL 3\footnote{\url{http://www.gnu.org/licenses/gpl.txt}} license.
+
+\subsection{Acknowledgments}
+
+Thanks to all contributors who have participated on the development of this style,
+especially Johannes Böttcher, Moewew, Dávid Lupták and others.
+
+\subsection{Feedback}
+
+The project lives on the GitHub page \url{https://github.com/michal-h21/biblatex-iso690}
+so feel free to use the possibilites provided there for reporting issues and the like.
+
+\section{Use}
+
+\subsection{General}
+
+\begin{verbatim}
+..
+\usepackage[english,czech]{babel}
+% or in case of using xelatex, use polyglossia package instead
+\usepackage{polyglossia}
+\setmainlanguage{czech}
+\setotherlanguage{english}
+..
+\usepackage[
+ backend=biber
+ ,style=iso-authoryear
+ ,sortlocale=cs_CZ
+ ,autolang=other
+ ,bibencoding=UTF8
+]{biblatex}
+\addbibresource{filename.fileextension}
+..
+\printbibliography
+
+\end{verbatim}
+
+According to the ISO~690 norm, some of the elements of the bibliographic
+resource should be printed in the main document language (language I~am
+currently writing) while the others in the language of a resource. You can
+specify the language of a resource into the field \t|langid| on the per-entry
+basis in a resource (\t|.bib|) file. In addition, all of the languages
+specified in these fields have to be loaded by \t|babel| or \t|polyglossia|
+package respectively.\label{gen:multilang}
+
+Note that for correct support of localization functionality, the \t|babel|
+package should be used. The main document language is the last one entered
+in a list of languages passed to this package.
+
+\subsection{Package options}
+
+\subsubsection{Provided by \biblatex by default}
+
+Frequently used package options are
+
+\begin{description}
+\item[style] style to be used for bibliographic references and citations.
+Three possibilities are available, \t|iso-authoryear| commonly known as
+Harvard system, \t|iso-numeric| as a numeric system and \t|iso-authortitle|.
+
+\item[backend] backend program for generating bibliographic entries. \biber
+is the default one for \biblatex package, providing a big variety
+of features. Another options are \t|bibtex| and \t|bibtex8|, but they both
+are far behind the possibilities of \biber. \biber is the recommended backend.
+
+\item[autolang] controls which language environment is used. The most
+significant value is \t|other|, which supports printing localization
+terms in language of resource or language specific hyphenation. Default
+value is \t|none|, which disables this feature.
+
+\item[sortlocale] responsible for sorting the bibliography according to the
+entered \t|locale| language identifier. The main document language one should
+be set.
+
+\item[bibencoding] specifies the encoding of the \t|bib| files. \t|<encoding>|
+needs to be explicitly specified only if the encoding of the \t|bib| file
+is different from the one of the \t|tex| file. Default value is \t|auto|, i.e.
+the encoding of the \t|bib| file is identical to the encoding of the \t|tex|
+file.
+\end{description}
+
+\subsubsection{Provided by \t|biblatex-iso690| in addition}
+
+\begin{description}
+ \item[spacecolon] if \t|true|, the space is printed before the colon
+ used in subtitles and publication information. Printing the colon this way
+ is not recommended. Default value is \t|false|.
+
+ \item[pagetotal] number of total pages is no longer required if the item
+ is being cited as a whole. Setting this option to \t|true| will print
+ such optional information in the notes section at the end of the reference.
+ Default value is \t|false|.\label{pkg:opt:iso690:pp}
+
+ \item[shortnumeration] the standard ISO~690 allows omission of term
+ \t|volume| and terms for smaller components of a serial publication.
+ If this option is \t|true|, such terms are distinguished typographically
+ (the volume number in bold type and the part number, if required, in
+ parentheses). If \t|false|, such terms are printed with preceding
+ literal terms.
+
+ \item[thesisinfolast] whether or not to print information about
+ thesis (i.e. type, institution or supervisor) in the note section
+ is ambiguous, print it before the section \textit{availability
+ and access} is possible by setting this option to \t|false|.
+ Default value is \t|true|.
+\end{description}
+
+
+\subsection{Database guide}
+
+\t|biblatex| supports more entry fields than legacy \t|bibtex|. Hence
+some examples of bibliography entry types with respective fields follow.
+
+%\begin{description}
+
+\paragraph{Book} \hfill\\
+
+\c{t01}
+\begin{verbatim}
+@BOOK{t01,
+ author = {Borgman, Christine L.},
+ year = {2003},
+ title = {From Gutenberg to the global information infrastructure},
+ subtitle = {access to information in the networked world},
+ edition = {1}, % should be not stated
+ location = {Cambridge (Mass)},
+ publisher = {The MIT Press},
+ pagetotal = {xviii, 324},
+ isbn = {0-262-52345-0},
+ langid = {english}
+}
+\end{verbatim}
+
+The \t|edition| field is edition of a printed publication. It's required
+if the item is not a first edition. Use integer or literal string to fill in
+this field.
+
+The \t|pagetotal| field is total number of pages of the work. If multiple
+kinds of numeration is used in the work, e.g. arabic as well as roman numerals,
+both can be provided, separated by a comma. Only for arabic numerals
+the localization term \t|pages| is appended. Note that total number of pages
+is no longer required by the norm itself, see also \ref{pkg:opt:iso690:pp}.
+
+The \t|langid| field is required for multilingual support of printing
+references. This affects printing of localization terms used in the reference,
+e.g. \t|edition| field. See also \ref{gen:multilang}.
+
+\paragraph{Contribution to a collection} \hfill\\
+
+\c{t02}
+\begin{verbatim}
+@INCOLLECTION{t02,
+ author = {Greenberg, David},
+ year = {1998},
+ title = {Camel drivers and gatecrashers},
+ subtitle = {quality control in the digital research library},
+ editor = {Hawkins, B.L and Battin, P},
+ booktitle = {The mirage of continuity},
+ booksubtitle = {reconfiguring academic information
+ resources for the 21st century},
+ location = {Washington (D.C.)},
+ publisher = {Council on Library and Information Resources;
+ Association of American Universities},
+ pages = {105-116},
+ langid = {english}
+}
+\end{verbatim}
+
+The \t|title| field is title of the contribution, the \t|booktitle|
+is title of the collection.
+
+The \t|pages| field is one or more page numbers or page ranges. This field
+is essential since the reference should identify the part of the item
+that is cited.
+
+It's also possible to use the cross-referencing feature to reference
+from a contribution entry (child entry) to a separate entry of a collection
+(parent entry). This can be done by the field \t|crossref|
+as the following example shows:
+\newline
+
+\noindent\c{prispevek1}
+
+\begin{verbatim}
+@COLLECTION{sbornik,
+ title = {Mimořádně užitečný sborník},
+ editor = {Geniální, Jiří},
+ year = {2007},
+ langid = {czech},
+ location = {Praha},
+ publisher = {Academia},
+ isbn = {978-222-626-222-2}
+}
+
+@INCOLLECTION{prispevek1,
+ crossref = {sbornik},
+ title = {Velmi zajímavý článek},
+ author = {Vlaštovka, Josef},
+ pages = {22-45}
+}
+\end{verbatim}
+
+Now, there is no need to fill in \t|booktitle| in the \t|sbornik| entry.
+The \t|biber| backend program performs the inheritance between parent and
+child entry automatically.
+
+\paragraph{Article in a serial}\hfill\\
+
+\c{t03}
+\begin{verbatim}
+@ARTICLE{t03,
+ author = {LYNCH, C.},
+ year = {2005},
+ title = {Where do we go from here?},
+ subtitle = {the next decade for digital libraries},
+ journaltitle = {DLib Magazine},
+ volume = {11},
+ number = {7/8},
+ urldate = {2005-08-15},
+ url = {http://www.dlib.org/dlib/july05/lynch/07lynch.html},
+ issn = {1082-9873},
+ langid = {english}
+}
+\end{verbatim}
+
+The example above is an article in online magazine. If the magazine
+is available online only, i.e. it is not published in print,
+it should be cited as an electronic information resource. This can be
+achieved by providing the \t|urldate| field. On the other hand
+\newline
+
+\c{knuth}
+\begin{verbatim}
+@PERIODICAL{tug,
+ journaltitle = {TUGBoat},
+ publisher = {TUG},
+ issn = {1222-3333},
+ langid = {english},
+ date = {1980/},
+ url = {http://tugboat.tug.org/}
+}
+
+@ARTICLE{knuth,
+ author = {Knuth, Donald},
+ title = {Journeys of \TeX},
+ volume = {17},
+ number = {3},
+ year = {2003},
+ pages = {12-22},
+ url = {http://tugboat.tug.org/kkk.pdf},
+ crossref = {tug}
+}
+\end{verbatim}
+
+\noindent the example shows an article in printed magazine, which is also
+available online. Similar to the contribution to a collection,
+using cross-referencing feature can be of benefit.
+
+\subsubsection{Specific entry types}
+
+\paragraph{Thesis}\hfill\\
+
+The entry type \t|thesis| and its aliases \t|mastersthesis| and
+\t|phdthesis| are available by default for thesis works. Use the
+\t|type| field to specify the type of the thesis -- localization
+term or literal string could be entered. For the list of supported
+localization terms, please refer to section 4.9.2.13 of the
+\t|biblatex| documentation. Names of the supervisor and school
+(institution) can be entered into the fields \t|supervisor| and
+\t|institution|, respectively.
+
+\paragraph{Patent}\hfill\\
+
+The field \t|classification| is available for the respective stuff.
+For other details regarding \t|patent| type, please refer
+to the \t|biblatex| documentation.
+
+\subsection{Hints and Caveats}
+
+This section provides additional hints concerning \t|biblatex| package
+as well as ISO~690 standard.
+
+For now, some of the things has to be dealt with at the level of \t|bib|
+file, another ones are directly addressed in this style package.
+Everything else relies on the \t|biblatex| package, so please also refer
+to the \t|biblatex| documentation.
+
+\subsubsection{Creators}
+
+The persons or organizations responsible for the cited work should be
+primarily given into the \t|author| field. If it's not appropriate,
+another 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
+to specify type of the editor. This is useful to distinguish the role
+of the creator and its relationship to the cited work. Some roles
+are supported by default, e.g. \t|editor|, \t|compiler|, \t|founder|,
+\t|reviser|, etc., in other cases the literal string can be entered.
+
+Example:
+When citing cinematographic works which are typically output of many
+individuals, title should be used as the first element of the reference.
+However, it's appropriate to include some relevant roles, e.g. director:
+
+%\begin{ltxexample}
+\begin{verbatim}
+ ..
+ editora = {Welles, Orson}
+ editoratype = {Directed by}
+ ..
+\end{verbatim}
+%\end{ltxexample}
+
+in English, or
+
+%\begin{ltxexample}
+\begin{verbatim}
+ ..
+ editora = {Welles, Orson}
+ editoratype = {Réžia}
+ ..
+\end{verbatim}
+%\end{ltxexample}
+
+in Slovak.
+
+The field \t|nameaddon| can be used to append additional information
+to the creator's name, e.g. variant forms of a name, name additions,
+pseudonyms, etc. This field is printed as is, in square brackets after
+creator's name.
+
+For anonymous works cited by author-year method, the term \textit{Anon}
+should be used instead of creator's name. Please, reflect this
+in \t|bib| file, since there is no other support for this for now.
+
+\subsubsection{Titles}
+
+Similar to the \t|nameaddon| field for names, \t|titleaddon| serves such
+purpose for titles. This field is appropriate for providing other or
+alternative titles, elucidation of ambiguous or incorrect titles,
+substitute for no titles, translation of titles, etc.
+
+Note that also other \t|*titleaddon| fields are supported by default.
+
+\subsubsection{Medium type}
+
+The field \t|howpublished| is used for providing information about
+medium designation or type of medium. Default value for electronic
+information resources is \t|online|. This field is printed as is,
+in square brackets after title section, generally.
+
+\subsubsection{Edition}
+
+The \t|edition| field is edition of a publication. It's required
+if the item is not a first edition. Use integer or literal string
+to fill in this field. Please reflect the constraint, not to print
+the edition if the cited item is a first edition, by not providing
+this field in the \t|bib| file.
+
+The \t|version| field is used for providing information about
+updated versions of an item, usually software.
+
+\subsubsection{Date}
+
+In case no date is given and also no approximation is possible, that
+should be stated. Please reflects this in \t|bib| file by including
+the following line into the respective entry.
+
+\begin{verbatim}
+ ..
+ date = {\mkbibbrackets{\bibsstring{nodate}}}
+ ..
+\end{verbatim}
+
+Explanation of the above code:
+\t|nodate| is localization string which prints something like
+\textit{n.d.}, \textit{b.r.}, etc. depending on the language,
+\t|bibsstring| is a command to use such localization term and
+\t|mkbibbrackets| is a command used to wrap it's argument into
+the square brackets. Finally, this statement is entered into
+the date entry field to be available as a date in a reference.
+So as a result we get e.g. \textit{[n.d.]}, which conforms
+the standard.
+
+Please also note the syntax for dates -- ISO 8601 format
+(YYYY-MM-DD) is accepted. Please use slash instead of
+any kind of dash for ranges of dates. If the range is
+open ended, enter just the first date followed by a slash.
+And last, but not least, use \t|date| field instead of
+the \t|year| in general.
+
+Examples follow:
+
+\begin{verbatim}
+ date = {2012-12-21} % exact date
+ date = {1998/2001} % date range
+ date = {2016/} % open ended date range
+\end{verbatim}
+
+\subsubsection{Location}
+
+If only limited number of copies of the work exists or
+location of graphic work is essential to its identification,
+such location (e.g. library or repository) should be stated
+in a reference. The field \t|library| serves for this purpose.
+
+\nocite{*}
+\printbibliography[title={Reference bibliography},heading={bibnumbered}]
+
+
+\section{Revision history}
+
+\begin{changelog}
+
+\begin{release}{0.3.1}{2016-05-13}
+\item Added support for entry types \t|thesis| and \t|patent|
+\item Added support for including location information (\t|library| field)
+\item Added Slovak localization
+\item Removed non-breaking space after standard identifier terms
+\item Streamlined the author-title citation style
+\item Minor doc corrections
+\end{release}
+
+\begin{release}{0.3}{2016-05-04}
+\item A~complete refactoring of the style to comply the latest version of the \t|biblatex| package as well as ISO~690 international standard
+\item Added english version of the documentation/user guide (this document)
+\end{release}
+
+\begin{release}{0.2.1}{2016-03-13}
+\item Solved issues about punctuation marks and redundant spaces
+\item Compatibility support for the latest version of the \t|biblatex| package
+\item Reformatted the driver for \verb|inbook| entry type
+\end{release}
+
+\begin{release}{0.2}{2015-03-25}
+\item Gathered changes during past four years
+\item Solved issue about the spacing of strings in main document language
+\end{release}
+
+\begin{release}{0.1}{2011-02-03}
+\item First release
+\item Draft of the documentation (only in Czech)
+\item Support for almost all of the entry types provided by the \t|biblatex| package
+\end{release}
+
+\end{changelog}
+
+\end{document}