Differences from `rjournal_article()` to R Journal Instructions.

[phargarten2]

Greetings! Thank you for allowing me to produce an article to fit the R Journal without leaving the R Markdown environment. Indeed, I used rticles::rjournal_article() on my markdown document and sent it off to the journal, as I thought that the function will take care of the formatting details. Again, thank you for this! Unfortunately, my article got rejected because it didn't conform to the submission standards provided in https://journal.r-project.org/submissions.html.

So, I investigated further. I think that the rjournal_article() function already accomplishes these tasks for me in the instructions to the authors of the R Journal (p. 2).

• rjournal_article() renames RJtemplate.tex for me
• rjournal_article() edits RJwrapper.tex for me
• rjournal_article() runs RJwrapper.tex repeatedly for me so that RJwrapper.pdf looks right.

However, rjournal_article() is different from the submission requirements in that the following required items are not done:
[ ] The RJreferences.bib needs to be the same name as the R file.
[ ] The Rlogo5.png is used, not Rlogo.png
[ ] The RJournal.sty may be out of date. I am unsure -- but that was one of the requirements.
[ ] There is no R Script that is produced, but a R script is required in the journal. To produce a R Script from Rmarkdown, I have been using r knitr::purl( Rmd, documentation = 1) where Rmd is the location of Rmarkdown file. The documentation=1 ensures that chunk headers are added to the code and the R file looks readable.
[ ] by two authors should be "Author 1 and Author 2", not "Author 1, Author 2".
[ ] The preamble used from the journal is different than the one used inrjournal_article().

Upon investigating, I noticed that the preamble.tex and *.tex created using rticles

\documentclass[10pt]{article}
\usepackage[usenames]{color} %used for font color
\usepackage{amssymb} %maths
\usepackage{amsmath} %maths
\usepackage[utf8]{inputenc} %useful to type directly diacritic characters

does not match up with the default R Journal template (RJwrapper.tex):

