使用手稿

人工智能与机器学习

概述

人工智能（AI）和机器学习（ML）是当今科技领域最热门的话题之一。AI是指计算机系统能够执行通常需要人类智能的任务，如视觉识别、语音识别和决策制定。ML是AI的一个子集，专注于开发能够从数据中学习的算法。

关键技术

深度学习

深度学习是ML的一个分支，使用多层神经网络来处理复杂的数据模式。它在图像和语音识别方面取得了显著的成果。

强化学习

强化学习是一种通过试错来学习的ML方法。它通常用于游戏和机器人控制等领域。

应用领域

医疗保健

AI和ML在医疗诊断、药物发现和个性化治疗方面有广泛应用。

金融

在金融领域，AI用于风险管理、欺诈检测和算法交易。

挑战

数据隐私

随着AI和ML的发展，数据隐私成为一个重要问题。如何在不侵犯个人隐私的情况下利用数据是一个挑战。

伦理问题

AI系统的决策过程可能不透明，这引发了关于伦理和责任的讨论。

未来展望

AI和ML的未来充满希望，但也伴随着挑战。随着技术的进步，我们期待看到更多创新的应用和解决方案。

概述

手稿是一种Quarto项目，允许你编写学术文章，其中计算笔记本既是文章的来源，也是已发表记录的一部分。

如果你是Quarto手稿的新手，请从手稿教程开始。

在本页中，你可以学习如何：

• 创建手稿项目
• 使用_quarto.yml中的选项控制手稿输出
• 添加期刊模板

创建手稿项目

要将项目标识为手稿，请在你的_quarto.yml配置文件中指定type: manuscript：

_quarto.yml

project: 
  type: manuscript

然后，在名为index.ipynb的Jupyter Notebook或名为index.qmd的Quarto文档中编写你的文章内容。

你可以使用配置文件中的manuscript键控制许多手稿选项。例如，你可以使用article键指定除index.*之外的文件作为文章来源，例如：

_quarto.yml

manuscript:
  article: earthquakes.qmd

如果你更愿意从一些模板内容开始，你可以通过命令行创建一个新的手稿项目：

终端

quarto create project manuscript

包含笔记本

任何包含在你的项目目录中的笔记本文件（.qmd或.ipynb）都将成为你手稿的一部分。这些笔记本将被渲染为HTML笔记本视图，并将在你的手稿网页的“笔记本”下链接。

笔记本链接

“笔记本”下的链接文本将是笔记本的title，如在YAML元数据中设置的那样，或者如果没有设置，则是笔记本中的第一个Markdown标题。如果两者都不存在，链接文本将是笔记本文件名。

你也可以使用notebooks设置文本。使用notebook指定笔记本的路径，并使用title设置链接文本：

_quarto.yml

manuscript:
  notebooks:
    - notebook: notebooks/data-screening.ipynb
      title: 数据处理

外部笔记本

要提供指向托管在其他地方的笔记本的链接，请添加url选项：

_quarto.yml

manuscript:
  notebooks:
    - notebook: index.ipynb
      title: Binder Jupyter Lab 演示
      url: http://mybinder.org/v2/gh/binder-examples/jupyterlab/master?urlpath=lab/tree/index.ipynb

如果你想让Quarto从你的笔记本源生成一个HTML笔记本视图，但你想提供一个特定的版本供下载，请添加download-url选项：

_quarto.yml

manuscript:
  notebooks:
    - notebook: notebooks/data-screening.ipynb
      title: 数据处理
      download-url: notebooks/data-screening-raw.ipynb

代码链接

使用code-links添加链接，这些链接将出现在你的手稿网页的“代码链接”标题下。例如，以下内容添加了一个指向Python脚本的链接：

_quarto.yml

---
manuscript:
  code-links:
    - text: 数据导入代码
      icon: file-code
      href: data-import.py
---

你可以为code-links中的项目提供以下选项：

