# 参与此项目

# Playground.vue

Playground文件是用于Vuetify开发的清洁室，是框架内迭代更改的推荐方法。

<template>
  <v-container>
    <!--  -->
  </v-container>
</template>

<script>
  export default {
    data: () => ({
      //
    }),
  }
</script>

用于Vuetify 开发的 App.vue 文件位于 packages/vuetify/dev 中。 它包含 v-app 和 v-main 组件以及本地 Playground.vue 文件。

# 选择一个基础分支

在开始开发之前，您应该知道您的更改基于哪个分支。 如果有疑问，使用master作为对master的更改通常可以合并到一个不同的分支中，而无需重新变基。

# 切换到所需的分支
git switch master

# 拉取上游的更新
git pull

# 创建一个新的分支继续工作
git switch --create fix/1234-some-issue

按照 <a href=“#Commit guidelines”>提交准则 提交您的更改，然后使用git push-u fork 将分支推送到您的fork，然后按照提供的模板在Vuetify仓库上打开一个pull请求。

# 文档-语言

我们 不 接受与除 en 外的任何语言相关的文档更改 PRs。 所有 en 以外的语言修改都通过我们的 Crowdin项目 提交. 您可以通过以下两种方式之一帮助翻译：

• 直接通过文档网站使用上下文翻译服务。 只需在文档中选择 Help Translate/帮助翻译 语言下拉选项。
• 直接通过 Crowdin 项目。

注意: 语言不会被添加到文档站点的语言下拉选项，直到他们完成了至少50%的翻译。

# 快速入门

要将一个主要功能添加到Vuetify，您必须将RFC作为.md文件合并到此仓库中。 以下是如何开始的指南：

• Fork Vuetify RFC 仓库 https://github.com/vuetifyjs/rfcs

• 复制 0000-template.md 到 active-rfcs/0000-my-feature.md (其中 my-feature 是说明性的. 还没有 分配一个 RFC 编号).

• 填写RFC。 详细记录。

  !!crwd_CB_78_BC_dwrc!!

• 提交一个 pull request 请求。 作为一个 pull request，RFC将从更大的社区接收设计反馈，作者应该准备好对其进行相应的修改。 新的 RFC pull requests 开始于 Pending 阶段.

• 建立共识并整合反馈。 得到广泛支持的 RFC 比那些没有收到任何评论的 RFC 更有可能取得进展。

• Eventually, the Core Team will decide whether the RFC is a candidate for inclusion in Vuetify.

• An RFC can be modified based upon feedback from the Core Team and community. 重大修改可能会触发一个新的 最终评论 期.

• 在公开讨论结束并对拒绝理由进行总结后，可拒绝RFC。 A Core Team member will close the RFCs associated pull request, at which point the RFC will enter the Rejected stage.

• RFC可能在其 最终评论 结束时被接受。 A Core Team member will merge the RFCs associated pull request, at which point the RFC will enter the Active stage.

一旦一个 RFC 被合并并且在Vuetify 仓库中实现了相应的功能， 它将是下一个 主要 或 次要 发布版本的一部分。 一旦版本发布，RFC 将进入 Released 阶段并被锁定。

欲了解更多关于RFCs的信息，请参阅官方仓库： https://github.com/vuetifyjs/rfcs

# 一般规则

• 提交信息必须有主题行，并且可以有正文副本。 这些必须用空白行隔开。

• 主题行不能超过60个字符

• 主题行必须用命令语气书写（修复，而不是 修复了/修复(s) 等）

• 正文副本必须包括所有已解决问题的参考：

  文档(sass-variables): 修复损坏的api链接
  
  解决了 #3219
  解决了 #3254
  

• 正文必须用72个字符换行

• 正文必须只包含做了什么和为什么做的说明，而不是怎么做的说明。 后者属于文档和实现。

# 提交类型

以下是一个 angular 预设中使用的 提交类型 的列表:

• feat: 提交会导致新特性或功能的提交。 向后兼容的功能将在下一个 小版本 中发布，而突破性的更改将在下一个 主要版本 中发布。 具有突破性更改的提交主体必须以 breaking CHANGE 开头，接下来是关于API如何更改的描述。
• fix: 为vuetify的代码库中的错误提供修复的提交。
• docs: 为文档更新提供的提交。
• style: 不影响代码运行方式的提交，这些只是对样式的更改。
• refactor: 提交既不修复错误也不添加功能。
• perf: 提交承诺提高性能。
• test: 提交以添加缺少的或更正现有的测试。
• chore: 其他不修改src或测试文件的提交。
• revert: 还原以前提交的提交。

# 共同化

Vuetify团队 将 commitizen 用于所有仓库提交。 这使我们能够轻松阅读和有组织的承诺，并尽量减少对正常提交功能的更改。 Commitizen为处理语义版本控制提供了一个灵活的接口，使编写发行说明 更加容易。

开始, 使用 yarn 在您的终端里执行以下命令以全局安装commitizen包 :

# 安装commitizen和传统的changelog适配器
yarn global add commitizen cz-conventional-changelog

# 然后创建一个.czrc文件来告诉commitizen
# 全局使用哪个适配器。
echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

完成后，您将在终端中运行命令 git cz 替代 git commit 。 在这里，您将看到一系列用于构建提交消息的提示。 有关更多信息，请查看我们关于 <a href=“#commit guidelines”>提交 的指南。