文档插件的用户“/reference”而不是“/docs”

问题描述

是否可以使用 http://localhost:3000/reference/ 或任何其他路径代替 http://localhost:3000/docs/ 来指向文档 *.md 结构？

我在 preset-classic 中配置了 docusaurus.config.js，如下所示：

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',{
        docs: {
          path: 'reference/',sidebarPath: require.resolve('./reference/sidebars.js')
        },theme: {
          customCss: require.resolve('./src/css/custom.css'),},],};

但我明白了：

test.md 1:2
Module parse Failed: Assigning to rvalue (1:2)
You may need an appropriate loader to handle this file type,currently no loaders are configured to process this file. See https://webpack.js.org/concepts#loaders
> ---
| id: test
| title: Test
 @ ./.docusaurus/registry.js 1:2593-2646 1:2459-2559
...

我正在使用 Docusaurus V2，它目前支持吗？

解决方法

是的，这是可能的。

您的错误可能是 / 中的 path: 'reference/',。

注意：当您更改 docusaurus.config.js 时，您需要终止 docusaurus 进程并重新启动，它不能很好地重新加载 --- 至少对我来说不是。

[...]
presets: [
    [
      '@docusaurus/preset-classic',{
        docs: {
          routeBasePath: 'reference',path: 'reference',sidebarPath: require.resolve('./reference/sidebars.js'),lastVersion: 'current',onlyIncludeVersions: ['current'],},theme: {
          customCss: require.resolve('./src/css/custom.css'),],[...]

您可能需要更改 navbar。

[...]
navbar: {
  [...]
  items: [
    {
      to: '/reference',label: 'Reference',position: 'left',activeBaseRegex: `/reference/`,[...]