FacebookDocusaurus中⽂⽂档导航和侧边栏
此系列⽂章的应⽤⽰例已发布于 . 可以 Fork 帮助改进或 Star 关注更新. 欢迎 Star.
导航和侧边栏
引⽤⽹站⽂档
如果你想在 docs ⽂件夹中引⽤另⼀个⽂档（或者你通过可选 customDocsPath路径站点配置选项设置的位置），那么你只需要使⽤你想引⽤的⽂档名称。
例如，如果你在 doc2.md 中，⽽你想引⽤ doc1.md：
这⾥引⽤了⼀个 [⽂档](doc1.md).
Docusaurus ⽬前不⽀持嵌套⽂件夹中的⽂件; 只能是在⼀个平⾯⽂件结构中。 我们正在考虑添加对嵌套⽂件夹的⽀持。
⽂档如何链接
docs 中的新 markdown ⽂件将在⽹站上显⽰为页⾯。 这些⽂档的链接⾸先通过在每个⽂档的头部使⽤ i
d 来创建。 如果没有 id 字段，那么⽂件的名称将作为链接名称。
例如，创建诸如 "docs/getting-started.md" 之类的空⽂件将使新页⾯ URL 成为 /docs/getting-started.html。
假设您将其添加到您的⽂档中：
---
id: intro
title: ⼊门
---
这是⽂档的 *新内容*...
如果您在⽂件的标记标题中设置了 id 字段，那么⽂档将从 /docs/intro.html 形式的 URL 访问。
您需要⼀个 id 字段才能将⽂档添加到侧边栏。
添加⽂档到侧边栏
很多时候，您将需要添加⼀个⽂档到侧边栏，这个侧边栏将与⽹站顶部导航栏中的⼀个标题相关联。 最常见的补充⼯具栏，以及在Docusaurus 初始化时安装的⼯具栏是 docs ⼯具栏。
"docs" 只是⼀个名字。 它没有继承的意义。 你可以随意更改。
您可以在 website/sidebars.json ⽂件中配置侧边栏的内容以及⽂档的顺序。
在将⽂档添加到 website/sidebars.json 之前，只能通过直接的URL访问它们。 该⽂档不会显⽰在任何侧边栏。
在 sidebars.json 中，将在⽂档头中使⽤的 id 添加到现有的侧边栏/类别中。 在下⾯的情况下，docs 是侧边栏的名称，Getting Started 是侧边栏中的⼀个类别。
{
"docs": {
"Getting Started": [
"getting-started"
或者你可以在侧边栏中创建⼀个新的类别：
{
js导航栏下拉菜单
"docs": {
...
"My New Sidebar Category": [
"getting-started"
],
...
添加新侧边栏
您也可以将⽂档放在新的侧边栏中。 在下⾯的例⼦中，我们在 sidebars.json ⾥⾯创建⼀个名为 My Example Category 的类别为 examples-sidebar 的⼯具栏，⾥⾯包含⼀个 id 为 my-examples 的⽂档。
{
"examples-sidebar": {
"My Example Category": [
"my-examples"
],
},
...
重要的是要注意，直到你，它将会被隐藏。
添加到⽹站导航栏
要展开侧边栏，您需要将可点击的标签添加到⽹站顶部的⽹站导航栏中。 您可以添加⽂档，页⾯和外部链接。
添加⽂档
通过将其到 sidebars.json，为该⽹站创建⼀个新的侧边栏后，您可以通过编辑 siteConfig.js 的 headerLinks 字段来从顶部导航栏中展开新的侧边栏。
headerLinks: [
...
{ doc: 'my-examples', label: 'Examples' },
...
],
⼀个名为 Examples 的标签将被添加到⽹站导航栏中，当您在⽹站顶部点击它时，将会显⽰ examples-sidebar，默认⽂档将是 my-examples。
添加⾃定义页⾯
要将⾃定义页⾯添加到⽹站导航栏，可将条⽬添加到 siteConfig.js 的 headerLinks 中。 例如，如果我们在 website/pages/help.js 中有⼀个页⾯，我们可以通过添加以下内容来链接到它：
headerLinks: [
...
{ page: 'help', label: 'Help' },
...
],
⼀个名为 Help 的标签将被添加到站点导航栏中，当您在站点顶部点击它时，将显⽰ help.js 页⾯的内容。
添加外部链接
⾃定义链接可以通过 siteConfig.js 中的以下条⽬添加到⽹站导航栏中：
headerLinks: [
...
{ href: 'github/facebook/Docusaurus', label: 'GitHub' },
...
],
⼀个名为 GitHub 的标签将被添加到站点导航栏中，当您在站点顶部点击它时，外部链接的内容将被显⽰。
要在新选项卡中打开外部链接，请在标题链接配置中提供⼀个 external: true 标志。
⽹站导航栏定位
在⽹站顶部的⽹站导航栏中显⽰搜索和语⾔下拉列表元素时，您的控制权限有限。
搜索
如果在您的⽹站上启⽤搜索，您的搜索栏将显⽰在您的链接的右侧。 如果您想要在搜索栏中的链接之间添加⼀个搜索条⽬，在 headerLinks 配置数组中：
headerLinks: [
{ doc: 'foo', label: 'Foo' },
{ search: true },
{ doc: 'bar', label: 'Bar' },
],
语⾔下拉菜单
如果在您的⽹站上启⽤了翻译，则语⾔下拉菜单将显⽰在您的链接的右侧（如果启⽤搜索，则会显⽰在搜索栏的左侧）。 如果要将语⾔选择放在标题中的链接之间，请在 headerLinks 配置数组中添加⼀个语⾔条⽬：
headerLinks: [
{ doc: 'foo', label: 'Foo' },
{ languages: true },
{ doc: 'bar', label: 'Bar' },
],
如果这篇⽂章对您有帮助, 感谢 下⽅点赞 或 Star ⽀持, 谢谢.