apalike-ejor (21jun21)

git-svn-id: svn://tug.org/texlive/trunk@59667 c570f23f-e606-0410-a88d-b1316a301751

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
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}