Quarto书籍技术咨询：取消前言目录编号、添加PDF输出等

1. 移除侧边栏目录中前言的编号 #

你尝试的.unnumbered类选择器无效，是因为Quarto书籍的章节编号控制需要结合全局配置或章节级YAML设置：

• 方法1：在章节YAML中指定
  打开前言对应的.qmd文件，在顶部YAML块中添加unnumbered: true：

  ---
  title: "Preface"
  unnumbered: true
  ---
  

• 方法2：在全局_quarto.yaml中配置
  如果你的书籍通过book.chapters定义章节结构，直接给前言项添加unnumbered: true：

  book:
    chapters:
      - index.qmd
      - preface.qmd:
          unnumbered: true
      - atlas.qmd  # 首个编号章节
  

  两种方法都能让侧边栏目录中的前言不再显示编号，从"Atlas"开始启用章节编号。

2. 添加PDF输出选项 #

在_quarto.yaml的format节点下新增pdf配置，基础示例如下：

format:
  html:
    # 保留你原有的HTML配置（如theme、toc等）
  pdf:
    documentclass: book  # 采用书籍类文档格式
    toc: true  # 生成PDF目录
    number-sections: true  # 章节编号（与HTML保持一致）
    margin: 1in  # 设置页面边距

你可以根据需求添加更多PDF参数（如fontsize、linestretch等），编译时执行quarto render --to pdf即可生成PDF版本。

3. 移除交叉引用的下划线 #

code-link: false仅控制代码块内链接的样式，针对章节/段落/图片的交叉引用，需要通过自定义CSS解决：

1. 在项目根目录创建styles.css文件，添加以下样式：

/* 移除所有交叉引用的下划线 */
a.section-ref, a.figure-ref, a.paragraph-ref {
  text-decoration: none;
}

2. 在_quarto.yaml的html格式配置中引入该CSS：

format:
  html:
    css: styles.css
    # 其他原有HTML配置

重新编译后，所有交叉引用的超链接下划线会被移除。

内容的提问来源于stack exchange，提问作者tcollar