Changelog

Future Version Wishlist

  • Implement missing .pdf features
    • Tables in .pdf jou mode should fit automatically.
  • Implement missing .docx features
    • Right-align equation numbers

Version 6.0.1

  • 2026-09-26
  • Made both journal modes (apauarto-pdf and apaquarto-typst) fully justified in their body text but not in markdown table text.
  • Added support for list of tables and list of figures in .docx, .typst, and .pdf.
  • Table of contents for .docx can be added setting list-of-contents: true. A message letting the user know how to update the page fields is displayed.
  • list-of-contents: true gives a table of contents in every format: typst and the .pdf build one of their own, .docx is built by hand, and .html lists the headings as links, since it has no pages to number.
  • In .html a contents is added only when Quarto’s own is not already in the margin, so toc: false is needed alongside list-of-contents: true there. A list of figures or of tables is not built for .html at all, which has no pages to find.
  • An entry in any of the lists reads Figure 1. The Figure Caption, in .docx, typst and .pdf alike.
  • The apa7 class options donotrepeattitle, draftfirst, draftall and nocorrespondence have done nothing since 6.0.0, when the .pdf stopped using that class. suppress-title-introduction and suppress-corresponding-paragraph do the first and the last of them, in every format.
  • Footnotes in .docx are single spaced, as recommended at apastyle.apa.org

