From 2a49c67eee870febe71143a093f3c304e0033153 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Tue, 22 Jun 2021 03:00:55 +0000 Subject: CTAN sync 202106220300 --- biblio/bibtex/contrib/apalike-ejor/README.md | 8 +- .../bibtex/contrib/apalike-ejor/apalike-ejor.bst | 81 ++++++++++----- .../contrib/apalike-ejor/example-references.bib | 33 ++++-- biblio/bibtex/contrib/apalike-ejor/example.pdf | Bin 124394 -> 142998 bytes biblio/bibtex/contrib/apalike-ejor/example.tex | 114 ++++++++++++++++++--- 5 files changed, 181 insertions(+), 55 deletions(-) (limited to 'biblio') diff --git a/biblio/bibtex/contrib/apalike-ejor/README.md b/biblio/bibtex/contrib/apalike-ejor/README.md index 74bcd5d4e5..09e2e170b0 100644 --- a/biblio/bibtex/contrib/apalike-ejor/README.md +++ b/biblio/bibtex/contrib/apalike-ejor/README.md @@ -1,6 +1,6 @@ -# `apalike-ejor` +# apalike-ejor - + This is a BibTeX `apalike-ejor` bibliography style, forked from [`apalike`](https://www.bibtex.com/s/bibliography-style-base-apalike/) version 0.99a by Oren Patashnik. The original copyright and documentation are included in the file. @@ -15,9 +15,11 @@ Specific deviations from the original `apalike` settings include the following: * Added a hyperlinked DOI field (requires `hyperref`). * Removed address information from publisher names. * Removed editor information, publisher information, and the words "In" and "pages" from conference proceedings. - * Removed "Thesis" label from theses. + * Removed "Thesis" label and address from theses. * Changed book edition to follow the title in parentheses, and abbreviated "edition". * Added chapter and page number support for books. + * Added a new dataset field for misc references. If it contains any value besides "0" or "false", the string "[dataset]" is prepended to the reference. + * Moved the note field to the end of references (except for unpublished). ## Installation and Usage diff --git a/biblio/bibtex/contrib/apalike-ejor/apalike-ejor.bst b/biblio/bibtex/contrib/apalike-ejor/apalike-ejor.bst index 75ae881ed5..8bfdb80b63 100644 --- a/biblio/bibtex/contrib/apalike-ejor/apalike-ejor.bst +++ b/biblio/bibtex/contrib/apalike-ejor/apalike-ejor.bst @@ -1,4 +1,4 @@ -% apalike-ejor v1.1.0 +% apalike-ejor v1.2.0 % Copyright (C) 2021 Adam Rumpf % % BibTeX `apalike-ejor' bibliography style, forked from the `apalike' style, @@ -14,14 +14,19 @@ % - Changed `and' to `\&' in lists of multiple authors. % - Changed `:' to `, ' between volume number and page numbers. % - Added a hyperlinked URL field (requires hyperref). -% - Added a hyperlinked DOI field (requires hyperref). +% - Added a hyperlinked DOI field (requires hyperref). If both the DOI and +% URL fields are present, the DOI is preferred. % - Removed address information from publisher names. % - Removed editor information, publisher information, and the words "In" and % "pages" from conference proceedings. -% - Removed thesis label from theses. +% - Removed thesis label and address from theses. % - Book edition numbers are in parentheses following the title, and % abbreviated "edition" to "ed.". % - Added an optional chapter number for books. +% - Added a new dataset field for misc references. If it contains any value +% besides "0" or "false", the string "[dataset]" is prepended to the +% reference. +% - Moved the note field to the end of references (except for unpublished). % % ============================================================================= % @@ -68,13 +73,15 @@ % this release clarified the license. % 18-jun-21 (AR) Modifications made by Adam Rumpf to comply with the EJOR % bibliography style guide. +% 21-jun-21 (AR) Modified misc formatting and added dataset field support. ENTRY { address author booktitle chapter - doi % added for apalike-ejor + dataset % unique field added for apalike-ejor + doi % added for apalike-ejor edition editor howpublished @@ -237,17 +244,30 @@ FUNCTION {format.urlending} % formats ending for doi and/or url fields doi missing$ { url missing$ - { fin.entry + { note output + fin.entry } { new.block % use url if no doi format.url output - fin.npentry + note missing$ + { fin.npentry } + { new.block + note output + fin.npentry + } + if$ } if$ } - { new.block % use doi if present + { new.block % use doi if present format.doi output - fin.npentry + note missing$ + { fin.npentry } + { new.block + note output + fin.npentry + } + if$ } if$ } @@ -551,6 +571,17 @@ FUNCTION {format.incoll.inproc.crossref} " \cite{" * crossref * "}" * } +FUNCTION {format.dataset} % unique "dataset" field for apalike +{ dataset empty$ % prints "[dataset]" for any value besides "0" or "false" + { "" } + { dataset "0" = dataset "l" change.case$ "false" = or + { "" } + { "[dataset]" } + if$ + } + if$ +} + FUNCTION {article} { output.bibitem format.authors "author" output.check @@ -568,7 +599,7 @@ FUNCTION {article} } if$ new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -598,14 +629,12 @@ FUNCTION {book} new.block format.number.series output new.sentence - %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% chapter missing$ % adding chapter number for apalike-ejor { publisher output } { publisher " " * format.chapter.pages * output } if$ - %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % address output removing publisher address for apalike-ejor } { new.block @@ -613,7 +642,7 @@ FUNCTION {book} } if$ new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -628,7 +657,7 @@ FUNCTION {booklet} howpublished output address output new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -664,7 +693,7 @@ FUNCTION {inbook} if$ format.edition output new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -691,7 +720,7 @@ FUNCTION {incollection} } if$ new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -718,7 +747,7 @@ FUNCTION {inproceedings} } if$ new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -736,7 +765,7 @@ FUNCTION {manual} address output format.edition output new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -750,14 +779,18 @@ FUNCTION {mastersthesis} new.block % "Master's thesis" format.thesis.type output.nonnull remove for apalike-ejor school "school" output.check - address output +% address output % removing address for apalike-ejor new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } FUNCTION {misc} { output.bibitem + format.dataset "" = % unique "dataset" field for apalike-ejor + { skip$ } + { format.dataset " " * write$ } + if$ format.authors output author format.key output % special for output.year.check % apalike @@ -766,7 +799,7 @@ FUNCTION {misc} new.block howpublished output new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -780,9 +813,9 @@ FUNCTION {phdthesis} new.block % "PhD thesis" format.thesis.type output.nonnull remove for apalike-ejor school "school" output.check - address output +% address output % removing address for apalike-ejor new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -800,7 +833,7 @@ FUNCTION {proceedings} organization output % a nonempty organization publisher output % here new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } @@ -816,7 +849,7 @@ FUNCTION {techreport} institution "institution" output.check address output new.block - note output +% note output % note handled in urlending format.urlending % auto-formatted doi/url ending } diff --git a/biblio/bibtex/contrib/apalike-ejor/example-references.bib b/biblio/bibtex/contrib/apalike-ejor/example-references.bib index 27babec036..bbb05bb283 100644 --- a/biblio/bibtex/contrib/apalike-ejor/example-references.bib +++ b/biblio/bibtex/contrib/apalike-ejor/example-references.bib @@ -7,37 +7,48 @@ publisher = {Prentice Hall}, title = {{Network Flows: Theory, Algorithms, and Applications}}, year = {1993} } - @article{kinney2005, author = {Kinney, R and Crucitti, P and Albert, R and Latora, V}, doi = {10.1140/epjb/e2005-00237-9}, journal = {European Physical Journal B}, pages = {101--106}, -title = {{Modeling cascading failures in the North American power grid}}, +title = {{Modeling cascading failures in the North American power + grid}}, volume = {46}, year = {2005} } - @inproceedings{cavdaroglu2010, -author = {Cavdaroglu, B and Nurre, S G and Mitchell, J E and Sharkey, T C and Wallace, W A}, -booktitle = {Vulnerability, Uncertainty, and Risk: Analysis, Modeling, and Management}, +author = {Cavdaroglu, B and Nurre, S G and Mitchell, J E and + Sharkey, T C and Wallace, W A}, +booktitle = {Vulnerability, Uncertainty, and Risk: Analysis, + Modeling, and Management}, editor = {Ayyub, B M}, pages = {171--179}, publisher = {American Society of Civil Engineers}, -title = {{Decomposition Methods for Restoring Infrastructure Systems}}, +title = {{Decomposition Methods for Restoring Infrastructure + Systems}}, url = {https://ascelibrary.org/doi/10.1061/41170(400)21}, year = {2010} } - @misc{kaul2021, -author = {Kaul, H and Rumpf, A}, -doi = {10.17632/ptzc7jxhmn}, +author = {Kaul, Hemanshu and Rumpf, Adam}, +dataset = {1}, +doi = {10.17632/ptzc7jxhmn.1}, howpublished = {Mendeley Data, V1}, -title = {{A linear input dependence model for interdependent networks}}, +title = {{A linear input dependence model for interdependent + networks}}, +url = {https://data.mendeley.com/datasets/ptzc7jxhmn/1}, year = {2021} } - +@misc{rumpf2019, +author = {Rumpf, Adam}, +note = {Accessed May 8, 2020}, +title = {{MCNFLI Computational Trials}}, +url = {https://github.com/adam-rumpf/mcnfli-trials}, +year = {2019} +} @phdthesis{schmocker2006, +address = {London, England}, author = {Schm\"ocker, J-D}, school = {Imperial College London}, title = {{Dynamic Capacity Constrained Traffic Assignment}}, diff --git a/biblio/bibtex/contrib/apalike-ejor/example.pdf b/biblio/bibtex/contrib/apalike-ejor/example.pdf index 25a532b66f..8fa908b6e4 100644 Binary files a/biblio/bibtex/contrib/apalike-ejor/example.pdf and b/biblio/bibtex/contrib/apalike-ejor/example.pdf differ diff --git a/biblio/bibtex/contrib/apalike-ejor/example.tex b/biblio/bibtex/contrib/apalike-ejor/example.tex index d66f50a703..43ead81580 100644 --- a/biblio/bibtex/contrib/apalike-ejor/example.tex +++ b/biblio/bibtex/contrib/apalike-ejor/example.tex @@ -4,9 +4,9 @@ %============================================================================== -\title{Example Usage of \texttt{apalike-ejor} Bib\TeX\ Style} +\title{Example Usage of \texttt{apalike-ejor} \textsc{Bib\TeX} Style} \author{Adam Rumpf\footnote{\url{https://github.com/adam-rumpf}}} -\date{June 18, 2021} +\date{June 21, 2021} %============================================================================== @@ -14,13 +14,11 @@ \maketitle -\section{Introduction} +\section*{Introduction} -This example document demonstrates the usage of the \texttt{apalike-ejor} style, which was developed for formatting bibliographies in accordance with the \textit{European Journal of Operational Research} \href{https://www.elsevier.com/journals/european-journal-of-operational-research/0377-2217/guide-for-authors}{style guide} (as it appeared on June 18, 2021). +This example document demonstrates the usage of the \href{https://www.ctan.org/pkg/apalike-ejor}{\texttt{apalike-ejor}} style, which was developed for formatting bibliographies in accordance with the \textit{European Journal of Operational Research} \href{https://www.elsevier.com/journals/european-journal-of-operational-research/0377-2217/guide-for-authors}{style guide} (as it appeared in June 2021). The \textsc{Bib\TeX} style file \texttt{apalike-ejor.bst} is a fork of \href{https://www.bibtex.com/s/bibliography-style-base-apalike/}{\texttt{apalike.bst}}, originally by Oren Patashnik, and mostly follows standard \href{https://apastyle.apa.org/style-grammar-guidelines/references/examples}{APA style}. -The Bib\TeX\ style file \texttt{apalike-ejor.bst} is a fork of \texttt{apalike.bst}, originally by Oren Patashnik, and mostly follows the standard APA style. Among other edits hyperlinked URL and DOI fields have been added, which requires the usage of the \texttt{hyperref} package. - -In order to use \texttt{apalike-ejor}, make sure that the \texttt{apalike.ejor.bst} file is located somewhere where your compiler can find it, then compile your document with Bib\TeX\ a couple of times followed by \LaTeX\ a couple of times. At minimum the following should be included in your main \texttt{.tex} document: +In order to use \texttt{apalike-ejor}, make sure that the \texttt{apalike.ejor.bst} file is located somewhere where your compiler can find it, then compile your document with \textsc{Bib\TeX} a couple of times followed by \LaTeX\ a couple of times. At minimum the following should be included in your main \texttt{.tex} file: \begin{verbatim} \documentclass{article} @@ -41,21 +39,103 @@ In order to use \texttt{apalike-ejor}, make sure that the \texttt{apalike.ejor.b \end{document} \end{verbatim} -\section{Examples} +\section*{URL and DOI Fields} -\begin{itemize} - \item Article: \cite{kinney2005} - \item Book: \cite{ahuja1993} - \item Conference Proceedings: \cite{cavdaroglu2010} - \item Dataset: \cite{kaul2021} - \item Thesis: \cite{schmocker2006} -\end{itemize} +Support for \texttt{url} and \texttt{doi} fields has been added for all reference types. Both produce a hyperlinked URL within the reference, which requires the use of the \href{https://ctan.org/pkg/hyperref}{\texttt{hyperref}} package. For \texttt{doi} entries only the DOI name, itself, should be included, which will automatically be appended to a \url{https://doi.org/} link. For \texttt{url} entries the entire URL should be included. If both the \texttt{doi} and \texttt{url} fields are filled, only the \texttt{doi} link is created. -\section*{Acknowledgements} +\section*{Datasets} + +The \textit{EJOR} style guide requests that dataset references include ``[dataset]'' at the beginning of the reference (this is only for the manuscript, and does not appear in the published article). Since datasets are usually handled as \texttt{@misc} entries, a new \texttt{dataset} field is recognized by \texttt{apalike-ejor}. + +Within a \texttt{.bib} file, including any string besides ``0'' or ``false'' (case insensitive) in a \texttt{@misc} entry's \texttt{dataset} field results in its reference beginning with the word ``[dataset]''. Including ``0'' or ``false'', or excluding the \texttt{dataset} field, results in a normal \texttt{@misc} citation. The \texttt{kaul2021} and \texttt{rumpf2019} references below provide an example of one dataset and one non-dataset \texttt{@misc} entry. + +\section*{Example References} + +The following entries are included in this repository's example reference file \texttt{example-references.bib}: + +\begin{verbatim} +@book{ahuja1993, +address = {Englewood Cliffs, NJ}, +author = {Ahuja, R K and Magnanti, T L and Orlin, J B}, +chapter = {16}, +edition = {1st}, +publisher = {Prentice Hall}, +title = {{Network Flows: Theory, Algorithms, and Applications}}, +year = {1993} +} +@article{kinney2005, +author = {Kinney, R and Crucitti, P and Albert, R and Latora, V}, +doi = {10.1140/epjb/e2005-00237-9}, +journal = {European Physical Journal B}, +pages = {101--106}, +title = {{Modeling cascading failures in the North American power + grid}}, +volume = {46}, +year = {2005} +} +\end{verbatim} +\newpage +\begin{verbatim} +@inproceedings{cavdaroglu2010, +author = {Cavdaroglu, B and Nurre, S G and Mitchell, J E and + Sharkey, T C and Wallace, W A}, +booktitle = {Vulnerability, Uncertainty, and Risk: Analysis, + Modeling, and Management}, +editor = {Ayyub, B M}, +pages = {171--179}, +publisher = {American Society of Civil Engineers}, +title = {{Decomposition Methods for Restoring Infrastructure + Systems}}, +url = {https://ascelibrary.org/doi/10.1061/41170(400)21}, +year = {2010} +} +@misc{kaul2021, +author = {Kaul, Hemanshu and Rumpf, Adam}, +dataset = {1}, +doi = {10.17632/ptzc7jxhmn.1}, +howpublished = {Mendeley Data, V1}, +title = {{A linear input dependence model for interdependent + networks}}, +url = {https://data.mendeley.com/datasets/ptzc7jxhmn/1}, +year = {2021} +} +@misc{rumpf2019, +author = {Rumpf, Adam}, +note = {Accessed May 8, 2020}, +title = {{MCNFLI Computational Trials}}, +url = {https://github.com/adam-rumpf/mcnfli-trials}, +year = {2019} +} +@phdthesis{schmocker2006, +address = {London, England}, +author = {Schm\"ocker, J-D}, +school = {Imperial College London}, +title = {{Dynamic Capacity Constrained Traffic Assignment}}, +year = {2006} +} +\end{verbatim} -Thank you to Oren Patashnik for writing the original \texttt{apalike} style file on which this was based. This modification of \texttt{apalike}, and the other files in this package, were largely based on the \texttt{zootaxa-bst} package by Gustavo A.\ Ballen, and seeing the \texttt{zootaxa-bst} repository on \href{https://github.com/gaballench/zootaxa-bst}{GitHub} is what originally gave me the motivation to make this slapdash and kludgy personal tool available to the public. Thank you also to the \href{https://tex.stackexchange.com/}{\LaTeX\ Stack Exchange} community, whose guidance proved invaluable in figuring out the basics of the \texttt{.bst} format, as well as to the \href{https://www.ctan.org/}{CTAN} community for making so much \TeX\ material openly available. Finally thank you to my graduate advisor Hemanshu Kaul, without whom I would never have been in a position to submit a paper to \textit{EJOR} in the first place. +\noindent Their inline references are typeset as follows:\\ + +Article: \cite{kinney2005} + +Book: \cite{ahuja1993} + +Conference Proceedings: \cite{cavdaroglu2010} + +Dataset: \cite{kaul2021} + +Web: \cite{rumpf2019} + +Thesis: \cite{schmocker2006} + +Applying the \texttt{apalike-ejor} style results in the following References section: \bibliographystyle{apalike-ejor} \bibliography{example-references} +\section*{Acknowledgements} + +Thank you to Oren Patashnik for writing the original \texttt{apalike} style file on which this was based. This modification of \texttt{apalike}, and the other files in this package, were largely based on the \href{https://www.ctan.org/pkg/zootaxa-bst}{\texttt{zootaxa-bst}} package by Gustavo A.\ Ballen, and seeing the \texttt{zootaxa-bst} repository on \href{https://github.com/gaballench/zootaxa-bst}{GitHub} is what originally gave me the motivation to make this slapdash and kludgy personal tool available to the public. Thank you also to the \href{https://tex.stackexchange.com/}{\LaTeX\ Stack Exchange} community, whose guidance proved invaluable in figuring out the basics of the \texttt{.bst} format, as well as to the \href{https://www.ctan.org/}{CTAN} community for making so much \TeX\ material openly available. Finally thank you to my graduate advisor Hemanshu Kaul, without whom I would never have been in a position to submit a paper to \textit{EJOR} in the first place. + \end{document} -- cgit v1.2.3