國際化貢獻
DataTables 的國際化外掛程式允許本地化 DataTables 的呈現層。目標一直是盡可能讓社群輕鬆提交 DataTables 的翻譯。多年來,許多貢獻者在 Github 上提交了 84 種不同語言的提取請求。如果您是這些貢獻者之一,我們想感謝您改進了 DataTables!然而,隨著時間的推移,DataTables 及其擴充套件添加了更多可配置的語言選項,這導致許多語言都未完成。
幾個月前,我們部署了一個新工具,允許人們在無需建立提取請求的情況下為國際化外掛程式做出貢獻。這個工具的易用性意味著許多新的提交已經完成,並且添加了幾個全新的翻譯。我們希望這個新工具以及這篇部落格文章能讓更多人更容易為 DataTables 做出貢獻並完成遺失的翻譯。
使用方式
新的國際化外掛程式工具提供了幾個不同的功能。
- 連結到特定語言的外掛程式頁面
- 每種語言的完成指示器
- 每種語言的編輯/新增表單
- 建立新語言的表單
我將在下面更詳細地介紹這些內容。
連結到特定語言的外掛程式頁面
這些位於 DataTable 的最左欄。它們連結到類似這樣的頁面,這些頁面提供了該語言外掛程式所需的完整 JSON,以及有關 CDN 和版本控制的可用性資訊。作者也會列在頁面頂端,以感謝他們的貢獻。
完成指示器
這簡單地指示了每種語言的翻譯檔案的完整程度。目標是讓盡可能多的檔案達到 100%!這是一種輕鬆查看哪些語言選項可以從社群獲得更多貢獻的方式。
編輯/新增至現有語言
在完成指示器的右側,有一個貢獻按鈕。這將打開一個表單,允許編輯或新增該語言的所有語言選項。
在左側,有一個選擇元素,允許使用者檢視任何待提交的變更。這允許使用者專注於翻譯尚未被其他人完成的選項。當然,如果您在待處理的翻譯中發現不準確之處,您可以提交自己的翻譯來取代它。
選擇元素後面是您姓名的輸入欄位。這不是必需的。這只是讓我們可以在相關頁面和 JSON 檔案中感謝您對 DataTables 的貢獻。
在左側,語言選項會與一個輸入元素一起列出,以獲取其值。當選擇輸入元素時,表單的右側將更新以提供有關語言選項的更多資訊。會顯示簡短描述以及預設值,如果適用,還會顯示一個圖片,以展示它在 DataTables 中的使用位置。
輸入所有翻譯後,只需按下表單右下角的編輯按鈕。我們會在批准它們用於外掛程式之前審核它們。
建立新語言
此表單與用於編輯/新增至目前語言的表單非常相似。語言選項與以前一樣列出,右側的資訊也相同。
此處唯一變更的是一個用於儲存語言名稱的輸入元素,以及另一個用於儲存此頁面上列出的 LCID 代碼的輸入元素。
新增您所能新增的所有翻譯後,按下右下角的建立按鈕,我們將在批准該語言及其選項之前進行審核。
授權
正如該工具上的表單中所述,透過該工具提交任何變更,即表示您同意根據DataTables 的 MIT 授權發佈任何變更。
摘要
我們希望這個工具對您有用,並讓您比以往更容易為 DataTables 做出貢獻,我們期待收到您的翻譯!
和往常一樣,如果您有任何可以改進此工具的想法,請聯絡我們或在下方留言。