创建你自己的内容文件#
既然你已经看到了一些示例内容文件,并且构建了一本简单的书,尝试创建你自己的内容文件吧!
创建你的文件并添加内容#
在你存放示例书籍内容的文件夹中,创建一个名为 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