Docusaurusの構築フロー

npx create-docusaurus@latest documents classic

Ok to proceed? (y) 

documents
npm start

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/[ユーザ名]/documents.git
git push -u origin main

themeConfig:
  ・・・中略・・・
          {
   -         href: 'https://github.com/facebook/docusaurus',
   +       href: 'https://github.com/facebook/docusaurus',
            label: 'GitHub',
            position: 'right',
          },
        ],
      },

 footer: {
        style: 'dark',
        links: [
          {

 presets: [
    [
      'classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          sidebarPath: require.resolve('./sidebars.js'),
          // Please change this to your repo.
          editUrl: 
 -           'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
 +           'https://github.com//[ユーザ名]/documents/edit/main/',
        },
        blog: {
          showReadingTime: true,
          // Please change this to your repo.
          editUrl:
-            'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
+            'https://github.com//[ユーザ名]/documents/edit/main/',
        },

npm run docusaurus docs:version 1.0

module.exports = {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'docsVersionDropdown',
        },
      ],
    },
  },
};

追加された。
![](https://storage.googleapis.com/zenn-user-upload/4facbe46f393-20220418.png)

### ドキュメントアップデートについて
- `versioned_docs/version-1.0/hello.md` が更新されると、 `http://localhost:3000/docs/hello` に反映される
- `docs/hello.md` が更新されると、 `http://localhost:3000/docs/next/hello` に反映される。

module.exports = {
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'ja'],
  },
};

npm run start -- --locale ja

[INFO] Starting the development server...
[ERROR] Error: "baseUrl" is required
"title" is required

const config = {
・・・中略
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'ja'],
  },
・・・中略
},

npm run start -- --locale ja

module.exports = {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'localeDropdown',
        },
      ],
    },
  },
};

---
sidebar_position: 1
title: Tutorial Intro
description: A short description of this page
keywords: [keywords, describing, the main topics]
---

const config = {
-   title: 'My Site',  
+   title: 'My documents',
   tagline: 'Dinosaurs are cool',
-   url: 'https://your-docusaurus-test-site.com',
+   url: 'https://my-documents.netlify.app/',
  baseUrl: '/',
  onBrokenLinks: 'throw',
  onBrokenMarkdownLinks: 'warn',
  favicon: 'img/favicon.ico',
-   organizationName: 'facebook', // Usually your GitHub org/user name.
+   organizationName: 'KoushiKagawa', // Usually your GitHub org/user name.
-   projectName: 'docusaurus', // Usually your repo name.
+   projectName: 'documents', // Usually your repo name.

{
            type: 'docsVersionDropdown',
            position: 'right',
          },

npm run write-translations -- --locale ja

[INFO] 56 translations will be written at i18n/ja/code.json.
[INFO] 4 translations will be written at i18n/ja/docusaurus-theme-classic/navbar.json.
[INFO] 9 translations will be written at i18n/ja/docusaurus-theme-classic/footer.json.
[INFO] 3 translations will be written at i18n/ja/docusaurus-plugin-content-blog/options.json.
[INFO] 3 translations will be written at i18n/ja/docusaurus-plugin-content-docs/current.json.

npm run start -- --locale ja

Koshi:
  name: Koshi Kagawa
  title: PM
  url: https://github.com/koushikagawa
  image_url: https://avatars.githubusercontent.com/u/19630409?v=4

---
slug: first-blog-post
title: First Blog Post
authors: Koshi
tags: [docusaurus]
---

I used docusaurus.

It is useful because it is simple and lacks markdown.

How to get started is summarized in [zenn](https://zenn.dev/koushikagawa/scraps/6f38fbc8a2b3ee).

**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.

presets: [
    [
      'classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          routeBasePath: '/', // <-追記
          sidebarPath: require.resolve('./sidebars.js'),
         

slug: /