贡献

感谢您对 cssnano 的贡献!我们感谢任何贡献,无论大小。如果您已为 cssnano 做出贡献,我们建议您将自己添加到 CONTRIBUTORS.md 中的贡献者列表中。

如何为 cssnano 的代码做出贡献?

自版本 4 起,我们在单一代码库中进行开发。这是因为许多转换彼此重叠;将它们一起测试会更容易。除此之外,您还需要安装 Node.js、pnpm 和 git。然后,您可以运行以下命令来设置存储库

git clone git@github.com:cssnano/cssnano.git
cd cssnano
pnpm install

您可以通过以下方式运行测试

pnpm test

我们建议您在问题跟踪器中查找标记为 help wanted 的任何内容;这是陷入困境并编写代码的第一个求助端口。如果您认为可以解决的任何其他未解决问题,请在讨论中发表评论,表达您的兴趣。

如果您对某些功能有想法,但没有问题跟踪,那么请在编写拉取请求之前打开一个问题。我们发现,在编写任何代码之前讨论您的要求会更有帮助。

为了帮助我们生成变更日志,请在您的提交消息中遵循 conventional commits 格式。

文档

文档网站也包含在存储库中,位于 /site 下。它运行 docusaurus,需要单独的 pnpm install 来提取依赖项。然后,您可以通过运行 pnpm start 在本地浏览文档。

请注意,某些文档是自动生成的,不应手动编辑。

发布

我们使用 @changesets/cli 来更新变更日志和标记版本。首先确保为要发布的每个更改都存在一个变更集。变更集是一个文本文件,其中包含更改的描述和受影响的包。要创建变更集,请运行

pnpm changeset

最好手动选择受影响的包,而不是依赖工具自动发现依赖项。例如,如果更改影响插件 cssnano-preset-default,请手动选择插件和 cssnano-preset-default(以及任何其他依赖的预设)。要标记版本并生成变更日志,请运行

pnpm changeset version

要将版本发布到 npm,请运行

pnpm all-publish

如果您不使用 package.json 脚本,请不要忘记先重建包!

  1. pnpm prepare
  2. pnpm changeset publish

还有其他贡献方式吗?

当然!尝试以下任何领域

改进我们的文档

如果您认为我们的文档中需要拼写检查、澄清、添加代码示例或以某种方式改进,请通过打开一个详细说明问题的 issue 来帮助我们。

使用 documentation 标签 查找相关问题。

改进我们的问题

问题就像记录项目的辅助手段,如果问题缺少重现步骤,请帮助我们与原始作者协调,以了解有关其问题的更多详细信息。

找到错误的来源后,您可以通过提交失败的测试用例作为拉取请求来提供进一步的帮助。我们的许多测试遵循简单的 fixtureexpected 字符串比较模式。

对问题提供反馈

对问题的反馈非常重要,并将塑造 cssnano 的方向。请帮助我们对对您来说重要的以及特别标记为“question”的问题提出建设性批评。

请注意,我们认为“+1”评论没有多大帮助;相反,请使用 GitHub 反应并订阅该主题以接收任何进度的通知。这有助于使我们的讨论集中在手头的话题上。

审查拉取请求

对即将推出的功能和修复进行更多关注非常重要。请通过审查拉取请求来提供帮助;即使留下一个点赞反应也比什么都不做要好。帮助我们进行审查意味着如果发布有缺陷的版本,我们所有人浪费的时间就会减少。

与我们交谈!

我们有一个 在线聊天,您可以在其中提问或讨论功能;通过加入聊天并回答社区可能提出的任何问题来帮助我们。随时提出您自己的任何问题!

您可以如何支持我们

如果您没有时间直接为该项目做出贡献,您还可以通过收藏该存储库或 在 Twitter 上关注我们 来帮助我们。口碑对我们来说真的意义重大!

您还可以 在经济上支持我们

最后更新于 2024 年 6 月 5 日星期三上午 10:27:34 GMT