cross-post: how do you exclude a specific file from quarto listing

[ligea-alexander]

Description

https://github.com/quarto-dev/quarto-web/discussions/1502#discussion-7611225

Hi, I'm working on a Quarto-based portfolio and blog, and I have a scenario where I need help excluding specific .ipynb files from being rendered as individual posts in a listing. Here's the situation:

1. My blog folder contains multiple .qmd files for blog posts, along with some Jupyter notebooks that I use for referencing charts or code in the blog posts.
2. In one specific case, I referenced visualizations and analysis from a Jupyter notebook (1-intervention-analysis.ipynb) in a corporate-visualizations blog post (corp-viz.qmd).
3. The notebook is necessary because it contains charts that I embed or reference directly in the blog post, but I do not want the notebook itself to render as a standalone blog post in my listings.

Configurations I've tried:

---
title: "Blog"
title-block-banner: true
description: "I enjoy writing about tools I've tried and sharing that knowledge with fellow learners."
listing:
  id: data-viz-blog
  contents: blog
  type: grid
  categories: true
  sort-ui: [date]
  page-size: 36
  exclude:
    file: blog/corporate-visualizations/1-intervention-analysis.ipynb
---

[mcanouil]

See https://quarto.org/docs/websites/website-listings.html#listing-contents

Note that your use of include/exclude is incorrect (file or item are not metadata, unless you have set those in your documents; YAML indentation is important "exclude" is not under "contents"), trying out random things is unlikely to work, see https://quarto.org/docs/websites/website-listings.html#including-or-excluding-items.

Additionally, hide your Jupyter notebooks using a _ prefix as described in https://quarto.org/docs/websites/index.html#render-targets

[ligea-alexander]

Hi, thanks for responding!

I used the link shared covering listing-contents but everytime I do

---
title: "Blog"
title-block-banner: true
description: "I enjoy writing about tools I've tried and sharing that knowledge with fellow learners."
listing:
  id: data-viz-blog
  contents: blog
  type: grid
  categories: true
  sort-ui: [date]
  page-size: 36
  exclude:
    - corporate-visualizations/1-intervention-analysis.ipynb
---

I get prompt there's an error:

Additionally, I tried using a _ in front of the jupyter notebook I don't want rendered and got this error:

ERROR: Unable to embed content from notebook '1-intervention-analysis.ipynb'
The file /projects/blog/corporate-visualizations/1-intervention-analysis.ipynb doesn't exist or cannot be read.

charts in the notebook are being referenced in the article so possibly using _ is not suitable in this scenario?

[mcanouil]

Unfortunately, and as disclaimed in the description when you opened the discussion, without a reproducible example, the likelihood of anyone being able to accurately and efficiently help is close to zero.

If you change the name/path of the file and you use that file/path elsewhere for instance in include/embed shortcode, you need to update the file/path as well. Quarto cannot know you renamed the file.

To go further in this discussion, you need to share a small self-contained "working" (reproducible) example to work with, i.e., a complete Quarto document or a Git repository? The goal is to make it as easy as possible for us to recreate your problem so that we can fix it: please help us help you! Thanks.

---

You can share a self-contained "working" (reproducible) Quarto document using the following syntax, i.e., using more backticks than you have in your document (usually four ````).
See https://quarto.org/bug-reports.html#small-is-beautiful-aim-for-a-single-document-with-10-lines.

If you have multiple files (and if it is absolutely required to have multiple files), please share as a Git repository.

R	Python
````qmd --- title: "Reproducible Quarto Document" format: html engine: knitr --- This is a reproducible Quarto document. {{< lipsum 1 >}} ```{r} x <- c(1, 2, 3, 4, 5) y <- c(1, 4, 9, 16, 25) plot(x, y) ``` {#fig-placeholder} {{< lipsum 1 >}} The end after @fig-placeholder. ````	````qmd --- title: "Reproducible Quarto Document" format: html engine: jupyter --- This is a reproducible Quarto document. {{< lipsum 1 >}} ```{python} import matplotlib.pyplot as plt x = [1, 2, 3, 4, 5] y = [1, 4, 9, 16, 25] plt.plot(x, y) plt.show() ``` {#fig-placeholder} {{< lipsum 1 >}} The end after @fig-placeholder. ````

Additionally and if not already given, please share the output of quarto check within a code blocks (i.e., using three backticks ```txt), see https://quarto.org/bug-reports.html#check.