\documentclass[a4paper]{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{RJournal}
\usepackage{amsmath} 
\usepackage{amssymb}
\usepackage{array}
\usepackage{booktabs}

The reproducible example came from creating a template in RStudio using rticles and executing the resulting markdown file, located here:. I then compared these files to a download of the template files from the R Journal website: https://journal.r-project.org/submissions.html.

I am using these packages after executing xfun::session_info('rticles').

R version 3.5.2 (2018-12-20)
Platform: x86_64-apple-darwin15.6.0 (64-bit)
Running under: macOS High Sierra 10.13.6, RStudio 1.2.1335

Locale: en_US.UTF-8 / en_US.UTF-8 / en_US.UTF-8 / C / en_US.UTF-8 / en_US.UTF-8

Package version:
  base64enc_0.1.3 digest_0.6.25   evaluate_0.14   glue_1.4.0      graphics_3.5.2  grDevices_3.5.2 highr_0.8      
  htmltools_0.4.0 jsonlite_1.6.1  knitr_1.28      magrittr_1.5    markdown_1.1    methods_3.5.2   mime_0.9       
  Rcpp_1.0.4      rlang_0.4.5     rmarkdown_2.1   rticles_0.10    stats_3.5.2     stringi_1.4.6   stringr_1.4.0  
  tinytex_0.16    tools_3.5.2     utils_3.5.2     xfun_0.12       yaml_2.2.1   

---

By filing an issue to this repo, I promise that

• [X ] I have fully read the issue guide at https://yihui.name/issue/.
• [X ] I have provided the necessary information about my issue.
  • If I'm asking a question, I have already asked it on Stack Overflow or RStudio Community, waited for at least 24 hours, and included a link to my question there.
  • If I'm filing a bug report, I have included a minimal, self-contained, and reproducible example, and have also included xfun::session_info('rticles'). I have upgraded all my packages to their latest versions (e.g., R, RStudio, and R packages), and also tried the development version: remotes::install_github('rstudio/rticles').
  • If I have posted the same issue elsewhere, I have also mentioned it in this issue.
• [X ] I have learned the Github Markdown syntax, and formatted my issue correctly.

I understand that my issue may be closed if I don't fulfill my promises.

[RLumSK]

@phargarten2 I had a look into the issue:

• RJournal.sty is the latest available version (2013/08/27 v0.13)
• preamble.texis nothing that needs to be uploaded to the journal, the created *.tex file by the template looks correct to me (hopefully I did not overlook something)
• 'rticles' uses Rlogo.pdf' not Rlogo5.png`, but this should not be an issue because it is nothing that gets uploaded to the journal (https://journal.r-project.org/share/author-guide.pdf)

For the rest, I will create a pull request addressing the points you raised.

[phargarten2]

@ramnathv, thank you for looking into this. I took another look at the *.tex file by the template. It is indeed different from the one uploaded to the journal.

[RLumSK]

@phargarten2 Sorry, I guess I still don't get it. The author's guide says

You should have only one ‘.bib’ file, and only two‘. tex’ files, one of which is ‘RJwrapper.tex’.

There is no preamble.tex to upload, and if I run the example shipped with the package I get two *.tex files:

1. RJwrapper.tex
2. Untitled.tex

The latter can have any other name. If I compare the first lines of RJwrapper.tex (shown
only everything before \begin{document}

From: https://journal.r-project.org/

\documentclass[a4paper]{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{RJournal}
\usepackage{amsmath,amssymb,array}
\usepackage{booktabs}

%% load any required packages FOLLOWING this line

From: 'rticles'

\documentclass[a4paper]{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{RJournal}
\usepackage{amsmath,amssymb,array}
\usepackage{booktabs}

\providecommand{\tightlist}{%
  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}

% Any extra LaTeX you need in the preamble

I admit there is a small difference, however, it is not something you have shown above, and it should not be a problem.

[RLumSK]

@phargarten2

[ ] by two authors is "Author 1 and Author 2", not "Author 1, Author 2".

I see the point, but I guess this is something that needs to be changed manually. The corresponding template.tex for rjournal_article() reads:

\author{by $for(author)$$author.name$$sep$, $endfor$}

I cannot see how this can be changed via pandoc conditionals to

\author{by Author One, Author Two and Author Three}

My understanding is that this is something that should have been integrated into the *.sty file in the first place. But maybe someone else has a better idea?

[phargarten2]

For some reason, when I updated rticles yesterday before I wrote the post, the version was not updated to rticles_0.14.1. Now, I updated rticles again to the current version, v. 0.14.1. Now, I do see that preambles are the same. So the difference must have been fixed in subsequent versions of rticles or tinytex.

The following packages are the latest ones downloaded on my computer:

> xfun::session_info('rticles')
R version 3.5.2 (2018-12-20)
Platform: x86_64-apple-darwin15.6.0 (64-bit)
Running under: macOS High Sierra 10.13.6, RStudio 1.2.1335

Locale: en_US.UTF-8 / en_US.UTF-8 / en_US.UTF-8 / C / en_US.UTF-8 / en_US.UTF-8

Package version:
  base64enc_0.1.3 digest_0.6.25   evaluate_0.14   glue_1.4.0      graphics_3.5.2 
  grDevices_3.5.2 highr_0.8       htmltools_0.4.0 jsonlite_1.6.1  knitr_1.28     
  magrittr_1.5    markdown_1.1    methods_3.5.2   mime_0.9        Rcpp_1.0.4.6   
  rlang_0.4.5     rmarkdown_2.1   rticles_0.14.1  stats_3.5.2     stringi_1.4.6  
  stringr_1.4.0   tinytex_0.21    tools_3.5.2     utils_3.5.2     xfun_0.13      
  yaml_2.2.1     

@phargarten2 Sorry, I guess I still don't get it. The author's guide says ...

[RLumSK]

Ok, then, at least this part is fixed.

[phargarten2]

With much thanks to @RLumSK, I want to give an update on where things stand in this issue. The rjournal_article() is different from the journal submission requirements in that the following required items are not done:
[X] The RJreferences.bib needs to be the same name as the R file.

Added by @RLumSK in a commit to RLumSK/rticles that referenced this issue.

[X] The Rlogo5.png is used, not Rlogo.png

this should not be an issue because it is nothing that gets uploaded to the journal (https://journal.r-project.org/share/author-guide.pdf)

[X] The RJournal.sty may be out of date. I am unsure -- but that was one of the requirements.

RJournal.sty is the latest available version (2013/08/27 v0.13)

[X] There is no R Script that is produced, but an R script is required in the journal. To produce an R Script from Rmarkdown, I have been using r knitr::purl( Rmd, documentation = 1) where Rmd is the location of the Rmarkdown file. The documentation=1 ensures that chunk headers are added to the code and the R file looks readable.

Added by @RLumSK in a commit to RLumSK/rticles that referenced this issue.

[ ] by two authors should be "Author 1 and Author 2", not "Author 1, Author 2".

I see the point, but I guess this is something that needs to be changed manually. The corresponding template.tex for rjournal_article() reads:

\author{by $for(author)$$author.name$$sep$, $endfor$}

I cannot see how this can be changed via pandoc conditionals to

\author{by Author One, Author Two and Author Three}

My understanding is that this is something that should have been integrated into the *.sty file in the first place. But maybe someone else has a better idea?

[X] The preamble used from the journal is different than the one used in rjournal_article().

Now, I do see that preambles are the same. So the difference must have been fixed in subsequent versions of rticles or tinytex.

A new reason
[ ] Lastly, The R Journal may have declined to review my article because they were unable to compile the LaTex document, RJwrapper.tex, to generate RJwrapper.pdf. I ran the example that came with the package, which created the modified RJwrapper.tex. Attempting to recompile the pdf document using the LaTeX file, RJwrapper.tex, I was unable to do so.

Two main issues stand out for me was that the RJwrapper.tex

• Thinks that the main document should be in equation mode.
• Unable to find the generated Untitled.tex file and any local files called in Untitled.tex. All these files are in the same folder, so I guess RJwrapper.tex needs some direction.
• The remaining details are found in RJwrapper.log.

[RLumSK]

@phargarten2 I tried to reproduce what you described, I had no problem to build the tex-files without RStudio (but after I first set it with RStudio). You have to typeset the RJwrapper.tex, which includes the Untilted.tex file (if this is really the name of the file). In the example above you miss certain headers (e.g., \documentclass etc.). And I am not sure whether 'LaTeXiT' finds the files correctly.

[RLumSK]

@phargarten2 Regarding:

[ ] The RJreferences.bib needs to be the same name as the R file.

This would be fixed if my pull request gets accepted.

[phargarten2]

Thank you. Regarding:

@phargarten2 I tried to reproduce what you described, I had no problem to build the tex-files without RStudio (but after I first set it with RStudio). You have to typeset the RJwrapper.tex, which includes the Untilted.tex file (if this is really the name of the file). In the example above you miss certain headers (e.g., \documentclass etc.). And I am not sure whether 'LaTeXiT' finds the files correctly.

What TeX editor did you use, @RLumSK? Based on your response, LaTeXiT may not be finding these files. LaTeXiT includes a preamble that includes the document class. I have edited the example to include this.

[RLumSK]

@phargarten2 I am using TeXShop. Usually, I use LaTeXit only for short tests, so I cannot tell why it does not work, but to me so far it looks good (I might be wrong).

[phargarten2]

I really have no idea why LaTeXiT did not work for me. But I used TeXShop, and I was able to re-compile the pdf document from the tex file. TeXShop processed the citations and even section titles (that I added to the Rmarkdown file). That is, after I ran the LaTex document in the following sequence (in TeXShop):

Typeset LaTeX
Typeset BibTeX
Typeset LaTeX
Typeset LaTeX

it compiled.

Regarding

[ ] by two authors should be "Author 1 and Author 2", not "Author 1, Author 2".

a fix may eventually come, but a manual edit in the LaTeX document was able to produce the change in the resulting pdf document.

[yihui]

Sounds like some issues have been resolved and some have not. If someone could give us a summary of this thread so that it's clearer to us what we need to fix/improve, I'll really appreciate it.