[Docs]: 改造文档「核心概念 - 标记(Mark)- wordCloud」 #6656
interstellarmt posted onGitHub
任务介绍
此 ISSUE 为 AntV 开源共建计划(AntV Open Source Contribution Plan,简称 AntV OSCP)第三期文档季 的任务 ISSUE,欢迎社区开发者参与共建~
- 更多任务,可查看 「2025 AntV OSCP Season of Docs」Project。
This ISSUE is one of the tasks of the AntV Open Source Contribution Plan (referred to as AntV OSCP) Phase3 Season of Docs . Welcome to join us in building it together!
- For more tasks, you can check the ["2025 AntV OSCP Season of Docs" Project]「2025 AntV OSCP Season of Docs」Project.
修改文档「核心概念 - 标记(Mark)- wordCloud」
任务介绍
任务名称:修改文档「核心概念 - 标记(Mark)- wordCloud」,包括调整文档结构、丰富文档内容、对配置项进行查漏补缺以及补充示例代码等。
技术方向:g2 / docs
任务难度:中 🌟🌟
可获得积分:30分
详细要求
操作指引:
选择感兴趣的且没有 Assignee 的任务,按格式回复,该任务 assign 给你后即为成功认领~
- 认领回复格式:【GitHub ID + Give it to me】
- eg:【Candicepan Give it to me】
需在 G2 中提交相应的修改文档的PR (需关联本 ISSUE)。
请保证文档语意通顺、格式正确、代码示例完整且能够正确编译,否则该 PR 将不会被 review 和 merge,此 issue 将被重新释放。
文档规范:
- 文档结构:「标记(Mark)」部分的文档至少应该包括【概述】、【配置项】,【示例】几个部分。
- 代码规范:示例代码统一使用
spec
语法。即chart.options({})
,可以在图表示例页面完成切换。 - 内容规范:
- 属性表格需要包含【属性】【描述】【类型】【默认值】【必选】列,所有的配置项包括绘图属性需要罗列完整。
- 默认值除了功能实现部分,还可能配置在主题里
src/theme/create.ts
- 回调函数类型尽量描述完整,使用
(datum, index, data, column) => number
代替Function<number>
。 - 对于枚举类型的,直接在【类型】里罗列。
范例与参考资料:
- 文档范例 :「核心概念 - 标记(Mark)- interval」 对应的中文文档源文件对应的示例代码playground链接
能力要求
- 了解图形语法。
- 对 G2 有一定了解,能阅读 G2 源码,编写示例。
执行路径
1. 认领任务
选择感兴趣的且没有 Assignee 的任务,按格式回复,该任务 assign 给你后即为成功认领~
- 认领回复格式:【@GitHub ID + Give it to me】
- eg:【@interstellarmt Give it to me】
2. 做任务
- clone g2 代码
git clone https://github.com/antvis/G2.git
- 拉取所有线上分支
git fetch
- 切换到 v5 分支
git checkout v5
- 安装依赖
pnpm install
- 进入 site 包
cd site
- 安装 site 依赖
pnpm install
- 本地启动 site 站点
pnpm run start
- 优化文档并预览效果
- 对应文件位于
site/docs/manual/core/mark/wordcloud.zh.md
- 功能实现位于
src/mark/wordCloud.ts
- 图表示例位于:
site/examples/general/text/demo
- 图表示例预览: https://g2.antv.antgroup.com/examples#general-text
3. 提交 PR
请保证文档语意通顺、格式正确、代码示例完整且能够正确编译,否则该 PR 将不会被 review 和 merge,此 issue 将被重新释放。
- 提交 Pull Request,等待 Code Review
- PR 标题参考
docs: 任务名称
,如docs: 改造「核心概念 - 标记(Mark)-wordCloud」文档
,并关联OSCP
标签,以便快速进入 PR review 阶段。 - PR 与对应任务 ISSUE 进行关联,方式:在 PR 正文中,通过
- Fixed: #任务 ISSUE 号
即可实现关联,eg:
根据(多次) Code Review 建议修改
等待合并入 v5 分支后,积分生效