外掛說明
為 GlotPress 新增 CSV 格式支援以匯出/匯入譯文及原文。
這個外掛能讓使用者將譯文集匯出至 CSV 檔案,並可以使用這個外掛將譯文或原文匯入至專案。
這個外掛已完成本地化準備。
CSV 格式
CSV 會輸出由 , (逗號) 分隔、" " 括起來的各個值。
資料列的數量取決於地區語言的複數型數量。
如需範例檔案,請參考 example.csv。
不同語言的譯文的標頭資料行使用 Translation (<plural-form>) 命名規範,複數型取決於每個匯出的地區語言。
請參考下方葡萄牙文的 CSV 匯出範例,其中有 2 種複數型。
匯出的 CSV (以純文字顯示)
"Context","Singular","Plural","Comments","References","Translation (Singular)","Translation (Plural)"
"","Singular in English.","","Comment 1.\nComment 2.","","Singular em Português.",""
主要資料行
5 個主要資料行分別是 Context、Singular、Plural、Comments 及 References。
複數型變數資料行
複數型資料行數量會依據每個地區語言的設定而有所不同。
請參考 GlotPress 地區語言的範例表格中的 1 至 6 複數型。
外掛內建的篩選器
gp_format_csv_header 能讓使用者新增、移除或自訂 CSV 標頭中的項目。
gp_format_csv_row 能讓使用者新增、移除或自訂 CSV 資料列中的項目。
使用方式
將譯文匯出為 CSV 格式檔案
- 前往譯文表格的底部。
- 選取
CSV (.csv)。 - 點擊
[匯出]連結以下載 CSV 檔案。
從 CSV 格式檔案匯入譯文
- 前往譯文表格的底部。
- 點擊
[匯入譯文]連結。 - 選取要上傳的 CSV 檔案,
[檔案格式]請選取 [自動偵測]。 - 點擊
[匯入]按鈕。
從 CSV 格式檔案匯入原文
- 前往專案頁面。
- 在 [專案可用操作] 中點擊
[匯入原文]連結。 - 選取要上傳的 CSV 檔案,
[檔案格式]請選取 [自動偵測]。 - 點擊
[匯入]按鈕。
常見問題集
-
如何將這個外掛本地化為使用者的母語?
-
如果有使用者要將這個外掛本地化為母語介面,請前往這個外掛的本地化專案頁面。
-
如何參與這個外掛開發專案?
-
非常歡迎前往這個外掛的 GitHub 存放庫回報問題或提出功能建議。
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
Unreleased
- Tested with WordPress 6.8.
1.0.3
- Require WP 5.1.
- Tested with WordPress 6.6.
- Tested with GlotPress 4.0.1.
- Tested with PHP 8.3.
- Removed Git Updater forbiden plugin header.
- Fix docblock type param.
- Update dependencies.
1.0.2
- Tested with WordPress 6.5.
- Tested with GlotPress 4.0.
- Tested with PHP 8.3.
- Add WP Plugin Check CI test.
- Update dependencies.
1.0.1
- Fix log error message typo. Props @fxbenard.
1.0.0
- Initial release.
- All WPCS and PHPStan level 9 verified.
