Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

`output-dir` YAML option is not respected when source file is not in the `render` list

未关闭
#14,927 3 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
68/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
javascript
领域
build-system, cli

调研方向

Start with the Quarto CLI render path that handles a source file not included in the project's render list, using the provided quarto.yml, correct.qmd, and wrong.qmd reproduction. Run both quarto render commands and trace how project.output-dir is applied. Done means rendering wrong.qmd places wrong.html under _products, matching correct.qmd.

由索引模型根据 Issue 内容生成。

描述

bug projects
I have:
  • searched the issue tracker for similar issues
  • installed the latest version of Quarto CLI
  • formatted my issue following the Bug Reports guide
Bug description

When a file is not listed among the ones to render in _quarto.yml, the output-dir option is not respected and the rendered file is placed directly next to the source file.

Steps to reproduce

Example files:
quarto.yml

project:
  title: "Test"
  output-dir: _products
  render: 
    - "correct.qmd"

correct.qmd

This is rendered inside `_products/`.

wrong.qmd

This is rendered at project root.

Outputs of quarto render

PS C:\Projects\test> quarto render .\wrong.qmd  
pandoc 
  to: html
  output-file: wrong.html
  standalone: true
  section-divs: true
  html-math-method: mathjax
  wrap: none
  default-image-extension: png
  
metadata
  document-css: false
  link-citations: true
  date-format: long
  lang: en
  
Output created: wrong.html
PS C:\Projects\test> quarto render .\correct.qmd
pandoc 
  to: html
  output-file: correct.html
  standalone: true
  section-divs: true
  html-math-method: mathjax
  wrap: none
  default-image-extension: png
  
metadata
  document-css: false
  link-citations: true
  date-format: long
  lang: en
  
Output created: _products\correct.html
Actual behavior

No response

Expected behavior

No response

Your environment
Positron Version: 2026.09.1 (user setup) build 2
Code - OSS Version: 1.130.0
Commit: 467ff390dd8b4ffc8972ebb84d9e05a1fd5a4fe2
Date: 2026-09-04T09:54:04-07:00
Electron: 42.6.0
Chromium: 148.0.7778.280
Node.js: 24.18.0
V8: 14.8.178.38-electron.0
OS: Windows_NT x64 10.0.26200
Quarto check output
PS C:\Projects\test> quarto check
Quarto 1.10.18
[>] Checking environment information...
      Quarto cache location: C:\Users\AlessandroDiFabio\AppData\Local\quarto
[>] Checking versions of quarto binary dependencies...
      Pandoc version 3.10.0: OK
      Dart Sass version 1.101.0: OK
      Deno version 2.7.14: OK
      Typst version 0.15.1: OK
[>] Checking versions of quarto dependencies......OK
[>] Checking Quarto installation......OK
      Version: 1.10.18
      Path: c:\Users\AlessandroDiFabio\AppData\Local\Programs\Positron\resources\app\quarto\bin
      CodePage: 1252

[>] Checking tools....................OK
      TinyTeX: v2026.06
      Chrome Headless Shell: (not installed)
      VeraPDF: (not installed)

[>] Checking LaTeX....................OK
      Using: TinyTex
      Path: C:\Users\AlessandroDiFabio\AppData\Roaming\TinyTeX\bin\windows\
      Version: 2026

[>] Checking Chrome Headless....................OK
      Using: Chrome found on system
      Path: C:\Program Files\Google\Chrome\Application\chrome.exe
      Source: Windows Registry

[>] Checking basic markdown render....OK

[>] Checking R installation...........(None)

      Unable to locate an installed version of R.
      Install R from https://cloud.r-project.org/

[>] Checking Python 3 installation....(None)

      Unable to locate an installed version of Python 3.
      Install Python 3 from https://www.python.org/downloads/

[>] Checking Julia installation...
主要语言
JavaScript
星标
6.1k
派生
466
平均合并
20 小时 28 分钟
30 天内合并 PR
64

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

quarto-dev/quarto-cli 的其他 Issue

查看 quarto-dev/quarto-cli 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。