The "Reviewed by" name is not displaying in the Title Block, but everything else is!

[noramcgregor]

Description

I have a website that I'm building here: https://noramcgregor.github.io/ds-essentials/ai-ml.html. I'm trying to customise the Title Block so that it will display the names of reviewers like it does with authors and I'm nearly there, except that for some reason it just won't render the reviewers name in the HTML! It does show links to their orcid id and email, but not the url/name. Any ideas?!

My YAML qmd looks like:
---
title: "AI & Machine Learning in Libraries"
date: 2025-05-13
date-modified: 2025-05-13
author:
  - name: Nora McGregor
    orcid: 0000-0001-6560-5586
    email: [email protected]
    url: https://libereurope.eu/member/nora-mcgregor/
    affiliation: 
      - name: British Library
        city: London
        country: UK
secondary-authors:
  - name: Stephen McGregor
    orcid: 0000-0001-6560-5586
    email: [email protected]
    url: https://www.tenfive.ai

And my title-block.html looks like: 

<header id="title-block-header" class="quarto-title-block default">
  <div class="quarto-title">
    $if(title)$
    <h1 class="title">$title$</h1>
    $endif$
    $if(subtitle)$
    <p class="subtitle lead">$subtitle$</p>
    $endif$
    $if(categories)$
    $if(quarto-template-params.title-block-categories)$
    <div class="quarto-categories">
      $for(categories)$
      <div class="quarto-category">$categories$</div>
      $endfor$
    </div>
    $endif$
    $endif$
  </div>
  $if(hide-description)$
  $elseif(description)$
  <div>
    <div class="description">
      $description$
    </div>
  </div>
  $endif$
  <div class="quarto-title-meta">

    $if(by-author)$
    <div class="quarto-title-meta-author" style="display: block; width: 100%; margin-left: 0; padding-left: 0; box-sizing: border-box; grid-column: 1 / -1; justify-self: start; text-align: left;">
      $if(labels.author-title)$
      <div class="quarto-title-meta-heading">$labels.author-title$</div>
      $else$
      <div class="quarto-title-meta-heading">Authors</div>
      $endif$
      <div class="quarto-title-meta-contents">
        $for(by-author)$
          $_title-meta-author.html()$ $endfor$
      </div>
    </div>
    $endif$
    $if(secondary-authors)$ <div class="quarto-title-meta-reviewed-by">
      <div class="quarto-title-meta-heading">Reviewed By</div>
      <div class="quarto-title-meta-contents">
        $for(secondary-authors)$ $_title-meta-author.html()$
        $endfor$
      </div>
    </div>
    $endif$
    $if(date)$
    <div class="quarto-title-meta-date">
      <div class="quarto-title-meta-heading">$if(labels.published-title)$$labels.published-title$$else$Published$endif$</div>
      <div class="quarto-title-meta-contents">
        <p class="date">$date$</p>
      </div>
    </div>
    $endif$
    $if(date-modified)$
    <div class="quarto-title-meta-modified-date">
      <div class="quarto-title-meta-heading">Modified</div>
      <div class="quarto-title-meta-contents">
        <p class="date-modified">$date-modified$</p>
      </div>
    </div>
    $endif$
    $if(doi)$
    <div class="quarto-title-meta-doi">
      <div class="quarto-title-meta-heading">DOI</div>
      <div class="quarto-title-meta-contents">
        <p class="doi">$doi$</p>
      </div>
    </div>
    $endif$
  </div>
  $if(abstract)$
  <div class="abstract">
    <div class="quarto-title-meta-heading">$abstract-title$</div>
    <div class="quarto-title-meta-contents">
      $abstract$
    </div>
  </div>
  $endif$
  $if(keywords)$
  <div class="quarto-title-meta-keywords">
    <div class="quarto-title-meta-heading">Keywords</div>
    <div class="quarto-title-meta-contents">
      <div class="text-keywords">
        <p>$for(keywords)$$keywords$$sep$, $endfor$</p>
      </div>
    </div>
  </div>
  $endif$
  </header>

[mcanouil]

It's because your "secondary-authors" is not like "authors" as it does not get normalised by Quarto, so you need to explicitly handle it.

[noramcgregor]

I tried to through the _title-meta-author.html but that hasn't worked....any ideas? Am I moving in the right direction?! Or do I need to just hard code every .qmd that needs a reviewer in the front matter/title block.....

$if(secondary-authors)$
<div class="quarto-title-meta-reviewed-by">
  <div class="quarto-title-meta-heading">Reviewed By</div>
  <div class="quarto-title-meta-contents">
    <ul>
    $for(secondary-authors)$
      <li>$name$ – $email$</li>
    $endfor$
    </ul>
  </div>