选项	描述
text	链接显示的文本。
href	链接的URL。
icon	链接的bootstrap图标。
rel	用于此链接的a标签中的rel。
target	用于此链接的a标签中的target。

GitHub和Binder链接

你还可以将两个特殊值作为项目传递给code-links：

repo

在“代码链接”下添加一个指向你的手稿GitHub仓库的“GitHub仓库”链接。

binder

如果你的手稿配置为使用Binder，则在“代码链接”下添加一个“启动Binder”链接。

包含其他资源

Quarto将尝试包含渲染你的笔记本到HTML所需的所有资源。然而，你也可以使用resources显式包含资源。例如，要包含你放在data/earthquakes.csv中的数据文件，你可以指定：

_quarto.yml

manuscript:
  resources:
    - data/earthquakes.csv

这确保读者可以在以下位置访问你的数据：{manuscript-url}/data/earthquakes.csv。

MECA捆绑包

手稿项目可以生成的一种格式是手稿交换通用方法（MECA）捆绑包。这个捆绑包是一种标准化的方式，用于传输你的手稿及其资源，包括计算笔记本。

如果你的文章的输出格式中列出了jats格式，则会生成一个MECA捆绑包。

_quarto.yml

format:
  html: default
  jats: default

或者，您可以在 manuscript 选项中显式地将 meca-bundle 设置为 true：

_quarto.yml

manuscript:
  meca-bundle: true

默认情况下，MECA 包以您的文章文件命名，例如 index-meca.zip，但您也可以使用 meca-bundle 提供文件名：

_quarto.yml

manuscript:
  meca-bundle: "bundle.zip"

手稿 URL

在非 HTML 格式中，指向您的笔记本的链接是使用您的手稿网站的 URL 构建的。 如果您的手稿发布到 GitHub Pages，Quarto 会自动检测并为您设置 URL。 但是，如果您发布到不同的主机，或者自动检测不起作用，您可以使用 manuscript-url 显式设置 URL：

_quarto.yml

manuscript:
  manuscript-url: www.posit.co

使用 Binder

Binder 允许您为读者提供一个链接，该链接可以恢复您的计算环境，以便他们可以在云计算环境中与您的手稿笔记本进行交互。

Quarto 可以帮助您配置手稿以使用 Binder。更多信息请参阅 使用 Binder。

自定义页面

您的手稿网站上的文章页面和笔记本视图是 HTML 页面，可以使用 html 格式的选项进行自定义。 完整的选项列表可在 HTML 选项 中找到。

主题

例如，您可以通过提供现有主题名称来使用 theme 选项更改页面的视觉样式：

_quarto.yml

format:
  html: 
    theme: solar

更多信息请参阅 HTML 主题。

评论

Quarto 还集成了三个工具，允许在您的手稿网站上进行评论。 要启用评论，请使用 html 格式的 comments 选项。 例如，要启用 Hypothes.is 评论，只需添加 hypothesis: true：

_quarto.yml

format:
  html: 
    comments:
      hypothesis: true

其他两个可用的工具是 Utterances 和 Giscus。您可以在 HTML 基础：评论 中了解如何设置它们。

添加期刊模板

您可以在 Quarto 扩展：期刊文章 页面上找到可用期刊格式的列表。 要使用期刊格式，例如 acs 格式，您需要完成两个步骤：

1. 安装适当的期刊格式。 您很可能在现有项目中安装，因此您将使用 quarto install extension 命令，例如：

   Terminal

   quarto install extension quarto-journals/acs

   扩展标识符 quarto-journals/acs 是扩展的 GitHub 用户和仓库。 您通常会在扩展的文档中找到这个标识符以及确切的安装命令。

2. 将 format 添加到您的配置文件中：

   _quarto.yml

   format:
     html: default
     docx: default
     jats: default
     acs-pdf: default

   格式将是扩展的名称（acs），后跟现有的 Quarto 格式（-pdf）。