创建你自己的内容文件#

既然你已经看到了一些示例内容文件,并且构建了一本简单的书,尝试创建你自己的内容文件吧!

创建你的文件并添加内容#

在你存放示例书籍内容的文件夹中,创建一个名为 mymarkdownfile.md 的新文件。将以下内容放入其中:

# 这是我的示例标题

这是一些示例文本。

(section-label)=
## 这是我的第一部分

这里有一个 [指向介绍的引用](intro.md)。这里有一个引用 [](section-label)。

我们添加了两项新的Markdown语法,它们都与交叉引用相关。

  • (section-label)= 是一个附加在部分标题上的标签。它指向紧随其后的标题,并允许你在文本的其他地方引用这个标签。

  • [链接文本](链接目标) 语法是你在Markdown中指定链接的方式。这里我们链接到另一个页面,以及上面创建的标签。

当你构建你的书籍时,你会看到这些链接在输出中的解析方式。

将其添加到目录中#

既然你已经有了一个新的文件,我们需要将其添加到你的 _toc.yml 文件中,这样Jupyter Book就知道它在你书籍结构中的位置。 在你的 _toc.yml 文件中添加一行指向这个新内容的指示。它应该看起来像这样:

# 在 _toc.yml 中
format: jb-book
root: intro
chapters:
- file: markdown
- file: notebooks
- file: markdown-notebooks
- file: mymarkdownfile

重新构建你的书籍#

既然你已经将文件添加到你的 _toc.yml 文件中,你可以重新运行构建命令:

$ jupyter-book build mybookname

这将重新构建你的书籍,你的新页面将出现在输出中。

Tip

如果你的书籍目录在更改 _toc.yml 文件后没有更新,尝试:

$ jupyter-book build --all mybookname