Add APA 7th edition template

[crsh]

To summarize the previous discussion, for those who urgently need APA 7th edition: With the current version of papaja you can get most of the way like this:

1. Make sure you are using the latest development version of papaja (remotes::install_github("crsh/papaja@devel"))
2. (Install the apa7 LaTeX document class, unless your LaTeX distribution, like tinytex is setup to do this on the fly.)
3. Make the following settings in the YAML front matter:

header-includes:
  - |
    \makeatletter
    \renewcommand{\paragraph}{\@startsection{paragraph}{4}{\parindent}%
      {0\baselineskip \@plus 0.2ex \@minus 0.2ex}%
      {-1em}%
      {\normalfont\normalsize\bfseries\typesectitle}}
    
    \renewcommand{\subparagraph}[1]{\@startsection{subparagraph}{5}{1em}%
      {0\baselineskip \@plus 0.2ex \@minus 0.2ex}%
      {-\z@\relax}%
      {\normalfont\normalsize\bfseries\itshape\hspace{\parindent}{#1}\textit{\addperi}}{\relax}}
    \makeatother

csl               : "`r system.file('rmd', 'apa7.csl', package = 'papaja')`"
documentclass     : "apa7"
output            : papaja::apa6_pdf

Note, that you currently cannot include the ORCID in the author note, as suggested in the apa7-manual, those YAML fields are currently not parsed.

---

Properly implementing support for APA 7th edition will require a little more work. I'll gather the required steps that I have identified, as of now, here. If I'm missing anything necessary adjustments, or if anyone has thoughts or suggestions about the implementation feel free to discuss. Also, this would be the time to rethink any design decisions regarding the R Markdown template (such as the setup of the font matter or naming of the options).

General

• It seems unnecessary to add another "APA article (7th edition)" entry to the template list because the templates would be almost identical.
• Create an R functions, such as apa7_*(), that generate the rmarkdown format. It may be worth considering, whether specialized functions for each edition are necessary. It seems easier and less confusing to just keep apa_*() and specify the version via the documentclass field in the front matter. Of course, the old functions would be kept for backward compatibility.
• Ship a APA 7th edition CSL file (see Automate updating APA CSL #314)

PDF format

• Add support for a ORCID element in the YAML author list and automatically add this information to the author note. This should be fairly straight forward for PDF (use \addORCIDlink{}{}) if I can make pandoc parse the contents of the author_note field.
• Check how the definitions of \subsubsection{} and \paragraph{} have changed and adjust the default header includes accordingly.
• Always position figure captions above the corresponding figure (for LaTeX approaches see this, this, and this SO post; for Rmarkdown see [this(https://stackoverflow.com/a/26743812/914024)]). This will be easy to do in Quarto.
• Don't add & to author name concatination on title page and use \authornames and \authorsaffiliations (Add APA 7th edition template #342 (comment))

Word format

• Create a pandoc word template for APA 7th edition.
• Add support for a ORCID element in the YAML author list and automatically add this information to the author note. This will require to ship an ORCID icon with the template.
• Adjust formatting of table captions generated by apa_table()
• Adjust formatting of figure captions in docx_fixes-Lua-filter, i.e. create an version of the filter for APA 7th edition

[jrennstich]

For some reason, folks who use the TeX package csquotes now need to add the following line in YAML for it to work:

csquotes          : true

It would be very useful to add this to the YAML options in the template.

[cjvanlissa]

Not sure how far this is, but the APA Publication Manual for the 7th edition is temporarily available for free during the Corona isolation period: https://apastyle.apa.org/blog/coronavirus-response?fbclid=IwAR2n0C1tz1xyG0420lMGFEvTmIT9Tz8lqoCRTJYY1v7ayldMg_ZxO-0AyK4

Maybe this is helpful to anyone currently contributing to this issue.

[raybecker]

It looks like that offer ended yesterday :(

…

On Thu, Mar 26, 2020 at 11:35 AM C. J. van Lissa ***@***.***> wrote: Not sure how far this is, but the APA Publication Manual for the 7th edition is temporarily available for free during the Corona isolation period: https://apastyle.apa.org/blog/coronavirus-response?fbclid=IwAR2n0C1tz1xyG0420lMGFEvTmIT9Tz8lqoCRTJYY1v7ayldMg_ZxO-0AyK4 Maybe this is helpful to anyone currently contributing to this issue. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#342 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACA67BZOMP56YEQ3CEKCHYLRJMVX5ANCNFSM4KHQSMBA> .

[cjvanlissa]

I apologize. It just reached me now.

[nikshl]

Thanks for this package and the work already invested in APA7 version. In my case the titles of tables and figures are written in serif font. For figures, the title is also written below the figure, which is different in APA7 (sans serif and above the figure). As a user, can I somehow adapt this myself or are updates planned?

[jlt10f]

how do I install the apa7 Latex document class?

[nikshl]

You can find the necessary file here.
There may be easier ways, but I installed it manually with this instruction (see "Installing sty or cls files" in the most popular response on that page).

[crsh]

In my case the titles of tables and figures are written in serif font. For figures, the title is also written below the figure, which is different in APA7 (sans serif and above the figure). As a user, can I somehow adapt this myself or are updates planned?

Are you looking to knit PDF or Word files?

[nikshl]

PDF.

[crsh]

It's been a while since I found time to look at this more closely, but could you point me to where the new manual states that figure titles should be in a sans serif font? As far as I can tell it's set in the same font used for the text, no? Either way, you should be able to control the caption font using the caption package (see for example here).

As for the placement of the figure title: This should be controlled by the apa7 document class. The example in the documentation suggests that titles should be printed above the figure. If you can provide a minimal reproducible example I'd be happy to take a closer look at what's going on.