Version 6.0.0

  • 2026-09-12
  • apaquarto-pdf is no longer built with the apa7 class (credit to Claude).
  • numbered-lines numbers the lines in apaquarto-pdf and in apaquarto-typst, in every document mode. The typst numbers are set in DejaVu Sans Mono, which is the one sans face typst bundles. It is possible to name a different font for the line numbers via the linenumber-font option (credit to Claude).
  • A heading reading Introduction at the start of the body is taken out. APA does not label the introduction — the title of the paper stands at the top of the first page of text and the introduction runs on underneath it — so such a heading is a style error, and an easy one to make now that the abstract can be written as a section, since something has to mark where the abstract ends. Only the first heading of the body, and only at level one: a heading of that name inside an appendix is left alone, as is one at any other level. The word is section-title-introduction in the language field. Set keep-introduction-heading: true to keep it (credit to Claude).
  • The abstract and the impact statement can be written in the document, as sections, instead of in the yaml. A heading called Abstract or Impact Statement is taken out of the body and its text is set on the title page exactly as a yaml field would have been. A long abstract is awkward to write in yaml — quoted or indented under a block scalar, stopped by an apostrophe in the wrong place, and left out of the spell check and the word count that the rest of the prose gets. The section is found by its identifier, so # Abstract needs nothing added to it, and by its heading text against section-title-abstract and title-impact-statement, so a document written in another language is matched too. Written in both places, the section is used and the render says so. This follows pandoc-ext/abstract-section, which does the same for the abstract alone. While it was being added, an impact statement of more than one paragraph was found to render as nothing in every format, and an abstract of more than one paragraph to work only when written as a yaml line block; both shapes are read now (credit to Claude).
  • An apa-note on a panel written as a plain markdown image is printed, in .html, .docx, typst and apaquarto-pdf. Such a panel is neither a float nor a cell — it keeps the note on the image itself, and nothing looked there — so the panel labels came out right and both panel notes were dropped. In typst the note of the first panel then reappeared on its own after the whole figure, because apanote.lua lifts an image’s note onto the div around it and for a panel that div is the scaffold Quarto wraps the whole grid in. The note is now lifted onto the panel, which is the shape the rest of apaquarto already reads, and the panel’s caption follows its Panel A label rather than sitting under the picture as a figure caption of its own (credit to Claude).
  • apaquarto requires Quarto 1.9 or greater.
  • quarto add wjschne/apaquarto fails with a message that says what is wrong, rather than with a page of YAML validation errors (credit to Claude).
  • The note of a panel in a multipanel figure is given a SubPanelNote style rather than FigureNote, so that it can be centred under the panel it belongs to while the note of the whole figure stays flush left under the whole figure. A panel is told from a table or a figure holding one thing by the layout the float asks for, so a table’s own note keeps FigureNote (credit to Claude).
  • In .docx a multipanel figure is set the APA way: its number and title above the figure rather than after it, no rule drawn under the panels or the note, the note of the whole figure in the FigureNote style below the panels, and each panel’s caption above its panel. Word has no way of putting panels side by side except a table, and the table was taking the reference document’s Table style, whose bottom rule belongs to APA tables and to no figure; it is given a FigureLayout style of its own now. A panel’s caption is written as Word markup so that it can go above the picture, which pandoc will not do on its own (credit to Claude).
  • In apaquarto-pdf the panels of a multipanel figure are set side by side rather than one under the other, and their captions and notes take the document’s line spacing. Quarto builds a figure environment for every panel, which inside apaquarto’s own figure is a figure within a figure and is set one under the other whatever the layout asked for, so the row is built here out of minipages. A minipage works its baseline skip out from the font as it stands, which left the captions and notes single spaced in a document set double (credit to Claude).
  • The panels of a multipanel figure are labelled the APA way — Panel A, Panel B, with the panel’s own caption after the label — in .html, .docx, typst and apaquarto-pdf. Quarto labelled a panel that had a label of its own “(A)” and left a panel written as a plain code chunk unlabelled altogether; both are relabelled now, and the count Quarto puts its “(A)” in front of is taken away so that it does not label them twice. A reference to a panel still reads Figure 1B. The word is figure-panel in the language field. (credit to Claude).
  • In typst, the apa-note of a multipanel figure runs the full width of the figure, and the panels are labelled the APA way: Panel A, Panel B, above each panel, with the panel’s own caption after the label. Quarto built the grid out of everything the float held, one cell per block, so a note left inside it was only as wide as a column. It could not be widened from outside either: an explicit layout matrix, which is how the full-width row is arranged for .html and .pdf, makes Quarto’s typst writer drop the figure; a note returned beside the float loses the label and typst stops with label <fig-x> does not exist in the document; and grid.cell(colspan:) counts only as a direct child of the grid. So apaquarto writes the grid itself for typst, which is also why the panel labels are now its own. The word is figure-panel in the language field (credit to Claude).
  • An apa-note on a multipanel figure is written in every format. A layout was only recognised as one when its panels carried labels of their own, so a figure whose panels are plain code chunks — a fig-cap and no label — lost its note in .html, .docx and .pdf, and brought the typst render down altogether with Block, list of Blocks, or compatible element expected. The layout attributes are now read alongside the label mark; typst no longer chokes on a float whose content is a list of panels rather than a single block; and in .docx the note follows the float rather than going inside it, since Word takes only as many cells as the layout asked for and dropped the note otherwise (credit to Claude).
  • #162 documentmode now works in apaquarto-typst, with all four modes: man, jou (two columns, with column-spanning floats), doc, and stu. documentmode now accepts the modes spelled out in full, in both apaquarto-pdf and apaquarto-typst: journal, manuscript, document, and student are aliases for jou, man, doc, and stu. Thanks David Hagmann
  • apaquarto-typst draws R figures with svglite, as apaquarto-html already did (credit to Claude).
  • In a manuscript project, a figure’s note is written under the figure and above the “Source:” link that the notebook view puts beneath it, rather than under the link. The note now goes inside the cell instead of after it, which settles the order for both ways Quarto writes that link: as a block at the foot of the cell in .docx and .pdf, and as an anchor appended to the cell’s HTML after the filters have run (credit to Claude).
  • #158 The apa-note of a figure embedded from a notebook is written in the article (credit to Claude).
  • #158 apa-note can be used in a document that is not in an apaquarto format. Adding filters: with quarto and then apanote under it to an ordinary document brings in the filters that read a note and write it below its figure or table, and nothing else of apaquarto — no title page, no APA headings, no stylesheet. apanote is a small companion extension that installs alongside apaquarto and names a few of its filters, so quarto add wjschne/apaquarto brings both. In .html, revealjs and .docx it writes the note of a figure, of a table, and of each panel of a figure laid out in panels; the note belonging to such a figure as a whole is written later in the render than apanote is able to name, so that one does not arrive. In typst it covers a figure only. .pdf still needs apaquarto-pdf, whose notes are built by the LaTeX template. All of them work in full in apaquarto’s own formats. A document in an apaquarto format that names the filters as well now prints each note once rather than twice (credit to Claude).
  • A bibliography or csl field left without a file name no longer stops the render with File not found in resource path. Pandoc reads an empty value as the name of a file to open, and the traceback pointed at citeprocr.lua, so a typo in the YAML looked like a fault in apaquarto — plain Quarto stops on the same document in the same way. An empty bibliography entry is now dropped, an empty csl falls back to apaquarto’s own apa.csl, and each says which field to look at (credit to Claude).
  • Figure and table notes are built about ten times faster. The markdown of a note was read with quarto.utils.string_to_inlines, which runs Quarto’s whole AST normalization pipeline over the result and so costs about 9 ms per note whatever the note says — an empty one costs the same. Notes are now read with pandoc directly, which costs about a tenth of a millisecond and gives the same inlines, since Quarto reads a note with pandoc’s markdown reader too; a note carrying syntax Quarto adds on top of markdown, a shortcode or a fenced div, still takes the old path. On example.qmd this takes apanote.lua from 77 ms to 8 ms. Output is unchanged (credit to Claude).
  • #163 The apa-note of a figure or table pulled in with {{< embed other.qmd#fig-x >}} is written out in .docx, .html and typst. Quarto has two ways of placing an embed: it either brings the cell across, note attribute and all, or it brings only the cell’s output — which is what a manuscript project does, the one that builds a notebook view and puts a “Source:” link under the embed. In the second, apa-note is a cell option Quarto knows nothing about and does not carry into the output it keeps, so the note was gone before any apaquarto filter ran and there was nothing left to print. The embed does record which notebook and which cell it came from, so the note is now read back out of the notebook itself. Works for a notebook written as .qmd or as .ipynb. .pdf was never affected.
  • #163 A figure or table pulled in with {{< embed other.qmd#fig-x >}} is styled in .docx as one that has a note, when it has one. An embed wraps the cell in a div of its own, which put the apa-note a level deeper than the style was looked for, so an embedded figure with a note was given the style for a figure without one: 12 points of space under the figure, and no keepNext holding the note on the page with it, which let Word break between a figure and its note and leave the note stranded at the top of the next page. The note itself was always written; where it landed is what changes. The paragraph after such a figure is no longer given the extra space that belongs after a figure with no note.
  • #164 A .pdf no longer fails to build on a table whose first cell opens with a parenthesis, such as the term name (Intercept) that model summaries produce. booktabs’ rules take an optional trim argument written \midrule(rl) and look for it by peeking at the character after the rule; inside a longtable that peek read the ( as the start of a trim spec, tried to parse the letters of Intercept as trim sides, and brought the build down with “Undefined control sequence”. \@BLTrule is given an empty trim spec of its own so that it stops peeking, which costs the trim argument inside longtables and nothing else. Pandoc’s own tables were never affected, since pandoc writes \noalign{} after every rule; a table written as latex, such as kable(format = "latex", booktabs = TRUE, longtable = TRUE), was. Traced and fixed by 112345brian.
  • The typst jou masthead follows the journals: the journal’s name at the right of the page with its logo opposite, a rule under both, and the issue at the right beneath it with the copyright at the left, after the Journal of Educational Psychology. journal takes logo, year, issue, pages, url, issn, copyrightnotice and copyrighttext alongside title and volume, with logo: default giving the apaquarto logo that the extension ships with, and assembles the issue line out of year, volume, issue and pages rather than leaving it to be written by hand. A volume given on its own is still printed exactly as it was written, so a document that carries the whole line there is unchanged. Any of the fields may be written at the top level instead of under journal. The words “Vol.” and “No.” are journal-volume and journal-issue in the language field.
  • apaquarto-pdf composes the journal’s issue line out of the same year, volume, issue and pages the typst masthead uses, so the two formats print the same line.
  • #149 Cross-referenced code listings are set flush left in .docx rather than centered.
  • New author-note-columns option for apaquarto-typst. 1 keeps the author note in one column however long it runs, 2 sends it across the foot of the page however short it is, and auto, the default, decides by the length of the note. Journal mode only; the other document modes do not float the author note.
  • #104 numbered-lines: true no longer takes the running head out of a .docx. Line numbering is now written into the reference document’s own section properties, next to the page size, so the running head, the margins and the numbered lines all belong to one section.
  • #104 The running head is written into the .docx header as text, so it shows in viewers that do not resolve data bindings.
  • #160 Fixed apaquarto-pdf crashing on a subfigure layout whose panels carry an apa-note (“Block, list of Blocks, or compatible element expected, got table”). A sub-figure is no longer wrapped in a figure environment of its own, which latex does not allow inside another one, and the outer float splices its content as Blocks rather than nesting a list where a single block was expected. Thanks David Hagmann.
  • A subfigure layout in .pdf keeps the grid layout-ncol asks for when its panels carry notes; the panels used to come out stacked one per row.
  • A note on a subfigure layout div is printed once, below the grid, instead of once under every panel.
  • A note belonging to a whole subfigure layout spans the full width of the figure in .pdf and .html instead of sitting in one column of the grid. The note is a cell of the layout like the panels are, so floatwithsubfigure.lua now writes the grid out as an explicit layout matrix with a full-width row at the end, padding a part-filled row with a blank cell so every panel keeps the width it had. Quarto’s typst writer reads layout-ncol and falls back to a single column for a matrix, so typst and .docx are left as they were.
  • A subfigure layout with no caption text of its own is numbered in .pdf and can be cross-referenced. Quarto writes no \caption for such a float, and the \label goes with it, so the figure came out unnumbered and every reference to it rendered as “Figure ??”.
  • apaquarto-html no longer builds standalone preview pages for documents pulled in with {{< embed >}}. Quarto resolved this format’s theme against its temporary embed directory rather than the project, so every render with an embed warned Theme file not found and produced a preview page with none of the apaquarto styling. The embedded figure or table itself was never affected. Set notebook-view: true to get the “Source:” link and its preview page back.
  • mainfont, monofont, and papersize now work with docx via the docxreferencedoc.lua filter (credit to Claude)
  • Fixed .docx 4th and 5th level headers with ampersands (credit to Claude).
  • apaquarto-pdf uses lualatex (the new Quarto default engine).
  • #157 Because of the switch to the lualatex engine, users can specify screen reader accessibility via pdf-standard: ua-2 in their apaquarto-pdf options. Unfortunately, flextable tables are not yet ua-2 compliant and will result in a compilation error if ua-2 standards are enforced. Thanks Issac Petersen
  • Make tinytable output left-aligned by default.
  • Typst documents with citations no longer fail on a bibliography style path that Typst cannot resolve.
  • floatsintext: false is no longer ignored.
  • Plain markdown table captions now accept a full attribute block, not just {#tbl-...}.
  • In jou mode, appendices run continuously instead of each starting on a new page.
  • Fixed table notes appearing twice in typst jou mode.
  • In typst jou mode, every body paragraph is now indented, including the one that opens a section, and appendix paragraphs use the same indent as the body. References take a hanging indent the size of the body indent rather than the manuscript’s half inch, and the ORCID lines of the author note are set flush left and unindented. Figure and table captions stay flush left.
  • Fixed the body first-line indent being reset to the manuscript’s half inch after a reference list or a figure or table note in the typst jou and doc modes, which use a smaller indent.
  • Typst jou mode now follows apa7’s journal masthead closely: 0.75 inch margins and 10 point body text, against the 12 point the other modes use; 11 point section headings with 9 points of space above and below them; a \LARGE roman (not bold) title; a byline larger than the affiliations below it, the two single spaced; an ORCID icon sized to the cap height of the text beside it, so it no longer stretches the line it sits on; no heading above the abstract; the abstract and impact statement set smaller and in a narrower block, as apa7 sets them in a 4.6875 inch parbox; and the author note at the foot of the first column under a rule, with no heading, its paragraphs indented and run on without extra space between them. Line spacing in jou mode was also about half again too large, because the leading the template asked for is the gap between lines in typst rather than the baseline-to-baseline distance; 10 point text now sits on the 12 point baseline apa7 uses.
  • Fixed apaquarto-pdf hanging in documentmode: jou. This also appears to be the cause of the longstanding jou-mode bug in which sections of the document went missing.
  • The journal name is now given as journal: {title: "..."}, because Quarto reserves journal as an object.
  • New supplemental-materials option. Its value is printed on the line below the keywords, after an italicized Supplemental materials:, in every format and document mode. The prefix can be changed with title-supplemental-materials in the language field, and the line can be turned off with suppress-supplemental-materials: true.
  • Fixed apa-twocolumn tables losing their two-column span in apaquarto-pdf jou mode, where they overprinted the column text beside them.

Version 5.0.18

Version 5.0.17

  • 2026-03-25
  • #152 Fix .pdf longtable problem Thanks drfurtado for identifing the problem and Michael Zehetleitner posting a solution.
  • Allow 4th and 5th level headings to end with an exclamation point (credit to Claude)
  • Fixed minor coding bugs in Typst and Lua (credit to Claude)
  • Fixed minor documentation errors (credit to Claude)

Version 5.0.16

  • 2026-03-25
  • #152 Fix .pdf journal mode line numbers Thanks Ana Neves

Version 5.0.15

Version 5.0.14

Version 5.0.13

  • 2025-11-19
  • #143 Allow fontsize to be set for .pdf. Options are 10pt, 11pt, and 12pt. Thanks Matthew Warburton for bringing this to my attention.

Version 5.0.12

Version 5.0.11

  • 2025-08-21
  • Added support for the note field for pdf in stu mode. Thanks choc96208!

Version 5.0.10

  • 2025-08-18
  • Fixed spelling errors and a minor bug

Version 5.0.9

  • 2025-08-16
  • Fixed bug in citeprocr.lua to allow nocite field to be specified but empty

Version 5.0.8

  • 2025-08-13
  • Fixed bug in nocite meta-analytic references with corporate authors.

Version 5.0.7

  • 2025-08-11
  • #137 Fixed error for when user does not supply a document mode for apaquarto-pdf documents. Thanks Clemens Brunner!

Version 5.0.6

  • 2025-08-05
  • added keep ampersands for narrative citations
  • Inserts references if References Header and refs div are omitted

Version 5.0.5

  • 2025-08-02
  • 136. Meta-analytic references incorrectly had asterisks if they were also cited in text. This problem is fixed. Also, if a reference header was omitted and there are references, one will added at the end. Thanks lalamilalami for pointing out the problem!
  • Paragraph indentation in pdf journal mode was fixed.

Version 5.0.4

  • 2025-06-26
  • The apa-note code chunk can produce multiple paragraphs using yaml sequences.
  • For .pdf and typst, the first-page option can set the first page to a different value.

Version 5.0.3

  • 2025-06-09
  • #28. Allow section numbering with Quarto’s number-section (and number-depth) fields. Thanks juho7 for the feature request and to Ladislas Nalborczyk for the solution to the longstanding problem.

Version 5.0.2

  • 2025-05-17
  • #130. Implement word count feature. Thanks k-jens

Version 5.0.1

Version 5.0.0

  • 2025-05-06
  • #75 Set caption width for tables correctly so text fits in column in two-column mode. Thanks Matti Vuorre!

Version 4.4.3

Version 4.4.2

  • 2025-05-04
  • Allow markdown formatting in apa-note for .pdf documents.

Version 4.4.1

  • 2025-05-03
  • #128 Table and figure notes using apa-note now translate to the other languages in the .pdf format. Thanks Guilherme Pinto
  • Fixed .html level 4 heading bolding problem.
  • Upgraded to latest apa.csl format

Version 4.4.0

  • 2025-03-31
  • #124 Cross-referencing now works for markdown tables outside of fenced divs. Thanks Clemens Brunner!
  • #121 Adding support for subfigures. Thanks Clemens Brunner for the suggestion!

Version 4.3.16

  • 2025-03-30
  • #71 Workaround implemented for getting .pdf to allow multi-page tables. Thanks Florian Kohrt!

Version 4.3.15

  • 2025-03-29
  • #123 Fixed bug that omitted affiliations in docx, html, and typst output. Thanks Stefany Coxe!

Version 4.3.14

  • 2025-03-16)
  • #120 When a table or figure reference is not found, a more informative error is displayed. Thanks Steffen Aasen!

