贡献
感谢您对 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
脚本,请不要忘记先重建包!
pnpm prepare
pnpm changeset publish
还有其他贡献方式吗?
当然!尝试以下任何领域
改进我们的文档
如果您认为我们的文档中需要拼写检查、澄清、添加代码示例或以某种方式改进,请通过打开一个详细说明问题的 issue 来帮助我们。
使用 documentation 标签 查找相关问题。
改进我们的问题
问题就像记录项目的辅助手段,如果问题缺少重现步骤,请帮助我们与原始作者协调,以了解有关其问题的更多详细信息。
找到错误的来源后,您可以通过提交失败的测试用例作为拉取请求来提供进一步的帮助。我们的许多测试遵循简单的 fixture
和 expected
字符串比较模式。
对问题提供反馈
对问题的反馈非常重要,并将塑造 cssnano 的方向。请帮助我们对对您来说重要的以及特别标记为“question”的问题提出建设性批评。
请注意,我们认为“+1”评论没有多大帮助;相反,请使用 GitHub 反应并订阅该主题以接收任何进度的通知。这有助于使我们的讨论集中在手头的话题上。
审查拉取请求
对即将推出的功能和修复进行更多关注非常重要。请通过审查拉取请求来提供帮助;即使留下一个点赞反应也比什么都不做要好。帮助我们进行审查意味着如果发布有缺陷的版本,我们所有人浪费的时间就会减少。
与我们交谈!
我们有一个 在线聊天,您可以在其中提问或讨论功能;通过加入聊天并回答社区可能提出的任何问题来帮助我们。随时提出您自己的任何问题!
您可以如何支持我们
如果您没有时间直接为该项目做出贡献,您还可以通过收藏该存储库或 在 Twitter 上关注我们 来帮助我们。口碑对我们来说真的意义重大!
您还可以 在经济上支持我们。
最后更新于 2024 年 6 月 5 日星期三上午 10:27:34 GMT