GNU Health/貢獻

歡迎貢獻者！

GNU Health 是一個 FLOSS 專案，歡迎您為它貢獻力量。有幾種方法可以做到這一點，其中大多數不需要您知道如何編碼！

以使用者的母語提供 GNU Health 是成功的重要組成部分。您可以透過改進現有的翻譯或用自己的語言建立新的翻譯來提供幫助。翻譯 GNU Health 很容易，不需要技術知識，並且全部透過 Web 介面完成。檢視本地化頁面以瞭解有關該過程的更多詳細資訊。

華夏公益教科書上的 GNU Health 文件（您現在正在閱讀）並不完整，並且需要在每次 GNU Health 升級時進行調整或新增。

如果您不想編寫文件，您仍然可以透過將其翻譯成您的語言來做出貢獻，以便醫療保健專業人員更容易使用 GNU Health。

不幸的是，幾乎所有軟體都包含錯誤。雖然我們正在積極努力修復錯誤，以便您不必費心，但請務必報告您遇到的任何錯誤或異常。

報告錯誤不需要花費太多時間。它是透過 Savannah 完成的。

提示：為了更快地解決問題，請包括您執行以導致錯誤的步驟的描述，如果可能，請包括問題的螢幕截圖。但請注意：不要在螢幕截圖或描述中包含患者資訊！

GNU Health 主要是 Tryton 模組，使用的程式語言是 Python。程式碼託管在 Savannah 上，並使用 Mercurial 進行版本控制。

您可以透過匿名檢出獲取最新程式碼的副本

hg clone http://hg.savannah.gnu.org/hgweb/health/

編碼風格應遵循 Tryton 的指南，否則應遵循 Python 最佳實踐。

如果您要為您的中心安裝 GNU Health，您很可能會對其進行自定義以滿足您的特定需求。報告、訪問控制規則和檢視只是通常自定義的物件中的一部分。主要概念是不要編輯標準程式碼或模組，因為它們會在下次更新時被覆蓋，並且很可能最終導致系統崩潰。

自定義 GNU Health 以適應您的中心的推薦步驟是

建立您的模組：建議您為您的本地模組使用以下命名約定z_health_<modulename>. 例如，如果您的專案名為 catalina，您的本地模組名稱將為z_health_catalina. 這樣可以輕鬆檢測和區分您的模組與基本程式碼。您還可以輕鬆地按照模式備份它們。
繼承物件。
修改或建立新模型。

如果您建立了一個新的自定義欄位，您也應該使用z_<fieldname>命名約定。這避免了與官方版本未來的欄位名稱發生衝突。我們不會使用任何以z_.

在~/gnuhealth/tryton/server/modules下有一個名為local 的目錄。請將包含您專案自定義的本地模組放在此目錄下。使用這種方法時，可以確保更新過程不會覆蓋您的包。

此外，有時您可能希望包含來自 Tryton 或社群的另一個現有包。此本地模組目錄是放置它們的地方。

請注意，我們只能支援包含在每個 GNU Health HMIS 發行版中的那些包。

常規貢獻者對程式碼庫具有寫入許可權。但是，如果您剛開始，我們希望確保您的更改得到稽核。方法是開啟一個錯誤描述您修復的問題或您新增的功能，並將補丁附加到該錯誤報告。開發人員之一將稽核您的補丁，如果批准，則將其提交到主開發分支。