chore: 调整官网文档

Author: xuying.xu

site/.dumirc.ts

@@ -74,6 +74,14 @@ export default defineConfig({
         },
         order: 4,
       },
+      {
+        slug: 'api/chart/guide',
+        title: {
+          zh: '标注 - Guide',
+          en: 'Guide',
+        },
+        order: 10,
+      },
       {
         slug: 'tutorial/framework',
         title: {

site/docs/api/chart/guide.zh.md

@@ -0,0 +1,12 @@
+---
+title: 标注 - Guide
+order: 9
+---
+
+提示和标注，主要用于在图表上标识额外的标记注解。目前内置 PointGuide 点标注、TextGuide 文本标注、TagGuide 标注、ImageGuide 图片标注和 LineGuide 线标注，也可以自定义标注。
+
+- [点标注 PointGuide](./point-guide.zh.md)
+- [文本标注 TextGuide](./text-guide.zh.md)
+- [标签标注 TagGuide](./tag-guide.zh.md)
+- [图片标注 ImageGuide](./image-guide.zh.md)
+- [辅助线标注 LineGuide](./line-guide.zh.md)

site/docs/api/chart/guide/guide.zh.md

@@ -0,0 +1,30 @@
+---
+title: 图片标注 - ImageGuide
+---
+
+## 用法
+
+```jsx
+import { ImageGuide } from '@antv/f2';
+
+<ImageGuide
+  records={[{ genre: 'Sports', sold: 5 }]}
+  src="https://example.com/image.png"
+  attrs={{ width: 24, height: 24 }}
+  offsetX={0}
+  offsetY={0}
+/>
+```
+
+## Props
+
+- **records: Array**  
+  标注的数据项或比例值
+- **src: string**  
+  图片地址
+- **attrs**  
+  图片属性
+- **offsetX: number**  
+  x 轴偏移量
+- **offsetY: number**  
+  y 轴偏移量

site/docs/api/chart/guide/image-guide.zh.md

@@ -0,0 +1,27 @@
+---
+title: 辅助线标注 - LineGuide
+---
+
+## 用法
+
+```jsx
+import { LineGuide } from '@antv/f2';
+
+<LineGuide
+  records={[{ genre: 'min', sold: 'max' }]}
+  style={{ stroke: '#f00', lineWidth: 2 }}
+  offsetX={0}
+  offsetY={0}
+/>
+```
+
+## Props
+
+- **records: Array**  
+  标注的数据项或比例值
+- **offsetX: number**  
+  x 轴偏移量
+- **offsetY: number**  
+  y 轴偏移量
+- **style**  
+  线样式

site/docs/api/chart/guide/line-guide.zh.md

@@ -0,0 +1,22 @@
+---
+title: 点标注 - PointGuide
+---
+
+## 用法
+
+```jsx
+import { PointGuide } from '@antv/f2';
+
+<PointGuide records={[{ genre: 'Sports', sold: 5 }]} offsetX={10} offsetY={-10} style={{ fill: '#f00' }} />
+```
+
+## Props
+
+- **records: Array**  
+  标注的数据项或比例值
+- **offsetX: number**  
+  x 轴偏移量
+- **offsetY: number**  
+  y 轴偏移量
+- **style**  
+  标注样式

site/docs/api/chart/guide/point-guide.zh.md

@@ -0,0 +1,36 @@
+---
+title: 标签标注 - TagGuide
+---
+
+## 用法
+
+```jsx
+import { TagGuide } from '@antv/f2';
+
+<TagGuide
+  records={[{ genre: 'Sports', sold: 5 }]}
+  content="标签内容"
+  direct="tr"
+  background={{ fill: '#fff' }}
+  textStyle={{ fill: '#000' }}
+/>
+```
+
+## Props
+
+- **records: Array**  
+  标注的数据项或比例值
+- **content: string**  
+  文本内容
+- **offsetX: number**  
+  x 轴偏移量
+- **offsetY: number**  
+  y 轴偏移量
+- **direct: string**  
+  可选值：'tl' | 'tc' | 'tr' | 'cl' | 'cr' | 'bl' | 'bc' | 'br'
+- **background: Attrs**  
+  背景样式
+- **triggerRef: any**  
+  tagGuide 实例
+- **textStyle: TextAttr**  
+  文本样式

site/docs/api/chart/guide/tag-guide.zh.md

@@ -0,0 +1,30 @@
+---
+title: 文本标注 - TextGuide
+---
+
+## 用法
+
+```jsx
+import { TextGuide } from '@antv/f2';
+
+<TextGuide
+  records={[{ genre: 'Sports', sold: 5 }]}
+  content="文本内容"
+  offsetX={-15}
+  offsetY={-20}
+  style={{ fill: '#000', fontSize: '24px' }}
+/>
+```
+
+## Props
+
+- **records: Array**  
+  标注的数据项或比例值
+- **content: string**  
+  文本内容
+- **offsetX: number**  
+  x 轴偏移量
+- **offsetY: number**  
+  y 轴偏移量
+- **style**  
+  文本样式

site/docs/api/chart/guide/text-guide.zh.md

@@ -3,3 +3,7 @@ title: 基础面积图
 order: 0
 ---
 
+- [基础面积图](./demo/area.jsx)
+- [带负值面积图](./demo/with-negative.jsx)
+- [带负值面积图（x 基线不为 0）](./demo/with-negative-not-start-on-zero.jsx)
+- [渐变填充面积图](./demo/gradient.jsx)

site/examples/area/area/index.zh.md

@@ -3,3 +3,6 @@ title: 层叠面积图
 order: 1
 ---
 
+- [百分比分组柱图](./demo/percent.jsx)
+- [区域图（存在空值）](./demo/area-none.jsx)
+- [层叠面积图](./demo/stacked.jsx)