apaquarto 使用与安装教程

apaquarto 使用与安装教程

apaquartoA quarto extension for creating APA7 documents in .docx, .html, and .pdf formats项目地址:https://gitcode.com/gh_mirrors/ap/apaquarto

1. 项目目录结构及介绍

apaquarto 是一个用于创建符合APA7风格文档的Quarto扩展。其目录结构如下：

.
├── _quarto.yml     # 主配置文件
├── apaquarto.Rproj   # R项目文件
├── apaquarto.scss    # 自定义样式表
├── bibliography.bib  # 引文数据库
├── CITATION.cff      # 项目贡献信息
├── changelog.qmd    # 更新日志
├── example*.qmd     # 示例文件
├── example_*.pdf    # 示例输出文件
├── img              # 图像资源
├── README.md        # 项目说明
└── *.csl            # APA7风格引用样式文件

• _quarto.yml: 配置整个项目的设置，包括输出格式、主题等。
• apaquarto.Rproj: R项目的入口，方便R用户操作。
• apaquarto.scss: 提供自定义CSS样式以调整输出文档的外观。
• bibliography.bib: BibTeX文件，存储所有参考文献。
• CITATION.cff: 描述项目贡献者和许可证的信息。
• changelog.qmd: 记录项目的更新历史。
• example*.qmd: 含有示例文本的Quarto文件。
• example_*.pdf: 示例文档的PDF输出。
• img: 存储图像资源。
• *.csl: 包含APA7引用样式规则。

2. 项目的启动文件介绍

启动文件是.qmd文件，例如 example.qmd 或 index.qmd，这是Quarto文档的源代码，包含Markdown文本、元数据和代码块。在这些文件中，可以插入文本、引用文献以及使用LaTeX语法进行数学公式或复杂格式化。

一个简单的 .qmd 文件可能包含以下元素:

---
title: "我的APA7论文"
author: ["你的名字"]
date: 2023-03-01
format:
  html: default
  pdf: 
    citation-package: biblatex
    documentclass: "article"
---
# 引言

这是一个示例段落，[参考文献](#refs)。

---

# 参考文献 {#refs}

元数据部分（以三个破折号开头）指定文档标题、作者、日期及输出格式。正文部分则包含Markdown文本，参考文献可以通过特定的引用标记自动从.bib文件中提取。

3. 项目的配置文件介绍

配置文件 _quarto.yml 用于定制Quarto编译过程的行为。它可包含如下的设置：

project:
  type: book

format:
  html:
    css: apaquarto.scss
    toc: true
    number-sections: false
  pdf:
    engine: luatex
    citation-package: biblatex
    documentclass: "apa6"

bibliography: bibliography.bib

csl: apa.csl

• project.type: 定义项目类型，这里设为书本格式。
• format.html: 设置HTML输出，包括CSS样式表、是否显示目录（TOC）、是否编号章节。
• format.pdf: 指定PDF引擎（如luatex）、引用包（如biblatex）、文档类（如apa6）。
• bibliography: 引用数据库文件名。
• csl: 选择使用的引用样式文件。

通过修改这个配置文件，你可以调整生成的文档样式和布局，使其更符合APA7规范。

完成上述步骤后，就可以开始使用apaquarto创建和编辑APA7风格的文档了。记得确保安装了Quarto和必要的扩展，然后按照教程所述的启动和配置步骤操作。

apaquartoA quarto extension for creating APA7 documents in .docx, .html, and .pdf formats项目地址:https://gitcode.com/gh_mirrors/ap/apaquarto