6  YAML

6.1 格式要求

  • 首行和最后一行不能空

6.2 常用设置

6.2.1 外链

符合正则表达式的视作内链。

  • link-external-filter: ^(?:http:|https:)\/\/www\.quarto\.org\/custom:不以http://www.quarto.org/customhttp://www.quarto.org/custom开头均为内链。

  • link-external-filter: "ppt/AKI决策流程.html":包含ppt/AKI决策流程.html的均为内链,否则为外链,可以控制同一网页内的外链跳转。

6.2.2 execute相关

freeze https://quarto.org/docs/projects/code-execution.html#freeze

execute:
  error: true
  freeze: true  # 只执行一次,对于不经常变动的,可用该属性
  freeze: auto  # 当文件有改变时执行

显示错误信息,错误不影响render。

6.2.3 书的结构

官网: https://quarto.org/docs/books/book-structure.html

chapters:
  - index.qmd
  - preface.qmd
  - part: dice.qmd
    chapters: 
      - basics.qmd
      - packages.qmd
  - part: cards.qmd
    chapters:
      - objects.qmd
      - notation.qmd
      - modifying.qmd
      - environments.qmd