docs: add sponsor and faq

pull/309/head
tangjinzhou 2018-12-14 21:35:19 +08:00
parent 24549cfbbb
commit c8ae767594
9 changed files with 260 additions and 36 deletions

44
docs/vue/faq.en-US.md Normal file
View File

@ -0,0 +1,44 @@
# FAQ
Here are the frequently asked questions about Ant Design Vue that you should look up before you ask in community or create new issue.
### Are you going to provide Sass/Stylus(etc...) style file?
No, actually, you can convert Less to Sass/Stylus(etc...) with tools (which you can Google).
### `Select Dropdown DatePicker TimePicker Popover Popconfirm` disappear when I click another popup component inside it, How to resolve it?
Use `<a-select :getPopupContainer="trigger => trigger.parentNode">` to render component inside Popover. (Or other getXxxxContainer props)
### `Select Dropdown DatePicker TimePicker Popover Popconfirm` scroll with the page?
Use `<a-select :getPopupContainer="trigger => trigger.parentNode">` to render component inside the scroll area. (Or other getXxxxContainer props).
### `Form` does not support two-way binding, can't use `v-model`?
First, we do not recommend using two-way binding in the Form, the same data may be used in multiple places, if you use two-way binding, then the data modification will be synchronized to each component, but this is not what we want, you Data should be synchronized when the form is submitted successfully or fails or confirmed. With a non-bidirectionally bound form, you have maximum control over data modification/synchronization.
Second, if you don't use the form's automatic check/collection feature, ie you don't use the `v-decorator` modifier, you can still use `v-model`.
### How to modify the default theme of Ant Design Vue?
See [Customize Theme](/ant-design-vue/docs/vue/customize-theme/)。
### How to optimize momentjs bundle size with webpack?
See: https://github.com/jmblog/how-to-optimize-momentjs-with-webpack
### It doesn't work when I change `defaultValue`,`defaultOpenKeys`, `initialValue` dynamically.
The `defaultXxxx` (like `defaultValue`) of `Input`/`Select`(etc...) only works in first render. This feature is referenced from [React](https://facebook.github.io/react/docs/forms.html#controlled-components).
### I set the `value` of `Input`/`Select`(etc...), and then, it cannot be changed by user's action.
Try `defaultValue` or `change` or `v-model` to change `value`.
### ant-design-vue override my global styles!
Yes, ant-design-vue is designed to develop a complete background application, we override some global styles for styling convenience, and it can't be removed now. More info trace https://github.com/ant-design/ant-design/issues/4331 .
Or, follow the instructions in [How to avoid modifying global styles?](docs/react/customize-theme#How-to-avoid-modifying-global-styles-?)

47
docs/vue/faq.zh-CN.md Normal file
View File

@ -0,0 +1,47 @@
# 常见问题
以下整理了一些 Ant Design Vue 社区常见的问题和官方答复,在提问之前建议找找有没有类似的问题。
### 你们会提供 Sass/Stylus 等格式的样式文件吗?
不。事实上你可以使用工具(请自行 Google将 Less 转换成 Sass/Stylus 等。
### 当我点击 `Select Dropdown DatePicker TimePicker Popover Popconfirm` 内的另一个 popup 组件时它会消失,如何解决?
使用 `<a-select :getPopupContainer="trigger => trigger.parentNode">` 来在 Popover 中渲染组件,或者使用其他的 getXxxxContainer 参数。
### `Select Dropdown DatePicker TimePicker Popover Popconfirm` 会跟随滚动条上下移动?
使用 `<a-select :getPopupContainer="trigger => trigger.parentNode">` 来将组件渲染到滚动区域内,或者使用其他的 getXxxxContainer 参数。
### `Form`表单不支持双向绑定,不能使用`v-model`
第一、我们不推荐在Form中使用双向绑定同一份数据可能在多处使用如果使用双向绑定那么数据的修改会同时同步到各个组件但这并不是我们想要的 你应该在表单提交成功或失败或确认时同步数据,使用非双向绑定的表单,你会拥有最大限度的控制数据修改/同步的权限。
第二、如果你不使用表单的自动校验/收集功能,即没有使用`v-decorator`修饰过得组件,你依然可以使用`v-model`。
### 如何修改 Ant Design Vue 的默认主题?
参考[主题定制](/ant-design-vue/docs/vue/customize-theme/)。
### 如何配置 webpack 以优化 momentjs 的打包大小?
参考https://github.com/jmblog/how-to-optimize-momentjs-with-webpack 。
### 当我动态改变 `defaultValue`,`defaultOpenKeys`, `initialValue`等`defaultXxxx`的时候它并没有生效。
`Input`/`Select` 等的 `defaultXxxx`(例如 `defaultValue`)只有在组件第一次渲染的时候有效,此特性参考自[React](https://reactjs.org/docs/forms.html#controlled-components)。
切记:第一次、第一次、第一次....
### 当我设置了 `Input`/`Select` 等的 `value` 时它就无法修改了。
尝试使用 `defaultValue``change``v-model` 来改变 `value`
### ant-design-vue 覆盖了我的全局样式!
是的ant-design-vue 在设计的时候就是用来开发一个完整的应用的,为了方便,我们覆盖了一些全局样式,现在还不能移除,想要了解更多请追踪这个 issuehttps://github.com/ant-design/ant-design/issues/4331 ,或者参考这个教程 [How to avoid modifying global styles?](docs/react/customize-theme#How-to-avoid-modifying-global-styles-?)
### `ant-design-vue` 在移动端体验不佳。
`ant-design-vue` 并非针对移动端设计。

69
docs/vue/sponsor.en-US.md Normal file
View File

@ -0,0 +1,69 @@
# Sponsor Ant Design Vue Development
ant-design-vue is an MIT licensed open source project and completely free to use. However, in order to continue the healthy and sustainable development of the project, we expect to receive corresponding financial support. You can support ant-design-vue development via the following methods:
## One-time Donations
We accept donations through these channels:
<div>
<a href="https://www.paypal.me/tangjinzhou" target="_blank">PayPal</a>
<br/>
<a href="https://user-images.githubusercontent.com/6937879/43032487-932a5536-8cea-11e8-9175-9c006e938a82.png" target="_blank">Alipay or WeChat</a>
</div>
## Recurring Pledges
Recurring pledges come with exclusive perks, e.g. having your name listed in the Vue GitHub repository, or have your company logo placed on this website.
<div>
<a href="https://www.patreon.com/tangjinzhou" target="_blank">Patreon</a>
<br/>
<a href="https://opencollective.com/ant-design-vue" target="_blank">opencollective</a>
</div>
## Corporate sponsorship
You can consult me by email [415800467@qq.com](415800467@qq.com).
## Current sponsors
### Sponsors
Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/ant-design-vue#sponsor)]
<div>
<a href="https://opencollective.com/ant-design-vue/sponsor/0/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/1/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/2/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/3/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/4/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/5/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/6/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/7/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/8/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/9/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/9/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/10/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/10/avatar.svg"></a>
</div>
### Backers
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/ant-design-vue#backer)]
<div>
<a href="https://github.com/limichange" target="_blank"><img width="64" style="border-radius: 50%;" src="https://avatars0.githubusercontent.com/u/1947344?s=400&v=4" title="limichange donation total 24$ by qq from 2018.9"></a>
<a href="https://opencollective.com/ant-design-vue/backer/0/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/0/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/1/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/1/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/2/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/2/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/3/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/3/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/4/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/4/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/5/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/5/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/6/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/6/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/7/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/7/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/8/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/8/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/9/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/9/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/10/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/10/avatar.svg"></a>
</div>
If you run a business and are using Ant Design Vue in a revenue-generating product, it makes business sense to sponsor Ant Design Vue development: it ensures the project that your product relies on stays healthy and actively maintained. It can also help your exposure in the Vue community and makes it easier to attract Vue developers.
If you are an individual user and have enjoyed the productivity of using Ant Design Vue, consider donating as a sign of appreciation - like buying me coffee once in a while :)

70
docs/vue/sponsor.zh-CN.md Normal file
View File

@ -0,0 +1,70 @@
# 赞助 Ant Design Vue 的研发
ant-design-vue 是采用 MIT 许可的开源项目,使用完全免费。 但为了项目能够健康持续的发展下去,我们期望获得相应的资金支持。 你可以通过下列的方法来赞助我们的开发。
## 一次性赞助
你可以通过以下任意一种方式赞助:
<div>
<a href="https://www.paypal.me/tangjinzhou" target="_blank">PayPal</a>
<br/>
<a href="https://user-images.githubusercontent.com/6937879/43032487-932a5536-8cea-11e8-9175-9c006e938a82.png" target="_blank">支付宝或微信</a>
</div>
## 周期性赞助
周期性赞助可以获得额外的回报,比如你的名字会出现在 Vue 的 GitHub 仓库中,再比如你的公司 logo 会出现在我们的官网上。
<div>
<a href="https://www.patreon.com/tangjinzhou" target="_blank">Patreon</a>
<br/>
<a href="https://opencollective.com/ant-design-vue" target="_blank">opencollective</a>
</div>
## 企业赞助
您可以通过邮件咨询[415800467@qq.com](415800467@qq.com)。
## 当前的赞助商
### Sponsors
Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/ant-design-vue#sponsor)]
<div>
<a href="https://opencollective.com/ant-design-vue/sponsor/0/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/1/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/2/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/3/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/4/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/5/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/6/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/7/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/8/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/9/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/9/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/sponsor/10/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/sponsor/10/avatar.svg"></a>
</div>
### Backers
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/ant-design-vue#backer)]
<div>
<a href="https://github.com/limichange" target="_blank"><img width="64" style="border-radius: 50%;" src="https://avatars0.githubusercontent.com/u/1947344?s=400&v=4" title="limichange donation total 24$ by qq from 2018.9"></a>
<a href="https://opencollective.com/ant-design-vue/backer/0/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/0/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/1/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/1/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/2/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/2/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/3/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/3/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/4/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/4/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/5/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/5/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/6/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/6/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/7/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/7/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/8/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/8/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/9/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/9/avatar.svg"></a>
<a href="https://opencollective.com/ant-design-vue/backer/10/website" target="_blank"><img src="https://opencollective.com/ant-design-vue/backer/10/avatar.svg"></a>
</div>
如果你是企业经营者并且将 Ant Design Vue 用在商业产品中,那么赞助 Ant Design Vue 有商业上的益处:可以让你的产品所依赖的框架保持健康并得到积极的维护,也能帮助你在 Vue 社区里获得更高的曝光度,从而更容易地吸引到 Vue 开发者。
如果你是个人开发者并且享受 Ant Design Vue 带来的高开发效率,可以用捐助来表示你的谢意 —— 就好像偶尔给我买杯咖啡 :)

View File

@ -14,7 +14,7 @@ export default {
<h2>Ant Design</h2>
<div>
<a href='https://github.com/vueComponent/ant-design-vue' target='_blank '>
<span>GitHub</span></a><span> - </span>
<span>GitHub</span></a><span></span>
<span><i class='anticon anticon-github'></i></span>
</div>
<div>

View File

@ -79,6 +79,11 @@ export default {
<a-menu-item key='github'>
<a href='https://github.com/vueComponent/ant-design-vue'>GitHub</a>
</a-menu-item>
<a-menu-item key='sponsor'>
<router-link to={{ path: '/ant-design-vue/docs/vue/sponsor' }}>
{isCN ? '赞助我们' : 'Sponsor'}
</router-link>
</a-menu-item>
</a-menu>
</a-col>
</a-row>

View File

@ -17,6 +17,8 @@ const docsList = [
{ key: 'customize-theme', enTitle: 'Customize Theme', title: '定制主题' },
{ key: 'changelog', enTitle: 'Change Log', title: '更新日志' },
{ key: 'i18n', enTitle: 'Internationalization', title: '国际化' },
{ key: 'faq', enTitle: 'FAQ', title: '常见问题' },
{ key: 'sponsor', enTitle: 'Sponsor', title: '赞助我们' },
]
export default {
@ -266,8 +268,8 @@ export default {
</div> : ''}
</div>
<section class='prev-next-nav'>
{prevPage ? <router-link class='prev-page' to={`${prevPage.url}`}>{prevPage.title}</router-link> : ''}
{nextPage ? <router-link class='next-page' to={`${nextPage.url}`}>{nextPage.title}</router-link> : ''}
{prevPage ? <router-link class='prev-page' to={`${prevPage.url}`}><a-icon type='left' />&nbsp;&nbsp;{prevPage.title}</router-link> : ''}
{nextPage ? <router-link class='next-page' to={`${nextPage.url}`}>{nextPage.title}&nbsp;&nbsp;<a-icon type='right' /></router-link> : ''}
</section>
</a-col>
</a-row>

View File

@ -87,6 +87,26 @@ export default [
component: () => import('../docs/vue/use-with-vue-cli.zh-CN.md'),
beforeEnter,
},
{
path: 'docs/vue/faq',
component: () => import('../docs/vue/faq.en-US.md'),
beforeEnter,
},
{
path: 'docs/vue/faq-cn',
component: () => import('../docs/vue/faq.zh-CN.md'),
beforeEnter,
},
{
path: 'docs/vue/sponsor',
component: () => import('../docs/vue/sponsor.en-US.md'),
beforeEnter,
},
{
path: 'docs/vue/sponsor-cn',
component: () => import('../docs/vue/sponsor.zh-CN.md'),
beforeEnter,
},
{
path: 'docs/vue/changelog',
component: () => import('../CHANGELOG.en-US.md'),

View File

@ -16,43 +16,10 @@
text-decoration: none;
}
> a.prev-page {
&:before {
font-family: 'anticon';
content: '\e61c';
font-size: 12px;
margin-right: 1em;
color: @site-text-color-secondary;
transition: all .3s;
position: relative;
left: 0;
}
&:hover:before {
color: @primary-color;
left: -3px;
}
}
> .next-page {
text-align: right;
float: right;
&:after {
font-family: 'anticon';
content: '\e61b';
font-size: 12px;
margin-left: 1em;
color: @site-text-color-secondary;
transition: all .3s;
position: relative;
right: 0;
}
&:hover:after {
color: @primary-color;
right: -3px;
}
}
.chinese {