Version 4.3.13

  • 2025-03-15
  • #118 Email in correspondence note is displayed as a link. HTML format has additional blank lines before and after Abstract. Thanks Clemens Brunner!
  • #119 Allow use of beforenotespace code chunk option in .pdf jou mode. Thanks Ovande Furtado!

Version 4.3.12

Version 4.3.11

  • 2025-03-06
  • #113 Author note will show author correspondence information if author-note is absent. Thanks Clemens Brunner!
  • #115 The title-block-role-introduction field now works in apaquarto-pdf. Thanks Clemens Brunner!
  • #117 The papersize field now works in apaquarto-typst. Thanks Clemens Brunner!

Version 4.3.10

  • 2025-01-26
  • #109 Make ORCID have https link instead of http. Thanks Kilian Sander!!
  • #107 added table of contents, list of figures, and list of tables to apaquarto-typst. Thanks bsgallih12!
  • Implemented Impact Statement. Thanks franfrutos!

Version 4.3.9

  • 2024-12-14
  • Removed an unnecessary keyword print command used to debug 4.3.8.
  • Made html blockquote text the same color as body text.

Version 4.3.8

  • 2024-12-14
  • #102 Let keywords field be a string instead of an array

Version 4.3.7

  • 2024-12-14
  • #101 Removed indentation from .docx abstract’s first paragraph

