Where does 'resources:' go and what is the format of the value for a book in html?

[bryanhanson]

Description

My question is for a book project in html format, what is the correct place to specify a path to a folder containing images? And how do we give that path, is it quoted or not? I don't see any examples in the documentation, but the option is mentioned here.

Related issues/discussion are #5084 which doesn't seem to apply to books as resource-path: is not (apparently) not used with books, and #3763 which might have never been resolved.

Specifically, in _quarto.yml do we do

project:
  type: book
  resources: imgs # or /imgs?

or

project:
  type: book
  resources: "imgs" # or "/imgs"?

or does the option belong at the same level as "projects"? Note that #3763 uses both positions with varying degrees of success.

project:
  type: book

resources: imgs # or /imgs etc?

In my experimentation none of these seem to work (no errors during previewing until one navigates to a page with an image stored in /imgs and then it's not found. So I fully expect the answer is "none of the above silly..."

Testing with the latest version obtained yesterday bygit pull and then ./configure.sh.

[mcanouil]

See https://quarto.org/docs/websites/website-tools.html#site-resources.

"References" pages are basically the list of "all" the options".
"Guide" pages contain examples, tutorials, etc.

[bryanhanson]

Thanks. Can you look at this example created by quarto create-project --type book followed by moving cover.png to a new folder imgs? I think I'm doing what the instructions say, but the image 404s.

test-book.zip

[dragonstyle]

I think the path to the image itself is wrong. With this _quarto.yml it should work without the explicitly included resources:

project:
  type: book

book:
  title: "test-book"
  author: "Norah Jones"
  date: "6/20/2023"
  image: imgs/cover.png # < note the corrected path
  chapters:
    - index.qmd
    - intro.qmd
    - summary.qmd
    - references.qmd

bibliography: references.bib

format:
  html:
    theme: cosmo

[bryanhanson]

Thanks. I guess I had the wrong impression of how it should work. I was thinking using resources: would avoid having to prepend all image paths with the folder name.

[dragonstyle]

Ahh I see. That isn't how it works - you do have to use correct paths, resources is really just there in case you'd like to include files that we don't already 'know about' (e.g. we know about files that are linked to, or used in images, or used in yaml, etc...). When those resources are included, they keep the same path they had in the project (e.g. the cover img will still end up in img/cover.png but in the output directory).

HTH!

[bryanhanson]

Thanks for the clarification! Onward...

[mcanouil]

"resources" examples you can have that are needed but not linked to any files in Quarto: .htaccess and CNAME files.