Skip to content

Commit

Permalink
feat(docs): remove en-US docs
Browse files Browse the repository at this point in the history
  • Loading branch information
hankliu62 committed Apr 22, 2024
1 parent 626393a commit 4da271d
Show file tree
Hide file tree
Showing 24 changed files with 169 additions and 2,127 deletions.
76 changes: 0 additions & 76 deletions docs/react/contributing.en-US.md

This file was deleted.

29 changes: 12 additions & 17 deletions docs/react/contributing.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,47 +4,47 @@ title: 贡献指南
toc: false
---

这篇指南会指导你如何为 Ant Design 贡献一份自己的力量,请在你要提 issue 或者 pull request 之前花几分钟来阅读一遍这篇指南。
这篇指南会指导你如何为 HankLiu UI 贡献一份自己的力量,请在你要提 issue 或者 pull request 之前花几分钟来阅读一遍这篇指南。

## 行为准则

我们有一份 [行为准则](https://github.com/ant-design/ant-design/blob/master/CODE_OF_CONDUCT.md),希望所有的贡献者都能遵守,请花时间阅读一遍全文以确保你能明白哪些是可以做的,哪些是不可以做的。
我们有一份 [行为准则](https://github.com/hankliu62/hankliu-ui/blob/master/CODE_OF_CONDUCT.md),希望所有的贡献者都能遵守,请花时间阅读一遍全文以确保你能明白哪些是可以做的,哪些是不可以做的。

## 透明的开发

我们所有的工作都会放在 [GitHub](https://github.com/ant-design) 上。不管是核心团队的成员还是外部贡献者的 pull request 都需要经过同样流程的 review。
我们所有的工作都会放在 [GitHub](https://github.com/hankliu62) 上。不管是核心团队的成员还是外部贡献者的 pull request 都需要经过同样流程的 review。

## 分支管理

基于我们的 [发布周期](/changelog),我们长期维护两个分支 `master``feature`。如果你要修一个 bug,那么请发 pull request 到 `master`,我们会每周从 master 发布一个 patch 版本;如果你要提一个增加新功能的 pull request,那么请基于 `feature` 分支来做,每月末我们会合并 feature 到 master,并发布一个包含新特性的 minor 版本。

## Bugs

我们使用 [GitHub Issues](https://github.com/ant-design/ant-design/issues) 来做 bug 追踪。 如果你想要你发现的 bug 被快速解决,最好的办法就是通过我们提供的 [issue 小助手](http://new-issue.ant.design) 来提 issue。并且能使用这个 [模板](https://u.ant.design/codesandbox-repro) 来提供重现。
我们使用 [GitHub Issues](https://github.com/hankliu62/hankliu-ui/issues) 来做 bug 追踪。 如果你想要你发现的 bug 被快速解决,最好的办法就是通过我们提供的 [issue 小助手](http://new-issue.ant.design) 来提 issue。并且能使用这个 [模板](https://u.ant.design/codesandbox-repro) 来提供重现。

在你报告一个 bug 之前,请先确保已经搜索过已有的 issue 和阅读了我们的 [常见问题](/docs/react/faq)

## 新增功能

如果你有改进我们的 API 或者新增功能的想法,我们同样推荐你使用我们提供的 [issue 小助手](http://new-issue.ant.design) 来新建一个添加新功能的 issue。

如果你希望协助开发新的 API,请参考 [API 规范](https://github.com/ant-design/ant-design/wiki/API-Naming-rules) 进行命名。
如果你希望协助开发新的 API,请参考 [API 规范](https://github.com/hankliu62/hankliu-ui/wiki/API-Naming-rules) 进行命名。

## 第一次贡献

如果你还不清楚怎么在 GitHub 上提 Pull Request ,可以阅读下面这篇文章来学习:

[如何优雅地在 GitHub 上贡献代码](https://segmentfault.com/a/1190000000736629)

为了能帮助你开始你的第一次尝试,我们用 [good first issues](https://github.com/ant-design/ant-design/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 标记了一些比较容易修复的 bug 和小功能。这些 issue 可以很好地作为你的首次尝试。
为了能帮助你开始你的第一次尝试,我们用 [good first issues](https://github.com/hankliu62/hankliu-ui/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 标记了一些比较容易修复的 bug 和小功能。这些 issue 可以很好地作为你的首次尝试。

如果你打算开始处理一个 issue,请先检查一下 issue 下面的留言以确保没有别人正在处理这个 issue。如果当前没有人在处理的话你可以留言告知其他人你将会处理这个 issue,以免别人重复劳动。

如果之前有人留言说会处理这个 issue 但是一两个星期都没有动静,那么你也可以接手处理这个 issue,当然还是需要留言告知其他人。

## Pull Request

Ant Design 团队会关注所有的 pull request,我们会 review 以及合并你的代码,也有可能要求你做一些修改或者告诉你我们为什么不能接受这样的修改。
HankLiu UI 团队会关注所有的 pull request,我们会 review 以及合并你的代码,也有可能要求你做一些修改或者告诉你我们为什么不能接受这样的修改。

**在你发送 Pull Request 之前**,请确认你是按照下面的步骤来做的:

Expand All @@ -59,23 +59,18 @@ Ant Design 团队会关注所有的 pull request,我们会 review 以及合并

[react-component](https://github.com/react-component/) 发送 pull request:

由于 antd 的大部分组件都是基于 react-component 的,所以有时候你可能需要给相应的 react-component 仓库发送 pull request。如果你是修复了某个 bug,那么我们在合并你的修改后会尽快发布一个 patch 版本,然后你只要重新安装你的依赖就可以使用新发布的版本了。如果你的 pull request 是新增了某个功能,那么在你的修改合并并且发布版本后,你还需要发送一个 pull request 到 [Ant Design](https://github.com/ant-design/ant-design/) 来升级相应的依赖、文档以及 TypeScript 的类型定义。
由于 hankliu-ui 的大部分组件都是基于 react-component 的,所以有时候你可能需要给相应的 react-component 仓库发送 pull request。如果你是修复了某个 bug,那么我们在合并你的修改后会尽快发布一个 patch 版本,然后你只要重新安装你的依赖就可以使用新发布的版本了。如果你的 pull request 是新增了某个功能,那么在你的修改合并并且发布版本后,你还需要发送一个 pull request 到 [HankLiu UI](https://github.com/hankliu62/hankliu-ui/) 来升级相应的依赖、文档以及 TypeScript 的类型定义。

## 开发流程

在你 clone 了 antd 的代码并且使用 `npm install` 安装完依赖后,你还可以运行下面几个常用的命令:
在你 clone 了 hankliu-ui 的代码并且使用 `npm install` 安装完依赖后,你还可以运行下面几个常用的命令:

1. `npm start` 在本地运行 Ant Design 的网站。
1. `npm start` 在本地运行 HankLiu UI 的网站。
2. `npm run lint` 检查代码风格。
3. `npm test` 运行测试。(在运行测试前请确保 `NODE_ENV` 环境变量没有被设定,否则可能会引发一些问题)
4. `npm run compile` 编译 TypeScript 代码到 lib 和 es 目录。
5. `npm run dist` 构建 antd 的 UMD 版本到 dist 目录。
5. `npm run dist` 构建 hankliu-ui 的 UMD 版本到 dist 目录。

## 加入社区

如果你贡献度足够活跃,希望和 Ant Design 团队一起参与维护工作,你可以[申请成为社区协作者](https://github.com/ant-design/ant-design/wiki/Collaborators#how-to-apply-for-being-a-collaborator)

你还可以参考下面两篇社区成员写的贡献指南,一步一步成为 antd 的贡献者吧:

- [记录向:如何快速的成为 Ant Design 的 contributor](https://zhuanlan.zhihu.com/p/123367842) [@Rustin-Liu](https://github.com/Rustin-Liu)
- [从 0 开始,成为 Ant-Design Contributor](https://zhuanlan.zhihu.com/p/143895612) [@fireairforce](https://github.com/fireairforce)
如果你贡献度足够活跃,希望和 HankLiu UI 团队一起参与维护工作,你可以[申请成为社区协作者](https://github.com/hankliu62/hankliu-ui/wiki/Collaborators#how-to-apply-for-being-a-collaborator)
81 changes: 0 additions & 81 deletions docs/react/customize-theme-variable.en-US.md

This file was deleted.

16 changes: 8 additions & 8 deletions docs/react/customize-theme-variable.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,17 @@ title: 动态主题(实验性)
## 注意事项

- 该功能通过动态修改 CSS Variable 实现,因而在 IE 中页面将无法正常展示。请先确认你的用户环境是否需要支持 IE。
- 该功能在 `antd@4.17.0-alpha.0` 版本起支持。
- 该功能在 `@hankliu/hankliu-ui@0.0.1` 版本起支持。

## 如何使用

### 引入 antd.variable.min.css
### 引入 hlui.variable.min.css

替换当前项目引入样式文件为 CSS Variable 版本:

```diff
-- import 'antd/dist/antd.min.css';
++ import 'antd/dist/antd.variable.min.css';
-- import '@hankliu/hankliu-ui/dist/hlui.min.css';
++ import '@hankliu/hankliu-ui/dist/hlui.variable.min.css';
```

注:如果你使用了 `babel-plugin-import`,需要将其去除。
Expand All @@ -39,7 +39,7 @@ ConfigProvider.config({

## 冲突解决

默认情况下,CSS Variable 会以 `--ant` 作为前缀。当你的项目中引用多份 css 文件时,可以通过修改前缀的方式避免冲突。
默认情况下,CSS Variable 会以 `--hlui` 作为前缀。当你的项目中引用多份 css 文件时,可以通过修改前缀的方式避免冲突。

### 代码调整

Expand Down Expand Up @@ -71,11 +71,11 @@ ConfigProvider.config({
由于前缀变更,你需要重新生成一份对应的 css 文件。

```bash
lessc --js --modify-var="ant-prefix=custom" antd/dist/antd.variable.less modified.css
lessc --js --modify-var="ant-prefix=custom" @hankliu/hankliu-ui/dist/hlui.variable.less modified.css
```

### 相关变更

为了实现 CSS Variable 并保持原始用法兼容性,我们于 `dist/antd.xxx.less` 文件中添加了 `@root-entry-name: xxx;` 入口注入以支持 less 动态加载对应的 less 文件。一般情况下,你不需要关注该变化。但是,如果你的项目中直接引用了 `lib|es` 目录下的 less 文件。你需要在 less 入口处配置 `@root-entry-name: default;` (或者 `@root-entry-name: variable;`)以使 less 可以找到正确的入口。
为了实现 CSS Variable 并保持原始用法兼容性,我们于 `dist/hlui.xxx.less` 文件中添加了 `@root-entry-name: xxx;` 入口注入以支持 less 动态加载对应的 less 文件。一般情况下,你不需要关注该变化。但是,如果你的项目中直接引用了 `lib|es` 目录下的 less 文件。你需要在 less 入口处配置 `@root-entry-name: default;` (或者 `@root-entry-name: variable;`)以使 less 可以找到正确的入口。

此外,我们将 `lib|es/style/minxins/index.less` 中的 `@import 'motion'``@import 'reset'` 迁移至了 `lib|es/style/themes/xxx.less` 中,因为这两个文件依赖了主题相关变量。如果你使用了相关内部方法,请自行调整。当然,我们还是建议直接使用 `dist` 目录下的 `antd.less` 文件而非调用内部文件,因为它们经常会受重构影响。
此外,我们将 `lib|es/style/minxins/index.less` 中的 `@import 'motion'``@import 'reset'` 迁移至了 `lib|es/style/themes/xxx.less` 中,因为这两个文件依赖了主题相关变量。如果你使用了相关内部方法,请自行调整。当然,我们还是建议直接使用 `dist` 目录下的 `hlui.less` 文件而非调用内部文件,因为它们经常会受重构影响。

0 comments on commit 4da271d

Please sign in to comment.