summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/acmart/acmart.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-02-07 03:01:02 +0000
committerNorbert Preining <norbert@preining.info>2024-02-07 03:01:02 +0000
commit50fcb5024d3243d7e1601abf72b5f4444dd618b6 (patch)
treef53a7b130aa3e1ab8afb00c716a31c33e888f625 /macros/latex/contrib/acmart/acmart.dtx
parent25b83ac051a8ec3bf79f47e3c3c66b3567a3216a (diff)
CTAN sync 202402070301
Diffstat (limited to 'macros/latex/contrib/acmart/acmart.dtx')
-rw-r--r--macros/latex/contrib/acmart/acmart.dtx106
1 files changed, 89 insertions, 17 deletions
diff --git a/macros/latex/contrib/acmart/acmart.dtx b/macros/latex/contrib/acmart/acmart.dtx
index 666e8d95b8..11c9b1eca1 100644
--- a/macros/latex/contrib/acmart/acmart.dtx
+++ b/macros/latex/contrib/acmart/acmart.dtx
@@ -289,10 +289,12 @@
% transactions, and course materials, while formats starting with
% |sig| are intended for proceedings published as books.
%
-% Note that sometimes conference proceedings are published as a
-% special issue (or issues) of an ACM journal. In this case, you
-% should use the journal format for a conference paper. Please
-% contact your conference committee if in doubt.
+% Sometimes conference proceedings are published as a special issue
+% (or issues) of an ACM journal. In this case, you should use the
+% journal format. The templates |sample-acmsmall-conf.tex| and
+% |sample-acmtog-conf.tex| show how to enter conference information.
+% Note that you need to comment out |\acmJournal{...}| line for such
+% papers to get the conference information in the footers and headers.
%
% \begin{table}
% \centering
@@ -2202,6 +2204,47 @@
% reserved for new journals which are not assigned an ISSN yet.
%
%
+%\subsection{Samples}
+%\label{sec:samples}
+%
+% There are several samples of acmart documents, that can serve as
+% templates for the authors. Among them
+% |sample-sig...| are templates for conference papers, while
+% |sample-acm...| are templates for journal articles and special
+% materials.
+%
+% Here is the list of the samples:
+% \begin{description}
+% \item[sample-manuscript:] A proceedings paper in the manuscript format.
+% \item[sample-acmsmall:] A journal paper in the |acmsmall| format.
+% \item[sample-acmsmall-biblatex:] A journal paper using experimental
+% \textsl{biblatex} bibliography processing.
+% \item[sample-acmlarge:] A journal paper in the |acmlarge| format.
+% \item[sample-acmtog:] A journal paper in the |acmtog| format.
+% \item[sample-sigconf:] A proceedings paper in the standard |sigconf|
+% format.
+% \item[sample-sigconf-biblatex:] A proceedings paper in the |sigconf|
+% format using experimental \textsl{biblatex} bibliography
+% processing.
+% \item[sample-sigconf-authordraft:] A proceedings paper in the
+% |sigconf| format with the |authordraft| option selected.
+% \item[sample-sigconf-i13n:] A proceedings paper in the
+% |sigconf| format with multilanguage titles and abstract.
+% \item[sample-sigconf-xelatex:] A proceedings paper in the
+% |sigconf| format, Xe\LaTeX\ version.
+% \item[sample-sigconf-lualatex:] A proceedings paper in the
+% |sigconf| format, Lua\LaTeX\ version.
+% \item[sample-sigplan:] A proceedings paper in the |sigplan| format.
+% \item[sample-acmsmall-conf:] A proceedings paper in the |acmsmall|
+% format for the publication in a journal using this option.
+% \item[sample-acmtog-conf:] A proceedings paper in the |acmtog|
+% format for the publication in a journal using this option.
+% \item[sample-acmcp:] A sample of ACM Cover Page used by JDS.
+% \item[sample-acmengage:] A sample of ACM Engage publication.
+% \end{description}
+%
+%
+%
%\subsection{A note about \texttt{sigchi-a} format}
%\label{sec:sigchi-a}
%
@@ -2266,7 +2309,7 @@
\ProvidesFile{acmart.dtx}
%</gobble>
%<class>\ProvidesClass{acmart}
-[2024/01/21 v2.02 Typesetting articles for the Association for Computing Machinery]
+[2024/02/04 v2.03 Typesetting articles for the Association for Computing Machinery]
% \end{macrocode}
%
% \changes{v1.00}{2016/04/14}{First released version}
@@ -2382,6 +2425,7 @@
% throughout}
% \changes{v1.93}{2023/10/22}{Added PACMSE journal option}
% \changes{v2.01}{2024/01/06}{Documentation update: POMACS uses acmsmall}
+% \changes{v2.03}{2024/02/04}{Added documentation about samples}
%
% And the driver code:
% \begin{macrocode}
@@ -2741,6 +2785,17 @@
%
% \end{macro}
%
+% \begin{macro}{\if@ACM@journal@bibstrip@or@tog}
+% \changes{v2.03}{2024/02/04}{Introduced macro}
+% ACM TOG sometimes uses journal-like bibstrip even for conference
+% proceedings, so we need to set it separately
+% \begin{macrocode}
+\newif\if@ACM@journal@bibstrip@or@tog
+% \end{macrocode}
+%
+% \end{macro}
+%
+%
% \begin{macro}{\if@ACM@sigchiamode}
% The formatting of SIGCHI extended abstracts is quite unusual. We have a
% special switch for them.
@@ -2770,7 +2825,6 @@
%
% \end{macro}
%
-%
%
%
% Setting up switches
@@ -2815,6 +2869,7 @@
\@ACM@journaltrue
\or % acmtog
\@ACM@journaltrue
+ \@ACM@journal@bibstrip@or@togtrue
\or % sigconf
\@ACM@journalfalse
\or % siggraph
@@ -2835,7 +2890,8 @@
\AtBeginDocument{\@ACM@printacmreffalse}%
\fi
\if@ACM@journal
- \@ACM@journal@bibstriptrue
+ \@ACM@journal@bibstriptrue
+ \@ACM@journal@bibstrip@or@togtrue
\else
\@ACM@journal@bibstripfalse
\fi
@@ -4734,7 +4790,8 @@
% And the syntactic sugar around it
% \begin{macrocode}
\def\acmJournal#1{\setkeys{ACM}{acmJournal=#1}%
- \global\@ACM@journal@bibstriptrue}
+ \global\@ACM@journal@bibstriptrue
+ \global\@ACM@journal@bibstrip@or@togtrue}
% \end{macrocode}
%
% \end{macro}
@@ -4753,6 +4810,7 @@
% \changes{v1.59}{2019/04/20}{Setting \cs{@ACM@journal@bibstrip}}
% \changes{v2.02}{2024/01/06}{Moved here setting the conference title
% for bibstrip}
+% \changes{v2.03}{2024/02/04}{Made setting bibstrip overriding journal}
% This is the conference command
% \begin{macrocode}
\newcommand\acmConference[4][]{%
@@ -6250,6 +6308,7 @@
% publications}
% \changes{v2.00}{2023/10/24}{Deleted acmPrice}
% \changes{v2.00}{2023/11/05}{Added ``ACM'' for papers}
+% \changes{v2.03}{2024/12/04}{Special processing for conferences in TOG}
% The (in)famous \cs{maketitle}. Note that in |sigchi-a| mode, authors
% are \emph{not} in the title box.
%
@@ -6290,7 +6349,7 @@
\if@ACM@acmcp\else
\ifx\@empty\@authorsaddresses\else
\if@ACM@anonymous\else
- \if@ACM@journal@bibstrip
+ \if@ACM@journal@bibstrip@or@tog
\footnotetextauthorsaddresses{%
\def\par{\let\par\@par}\parindent\z@\@setauthorsaddresses}%
\fi
@@ -7685,6 +7744,7 @@
% \changes{v1.86}{2022/06/26}{Special treatment of ACM Engage materials}
% \changes{v1.87}{2022/08/14}{Special treatment of ACMCP}
% \changes{v1.91}{2023/06/22}{Redesigned ACMP labels}
+% \changes{v2.03}{2024/02/04}{Special treatment of ACM TOG}
% The page style for all pages but the first one
% \begin{macrocode}
\AtBeginDocument{%
@@ -7699,7 +7759,7 @@
\@acmArticle\if@ACM@printfolios:\thepage\fi%
\fi%
}%
- \if@ACM@journal@bibstrip
+ \if@ACM@journal@bibstrip@or@tog
\ifcase\ACM@format@nr
\relax % manuscript
\fancyhead[LE]{\ACM@linecountL\if@ACM@printfolios\thepage\fi}%
@@ -7735,9 +7795,15 @@
\fancyhead[RE]{\ACM@linecountR}%
\fancyhead[RO]{\@headfootfont
\shorttitle\quad\textbullet\quad\@acmArticlePage\ACM@linecountR}%
- \if@ACM@nonacm\else%
- \fancyfoot[RO,LE]{\footnotesize \@journalNameShort, Vol. \@acmVolume, No.
- \@acmNumber, Article \@acmArticle. Publication date: \@acmPubDate.}%
+ \if@ACM@nonacm\else
+ \if@ACM@journal@bibstrip
+ \fancyfoot[RO,LE]{\footnotesize \@journalNameShort,
+ Vol. \@acmVolume, No.~\@acmNumber, Article \@acmArticle.
+ Publication date: \@acmPubDate.}%
+ \else
+ \fancyfoot[RO,LE]{\footnotesize \acmConference@shortname,
+ \acmConference@date, \acmConference@venue.}%
+ \fi
\fi
\else % Proceedings
\fancyfoot[C]{\if@ACM@printfolios\footnotesize\thepage\fi}%
@@ -7852,6 +7918,7 @@
% \changes{v1.87}{2022/08/14}{Special treatment for acmcp}
% \changes{v1.89}{2022/12/27}{Moved badges here}
% \changes{v2.00}{2023/10/22}{Deleted blobs}
+% \changes{v2.03}{2024/02/04}{Special treatment of tog}
% The page style for the first page only.
% \begin{macrocode}
\AtBeginDocument{%
@@ -7859,7 +7926,7 @@
\fancyhf{}%
\renewcommand{\headrulewidth}{\z@}%
\renewcommand{\footrulewidth}{\z@}%
- \if@ACM@journal@bibstrip
+ \if@ACM@journal@bibstrip@or@tog
\ifcase\ACM@format@nr
\relax % manuscript
\fancyhead[L]{\ACM@linecountL\@acmBadgeL}%
@@ -7890,9 +7957,14 @@
\fancyhead[LO]{\ACM@linecountL\@acmBadgeL}%
\or % acmtog
\if@ACM@nonacm\else%
- \fancyfoot[RO,LE]{\footnotesize \@journalNameShort, Vol. \@acmVolume, No.
- \@acmNumber, Article \@acmArticle. Publication date:
- \@acmPubDate.}%
+ \if@ACM@journal@bibstrip
+ \fancyfoot[RO,LE]{\footnotesize \@journalNameShort,
+ Vol. \@acmVolume, No.~\@acmNumber, Article \@acmArticle.
+ Publication date: \@acmPubDate.}%
+ \else
+ \fancyfoot[RO,LE]{\footnotesize \acmConference@shortname,
+ \acmConference@date, \acmConference@venue.}%
+ \fi
\fi%
\fancyhead[L]{\ACM@linecountL\@acmBadgeL}%
\fancyhead[R]{\@acmBadgeR\ACM@linecountR}%