貢獻

感謝您為 cssnano 貢獻!我們 appreciate 任何貢獻,無論大小。如果您已為 cssnano 做出貢獻,我們建議您將自己添加到貢獻者列表中,該列表位於 CONTRIBUTORS.md 中。

我如何貢獻 cssnano 的程式碼?

從版本 4 開始,我們在一個 monorepo 中進行開發。這是因為許多轉換彼此重疊;一起測試它們更容易。除此之外,您需要安裝 Node.js、pnpm 和 git。然後,您可以運行以下命令來設置儲存庫

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

您可以使用以下命令運行測試

pnpm test

我們建議您在議題追蹤器中查找任何標記為 需要幫助 的內容;這是開始參與並編寫程式碼的第一個地方。如果您認為自己可以解決任何其他未解決的議題,請在討論串中發表評論,表達您的興趣。

如果您對某些功能有想法,但沒有追蹤它的議題,請在撰寫拉取請求之前開啟一個議題。我們發現在編寫任何程式碼之前討論您的需求會更有幫助。

為了幫助我們產生更新日誌,請在您的提交訊息中遵循 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

還有其他貢獻方式嗎?

當然!嘗試以下任何領域

改進我們的文件

如果您認為我們的文件中需要拼寫檢查、清理、額外的程式碼範例或可以以某種方式改進,請通過開啟一個詳細說明問題的議題來幫助我們。

使用 文件標籤 查找相關議題。

改進我們的議題

議題就像記錄專案的次要方法,如果議題缺少重現步驟,請通過與原作者協調以了解有關他們問題的更多詳細資訊來幫助我們。

找到錯誤來源後,您可以通過提交失敗的測試案例作為拉取請求來提供進一步的幫助。我們的許多測試都遵循簡單的 fixtureexpected 字串比較模式。

就議題發送回饋

對議題的回饋非常重要,它將決定 cssnano 的方向。請通過對您重要的議題,尤其是標記為「問題」的議題,提出建設性批評來幫助我們。

請注意,我們認為「+1」評論沒有太大幫助;請改用 GitHub 回應並訂閱討論串以獲取任何進展的通知。這有助於使我們的討論集中在手頭的主題上。

審查拉取請求

讓更多人關注即將推出的功能和修復非常重要。請通過審查拉取請求來提供幫助;即使留下豎起大拇指的回應也比什麼都不做要好。幫助我們進行審查意味著如果發佈了錯誤的版本,我們所有人浪費的時間都會減少。

與我們交談!

我們有一個 線上聊天室,您可以在其中提問或討論功能;通過加入聊天室來幫助我們,並回答社群可能提出的任何問題。歡迎提出您自己的任何問題!

您可以如何支持我們

如果您沒有時間直接為專案貢獻,您也可以通過為儲存庫加星標或 在 Twitter 上關注我們 來幫助我們。口碑對我們來說真的意義重大!

您也可以 在財務上支持我們

上次更新時間:2024 年 6 月 5 日星期三 格林威治標準時間 10:27:34