Skip to content

fix: stop rendering skill.md by enumerating Quarto render globs#236

Open
has2k1 wants to merge 1 commit into
posit-dev:mainfrom
has2k1:fix-skill-md-render-exclusion
Open

fix: stop rendering skill.md by enumerating Quarto render globs#236
has2k1 wants to merge 1 commit into
posit-dev:mainfrom
has2k1:fix-skill-md-render-exclusion

Conversation

@has2k1

@has2k1 has2k1 commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

The PR addresses skill.md being rendered into the docs site despite the !skill.md exclusion in project.render, because a recursive ** glob overpowers any ! negation that follows it. For example, with render: ["**", "!skill.md"] Quarto still rendered skill.mdskill.html; a post-render step then deleted that stray skill.html, which crashed great-docs build --watch when Quarto's file monitor tried to hash the now-missing file (#228).

This PR seeds project.render with Quarto's default input globs

["*.qmd", "*.md", "*.markdown", "*.rmd", "*.Rmd", "*.rmarkdown", "*.ipynb"]

instead of **, so the !skill.md exclusion — and the analogous custom-page exclusions — actually take effect while still matching files recursively (subdirectory pages like user_guide/*.qmd continue to render).

With skill.md no longer rendered, it also removes the now-dead post-render workarounds that deleted skill.html and rewrote its links, so skill.md is served directly as a resource and the watch build no longer crashes.

fixes #228

A recursive "**" in project.render overpowers any "!" negation, so
Quarto rendered skill.md -> skill.html despite the !skill.md exclusion.
The stray skill.html was then deleted in post-render, which crashed
`build --watch` when Quarto tried to hash the missing file (posit-dev#228).

Seed project.render with Quarto's default input globs instead of "**" so
the !skill.md (and custom-page) exclusions take effect while still
matching files recursively. Remove the now-dead post-render workarounds
that deleted skill.html and rewrote its links.

fixes posit-dev#228
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

great-docs build --watch fails

1 participant