docs: add menu management documentation (#453)

添加菜单管理的使用文档。

Fixes https://github.com/halo-dev/docs/issues/331

/kind documentation

```release-note
None
```
This commit is contained in:
Ryan Wang
2024-10-29 16:16:12 +08:00
committed by GitHub
parent 4b9a671204
commit 9058e60b44
19 changed files with 390 additions and 0 deletions

64
docs/user-guide/menus.md Normal file
View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -84,6 +84,7 @@ module.exports = {
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",

Binary file not shown.

After

Width:  |  Height:  |  Size: 134 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 131 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 129 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 129 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 780 KiB

View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -0,0 +1,64 @@
---
title: 菜单
description: 菜单管理相关功能说明
---
菜单功能用于管理网站上的导航菜单,目前 Halo 支持配置多个菜单组。
![Menus](/img/user-guide/menus/menus.png)
说明:
1. 左边为菜单列表,右边为所选菜单的菜单项列表。
2. 点击左边的菜单可以切换菜单项列表。
## 创建菜单
点击左边菜单列表底部的 **新建** 可以打开新建菜单的对话框,输入名称即可创建。
![Create menu](/img/user-guide/menus/create-menu.png)
![Menu operation](/img/user-guide/menus/menu-operation.png)
点击菜单条目的操作按钮可以展开操作选项,包括:
1. **设置为主菜单**:设置当前菜单为主菜单,主菜单会在网站导航栏中显示(具体需要以主题的实现为准)。
2. **编辑**:编辑当前菜单的名称。
3. **删除**:删除当前菜单,会同时删除菜单下的所有菜单项。
## 创建菜单项
点击菜单项列表右上角的 **新建** 可以打开新建菜单的对话框。
![Create menu item](/img/user-guide/menus/create-menu-item.png)
表单项说明:
1. **上级菜单项**:可以选择当前新建的菜单项归属的上级菜单项。
2. **类型**
1. 自定义链接:可以输入任意的名称和链接地址,可以是外部的网址。
2. 文章:可以选择网站上已有的文章。
3. 自定义页面:可以选择网站上已有的页面。
4. 分类:可以选择网站上已有的分类。
5. 标签:可以选择网站上已有的标签。
3. **名称**:当类型为自定义链接时,可以输入任意的名称,当类型为文章、自定义页面、分类、标签时,会自动生成名称。
4. **链接地址**:当类型为自定义链接时,可以输入任意的链接地址,当类型为文章、自定义页面、分类、标签时,会自动生成链接地址。
5. **打开方式**:链接的打开方式。
![Create menu item 2](/img/user-guide/menus/create-menu-item-2.png)
上图是类型选择 **分类** 时的表单,可以选择分类。
![Menu item operation](/img/user-guide/menus/menu-item-operation.png)
点击菜单项条目的操作按钮可以展开操作选项,包括:
1. **编辑**:编辑当前菜单项的信息。
2. **新增子菜单项**:新增当前菜单项的子菜单项。
3. **删除**:删除当前菜单项,如果当前菜单项包含子菜单项,会同时删除。
## 排序
你可以按住菜单项前的图标,通过拖拽来调整菜单项间的层级关系和顺序。
![Sort](/img/user-guide/menus/sort.gif)

View File

@@ -63,6 +63,7 @@
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",

View File

@@ -64,6 +64,7 @@
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",

View File

@@ -64,6 +64,7 @@
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",

View File

@@ -65,6 +65,7 @@
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",

View File

@@ -66,6 +66,7 @@
"user-guide/posts",
"user-guide/pages",
"user-guide/attachments",
"user-guide/menus",
"user-guide/themes",
"user-guide/plugins",
"user-guide/app-store",