docs: 修复中英文标点符号

Author: yue1123

docs/.vitepress/config.mts

@@ -25,8 +25,8 @@ export default withPwa(
       returnToTopLabel: 'top',
       logo: '/logo.svg',
       nav,
-      outlineTitle: 'ON THIS PAGE',
-      outline: [1, 5],
+      outlineTitle: '目录',
+      outline: [2, 5],
       search: {
         provider: 'local'
         // provider: 'algolia',

docs/package.json

@@ -5,7 +5,8 @@
     "build": "prettier -w ./zh-CN/* && vitepress build .",
     "preview": "vitepress preview .",
     "fix-dot": "fixdot ./zh-CN/base/* ./zh-CN/control/* ./zh-CN/guide/* ./zh-CN/overlay/* ./index.md -d -p",
-    "format": "prettier -w ./zh-CN/*"
+    "format": "prettier -w ./zh-CN/*",
+    "lint:zh": "pnpm zhlint '**/*.md' --fix"
   },
   "devDependencies": {
     "@vite-pwa/vitepress": "^0.3.1",
@@ -17,7 +18,8 @@
     "prismjs": "^1.29.0",
     "vanilla-tilt": "^1.8.0",
     "vite-plugin-pwa": "^0.17.2",
-    "vue3-baidu-map-gl": "workspace:*"
+    "vue3-baidu-map-gl": "workspace:*",
+    "zhlint": "^0.8.2"
   },
   "engines": {
     "node": ">=18.0.0"

docs/sponsor.md

@@ -9,7 +9,7 @@
 
 ## 如何赞助
 
-您可以通过微信或者支付宝扫描下面二维码进行赞助，我们会在下面展示您的昵称信息（如果您介意展示，也可在留言中说明）。
+您可以通过微信或者支付宝扫描下面二维码进行赞助，我们会在下面展示您的昵称信息 (如果您介意展示，也可在留言中说明)。
 
 非常感谢您的支持。
 

docs/zh-CN/components/control/panorama-control.md

@@ -7,12 +7,12 @@ import { BPanoramaControl } from 'vue3-baidu-map-gl'
 ```
 
 :::tip
-全景地图服务属于百度地图高级服务，需要向 [百度地图申请](https://lbs.baidu.com/apiconsole/fankui#?typeOne=%E4%BA%A7%E5%93%81%E9%9C%80%E6%B1%82&typeTwo=%E9%AB%98%E7%BA%A7%E6%9C%8D%E5%8A%A1&typeThree=JS%20API%E5%85%A8%E6%99%AF%E5%9B%BE) 才可以使用
+全景地图服务属于百度地图高级服务，需要向[百度地图申请](https://lbs.baidu.com/apiconsole/fankui#?typeOne=%E4%BA%A7%E5%93%81%E9%9C%80%E6%B1%82&typeTwo=%E9%AB%98%E7%BA%A7%E6%9C%8D%E5%8A%A1&typeThree=JS%20API%E5%85%A8%E6%99%AF%E5%9B%BE)才可以使用
 :::
 
 ## 组件示例
 
-单独使用该组件不会显示全景地图覆盖情况，还需要搭配`BPanoramaCoverageLayer`组件使用。
+单独使用该组件不会显示全景地图覆盖情况，还需要搭配 `BPanoramaCoverageLayer` 组件使用。
 
 :::demo
 control/panoramaControl

docs/zh-CN/components/layer/panorama-coverage.md

@@ -7,12 +7,12 @@ import { BPanoramaCoverageLayer } from 'vue3-baidu-map-gl'
 ```
 
 :::tip 提示
-全景地图服务属于百度地图高级服务，需要向 [百度地图申请](https://lbs.baidu.com/apiconsole/fankui#?typeOne=%E4%BA%A7%E5%93%81%E9%9C%80%E6%B1%82&typeTwo=%E9%AB%98%E7%BA%A7%E6%9C%8D%E5%8A%A1&typeThree=JS%20API%E5%85%A8%E6%99%AF%E5%9B%BE) 才可以使用
+全景地图服务属于百度地图高级服务，需要向[百度地图申请](https://lbs.baidu.com/apiconsole/fankui#?typeOne=%E4%BA%A7%E5%93%81%E9%9C%80%E6%B1%82&typeTwo=%E9%AB%98%E7%BA%A7%E6%9C%8D%E5%8A%A1&typeThree=JS%20API%E5%85%A8%E6%99%AF%E5%9B%BE)才可以使用
 :::
 
 ## 组件示例
 
-单独使用该组件无法查看全景地图，还需要搭配`BPanoramaControl`组件使用。
+单独使用该组件无法查看全景地图，还需要搭配 `BPanoramaControl` 组件使用。
 
 :::demo 显示全景图层
 layer/panoramaCoverage

docs/zh-CN/components/map.md

@@ -24,17 +24,17 @@ map/multiInstance
 
 ## 个性化地图
 
-通过指定 `Map` 组件的 `mapStyleId`或者`mapStyleJson`来展示个性化地图，如果同时指定，`mapStyleId`会优先生效。
+通过指定 `Map` 组件的 `mapStyleId` 或者 `mapStyleJson` 来展示个性化地图，如果同时指定，`mapStyleId` 会优先生效。
 
 ::: tip 提示
 
-1. 如果个性化地图没有生效，请先检查`mapStyleId`或`mapStyleJson`是否正确。如果是通过`mapStyleId`实现，还需要检查是否与 `ak`申请的账号一致
-2. 以下示例使用的 `mapStyleId` 均与 ak 和 域名绑定，无法直接复制使用。可根据示例主题名字到[百度地图个性化编辑器](https://lbsyun.baidu.com/apiconsole/custommap)创建后使用
+1. 如果个性化地图没有生效，请先检查 `mapStyleId` 或 `mapStyleJson` 是否正确。如果是通过 `mapStyleId` 实现，还需要检查是否与 `ak` 申请的账号一致
+2. 以下示例使用的 `mapStyleId` 均与 ak 和域名绑定，无法直接复制使用。可根据示例主题名字到[百度地图个性化编辑器](https://lbsyun.baidu.com/apiconsole/custommap)创建后使用
    :::
 
 ### 获取资源
 
-> mapStyleId 和 mapStyleJson 获取以及相关注意事项，请访问 [百度地图个性化地图相关文档](https://lbsyun.baidu.com/index.php?title=jspopularGL/guide/custom#service-page-anchor3) 知悉
+> mapStyleId 和 mapStyleJson 获取以及相关注意事项，请访问[百度地图个性化地图相关文档](https://lbsyun.baidu.com/index.php?title=jspopularGL/guide/custom#service-page-anchor3)知悉
 
 ### 出行主题示例
 
@@ -50,7 +50,7 @@ map/theme2
 
 ## 自定义地图加载中
 
-默认情况下，地图加载中效果是`map loading...`文字居中。如果不能满足你的需求，你可以通过提供`loading`具名插槽来自定义地图加载中显示效果。
+默认情况下，地图加载中效果是 `map loading...` 文字居中。如果不能满足你的需求，你可以通过提供 `loading` 具名插槽来自定义地图加载中显示效果。
 
 :::details 显示代码
 
@@ -173,7 +173,7 @@ map/theme2
 | BMAP_SATELLITE_MAP | 普通卫星地图 |
 
 ::: warning 注意
-地球模式（BMAP_EARTH_MAP）下能支持的地图交互操作有限，如您需要卫星地图支持和标准地图（BMAP_NORMAL_MAP）一致的交互体验，请使用普通卫星图模式（BMAP_SATELLITE_MAP）
+地球模式 (BMAP_EARTH_MAP) 下能支持的地图交互操作有限，如您需要卫星地图支持和标准地图 (BMAP_NORMAL_MAP) 一致的交互体验，请使用普通卫星图模式 (BMAP_SATELLITE_MAP)
 :::
 
 ## displayOptions

docs/zh-CN/components/overlay/bezierCurve.md

@@ -7,7 +7,7 @@ import { BBezierCurve } from 'vue3-baidu-map-gl'
 ```
 
 ::: tip 提示
-不了解贝塞尔曲线的小伙伴可以先学习一下: https://zh-CN.javascript.info/bezier-curve
+不了解贝塞尔曲线的小伙伴可以先学习一下：https://zh-CN.javascript.info/bezier-curve
 :::
 
 ## 组件示例

docs/zh-CN/components/overlay/infowindow.md

@@ -7,7 +7,7 @@ import { BInfoWindow } from 'vue3-baidu-map-gl'
 ```
 
 ::: tip 提示
-地图上只能同时显示一个`infoWindow`，所以当地图上有多个`infoWindow`组件同时绑定`v-model="true"`，只有最后一个 `infoWindow`组件会在地图上显示。
+地图上只能同时显示一个 `infoWindow`，所以当地图上有多个 `infoWindow` 组件同时绑定 `v-model="true"`，只有最后一个 `infoWindow` 组件会在地图上显示。
 :::
 
 ## 组件示例

docs/zh-CN/components/overlay/mapMask.md

@@ -2,7 +2,7 @@
 
 控制地图元素的局部显示与隐藏
 
-- 局部显示：只展示指定区域的地图及地图元素（poi 标注、底图、楼块等），隐藏掉区域外的地图元素以突出重点。
+- 局部显示：只展示指定区域的地图及地图元素 (poi 标注、底图、楼块等)，隐藏掉区域外的地图元素以突出重点。
 - 局部隐藏：隐藏掉局部区域地图元素，比如隐藏掉指定园区范围的地图元素，然后自定义叠加园区模型。
 
 ```ts

docs/zh-CN/components/overlay/marker.md

@@ -14,7 +14,7 @@ overlay/marker
 
 ## 动态渲染
 
-有时候需要根据动态数据,渲染 marker,点击更新按钮查看效果.
+有时候需要根据动态数据，渲染 marker，点击更新按钮查看效果。
 :::demo class="p-bottom"
 overlay/dyynmicMaker
 :::
@@ -45,11 +45,11 @@ overlay/dyynmicMaker
 
 simple_red , simple_blue , loc_red , loc_blue , start , end , location
 
-红色图标: red1 , red2 , red3 , red4 , red5 , red6 , red7 , red8 , red9 , red10
+红色图标：red1，red2，red3，red4，red5，red6，red7，red8，red9，red10
 
-蓝色图标: blue1 , blue2 , blue3 , blue4 , blue5 , blue6 , blue7 , blue8 , blue9 , blue10
+蓝色图标：blue1，blue2，blue3，blue4，blue5，blue6，blue7，blue8，blue9，blue10
 
-其余图标可根据下图自行定位裁切:
+其余图标可根据下图自行定位裁切：
 
 ![https://mapopen.bj.bcebos.com/cms/react-bmap/markers_new2x_fbb9e99.png](https://mapopen.bj.bcebos.com/cms/react-bmap/markers_new2x_fbb9e99.png)
 

docs/zh-CN/expand/bmap-draw.md

@@ -2,7 +2,7 @@
 
 BMap Draw 是一个基于百度地图 JSAPI 的轻量级鼠标绘制库，提供了鼠标绘制、编辑、裁切、合并、复制黏贴、移动、测量等多种几何图形操作能力，助力开发者开箱即用式快速实现自己的几何图形编辑器。
 
-> 使用方式请参考官方文档: https://lbsyun.baidu.com/bmap-draw/
+> 使用方式请参考官方文档：https://lbsyun.baidu.com/bmap-draw/
 
 :::warning 注意
 该组件库中 `BMapGL` 是异步加载，而 `bmap-draw` 中配置文件中包含同步调用 `BMapGL` 相关构造函数，所以只能使用异步加载。

docs/zh-CN/expand/mapv.md

@@ -4,13 +4,13 @@ MapVGL，是一款基于 WebGL 的地理信息可视化库，可以用来展示
 
 本章节将演示一下通过插件的形式和 npm 形式加载 `mapv` 相关资源，并展示几个示例。
 
-## 结合方式:
+## 结合方式：
 
-与 `mapv` 相关资源结合有如下两种方式:
+与 `mapv` 相关资源结合有如下两种方式：
 
-### 1. 通过组件库提供的插件形式（内部以 cdn 方式加载）
+### 1。通过组件库提供的插件形式 (内部以 cdn 方式加载)
 
-全局配置插件:
+全局配置插件：
 
 ```ts
 // ...
@@ -19,7 +19,7 @@ app.use(baiduMap, {
 })
 ```
 
-或者通过组件配置插件:
+或者通过组件配置插件：
 
 ```vue
 <template>
@@ -40,7 +40,7 @@ app.use(baiduMap, {
 </script>
 ```
 
-### 2. 通过 npm
+### 2。通过 npm
 
 安装
 
@@ -75,7 +75,7 @@ mapv、mapvgl、mapvThree 均使用 umd 格式打包，而非 esm。所以通过
 
 ## 示例
 
-> 以下示例均来自于 `mapv` 官方示例。更多示例见及文档请参考: https://mapv.baidu.com/gl/docs/index.html
+> 以下示例均来自于 `mapv` 官方示例。更多示例见及文档请参考：https://mapv.baidu.com/gl/docs/index.html
 
 ### PointLayer 基础点层图
 

docs/zh-CN/guide/com-events.md

@@ -5,7 +5,7 @@ lang: zh-CN
 
 # 全局组件事件
 
-每个组件都有这两个事件。如果该组件库提供的功能不能满足开发需求，则可以通过`initd`事件暴露百度地图实例来自由的使用。
+每个组件都有这两个事件。如果该组件库提供的功能不能满足开发需求，则可以通过 `initd` 事件暴露百度地图实例来自由的使用。
 
 | 事件名 | 说明                                       | 类型                        |
 | ------ | ------------------------------------------ | --------------------------- |

docs/zh-CN/guide/config.md

@@ -11,12 +11,12 @@ lang: zh-CN
 
 目前支持两种方式，全局配置和组件 props 传入
 ::: tip
-如果你是**全局注册**使用方式，那么`ak`、`apiUrl`、`plugins` 和 `pluginsSourceLink` 都支持两种来源（全局注册配置和组件 `props` 提供），当同时指定的时候，会优先就近原则，从组件 `props` 中获取。如果全局注册配置和组件 `props` 都提供了，则会尝试合并两个配置。
+如果你是**全局注册**使用方式，那么 `ak`、`apiUrl`、`plugins` 和 `pluginsSourceLink` 都支持两种来源 (全局注册配置和组件 `props` 提供)，当同时指定的时候，会优先就近原则，从组件 `props` 中获取。如果全局注册配置和组件 `props` 都提供了，则会尝试合并两个配置。
 
 如果你是**按需加载**使用方式，则只支持组件 `props` 方式
 :::
 
-### 1. 通过全局注册配置 ak 与 插件
+### 1。通过全局注册配置 ak 与插件
 
 全局注册 Options
 
@@ -40,7 +40,7 @@ app.use(baiduMap, {
 app.mount('#app')
 ```
 
-### 2. 组件 `BMap` 传入 [`props`](/zh-CN/components/map#%E9%9D%99%E6%80%81%E7%BB%84%E4%BB%B6-props) 配置
+### 2。组件 `BMap` 传入 [`props`](/zh-CN/components/map#%E9%9D%99%E6%80%81%E7%BB%84%E4%BB%B6-props) 配置
 
 <!-- prettier-ignore -->
 ```html{2,3}
@@ -71,7 +71,7 @@ app.mount('#app')
 
 ### 更换插件资源链接
 
-如果需要自建或其他地址的资源链接，则可以通过该方式自定义。同样，该方式也支持两种形式:
+如果需要自建或其他地址的资源链接，则可以通过该方式自定义。同样，该方式也支持两种形式：
 
 ```ts{3-6}
 // ...
@@ -100,7 +100,7 @@ app.use(baiduMap, {
 
 除了提供的插件外，你还可以通过自定义插件扩展，自定义的插件将在地图加载完毕后执行与处理。
 
-自定义的方式也很简单，你只需定义一个返回`Promise`的函数即可
+自定义的方式也很简单，你只需定义一个返回 `Promise` 的函数即可
 
 ```ts
 const customPlugin = () => {

docs/zh-CN/guide/installation.md

@@ -2,7 +2,7 @@
 
 ## 使用包管理器
 
-我们建议您使用包管理器（如 NPM、Yarn 或 pnpm）安装 Vue3 BaiduMap GL，然后您就可以使用打包工具，例如 Vite 或 webpack。
+我们建议您使用包管理器 (如 NPM、Yarn 或 pnpm) 安装 Vue3 BaiduMap GL，然后您就可以使用打包工具，例如 Vite 或 webpack。
 
 ::: code-group
 
@@ -24,7 +24,7 @@ npm install vue3-baidu-map-gl
 
 直接通过浏览器的 HTML 标签导入 Vue3 BaiduMap GL，然后就可以使用全局变量 `Vue3baiduMapGl` 了。
 
-不同的 CDN 提供商有不同的引入方式， 我们在这里以 [unpkg](https://unpkg.com) 和 [jsDelivr](https://www.jsdelivr.com) 举例。 你也可以使用其它的 CDN 供应商。
+不同的 CDN 提供商有不同的引入方式，我们在这里以 [unpkg](https://unpkg.com) 和 [jsDelivr](https://www.jsdelivr.com) 举例。你也可以使用其它的 CDN 供应商。
 
 ::: code-group
 

docs/zh-CN/guide/introduction.md

@@ -12,9 +12,9 @@
 </a>
 </div>
 
-基于百度地图 JavaScript GL 版（使用了 WebGL 对地图、覆盖物等进行渲染，支持 3D 视角展示地图） API 封装设计的 Vue3 组件库，开发体验良好，以优雅的方式完成百度地图的接入。
+基于百度地图 JavaScript GL 版 (使用了 WebGL 对地图、覆盖物等进行渲染，支持 3D 视角展示地图) API 封装设计的 Vue3 组件库，开发体验良好，以优雅的方式完成百度地图的接入。
 
-## :sparkles: 特性
+## ：sparkles：特性
 
 - 🚀 自动加载百度地图 SDK，将百度地图繁琐的 Api 封装进组件，你只需关注组件本身
 - 📦 20+ 高质量的开箱即用 Vue 3 组件以及 8+ hooks 封装
@@ -29,7 +29,7 @@
 
 ### 组件库
 
-Vue3 BaiduMap GL 可以在支持 [ES2018](https://caniuse.com/?feats=mdn-javascript_builtins_regexp_dotall,mdn-javascript_builtins_regexp_lookbehind_assertion,mdn-javascript_builtins_regexp_named_capture_groups,mdn-javascript_builtins_regexp_property_escapes,mdn-javascript_builtins_symbol_asynciterator,mdn-javascript_functions_method_definitions_async_generator_methods,mdn-javascript_grammar_template_literals_template_literal_revision,mdn-javascript_operators_destructuring_rest_in_objects,mdn-javascript_operators_spread_spread_in_destructuring,promise-finally) 的浏览器上运行。 如果您确实需要支持旧版本的浏览器，请自行添加 [Babel](https://babeljs.io/) 和相应的 Polyfill 。
+Vue3 BaiduMap GL 可以在支持 [ES2018](https://caniuse.com/?feats=mdn-javascript_builtins_regexp_dotall,mdn-javascript_builtins_regexp_lookbehind_assertion,mdn-javascript_builtins_regexp_named_capture_groups,mdn-javascript_builtins_regexp_property_escapes,mdn-javascript_builtins_symbol_asynciterator,mdn-javascript_functions_method_definitions_async_generator_methods,mdn-javascript_grammar_template_literals_template_literal_revision,mdn-javascript_operators_destructuring_rest_in_objects,mdn-javascript_operators_spread_spread_in_destructuring,promise-finally) 的浏览器上运行。如果您确实需要支持旧版本的浏览器，请自行添加 [Babel](https://babeljs.io/) 和相应的 Polyfill。
 
 由于 Vue 3 不再支持 IE11，该组件库是基于 Vue3 封装，自然也不再支持 IE 浏览器。
 | ![IE](https://cdn.jsdelivr.net/npm/@browser-logos/edge/edge_32x32.png) | ![Firefox](https://cdn.jsdelivr.net/npm/@browser-logos/firefox/firefox_32x32.png) | ![Chrome](https://cdn.jsdelivr.net/npm/@browser-logos/chrome/chrome_32x32.png) | ![Safari](https://cdn.jsdelivr.net/npm/@browser-logos/safari/safari_32x32.png) |

docs/zh-CN/guide/quick-start.md

@@ -67,4 +67,4 @@ Vue3 BaiduMap GL 提供了基于 ES Module 开箱即用的 Tree Shaking 功能
 
 ## 开始使用
 
-您可以从现在起启动您的项目。 对于每个组件或 hooks 的用法，请参考对应的文档。
+您可以从现在起启动您的项目。对于每个组件或 hooks 的用法，请参考对应的文档。

docs/zh-CN/hooks/useAddressGeocoder.md

@@ -14,7 +14,7 @@ hooks/useAddressGeocoder/index
 :::
 
 :::tip
-在 Ts 中使用单个解析地址时，使用泛型`Point`内部可推断`point`为可推断为`Point`，从而避免读取值时 ts 的报错。
+在 Ts 中使用单个解析地址时，使用泛型 `Point` 内部可推断 `point` 为可推断为 `Point`，从而避免读取值时 ts 的报错。
 
 ```ts
 import { Point } from 'vue3-baidu-map-gl'
@@ -31,7 +31,7 @@ hooks/useAddressGeocoder/batch
 :::
 
 :::tip
-在 Ts 中使用批量解析地址时，使用泛型`Point[]`内部可推断`point`为可推断为`Point[]`，从而避免遍历时 ts 的报错。
+在 Ts 中使用批量解析地址时，使用泛型 `Point[]` 内部可推断 `point` 为可推断为 `Point[]`，从而避免遍历时 ts 的报错。
 
 ```ts
 import { Point } from 'vue3-baidu-map-gl'
@@ -47,7 +47,7 @@ const { get, point, isLoading, isEmpty } = useAddressGeocoder(cal)
 ```
 
 :::tip
-该 hooks 依赖于 `BMapGL` ，所以需要在 `Map` 组件初始化完毕调用 `get` 方法后数据才可用
+该 hooks 依赖于 `BMapGL`，所以需要在 `Map` 组件初始化完毕调用 `get` 方法后数据才可用
 :::
 
 ### 参数

docs/zh-CN/hooks/useAreaBoundary.md

@@ -19,7 +19,7 @@ const { isLoading, boundaries, get } = useAreaBoundary(cal)
 ```
 
 :::tip
-该 hooks 依赖于 `BMapGL` ，所以需要在 `Map` 组件初始化完毕调用 `get` 方法后数据才可用
+该 hooks 依赖于 `BMapGL`，所以需要在 `Map` 组件初始化完毕调用 `get` 方法后数据才可用
 :::
 
 ### 参数