Including image-files via knitr::include_graphics() errors out if path is relative to project-root, but document-location is not at root

[Gewerd-Strauss]

Description

Hello,

I feel like I am going crazy.

Assume I have a website-project, and within it I have a file file.qmd at root-level:

---
aliases: []
author: redacted
creation date: "2024-07-01 11:17"
modification date: "2024-07-04 15:16"
subtitle: to compare against when quantifying effects of modifications to the setup
tags:
  - BE31/parameters
title: baseline-setup
---
```{r}
#| warning: false
#| out-width: "100%"
c <- "assets/obsidian-assets/photobox_overview_gfa_coords.jpg"
knitr::include_graphics(c)
```

The image exists under the path described, relative to the project root.

This renders correctly in html and pdf when executing quarto render .\file.qmd.
If I create an identical file in e.g. experiments/file.qmd, and repeat the process, this file is no longer found, and the following error is issued when converting to pdf:

[2/2] experiments\file.qmd


processing file: file.qmd
1/3
2/3 [unnamed-chunk-1]
3/3
output file: file.knit.md



processing file: file.qmd
1/3
2/3 [unnamed-chunk-1]
3/3
output file: file.knit.md


Rendering PDF
running xelatex - 1
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode

updating tlmgr

updating existing packages
ERROR: 
compilation failed- error
Unable to load picture or PDF file 'assets/obsidian-assets/photobox_overview_gfa_coords.jpg'.
<to be read again>
                   }
l.224 ...-assets/photobox_overview_gfa_coords.jpg}


see D:\Dokumente neu\Obsidian NoteTaking\BE31-Thesis-quarto\experiments\file.log for more information.

When trying to convert to html, I don't receive an error, but the resulting webpage will not render the image:

Contrary to that, when I target the root-level file file.qmd, it converts successfully to both html and pdf:

---

---

To my understanding, with the config-setting execute-dir: project, paths should be reconstructed from the project's root-level. I don't understand

• why a file nested in another folder does not find <root>/assets/obsidian-assets/photobox_overview_gfa_coords.jpg, nor
• how I can rectify this issue.

Can someone help me make sense of this?

Thank you.
Sincerely,
~Gw

---

---

Project yaml:

project:
  type: website
  output-dir: _site
  execute-dir: project
  render: # order in project.render is important; because documents are rendered in this order. a change that should suppress an update in 5 minutes
# ...
  - "*.qmd"
  - "*.md"
# ...
format:
  html:
    toc: true
  pdf:
    toc: true

The logfile contains:

LaTeX Warning: File `assets/obsidian-assets/photobox_overview_gfa_coords.jpg' not found on input line 224.

! Unable to load picture or PDF file 'assets/obsidian-assets/photobox_overview_gfa_coords.jpg'.

I am running quarto v.1.5.52.

A reprex for this issue can be found at https://github.com/Gewerd-Strauss/quarto-cli-10226. Refer to its readme for reproduction steps.

[Gewerd-Strauss]

I have found a bad hotfix for this issue:

By organising images relative to the notes which embed them, these notes get correctly rendered during single-renders, as well as directory- and project-wide renders to both html and pdf.

The downside is that an image which is required elsewhere will have to be duplicated across multiple directories - and moving files around becomes substantially more frustrating.

For these reasons, I'd much rather understand why the above is not working, and how I can rectify this in a more stringent manner.