fix(cli): allow passing a list of file names to write-heading-ids (#6500)

This commit is contained in:
Joshua Chen 2022-01-29 12:21:15 +08:00 committed by GitHub
parent 9af7aae9e2
commit c1e3801ee7
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
28 changed files with 74 additions and 74 deletions

View file

@ -362,7 +362,7 @@ The position metadata is only used **within a sidebar slice**: Docusaurus does n
:::
## Using number prefixes
## Using number prefixes {#using-number-prefixes}
A simple way to order an autogenerated sidebar is to prefix docs and folders by number prefixes, which also makes them appear in the file system in the same order when sorted by file name:
@ -398,7 +398,7 @@ Updating a number prefix can be annoying, as it can require **updating multiple
:::
## Customize the sidebar items generator
## Customize the sidebar items generator {#customize-the-sidebar-items-generator}
You can provide a custom `sidebarItemsGenerator` function in the docs plugin (or preset) config:

View file

@ -117,7 +117,7 @@ type SidebarsFile = {
};
```
## Theme configuration
## Theme configuration {#theme-configuration}
### Hideable sidebar {#hideable-sidebar}
@ -133,7 +133,7 @@ module.exports = {
};
```
### Auto-collapse sidebar categories
### Auto-collapse sidebar categories {#auto-collapse-sidebar-categories}
The `themeConfig.autoCollapseSidebarCategories` option would collapse all sibling categories when expanding one category. This saves the user from having too many categories open and helps them focus on the selected section.

View file

@ -223,7 +223,7 @@ Use `generated-index` links as a quick way to get an introductory document.
:::
#### Embedding generated index in doc page
#### Embedding generated index in doc page {#embedding-generated-index-in-doc-page}
You can embed the generated cards list in a normal doc page as well, as long as the doc is used as a category index page. To do so, you need to use the `DocCardList` component, paired with the `useCurrentSidebarCategory` hook.

View file

@ -21,7 +21,7 @@ Most of the time, you don't need versioning as it will just increase your build
To better understand how versioning works and see if it suits your needs, you can read on below.
## Overview
## Overview {#overview}
A typical versioned doc site looks like below:
@ -67,7 +67,7 @@ By default, the `current` docs version is labeled as `Next` and hosted under `/d
:::
### Terminology
### Terminology {#terminology}
Note the terminology we use here.
@ -80,7 +80,7 @@ Note the terminology we use here.
Current version is defined by the **file system location**, while latest version is defined by the **the navigation behavior**. They may or may not be the same version! (And the default configuration, as shown in the table above, would treat them as different: current version at `/docs/next` and latest at `/docs`.)
## Tutorials
## Tutorials {#tutorials}
### Tagging a new version {#tagging-a-new-version}
@ -157,7 +157,7 @@ Example:
2. Delete the versioned docs directory. Example: `versioned_docs/version-1.8.0`.
3. Delete the versioned sidebars file. Example: `versioned_sidebars/version-1.8.0-sidebars.json`.
## Configuring versioning behavior
## Configuring versioning behavior {#configuring-versioning-behavior}
The "current" version is the version name for the `./docs` folder. There are different ways to manage versioning, but two very common patterns are:
@ -207,7 +207,7 @@ We offer these plugin options to customize versioning behavior:
See [docs plugin configuration](../../api/plugins/plugin-content-docs.md#configuration) for more details.
## Navbar items
## Navbar items {#navbar-items}
We offer several navbar items to help you quickly set up navigation without worrying about versioned routes.
@ -249,7 +249,7 @@ Don't use relative paths import within the docs. Because when we cut a version t
+ import Foo from '@site/src/components/Foo';
```
### Link docs by file paths
### Link docs by file paths {#link-docs-by-file-paths}
Refer to other docs by relative file paths with the `.md` extension, so that Docusaurus can rewrite them to actual URL paths during building. Files will be linked to the correct corresponding version.