</div>
$endif$

[cderv]

To add to the previous answer, the authors and affiliations handling in Quarto is quite specific and different than Pandoc metadata alone; This is detailed in

• Usage in front matter: https://quarto.org/docs/authoring/front-matter.html#authors-and-affiliations
• Normalization: https://quarto.org/docs/journals/authors.html
  The idea is to be flexible on the YAML side for passing information and normalized for template and filter usage.

So the idea is to use author even with multiple authors, and adapt their role for example. Reviewed By could be

author:
  - name: Josiah Carberry
    roles: "editing"

https://quarto.org/docs/authoring/front-matter.html#roles

Now with this context, regarding what you tried with

secondary-authors:
  - name: Stephen McGregor
    orcid: 0000-0001-6560-5586
    email: [email protected]
    url: https://www.tenfive.ai

As already mentioned, this will not be processed by Authors normalization - it will be regular metadata for pandoc to use in the template. Depending on what you want, this could work.

But it seems you are trying to use _title-meta-author.html() directly with your new secondary-authors metadata, so it may need to be transformed.

Though I need to try, because reading it like this, it could have work. Tweaking this part is complex. 🤔

Do I understand correctly that you want a new HTML part in your document title block to separate your reviewers' list from the authors' list? Using roles is not enough ?

[cderv]

Also a note : Your .qmd does not have

format:
  html: 
    template-partials: 
      - title-block.html

this is required for the custom partials to be used. When I do that, I get

but as expected, the value are not used because of how the metadata is stored (being not normalized like by-authors) - So it can't directly by used by _title-meta-author.html it logic.

It would work if you use the "normalized" version as the name is it.name.literal and not just it.name

secondary-authors:
  - name: 
      literal: Stephen McGregor
    orcid: 0000-0001-6560-5587
    email: [email protected]
    url: https://www.tenfive.ai

Details

---
title: "AI & Machine Learning in Libraries"
date: 2025-05-13
date-modified: 2025-05-13
author:
  - name: Nora McGregor
    orcid: 0000-0001-6560-5586
    email: [email protected]
    url: https://libereurope.eu/member/nora-mcgregor/
    affiliation: 
      - name: British Library
        city: London
        country: UK
secondary-authors:
  - name: 
      literal: Stephen McGregor
    orcid: 0000-0001-6560-5587
    email: [email protected]
    url: https://www.tenfive.ai
format: 
  html:
    template-partials: 
      - title-block.html
---

# Content

<header id="title-block-header" class="quarto-title-block default">
<div class="quarto-title">
    $if(title)$
    <h1 class="title">$title$</h1>
    $endif$
    $if(subtitle)$
    <p class="subtitle lead">$subtitle$</p>
    $endif$
    $if(categories)$
    $if(quarto-template-params.title-block-categories)$
    <div class="quarto-categories">
    $for(categories)$
    <div class="quarto-category">$categories$</div>
    $endfor$
    </div>
    $endif$
    $endif$
</div>
$if(hide-description)$
$elseif(description)$
<div>
    <div class="description">
    $description$
    </div>
</div>
$endif$
<div class="quarto-title-meta">

    $if(by-author)$
    <div class="quarto-title-meta-author" style="display: block; width: 100%; margin-left: 0; padding-left: 0; box-sizing: border-box; grid-column: 1 / -1; justify-self: start; text-align: left;">
    $if(labels.author-title)$
    <div class="quarto-title-meta-heading">$labels.author-title$</div>
    $else$
    <div class="quarto-title-meta-heading">Authors</div>
    $endif$
    <div class="quarto-title-meta-contents">
        $for(by-author)$
        $_title-meta-author.html()$ $endfor$
    </div>
    </div>
    $endif$
    $if(secondary-authors)$ <div class="quarto-title-meta-reviewed-by">
    <div class="quarto-title-meta-heading">Reviewed By</div>
    <div class="quarto-title-meta-contents">
        $for(secondary-authors)$ $_title-meta-author.html()$
        $endfor$
    </div>
    </div>
    $endif$
    $if(date)$
    <div class="quarto-title-meta-date">
    <div class="quarto-title-meta-heading">$if(labels.published-title)$$labels.published-title$$else$Published$endif$</div>
    <div class="quarto-title-meta-contents">
        <p class="date">$date$</p>
    </div>
    </div>
    $endif$
    $if(date-modified)$
    <div class="quarto-title-meta-modified-date">
    <div class="quarto-title-meta-heading">Modified</div>
    <div class="quarto-title-meta-contents">
        <p class="date-modified">$date-modified$</p>
    </div>
    </div>
    $endif$
    $if(doi)$
    <div class="quarto-title-meta-doi">
    <div class="quarto-title-meta-heading">DOI</div>
    <div class="quarto-title-meta-contents">
        <p class="doi">$doi$</p>
    </div>
    </div>
    $endif$
