Feature Request: Support in Rticles for Using Additional Journals, such as Biometrics

[skywalker26]

I've done some academic writing with the Rticles package and I love it! I'm trying to write a journal article to publish in Biometrics, but am having a difficult time figuring out how I would go about adding in the Biometrics document class and such. Is this something that you'd be open to developing further?

[dlebauer]

(I think this issue could be renamed 'how can I contribute a template for a new journal?)

It would be great to have a step-by-step guide to adding a new template. Perhaps this could be added to the package documentation, the README or CONTRIBUTING.md

In addition to the instructions, it could help to have a generic article type - this would serve two purposes: 1) a directory named ``inst/rmarkdown/templates/generic_articlethat someone wishing to contribute could copy toinst/rmarkdown/templates/journalname_article` and 2) for folks who don't want to contribute a template or doesn't know the target submission journal could get started writing a first draft.

Based on a few pull requests, It seems it should be straightforward to add a new template, but perhaps not #83 #147, PeerJ #127

main content

• add journalname_article() function to R/journalname_article.R
  • what are requirements here? is this mostly copy-paste and find-replace?
• add inst/rmarkdown/templates/journalname_article/resources/template.tex
  • how to convert a journal provided latex template to a Rmd template? Seems lots of use of $ to define variables
• add inst/rmarkdown/templates/journalname_article/skeleton/skeleton.Rmd
• add inst/rmarkdown/templates/journalname_article/template.yaml
• which sty / bst / cls / csl etc files to add?
  • add a Bioinformatics template #83 adds natbib.sty - isn't that usually available by default?

housekeeping

• Update namespace (could be done by devtools::document()
• update NEWS
• Update README w/ link to supported journal
• Add tests (what are we testing for?)
  • example: https://github.com/dleutnant/rticles/blob/80fa67ca34f58270dbe2de622d331023e0becd64/tests/testthat/test_formats.R
• gitignore?

[daltonhance]

I was able to create Biometrics template in my fork. I used this package of pandoc templates as a starting point: https://github.com/sachsmc/pandoc-journal-templates That package has other statistics journals that wouldn't be too hard to translate to rticles. My fork has all the main content @dlebauer listed, but I would need a little help walking through the housekeeping for a pull request.

[nuest]

PR is open at #170

[oleskiewicz]

I've just opened #175, I agree that it would have been very helpful to have a contribution guide - maybe a .github/PULL_REQUEST_TEMPLATE file (as described here), with checkboxes from @dlebauer's comment above?

[yihui]

A contributing guide has been added: https://github.com/rstudio/rticles/blob/master/.github/PULL_REQUEST_TEMPLATE.md Thanks

[github-actions]

This old thread has been automatically locked. If you think you have found something related to this, please open a new issue by following the issue guide (https://yihui.org/issue/), and link to this old issue if necessary.