Unable to reproduce YAML Listing Content example

[dspm]

Description

Hello! I'm trying to reproduce the example from YAML Listing Content section in Guide > Websites > Listing Pages, but with no success. It looks like inputs that match a glob and inputs provided explicitly via YAML file are not getting merged and glob inputs take priority.

After creating a fresh project with quarto create project blog testing (version 1.4.551) I make a file archived-items.yaml in root directory which looks like this:

- title: "Archived Item 1"
  author: Norah Jones
  date: 2020-01-01
  path: "archived/archived-item-.html"
  categories: [archived, technology]

... and a file custom.qmd which looks like this:

---
title: "Listing Example"
listing:
  id: sample-listings
  contents: 
    - posts
    - archived-items.yaml
  sort: "date desc"
  type: table
---

... but the resulting listing shows only .qmd files from posts directory, not the entry from archived-items.yaml. The documentation says that sources of content should be merged, but it's not the case.

If I comment out posts (#- posts) as a content source, item from archived-items.yaml is displayed.

Further and building from the example in documentation, if I create another YAML file as a source of content and edit custom.qmd accordingly:

---
title: "Listing Example"
listing:
  id: sample-listings
  contents: 
    #- posts
    - archived-items.yaml
    - archived-items-2.yaml
  sort: "date desc"
  type: table
---

... it will display items merged from both YAML sources. However, including - posts as a source will again display only posts and ignore explicit YAML sources.

Am I missing out on something or there is a problem in the documentation?

[mcanouil]

Could you share a small self-contained "working" (reproducible) example to work with, i.e., a complete Quarto document or a Git repository (preferably)? Thanks.

Edit: to be clear, I cannot reproduce with what you shared, so something in your project/environment is missing for us to reproduce.

[dspm]

Sure, Git repository is here, output of quarto check in README.
Thx, @cderv, hopefully it's something silly on my side.

[cderv]

Cloning your repo and running quarto preview shows

I can't reproduce.

[cderv]

@dspm following your instruction, I can't reproduce with 1.4.551 latest release. I get this when looking at custom.html in the preview :

quarto preview custom.qmd

So the archived-items.yml content is included also in the listing table

[dspm]

I can successfully replicate the example from documentation if I run quarto preview while inside the project directory, but not if I run it from its parent directory (which is what I usually do).

So, quarto preview custom.qmd works, but quarto preview testing_YAML_listing/ or quarto preview testing_YAML_listing/custom.qmd will not work - it will preview the project in a browser, but behave the way I described.

This solves the problem for me, but feels like an unexpected behaviour and might be of interest to someone to see why it happens (I'm guessing preview misses paths of YAML content files and gives no warning), especially if it generalises to YAML content files placed in directories beneath the root.

[cderv]

So, quarto preview custom.qmd works, but quarto preview testing_YAML_listing/ or quarto preview testing_YAML_listing/custom.qmd will not work - it will preview the project in a browser, but behave the way I described.

Thanks that is detailed I did not have. Does it means you are running quarto preview or quarto render from outside the project directory usually ?

Your quarto project here is testing_YAML_listing/ and I understand your terminal working directory is ../testing_YAML_listing/ - the parent folder . Am I understanding correctly ?

[dspm]

Your quarto project here is testing_YAML_listing/ and I understand your terminal working directory is ../testing_YAML_listing/ - the parent folder . Am I understanding correctly ?

Yes.

[cderv]

I can reproduce this. Thank you ! We'll look into it!

[cderv]

Tracked in #9086