Skip to main content Link Menu Expand (external link) Document Search Copy Copied

导航

主页面导航

J-T-D站点的主导航在页面的左侧,如果屏幕的小的话在顶部。主导航可以形成多层的系统, 默认情况下所有的页面都会出现在顶层,除非定义了父页面。

有序页面

要明确页面顺序可以在front matter中使用mnav_order参数。

---
layout: default
title: Customization
nav_order: 4
---

参数值决定了顶层页面的次序以及有相同父页面的子页面的次序。可以为不同父页面的子页面复用这 些参数值。

参数值可以是数字或者字符串,数值型的参数在字符串型的前面,在省略nav_order时默 认是页面的title.如果想要页面的顺序独立于页面的title,需要在所有页面上明确设定 nav_order,设置了nav_order的所有页面出现在以title排序的页面前面。

默认情况下,大写字符在小写字符前面,可以在配置文件中使用nac_sort: case_insensitive来忽略大小写。字符串可以使用引号闭合,数值类型如果使用引号将会 按照文本排序。

排除页面

对于一些不希望放在主导航栏的页面比如404页面可以在frone matter中使用nav_exclude: true参数。

---
layout: default
title: 404
nav_exclude: true
---

nav_exclude参数不会影响子页面的自动生成列表,可以用来访问主导航栏之外的页面。

没有title的页面会被自动排除在主导航栏之外。

子页面

有时我们会像样创建有许多section的页面,首先,建议放在同一个目录之下,比如所有文 档放在./docs目录下,每个章节放在一个子目录下比如./docs/ui-components./docs/utilities,目录结构如下:

+-- ..
|-- (Jekyll files)
|
|-- docs
|   |-- ui-components
|   |   |-- index.md  (parent page)
|   |   |-- buttons.md
|   |   |-- code.md
|   |   |-- labels.md
|   |   |-- tables.md
|   |   +-- typography.md
|   |
|   |-- utilities
|   |   |-- index.md      (parent page)
|   |   |-- color.md
|   |   |-- layout.md
|   |   |-- responsive-modifiers.md
|   |   +-- typography.md
|   |
|   |-- (other md files, pages with no children)
|   +-- ..
|
|-- (Jekyll files)
+-- ..

在父页面上添加frone matter has_children: true.比如:

---
layout: default
title: UI Components
nav_order: 2
has_children: true
---

子页面

有序子页面

自动生成TOC

子页面的子页面

附加链接

外部导航链接

TOC 页面导航