Version 4.3.6

  • 2024-11-22
  • #98 The mainfont option now works for apaquarto-html.

Version 4.3.5

  • 2024-11-22
  • #97 Added a draft-date option.

Version 4.3.4

  • 2024-09-01
  • #85 Fixed longtable counter problem.

Version 4.3.3

  • 2024-07-04
  • Fixed lang option for abstract. Documented language options that are likely to be used in apaquarto.

Version 4.3.2

  • 2024-06-19
  • #76 Fixed bug that failed to account for user-specified terms in crossref

Version 4.3.1

  • 2024-05-28
  • #72 Fix bug while loading flextable in pdf.
  • #73 Fix bug for figure labels with underscores in them.

Version 4.3.0

  • 2024-05-22
  • #69 Allow users to set custom margins using Quarto’s geometry options.

Version 4.2.0

  • 2024-05-16
  • #67 Setting no-ampersand-parenthetical: true will replace the ampersand in both parenthetical and narrative (in text) citations.
  • Make link-citations: true the default. Can be set to link-citations: false in YAML.

Version 4.1.0

  • 2024-05-13
  • #68 Enable selective suppression of most elements of the title page and abstract page.

Version 4.0.3

  • 2024-05-11
  • For apaquarto-typst to run correctly, Quarto 1.5 or greater is required #54. An error message now prompts the user to update Typst.
  • Fixed link-citations for pdf #64.
  • Fixed rendering of stylized \(\LaTeX\) symbol in docx.
  • Updated to most recent version of apa.cls
  • Enable codelisting #62

