refactor(plugin-markdown-preview): improve documentation and localization comments

Author: Mister-Hope

docs/plugins/markdown/markdown-preview.md

@@ -97,9 +97,7 @@ document.querySelector('body').innerText = 'Hello world!'
   }
   ```
 
-- Details:
-
-  Locales configuration for `<VPPreview>`.
+- Details: Locales configuration for `<VPPreview>`.
 
 ## Styles
 

docs/zh/plugins/markdown/markdown-preview.md

@@ -49,7 +49,7 @@ export default {
 ````md
 <VPPreview title="可选标题">
   <template #content>
-    <!-- 你的内容在这里  -->
+    <!-- 你的内容在这里 -->
 
     Hello world!
 
@@ -67,7 +67,7 @@ document.querySelector('body').innerText = 'Hello world!'
 
 <VPPreview title="可选标题">
   <template #content>
-    <!-- 你的内容在这里  -->
+    <!-- 你的内容在这里 -->
 
     Hello world!
 
@@ -91,15 +91,15 @@ document.querySelector('body').innerText = 'Hello world!'
   ```ts
   export interface MarkdownPreviewLocaleData {
     /**
-     * 切换代码按钮文本
+     * Toggle code button text
+     *
+     * 切换代码按钮文字
      */
     toggle: string
   }
   ```
 
-- 详细信息:
-
-  `<VPPreview>` 的多语言配置。
+- 详情：`<VPPreview>` 的本地化配置。
 
 ## 样式
 

plugins/markdown/plugin-markdown-preview/src/node/index.ts

@@ -1,2 +1,3 @@
 export * from './markdownPreviewPlugin.js'
+export type * from './options.js'
 export * from './preview.js'

plugins/markdown/plugin-markdown-preview/src/node/markdownPreviewPlugin.ts

@@ -10,6 +10,24 @@ const PLUGIN_NAME = '@vuepress/plugin-markdown-preview'
 
 const __dirname = getDirname(import.meta.url)
 
+/**
+ * Markdown preview plugin
+ *
+ * Markdown 预览插件
+ *
+ * @param options - plugin options / 插件选项
+ *
+ * @example
+ * ```ts
+ * import { markdownPreviewPlugin } from '@vuepress/plugin-markdown-preview'
+ *
+ * export default {
+ *   plugins: [
+ *     markdownPreviewPlugin(),
+ *   ],
+ * }
+ * ```
+ */
 export const markdownPreviewPlugin =
   (options: MarkdownPreviewPluginOptions = {}): Plugin =>
   (app) => ({

plugins/markdown/plugin-markdown-preview/src/node/options.ts

@@ -3,9 +3,9 @@ import type { MarkdownPreviewPluginLocaleData } from '../shared/index.js'
 
 export interface MarkdownPreviewPluginOptions {
   /**
-   * Localization config
+   * Localization config for preview component
    *
-   * 本地化配置
+   * 预览组件的本地化配置
    */
   locales?: LocaleConfig<MarkdownPreviewPluginLocaleData>
 }

plugins/markdown/plugin-markdown-preview/src/shared/locales.ts

@@ -2,7 +2,9 @@ import type { ExactLocaleConfig } from '@vuepress/helper'
 
 export interface MarkdownPreviewPluginLocaleData {
   /**
-   * toggle code button text
+   * Toggle code button text
+   *
+   * 切换代码按钮文字
    */
   toggle: string
 }