Zenn
Open5

DocusaurusでDocsを作る

React
Markdown
Docusaurus
Yuta KobayashiYuta Kobayashi

サイトの作成

npx @docusaurus/init@latest init my-website classic

開発サーバーを起動

cd my-website
npx docusaurus start
Yuta KobayashiYuta Kobayashi

DocusaurusのDocsをトップページにする

これは公式ではDocs-only modeと呼ばれてる。

docusaurus.config.jsにpresets内のdocsにrouteBasePath: '/',を追加

docusaurus.config.js
 presets: [
    [
      '@docusaurus/preset-classic',
      {
        docs: {
          routeBasePath: '/', // 追加
          sidebarPath: require.resolve('./sidebars.js'),
          // Please change this to your repo.
          editUrl:
            'https://github.com/facebook/docusaurus/edit/master/website/',
      },
    ],
  ],

srcのpages内にあるindex.jsを削除してこれだけだとPage Not Found
になるのでトップページにしたいdocsのMarkdownファイルにslug: /を追加

home.md
---
sidebar_position: 1
slug: /
---
Yuta KobayashiYuta Kobayashi

ブログを削除

blogディレクトリを削除するだけでOKだった。
なぜかエラー出たけど再起動したら解決