docs: updates

Author: kazupon

.gitignore

@@ -1,5 +1,5 @@
 dist
-docs/api/vue-i18**
+docs/api/
 types
 temp
 coverage

README.md

@@ -54,14 +54,14 @@ If you use stable Vue I18n version, see this [repository](https://github.com/kaz
 
 New style API for Vue Composition API. See the following docs:
 
-- [createI18n](https://vue-i18n-next.intlify.dev/api/vue-i18n-function.html#createi18n)
-  - [I18nOptions](https://vue-i18n-next.intlify.dev/api/vue-i18n-typealias.html#i18noptions)
-  - [ComposerOptions](https://vue-i18n-next.intlify.dev/api/vue-i18n-interface.html#composeroptions)
-  - [VueI18nOptions](https://vue-i18n-next.intlify.dev/api/vue-i18n-interface.html#vuei18noptions)
-- [useI18n](https://vue-i18n-next.intlify.dev/api/vue-i18n-function.html#usei18n)
-  - [ComposerOptions](https://vue-i18n-next.intlify.dev/api/vue-i18n-interface.html#composeroptions)
-- [Composer](https://vue-i18n-next.intlify.dev/api/vue-i18n-interface.html#composer)
-- [VueI18n](https://vue-i18n-next.intlify.dev/api/vue-i18n-interface.html#vuei18n)
+- [createI18n](https://vue-i18n-next.intlify.dev/api/general.html#createi18n)
+  - [I18nOptions](https://vue-i18n-next.intlify.dev/api/general.html#i18noptions)
+  - [ComposerOptions](https://vue-i18n-next.intlify.dev/api/composition.html#composeroptions)
+  - [VueI18nOptions](https://vue-i18n-next.intlify.dev/api/legacy.html#vuei18noptions)
+- [useI18n](https://vue-i18n-next.intlify.dev/api/compositiono.html#usei18n)
+  - [ComposerOptions](https://vue-i18n-next.intlify.dev/api/compositino.html#composeroptions)
+- [Composer](https://vue-i18n-next.intlify.dev/api/composition.html#composer)
+- [VueI18n](https://vue-i18n-next.intlify.dev/api/legacy.html#vuei18n)
 
 ### `<i18n-t>` Component (formerly called `<i18n>` component)
 

docs/.vitepress/config.js

@@ -1,6 +1,3 @@
-const { readdirSync } = require('fs')
-const { resolve, basename } = require('path')
-
 /** @typedef {import('vitepress').UserConfig} UserConfig */
 
 /** @type {UserConfig['head']} */
@@ -36,8 +33,7 @@ const config = {
           },
           {
             text: 'API Reference',
-            link: '/api/'
-            //link: '/api/vue-i18n-general'
+            link: '/api/general'
           },
           {
             text: 'Chnagelog',
@@ -145,44 +141,24 @@ const config = {
               link: '/v8-docs',
             },
           ],
-          '/api/': getSidebarApi('vue-i18n'),
-          // '/api/': [
-          //   {
-          //     text: 'General',
-          //     link: '/api/vue-i18n-general'
-          //   },
-          //   {
-          //     text: 'Legacy API',
-          //     link: '/api/vue-i18n-legacy'
-          //   },
-          //   {
-          //     text: 'Composition API',
-          //     link: '/api/vue-i18n-composition'
-          //   }
-          // ]
+          '/api/': [
+            {
+              text: 'General',
+              link: '/api/general'
+            },
+            {
+              text: 'Legacy API',
+              link: '/api/legacy'
+            },
+            {
+              text: 'Composition API',
+              link: '/api/composition'
+            }
+          ]
         }
       }
     }
   }
 }
 
-function getSidebarApi(target) {
-  const API_TITLE_MAPS = {
-    function: 'Functions',
-    interface: 'Interfaces',
-    typealias: 'Type Aliases',
-    variable: 'Variables',
-    class: 'Classes'
-  }
-  return readdirSync(resolve(__dirname, '../api'))
-    .map(file => basename(file, '.md'))
-    .filter(file => file.includes(target))
-    .map(file => {
-      return {
-        text: API_TITLE_MAPS[file.split('-').pop()],
-        link: `/api/${file}`
-      }
-    })
-}
-
 module.exports = config

docs/api/index.md

@@ -0,0 +1,7 @@
+const linkReferencer = require('./scripts/api/resolver')
+const processor = require('./scripts/api/processor')
+
+module.exports = {
+  linkReferencer,
+  processor
+}

docsgen.config.js

@@ -152,8 +152,7 @@
     "clean:type": "rm -rf ./types/** ./temp ./dist/vue-i18n.d.ts",
     "coverage": "opener coverage/lcov-report/index.html",
     "dev:e2e": "jest --runInBand --config ./jest.e2e.config.js",
-    "docs:apigen": "api-docs-gen ./temp/vue-i18n.api.json -o ./docs/api",
-    "docs:apigen1": "api-docs-gen ./temp/vue-i18n.api.json -o ./docs/api -c ./scripts/docsgen.config.js --tsdoc-config ./tsdoc.json",
+    "docs:apigen": "api-docs-gen ./temp/vue-i18n.api.json -o ./docs/api -c ./docsgen.config.js -g noprefix -t ./tsdoc.json",
     "docs:build": "yarn docs:setup && vitepress build docs",
     "docs:dev": "vitepress dev docs",
     "docs:serve": "vitepress serve docs",