貢獻指南

歡迎來到 PrimeVue 貢獻指南，感謝您考慮貢獻。

簡介 #

PrimeVue 是一個廣受歡迎的 Vue UI 函式庫，由 PrimeTek 維護，PrimeTek 是一家以其為各種框架提供全面的 UI 元件而聞名的公司。 PrimeTek 致力於提供高品質、多功能且易於存取的 UI 元件，幫助開發人員更快地建構更好的應用程式。

開發設定

首先，從 GitHub 克隆 PrimeVue 儲存庫


git clone https://github.com/primefaces/primevue.git
cd primevue

然後在您的本機環境中的 http://localhost:3000/ 執行展示。


npm run setup
npm run dev

專案結構

PrimeVue 使用單一儲存庫架構，函式庫位於 packages 資料夾，而網站位於 apps/showcase。


- apps
  - showcase                // website
- packages
  - auto-import-resolver    // unplugin resolver
  - core                    // core api
  - icons                   // primeicons as sfc
  - metadata                // list of components and directives
  - nuxt-module             // module for nuxt    
  - primevue                // main package of components and directives
  - themes                  // presets of styled mode

需要協助 #

PrimeVue 是一個由社群驅動的專案，並由 PrimeTek 的專業知識和贊助支持，我們感謝您提供的任何幫助。以下是一些您可以貢獻的領域

問題分類

幫助我們管理問題，方法如下：

  • 重現回報的錯誤
  • 釐清問題描述
  • 為問題標記適當的標籤

傳送 Pull Requests

我們鼓勵您傳送 pull requests，特別是標記有 help-needed 標籤的問題。

社群支援

參與問題追蹤器、GitHub 討論區，以及 PrimeLand Discord 伺服器，來協助其他使用者。您的專業知識可以幫助其他人解決問題並改善他們使用 PrimeVue 的體驗。

重點 #

PrimeVue 有幾個附加元件，例如 UI Kit、Premium Templates 和 Blocks，它們依賴於設計令牌和樣式。任何核心結構的變更，例如新增新的 props、事件或更新設計令牌，都應與核心團隊溝通，以確保一致性和相容性。

溝通 #

加入 PrimeLand Discord 伺服器上的 Contributors 頻道，以聯繫 PrimeVue 工作人員和其他貢獻者。在此頻道中，您可以討論您想要貢獻的領域並接收回饋。此頻道開放給所有想要貢獻的人。

途徑 #

PrimeTek 提供一個包含貢獻者和核心團隊的組織結構

貢獻者角色

經過一段時間的頻繁貢獻後，會向社群成員提供貢獻者角色。平均而言，可能需要大約三個月，但確切的持續時間可能因個人投入程度而異。

提交者角色

如果貢獻者積極參與程式碼庫和 PR，他們的角色可能會升級為提交者級別，提供對 PrimeVue 程式碼庫的直接提交權限。

聘僱

PrimeTek 傾向於從開源提交者中聘僱團隊成員，因此當有職位空缺時，可能會向您提供全職職位。

好處 #

貢獻 PrimeVue 有幾個好處。參與開源專案將提升您的職業生涯，並開啟令人興奮的機會。貢獻者和提交者將列在我們的團隊頁面上。您將在開發人員社群中獲得顯著的曝光率，同時提升自己的專業能力。

您將被邀請加入 Discord 上的私人溝通頻道，以聯繫 PrimeTek。此外，貢獻者可以免費存取所有 PrimeVue 附加元件，如 Premium Templates、Blocks 和 UI Kit。

CLA #

當向社群成員提供貢獻者角色時，他們應簽署貢獻者授權協議 (CLA) 以用於法律目的。這有助於保護貢獻者和 PrimeTek。

PrimeVue 4.2.5 on Vue 3 by PrimeTek