summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-06-21 20:43:36 +0000
committerKarl Berry <karl@freefriends.org>2021-06-21 20:43:36 +0000
commit63c98ca91e2e2b434b3449be5bfc33feefcfe7ea (patch)
tree38b2f4622cf244dd8d84f52e773cd7575fb2f36e
parent67d93af9dd0b03862e7cf3887401e4e0fffbde2f (diff)
apalike-ejor (21jun21)
git-svn-id: svn://tug.org/texlive/trunk@59667 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/bibtex/bst/apalike-ejor/apalike-ejor.bst81
-rw-r--r--Master/texmf-dist/doc/bibtex/apalike-ejor/README.md8
-rw-r--r--Master/texmf-dist/doc/bibtex/apalike-ejor/example-references.bib33
-rw-r--r--Master/texmf-dist/doc/bibtex/apalike-ejor/example.pdfbin124394 -> 142998 bytes
-rw-r--r--Master/texmf-dist/doc/bibtex/apalike-ejor/example.tex114
5 files changed, 181 insertions, 55 deletions
diff --git a/Master/texmf-dist/bibtex/bst/apalike-ejor/apalike-ejor.bst b/Master/texmf-dist/bibtex/bst/apalike-ejor/apalike-ejor.bst
index 75ae881ed53..8bfdb80b631 100644
--- a/Master/texmf-dist/bibtex/bst/apalike-ejor/apalike-ejor.bst
+++ b/Master/texmf-dist/bibtex/bst/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/Master/texmf-dist/doc/bibtex/apalike-ejor/README.md b/Master/texmf-dist/doc/bibtex/apalike-ejor/README.md
index 74bcd5d4e5e..09e2e170b05 100644
--- a/Master/texmf-dist/doc/bibtex/apalike-ejor/README.md
+++ b/Master/texmf-dist/doc/bibtex/apalike-ejor/README.md
@@ -1,6 +1,6 @@
-# `apalike-ejor`
+# apalike-ejor
-<img src="https://img.shields.io/github/v/release/adam-rumpf/apalike-ejor"/> <img src="https://img.shields.io/github/license/adam-rumpf/apalike-ejor"/>
+<a href="https://www.ctan.org/pkg/apalike-ejor"><img src="https://img.shields.io/ctan/v/apalike-ejor"/></a> <a href="https://github.com/adam-rumpf/apalike-ejor/releases"><img src="https://img.shields.io/github/v/release/adam-rumpf/apalike-ejor"/></a> <a href="https://www.ctan.org/license/lppl1.3c"><img src="https://img.shields.io/ctan/l/apalike-ejor"/></a>
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/Master/texmf-dist/doc/bibtex/apalike-ejor/example-references.bib b/Master/texmf-dist/doc/bibtex/apalike-ejor/example-references.bib
index 27babec036c..bbb05bb2833 100644
--- a/Master/texmf-dist/doc/bibtex/apalike-ejor/example-references.bib
+++ b/Master/texmf-dist/doc/bibtex/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/Master/texmf-dist/doc/bibtex/apalike-ejor/example.pdf b/Master/texmf-dist/doc/bibtex/apalike-ejor/example.pdf
index 25a532b66f5..8fa908b6e43 100644
--- a/Master/texmf-dist/doc/bibtex/apalike-ejor/example.pdf
+++ b/Master/texmf-dist/doc/bibtex/apalike-ejor/example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/bibtex/apalike-ejor/example.tex b/Master/texmf-dist/doc/bibtex/apalike-ejor/example.tex
index d66f50a7035..43ead815807 100644
--- a/Master/texmf-dist/doc/bibtex/apalike-ejor/example.tex
+++ b/Master/texmf-dist/doc/bibtex/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}