Fumadocs项目中导航链接配置的注意事项

在Fumadocs项目中，开发者可能会遇到导航链接配置方面的困惑。本文将详细介绍导航链接配置的正确方式，帮助开发者避免常见误区。

导航链接配置的演变

Fumadocs项目早期版本中，LinkItemType接口提供了一个on属性，用于控制链接显示的位置（导航栏或菜单）。然而，随着项目的发展，这一设计已被废弃，转而采用更清晰的布局分离方案。

当前推荐做法

现在Fumadocs推荐开发者分别为不同的布局组件传递不同的链接配置：

1. 文档布局(DocsLayout)：专门用于文档页面的导航配置
2. 首页布局(HomeLayout)：用于网站首页的导航配置

这种分离式的配置方式相比之前的on属性更加清晰和易于维护，开发者可以明确地为不同场景定义不同的导航结构。

废弃属性的行为

虽然on属性在技术上仍然能在HomeLayout中工作，但不建议继续使用。在DocsLayout中，该属性已经完全失效。开发者应当尽快迁移到新的配置方式。

迁移建议

对于需要在不同布局中显示不同链接的场景，建议：

1. 创建独立的链接配置对象
2. 根据布局类型传递相应的配置
3. 避免使用废弃的on属性

这种改进后的配置方式不仅解决了原有属性的不一致问题，还提供了更好的类型安全和代码可读性。开发者可以更精确地控制不同页面布局的导航结构，提升项目的可维护性。