</div>
$if(abstract)$
<div class="abstract">
    <div class="quarto-title-meta-heading">$abstract-title$</div>
    <div class="quarto-title-meta-contents">
    $abstract$
    </div>
</div>
$endif$
$if(keywords)$
<div class="quarto-title-meta-keywords">
    <div class="quarto-title-meta-heading">Keywords</div>
    <div class="quarto-title-meta-contents">
    <div class="text-keywords">
        <p>$for(keywords)$$keywords$$sep$, $endfor$</p>
    </div>
    </div>
</div>
$endif$
</header>

[noramcgregor]

OH MY GOSH you are a wizard! Thank you so much, I am so grateful for this, that's worked perfectly! Spelling out the whole thing here in case that helps others. Have a wonderful day!!!

1. In my _quarto.yml I have:

format:
  html:
    template-partials:
      - title-block.html
      - partials/_title-meta-author.html

2. In my _template-meta-author.html I have the default: https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/formats/html/templates/_title-meta-author.html

3. Within each front matter of each article I will make sure that reviewer is in the format you suggested:

 secondary-authors:
  - name: 
      literal: Stephen McGregor
    orcid: 0000-0001-6560-5587
    email: [email protected]
    url: https://www.tenfive.ai

4. And my title-block.html remains:

<header id="title-block-header" class="quarto-title-block default">
  <div class="quarto-title">
    $if(title)$
    <h1 class="title">$title$</h1>
    $endif$
    $if(subtitle)$
    <p class="subtitle lead">$subtitle$</p>
    $endif$
    $if(categories)$
    $if(quarto-template-params.title-block-categories)$
    <div class="quarto-categories">
      $for(categories)$
      <div class="quarto-category">$categories$</div>
      $endfor$
    </div>
    $endif$
    $endif$
  </div>
  $if(hide-description)$
  $elseif(description)$
  <div>
    <div class="description">
      $description$
    </div>
  </div>
  $endif$
  <div class="quarto-title-meta">

    $if(by-author)$
    <div class="quarto-title-meta-author" style="display: block; width: 100%; margin-left: 0; padding-left: 0; box-sizing: border-box; grid-column: 1 / -1; justify-self: start; text-align: left;">
      $if(labels.author-title)$
      <div class="quarto-title-meta-heading">$labels.author-title$</div>
      $else$
      <div class="quarto-title-meta-heading">Authors</div>
      $endif$
      <div class="quarto-title-meta-contents">
        $for(by-author)$
          $_title-meta-author.html()$ $endfor$
      </div>
    </div>
    $endif$
    $if(secondary-authors)$ <div class="quarto-title-meta-reviewed-by">
      <div class="quarto-title-meta-heading">Reviewed By</div>
      <div class="quarto-title-meta-contents">
        $for(secondary-authors)$ $_title-meta-author.html()$
        $endfor$
      </div>
    </div>
    $endif$
    $if(date)$
    <div class="quarto-title-meta-date">
      <div class="quarto-title-meta-heading">$if(labels.published-title)$$labels.published-title$$else$Published$endif$</div>
      <div class="quarto-title-meta-contents">
        <p class="date">$date$</p>
      </div>
    </div>
    $endif$
    $if(date-modified)$
    <div class="quarto-title-meta-modified-date">
      <div class="quarto-title-meta-heading">Modified</div>
      <div class="quarto-title-meta-contents">
        <p class="date-modified">$date-modified$</p>
      </div>
    </div>
    $endif$
    $if(doi)$
    <div class="quarto-title-meta-doi">
      <div class="quarto-title-meta-heading">DOI</div>
      <div class="quarto-title-meta-contents">
        <p class="doi">$doi$</p>
      </div>
    </div>
    $endif$
  </div>
  $if(abstract)$
  <div class="abstract">
    <div class="quarto-title-meta-heading">$abstract-title$</div>
    <div class="quarto-title-meta-contents">
      $abstract$
    </div>
  </div>
  $endif$
  $if(keywords)$
  <div class="quarto-title-meta-keywords">
    <div class="quarto-title-meta-heading">Keywords</div>
    <div class="quarto-title-meta-contents">
      <div class="text-keywords">
        <p>$for(keywords)$$keywords$$sep$, $endfor$</p>
      </div>
    </div>
  </div>
  $endif$
  </header>