如何添加文档?

添加文档

文档位于_docs目录下。各子文档以子目录进行分类,如_docs/website是关于本网站建设的文档。添加文档到各子目录下并使用如下文件头:

layout: doc
title: 文档
order: 1

layout字段通知Jekyll使用文档模板进行排版。在排版过程中,文档所在目录以及各级子目录下的所有文档文件都会归并到菜单栏。

菜单管理

文档菜单可通过头文件字段管理。通过修改order字段对文档进行排序,值越小排序越高。菜单分两级,各文档默认进入第二级。通过设置section,可使文档进入一级菜单:

section: true

为了使特定文档页面进入/docs/(或设为文档主页),可设置如下字段:

doc: 1

doc值可决定文档主页的排序。