Version 4.0.2

  • 2024-05-01
  • For apaquarto-typst to run correctly, Typst version 0.11.0 or greater is required #54. An error message now prompts the user to update Typst.

Version 4.0.1

  • 2024-05-01
  • Improvements for typst
    • Render LaTeX logo correctly
    • Implemented NoIndent feature for typst
    • Proper indenting for multi-paragraph abstracts
    • Fixed numbering of tables in appendices
    • Block quote indenting corrected
    • Color links blue
  • Fixed bug that reversed floatsintext to the opposite of expectations.
  • On the remote chance that anyone needs more than 26 appendices, subsequent appendices are AA, AB, AC, …, BA, BB, BC, … AAA, AAB, …

Version 4.0.0

  • 2024-05-01
  • Building on mvuorre’s typst template, typst-apaquarto is working. More to come.

Version 3.5.4

  • 2024-04-30
  • Fixed many bugs.
  • mvuorre contributed a typst template for apaquarto! Not all features are working yet, but typst opens up many possibilities.

Version 3.5.3

  • 2024-04-23
  • Abstract in .docx and .html no longer indented

Version 3.5.2

  • 2024-04-20
  • Added xpatch package to .pdf to fix appendix bug
  • Fixed bug that inserted meta-analysis explanation when nocite was empty
  • Fixed placement of references when refs div is omitted.

