1 files changed, 72 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex/zootaxa-bst/example.tex b/Master/texmf-dist/doc/bibtex/zootaxa-bst/example.tex
new file mode 100644
index 00000000000..52f2d0842cf
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/zootaxa-bst/example.tex
@@ -0,0 +1,72 @@
+\documentclass{article}
+
+\usepackage{natbib}
+\usepackage{amsmath}
+\usepackage[USenglish]{babel}
+\usepackage[utf8]{inputenc}
+\usepackage[colorlinks=true,citecolor=blue]{hyperref}
+
+\author{Gustavo A. Ballen}
+\date{\today}
+\title{An example manuscript using the \texttt{zootaxa.bst} reference style for Bib\TeX}
+
+\begin{document}
+
+\maketitle
+
+This example uses \texttt{natbib} for handling taxonomic author citations, that behave a bit different from usual bibliographic citations. For details see this blog post: https://gaballench.wordpress.com/2019/03/22/referencing-zoological-name-authorships-in-latex/
+
+The usage is pretty simple: Just install \texttt{zootaxa.bst} in a place where \texttt{bibtex} can find it and the compile a couple times with bibtex before compiling with latex. Rinse and repeat if needed. Also, don't forget to create your \texttt{bibtex} \texttt{.bib} bibliography file. Please note that three lines are absolutely necessary for this:
+
+\begin{verbatim}
+\documentclass{article}
+
+\usepackage{natbib}
+...
+...
+...
+\bibliographystyle{zootaxa}
+\bibliography{example-refs}
+
+\end{document}
+\end{verbatim}
+
+The command \texttt{usepackage} activates the \texttt{natbib} package necessary for managing references. The command \texttt{bibliographystyle} will tell the system to use \texttt{zootaxa.bst}. The command \texttt{bibliography} points the \texttt{.bib} file. Please note that the fact that we are not indicating paths indicates that 1) the files are in the path (in the case of the package if it was installed where the system can find it),  or the in working directory where the remaining files are found (e.g., the bibliography file). 
+
+The Instructions for Authors on zootaxa's website indicate that:
+
+
+    A) Journal paper: 
+    Smith, A. (1999) Title of the paper. Title of the journal in full, volume number, page range. 
+
+    B) Book chapter: 
+    Smith, A. \& Smith, B. (2000) Title of the Chapter. In: Smith, A, Smith, B. \& Smith, C. (Eds), Title of Book. Publisher name and location, pp. x–y. 
+
+    C) Book: 
+    Smith, A., Smith, B. \& Smith, C. (2001) Title of Book. Publisher name and location, xyz pp.
+
+    D) Internet resources
+    Author (2002) Title of website, database or other resources, Publisher name and location (if indicated), number of pages (if known). Available from: http://xxx.xxx.xxx/ (Date of access).
+
+Dissertations resulting from graduate studies and non-serial proceedings of conferences/symposia are to be treated as books and cited as such. Papers not cited must not be listed in the references.
+
+Also, the separator between authors should the the ampersand (\&), and the abbreviation \textit{et allii} should be italized (\textit{et al.})
+
+All of these aspects are handled automatically by \texttt{zootaxa.bst}. For instance, the following text will make use of several references that will be rendered into text according to rules of zootaxa, while generating the references also in the appropriate format.
+
+\section{Live example}
+
+Seven genus-group names based on extant taxa have been allocated to the Sphyraenidae: \textit{Agriosphyraena} \citealp{Fowler1903} (type \textit{Esox barracuda}), \textit{Australuzza} \citealp{Whitley1947} (type \textit{Sphyraena novaehollandiae}), \textit{Callosphyraena} \citealp{Smith1956} (type \textit{Sphyraema toxeuma}, junior synonym of \textit{Sphyraena forsteri}), \textit{Indosphyraena} \citealp{Smith1956} (type \textit{Sphyraena africana}), \textit{Sphyraenella} \citealp{Smith1956} (type \textit{Sphyraena flavicauda}), and \textit{Sphyraena} \citealp{Artedi1793} (type \textit{Esox sphyraena}). All of these genera are currently considered synonyms of \textit{Sphyraena}. \cite{Smith1956} elevated all the previous names to subgeneric rank, while \citet{DeSylva1963} deemed such actions unjustified, synonymizing all of these into \textit{Sphyraena} Röse (correct authorship is by Artedi instead).
+
+\citet{Santini2015} has presented an overview of six fossil species names associated with \textit{Sphyraena}; these authors mentioned \textit{Sphyraena fluctuosa} as a Sphyraenid species based on otolihts; however, such species was originally described by \citet{Nolf1972} in the genus \textit{Platycephalus} (Scorpaeniformes) and subsequently ratified in that genus \citep[e.g.,][]{Huyghebaert1979}. It is herein excluded from the Sphyraenid fossil species. \textit{Sphyraena intermedia} \citealp{Bassani1889} was mentioned also by Santini et al. without noting that another species of extant \textit{Sphyraena} was described with the same specific epithet \citep{Pastore2009}; therefore the latter species by Pastore is herein found to be primary homonym of \textit{Sphyraena intermedia} \citep{Bassani1889}, a fossil species known from the Oligocene of Italy and consequently the name by Pastore is deemed permanently invalid under Article 57.2 of the \citet{ICZN1999}.
+
+The style handles properly situations just like web pages through the \texttt{@misc} tag \citep[e.g., ][]{EschmeyerWeb} and book sections \citep{Switchenska1968,Bohm1924}.
+
+\section{Acknowledgements}
+
+First of all to the open source community for doing all this sharing and modification possible for newer and case-specific uses. I never thought there will be the day that one could prepare a manuscript for zootaxa entirely in \LaTeX and this is a step forward. This late-hours project was indirectly funded by FAPESP through a doctoral scholarship. Many thanks to the Stack Overflow community. This as much of the software projects are speeded up a lot by its existence.
+
+\bibliographystyle{zootaxa}
+\bibliography{example-refs}
+
+\end{document}
+\ No newline at end of file