Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add menu management documentation #453

Merged
merged 1 commit into from
Oct 29, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 64 additions & 0 deletions docs/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/user-guide/menus/create-menu-item.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/user-guide/menus/create-menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/user-guide/menus/menu-operation.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/user-guide/menus/menus.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/user-guide/menus/sort.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 64 additions & 0 deletions versioned_docs/version-2.16/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
64 changes: 64 additions & 0 deletions versioned_docs/version-2.17/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
64 changes: 64 additions & 0 deletions versioned_docs/version-2.18/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
64 changes: 64 additions & 0 deletions versioned_docs/version-2.19/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
64 changes: 64 additions & 0 deletions versioned_docs/version-2.20/user-guide/menus.md
Original file line number Diff line number Diff line change
@@ -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)
Loading