Version 3.5.1

  • 2024-04-19
  • Fixed bug that failed to move all float to the end of the document in .docx and .html

Version 3.5.0

  • 2024-04-12
  • Added table of contents for pdf documents #45

Version 3.4.9

  • 2024-04-09
  • At mvuorre’s suggestion #41:
    • I moved the example/documentation text out of the template and into a file called example.qmd. The new template contains what used to be called minimal.qmd.
    • I removed the apaquarto.Rproj file, references.bib, and img folder from being included by the quarto use template command.
  • Fixed mainfont problem not loading fontspec package in time for .pdf #40
  • Fixed bug associated with #41
  • Fixed bug that occurs when no author note is included.
  • Fixed figure numbering bug for markdown figures.

Version 3.4.8

  • 2024-03-30
  • Allow the correspondence note to be overridden by setting the correspondence-note subfield of the author-note field.
  • The meta-analysis field is now set to true by default (and thus does not need to appear in the metadata). If marking studies in the nocite field with asterisks is not desired, set the meta-analysis field to false.

Version 3.4.7

  • 2024-03-29
  • Studies included in a meta-analysis are not usually cited in the text but are included in the References section and flagged with an asterisk. When the meta-analysis field is set to true, citations listed in nocite are flagged with an asterisk in References section and a note to that effect is inserted below the References header.

