Hugo Terminal主题菜单项显示与排序优化指南

Hugo Terminal主题作为一款简洁高效的静态网站生成器主题，其菜单系统的配置方式值得开发者关注。本文将详细介绍如何调整菜单项的显示数量和排序方式，帮助用户打造更符合需求的导航体验。

菜单项显示数量配置

默认情况下，Hugo Terminal主题在桌面视图中只会显示前两个菜单项，其余项目会被折叠到"显示更多"的下拉菜单中。这一设计虽然保持了界面简洁，但可能不符合所有用户的需求。

要修改这一行为，开发者需要在项目配置文件(hugo.toml)中调整参数。具体操作是在[[params]]部分添加或修改showMenuItems参数值。例如，若希望显示5个菜单项后再折叠，可设置为：

[params]
  showMenuItems = 5

值得注意的是，在移动端视图中，主题会自动将所有菜单项折叠为一个下拉菜单，标签显示为"Menu"，这一行为是响应式设计的体现，无法单独配置。

菜单项排序控制

Hugo Terminal主题默认会按照字母顺序排列菜单项，这可能导致重要的导航链接（如首页）无法处于理想位置。Hugo框架提供了weight参数来解决这一问题。

weight参数采用"轻者上浮，重者下沉"的逻辑：

• 数值越小，优先级越高，位置越靠前
• 数值越大，优先级越低，位置越靠后

例如，要使"首页"始终显示在第一位：

---
title: 首页
weight: 10
---

其他页面可以依次设置更高的weight值：

---
title: 关于
weight: 20
---

---
title: 博客
weight: 30
---

这种排序方式不仅影响菜单显示顺序，也会影响Hugo生成的其他列表页面，如分类列表、标签列表等。

最佳实践建议

1. 保持一致性：为所有页面设置weight值，避免部分页面使用默认排序
2. 预留间隔：设置weight值时建议以10为间隔，方便后续插入新页面
3. 响应式考虑：虽然可以增加显示菜单项数量，但建议保持适度，确保移动端体验
4. 语义化命名：配合合理的weight值，使用有意义的页面标题

通过合理配置这些参数，开发者可以轻松打造既美观又实用的网站导航系统，提升用户体验的同时保持代码的可维护性。