quarto-dev / quarto-dev/quarto-cli
Option for content-dir in `_quarto.yml`
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
It's nice when writing a book to have a dedicated sub-dir for the "actual writing", as opposed to quarto scaffolding.
For example:
/
| -- quarto.yml
|
...
|
| -- chapters/
| -- chapter1.qmd
Currently, this works fine if your _quarto.yml looks like:
chapters:
- chapters/chapter1.qmd
This gets unwieldy if you have lots of chapters, or a long dir name.
It would be nice to be able to specify a sub-dir once and then just use the chapter names, e.g.:
content-dir: chapters
chapters:
- chapter1.qmd
My apologies if this is already possible and I just missed it in the docs.
So far, loving a bookdown -> quarto conversion. Everything feels super ergonomic. Thank you!
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the _quarto.yml examples in the issue and compare the current chapters paths with the proposed content-dir form. Trace how chapter paths are resolved, then verify that the documented configuration works for a book with multiple chapters.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- yaml
- Domain
- build-system
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100