默认情况下，页面的URL将遵循文件系统路径。例如，如果你有一个位于 content/posts/python3.md 的页面，它将在 {config.base_url}/posts/python3/ 可用。你可以通过在Front Matter中设置 slug 变量来覆盖从文件名创建的slug。

通常，一个页面将包含资产，你可能希望将它们与Markdown文件放在同一位置。Gutenberg默认支持这种模式：你可以创建一个文件夹，放入一个名为 index.md 的文件以及任何与之一起的文件（不是Markdown文件）。这些资产将在构建时复制到同一文件夹中，因此你可以使用相对路径来使用它们。

只有当你将 <!-- more --> 放在内容中时，才会定义摘要。如果存在于页面中，摘要将从开始到该标签。

章节

章节代表一组页面，例如你的网站的 tutorials 章节示例。只有当在 content 目录中找到名为 _index.md 的文件时，Gutenberg才会创建章节。

此 _index.md 文件也需要包括Front Matter，但不会包含内容。

+++
title = "Tutorials"
+++

您还可以设置 template 变量来更改用于渲染该章节的模板。

章节还会自动获取其子章节，允许您创建一些复杂的页面布局和目录。

您可以使用Front Matter中的 sort_by 键定义章节页面的排序方式。选项包括 date、order 和 none（默认）。目前无法排序的页面将被静默删除：最终页面将被渲染，但它不会出现在章节模板中的 pages 变量中。

特殊案例是位于 content 目录根部的 _index.md，它代表主页。它只用于控制主页的分页和排序。

您还可以分页章节，包括索引，通过在Front Matter中设置 paginate_by 字段为整数来实现。这代表分页器每个分页器的页面数。您需要通过 paginator 对象来访问页面。（待文档化）。

目录

每个页面/章节将根据标题生成一个目录。它通过 section.toc 和 page.toc 可访问。它是一个包含 permalink、title 和 children 的标题列表。以下是如何使用该目录的示例。

<ul>
{% for h1 in page.toc %}
    <li>
        <a href="{{h1.permalink}}">{{ h1.title }}</a>
        {% if h1.children %}
            <ul>
                {% for h2 in h1.children %}
                    <li>
                        <a href="{{h2.permalink}}">{{ h2.title }}</a>
                    </li>
                {% endfor %}
            </ul>
        {% endfor %}
    </li>
{% endfor %}
</ul>

虽然在该示例中标题井然有序，但你也可以创建一个看起来像 h2、h2、h1、h3 的目录，而没有任何问题。

分类法：标签和分类

仅支持具有日期的页面进行单独的标签/分类页面。

代码高亮主题

可以通过在 config.toml 中设置 highlight_code = true 来开启代码高亮。

开启后，所有在反引号之间的文本都将被高亮显示，如下面的示例所示。

let site = Site::new();

如果没有指定语言名称，则默认为纯文本高亮。

Gutenberg 使用 Sublime Text 主题进行语法高亮。它内置以下主题：

• base16-ocean-dark
• base16-ocean-light
• gruvbox-dark
• gruvbox-light
• inspired-github
• kronuz
• material-dark
• material-light
• monokai
• solarized-dark
• solarized-light

内部链接

您可以在 Markdown 中添加内部链接，在渲染时将被完整 URL 替换。为此，请使用常规 Markdown 链接语法，以 ./ 开头的链接，指向要链接的 .md 文件。文件的路径从 content 目录开始。

例如，要链接到位于 content/pages/about.md 的文件，链接方式将是 [我的链接](./pages/about.md)。

锚点

为了能够添加深链接，标题将根据其内容自动获得一个 ID。您还可以在章节级别选择是否自动在旁边插入锚点链接。默认情况下是关闭的，但可以在 _index.md 文件中将 insert_anchor = "left" 或 insert_anchor = "right" 设置为开启。 left 将在标题文本之前插入锚点链接，而 right 将在其后插入。

{{ youtube(id="my_youtube_id") }}

{% quote(author="Me", link="https://google.com") %}
My quote
{% end %}

$ git submodule update --init 

$ cd sublime_syntaxes
$ git submodule add https://github.com/elm-community/Elm.tmLanguage.git

$ git submodule update --remote --merge

$ cargo run --example generate_sublime synpack sublime_syntaxes sublime_syntaxes/newlines.packdump sublime_syntaxes/nonewlines.packdump

$ cargo run --example generate_sublime themepack sublime_themes sublime_themes/all.themedump