Version 3.4.6

  • 2024-03-22
  • Figures and Tables in appendices have prefixes of A, B, C, etc.
  • Appendices appear after figures and tables when figures and tables appear at the end of the document.

Version 3.4.5

  • 2024-03-16
  • Indent abstract with multiple paragraphs properly
  • Title on first page of text is no longer numbered when number-sections is true
  • Remove indent from level 3 headers in .html output

Version 3.4.4

  • 2024-03-10
  • suppress-title-page option to suppress title page
  • Fix author names when specified by given, family, or literal fields
  • Fix author subscripts in pdf when affiliations are identical

Version 3.4.3

  • 2024-03-08
  • Allow for fonts other than Times in pdf documents.
  • Removed the notimes and notxfonts options for pdf documents. If mainfont is not selected, then the newtx package will be used.
  • Fixed balance of two columns in journal mode for pdf.

Version 3.4.2

  • 2024-03-06
  • Fixed .pdf bug when only one author or one affiliation

Version 3.4.1

  • 2024-03-05
  • Added “possessive” citations such that @schneider2024 ['s] will render as “Schneider’s - 2024)”

Version 3.4.0

  • 2024-03-04
  • Implemented language options for internationalization and customization.
  • Figures in jou mode fit to column width automatically. Can be overridden with fig-width or out-width.

Version 3.3.0

  • 2024-02-29
  • Added better documentation of apaquarto template options
  • If mask option is true, remove author names, author affiliations, and author notes from title page.
  • Fixed blank spaces above title and author note in .docx
  • Numbered lines for .docx
  • Support for multiline abstracts
  • Many minor fixes

Version 3.2.3

  • 2024-02-19
  • Add support for callout boxes in .pdf
  • Fixed .pdf line number problem that crept back in somehow yet again #34
  • Fixed problem with curly single quote in .docx running header

Version 3.2.2

  • 2024-02-15
  • Fixed bug so that tables and figures appear in correct order when floatsintext is true.

Version 3.2.1

  • 2024-02-14
  • Fixed error when no citations are present #33
  • Fixed .pdf line number problem that crept back in somehow #34

Version 3.2.0

  • 2024-02-13
  • Added support for masked references. #27

Version 3.1.0

  • 2024-02-09
  • The floatsintext option now works in docx and html. Setting it to true, intermingles text, figures, and tables. Setting it to false moves all figures and tables to the end of the document.

Version 3.0.0

  • 2024-01-20

The main goal for version 3 was to do everything with lua filters instead of R. It was quite a journey, but apaquarto is now completely independent of R, which should help folks working with other languages.

Breaking changes

  • The apafg- and apatb- prefixes are no longer used for figures and tables. Use the standard Quarto prefixes (fig- and tbl-), as well as the standard quarto referencing syntax (e.g., @fig-myplot will reference the fig-myplot chunk.).
  • The include statement below the metadata is no longer used and must be deleted. An informative error will provide instruction if the include statement remains.

Improvements

.docx

  • The title page and abstract page are now processed using lua filters instead of R.
  • The officer package is no longer required to create a new reference document every time the document is rendered #5 #29. Now, a lua filter looks for the shorttitle field in your yaml. If that is not found, the title and subtitle fields are used instead. The running header is assigned to the description field in the quarto metadata. This value will show up in the Comments field in the rendered .docx file, which is then inserted into the field box in the header.
  • The .docx running header is set with a lua filter and a docx field that draws from the .docx metadata.

.pdf

  • Can number lines #25
  • Fixed tightlist error #31
  • The jou (journal) mode in .pdf is better supported. There are a few hacky solutions that need a bit of work. #2 #27

Version 2.0.0

  • 2023-11-10
  • Many small fixes #15
  • Support for markdown tables #9 #21
  • Support for .html and .pdf became more solid. #22
  • CReditT taxonomy added for author roles. #3

Version 1.0.0

  • 2023-03-05

Initial release. Basic functions worked, but relied on many hacks that I always intended to fix. Mostly just for .docx, but .html and .pdf supported to some degree.

  • Most of the title page information was processed in R because I did not understand lua. UPDATE: As of version 3.0.0, all of the R code that used to be inserted, is not longer used. The lua filters take care of everything in the .html and .docx formats.
  • Because I did not yet understand lua and Quarto, I processed figures and tables differently in a non-standard way. I wrestled with Quarto, but I could not stop it from formatting the captions the way it wanted to. Finally I gave up and processed them with non-standard syntax and knitr hooks. UPDATE: This was always intended to be a temporary solution. As of version 3.0.0, all non-standard syntax is gone.
  • The ability to put simple markdown notes below figures and tables was important to me. The tricky part was to get them to travel with the figures and tables when they were part of floats or when they moved to the end of the document. Many headaches later, it works using the apa-note chunk option or apa-note as a custom attribute of a fenced div.
  • APA level 4 and 5 headings should remain as true headings that appear in the navigation tab in MS Word. Yet they appear as if they are in the same paragraph with subsequent text. This feature was implemented with apaquarto.lua filter that inserts openxml tags in the headers:
```openxml
<w:vanish/><w:specVanish/>
```

This creates a Style Separator character that you can see in MS Word by clicking the Show/Hide ¶ button. BTW, the CTRL+ALT+Enter keyboard shortcut in Word will insert a style separator. See https://www.cadmanediting.com/the-style-separator-a-hidden-gem-in-ms-word