ieee_article() add journal support

DESCRIPTION

@@ -46,6 +46,7 @@ Authors@R: c(
   person("Alfredo", "Hernández", role = c("ctb"), email = "aldomann.designs@gmail.com", comment = c(ORCID = "0000-0002-2660-4545")),
   person("Christophe", "Dervieux", role = c("aut"), email = "cderv@rstudio.com", comment = c(ORCID = "0000-0003-4474-2498")),
   person("Stefano", "Coretta", role = c("ctb"), email = "stefano.coretta@gmail.com", comment = c(ORCID = "0000-0001-9627-5532", github = "stefanocoretta"))
+  person("Karel", "Kroeze", role = c("ctb"), email = "karel.kroeze@gmail.com" comment = c(ORCID = "0000-0002-7000-7377", github = "karel-kroeze"))
   )
 Description: A suite of custom R Markdown formats and templates for
   authoring journal articles and conference submissions.

NEWS.md

@@ -1,3 +1,5 @@
+- `ieee_article()` now supports both conference papers and journal articles (thanks, @Karel-Kroeze). 
+
 rticles 0.19
 ---------------------------------------------------------------------
 - Update Copernicus Publications template to version 6.2 from 2021-01-15 (thanks, @RLumSK, #366).

R/ieee_article.R

@@ -3,8 +3,9 @@
 #' Format for creating submissions to IEEE Transaction journals. Adapted from
 #' \url{http://www.ieee.org/publications_standards/publications/authors/author_templates.html}.
 #'
-#' Presently, only the \code{"conference"} paper mode offered by the
-#' \code{IEEEtran.cls} is supported.
+#' Presently, only the \code{"conference"} paper mode offered by
+#' \code{IEEEtran.cls} is fully supported, with experimental support for the
+#' \code{"journal"} mode.
 #'
 #' @inheritParams rmarkdown::pdf_document
 #' @param draftmode Specify the draft mode to control spacing and whether images

inst/rmarkdown/templates/ieee/resources/template.tex

@@ -50,7 +50,11 @@
 % The testflow support page is at:
 % http://www.michaelshell.org/tex/testflow/
 
-\documentclass[conference,$if(fontsize)$$fontsize$,$endif$$if(draftmode)$$draftmode$,$endif$$if(papersize)$$papersize$,$endif$$for(classoption)$$classoption$$sep$,$endfor$]{IEEEtran}
+% *** rticle changes for journal/conference mode.
+% adding journal as an override for conference mode to maintain backwards
+% compatibility. Any future expansions to further modes will have to come up with
+% a cleverer solution, or introduce breaking changes.
+\documentclass[$if(journal)$journal$else$conference$endif$,$if(fontsize)$$fontsize$,$endif$$if(draftmode)$$draftmode$,$endif$$if(papersize)$$papersize$,$endif$$for(classoption)$$classoption$$sep$,$endfor$]{IEEEtran}
 % Some Computer Society conferences also require the compsoc mode option,
 % but others use the standard conference format.
 %
@@ -382,9 +386,11 @@
             breaklinks=true}
 \urlstyle{same}  % don't use monospace font for urls
 
-% Pandoc toggle for numbering sections (defaults to be off)
+% Pandoc toggle for numbering sections (defaults to be off in conference, on in journal)
 $if(numbersections)$
 \setcounter{secnumdepth}{$if(secnumdepth)$$secnumdepth$$else$5$endif$}
+$elseif(journal)$
+\setcounter{secnumdepth}{$if(secnumdepth)$$secnumdepth$$else$5$endif$}
 $else$
 \setcounter{secnumdepth}{0}
 $endif$
@@ -447,6 +453,24 @@
 % Do not put math or special symbols in the title.
 \title{$title$}
 
+
+% split author affiliations for journal and conference layouts
+$if(journal)$
+
+$if(affiliation.author)$
+\author{
+  $for(affiliation.author)$$if(it.last)$and $endif$$it.name$$if(it.member)$, \IEEEmembership{$it.member$}$endif$$sep$, $endfor$
+  $if(affiliation.thanks)$$for(affiliation.thanks)$\thanks{$affiliation.thanks$}$endfor$$endif$
+}
+$else$
+$~$!!! Only 'affiliation.author' is supported for the journal mode.$~$
+$endif$
+
+\markboth{$journal$$~$, Vol. XX, No. X, XXXXXX 20XX$~$}%
+{$title$}
+
+$else$ % -- end if/journal
+
 % author names and affiliations
 % use a multiple column layout for up to three different
 % affiliations
@@ -563,6 +587,8 @@
 $endif$
 }
 
+$endif$ %% -- end else/journal
+
 % conference papers do not typically use \thanks and this command
 % is locked out in conference mode. If really needed, such as for
 % the acknowledgment of grants, issue a \IEEEoverridecommandlockouts
@@ -586,14 +612,6 @@
 %\IEEEauthorblockA{\IEEEauthorrefmark{4}Tyrell Inc., 123 Replicant Street, Los Angeles, California 90210--4321}}
 
 
-
-
-% use for special paper notices
-%\IEEEspecialpapernotice{(Invited Paper)}
-
-
-
-
 % make the title area
 \maketitle
 
@@ -606,7 +624,7 @@
 % keywords
 $if(keywords)$
 \begin{IEEEkeywords}
-$for(keywords)$$keywords$$sep$; $endfor$
+$for(keywords)$$keywords$$sep$$if(journal)$, $else$; $endif$$endfor$
 \end{IEEEkeywords}
 $endif$
 
@@ -661,5 +679,3 @@
 
 $endfor$
 \end{document}
-
-