Temple apa7

[alsonicr]

Hello,

i'm trying to create a pdf latex template for the document class apa7.

However the handling of the authors is not typical from other latex template (see https://ctan.math.illinois.edu/macros/latex/contrib/apa7/apa7.pdf for details)

\author{⟨author name⟩}
\twoauthors{First Author(s)}{Second Author(s)}
\threeauthors{John and Jim}{Mary and Sue}{Nick}
\fourauthors{Helen}{Dick}{Tracy and Larry}{James Bond}

Therefore quarto yaml metadata author is not working

My first ideas was to use the length of author meta data and could have look like that :

$if length(author)==3$  
\threeauthors{John and Jim}{Mary and Sue}{Nick}
$else$ $if length(author)==2$
\twoauthors{First Author(s)}{Second Author(s)}
....

but could find a way to access author length or to access a specific rank in author.

My  second  ideas was to create to create a metadata author1 to author6 and add :

$if (author2)$
\twoauthors{John Jim}{Mary Sue}
$endif$

and could not make it work.

does someone have any ideas ? 

[cderv]

Regarding Journal Template, you'll find a list of existing example in https://quarto.org/docs/extensions/listing-journals.html

There will be example there of how authors are handled in the . It is is not just a simple authors value, Quarto expose a normalized version of this metadata. See more in https://quarto.org/docs/journals/authors.html
If you're not leveraging the by-authors meta, maybe it can help.

length is a good idea but I don't think Pandoc's templating system as conditional for this testing of equality. Conditional is only for testing variable existence and truthiness.

I'll think more if we have some ways to express this iteration when a template require different command according to the number of authors. Not something we have encountered yet I think. Did you @dragonstyle ?

[alsonicr]

@dragonstyle I recently tried to add table in the two-column journal classoption.

I have seen you workaround here .

The solution seems to "work" (produce a pdf) sometimes and sometimes not, at random. I couldn't replicate when it does or doesn't work, because it happens when I don't change any file at all (e.g. I push the commit like it "works" and it doesn't).

Have I forgotten something for the _two-column-longtable.tex solution? For example, I did not find it referenced in the partial template from Elsevier.

[dragonstyle]

I'm not sure - in the Elsevier case it may be that there aren't two column formats or that the Elsevier class can accept long tables. Without seeing the exact tex generated, errors, and so on it is pretty difficult to diagnose. If you can try to narrow it down to something repeatable I am happy to have a look...

[alsonicr]

here is the error

compilation failed- error
Package longtable Error: longtable not in 1-column mode.

See the longtable package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              
                                                  
l.249 \begin{longtable}
                       []{@{}llrc@{}} 

see template.log for more information.

template.log return the same.

Normally it should be able to replicate the error from the repos : https://github.com/alsonicr/quarto-apa7

Normally ...

[dragonstyle]

Yes I could reproduce it - you need to actually include / use that .tex file. For example, I moved it out of the templates directory and up a level and then updated the _extension.yml file to read:

title: Apa7
author: First Last
version: 1.0.0
quarto-required: ">=1.2.0"
contributes:
  formats:
    common:
      toc: true
      filters:
        - apa7.lua
    pdf:
      documentclass: apa7
      include-in-header: _two-column-longtable.tex
      template-partials:
        - "partials/before-body.tex"
        - "partials/title.tex"
        
      
    # html:
    #   css: styles.css

This is the basic idea - include this tex file in the header when you're in 2 column mode. There are other fancier ways to handle this (for example from within LUA detecting whether the format will use 2 columns or not) but I'm not sure whether that is necessary here.

[alsonicr]

It seems to work

However, for some reason I can't seem to get the _two-column-longtable.tex code to interact with the Latex production. If I don't put a large chunk of text before the table, the text before the table is not included in the PDF. But if I remove the table of contents (toc: false) it works fine. Any ideas why? (sometimes latex compilation seems to loop infitly since I set max run to 20)

When classoption: man for the manuscript pdf other latex code is not included in the pdf when longtable start. My best guess is that _two-column-longtable.tex should only be included in the header when the jou option is used with some lua as you mention.

I was thinking of something like that:

Meta = function(meta)
  -- classoption function
  local test = meta['classoption']
  if test[1]=="jou" then 
    print("## APA journal format ##")  
    longtable = pandoc.RawInline('latex', '\include{"_two-column-longtable.tex"}')
    meta['longtable'] = longtable
    return meta
  else  
    print("### APA manuscript format###")  
  end
end

But I am not sure how to test the classoption man or jou

repo is update