Jekyll中文文档__Pages

子车心思
2023-12-01

页面是内容最基本的构建块。它们对于独立内容(不基于日期的内容或不属于一组内容(如 staff members 或 recipes))很有用。

添加页面的最简单方法是在根目录中添加一个具有适当文件名的HTML文件。您也可以用Markdown在一个 .md 扩展名的文件中编写页面,该文件在构建时转换为HTML。对于具有主页、关于页面和联系页面的网站,以下是根目录和相关URL的样子:

.
├── about.md    # => http://example.com/about.html
├── index.html    # => http://example.com/
└── contact.html  # => http://example.com/contact.html

如果您有很多页面,可以将它们组织到子文件夹中。构建网站时,用于在项目 source 中对页面进行分组的相同子文件夹将存在于 _site 文件夹中。然而,当一个页面的 front matter 设置了不同的 permalink 时,_site 处的子文件夹会相应地发生变化。

.
├── about.md          # => http://example.com/about.html
├── documentation     # folder containing pages
│   └── doc1.md       # => http://example.com/documentation/doc1.html
├── design            # folder containing pages
│   └── draft.md      # => http://example.com/design/draft.html

更改输出URL

您可能需要为 source 文件设置一个特定的文件夹结构,该结构将针对构建的网站进行更改。通过 permalinks ,您可以完全控制输出URL。

Excerpts for pages

从 Jekyll 4.1.1开始,可以通过在配置文件中将 page_excerpts 设置为 true 来选择为页面生成摘录。

 类似资料: