Automatic Variants for GlotPress

外掛說明

這個 GlotPress 的擴充功能外掛可以自訂一組選取地區語言 (最上層地區語言/語言變體) 的預設行為，讓使用者將最上層地區語言中的已核准/目前譯文字串自動轉換至其變體語言。

這個外掛會使用 GlotPress 持續將最上層地區語言的譯文自動轉換並同步至其語言變體的譯文。

只有與最上層地區語言譯文不同的譯文，才會新增至變體語言譯文集。

變體語言中不需要轉換的字串會保持未翻譯的狀態，並改為使用最上層地區語言的譯文。

這個外掛主要受到塞爾維亞拉丁文從塞爾維亞斯拉夫文進行音譯解決方案的啟發。

外掛功能

• 篩選器 gp_automatic_variants_list 可以將語言變體新增至自動轉換的語言變體陣列。
• 篩選器 gp_automatic_variants_convert_{variant_locale} 可以處理變體語言的字串自動轉換。
• 檢查 GlotPress 的最低安裝需求。
• 檢查新增的地區語言是否為 GlotPress 支援的語言變體。
• 轉換最上層地區語言的目前譯文，並新增至變體語言的譯文集。
• 刪除不再使用的語言變體譯文，而不是保留已駁回的譯文、模糊翻譯譯文及前版譯文。
• 當最上層地區語言的新增譯文具備相同 original_id 則不進行轉換，並刪除語言變體的目前譯文。

安裝 GlotPress

1. 安裝並啟用 GlotPress 3.0.0-alpha。

2. 在 [外掛] 頁面中安裝並啟用這個外掛。

為 GlotPress 的自動語言變體進行組態

1. 使用篩選器 gp_automatic_variants_list 依據需求設定要自動轉換的語言變體：

   /**
    * Add my automatically converted variants.
    */
   function my_automatic_variants( $locales ) {
       $additional_locales = array(
           'ca-valencia',
           'pt-ao90',
           'ca-valencia',
           'en-gb',
           'de-at',
           'de-ch',
       );
       return array_merge( $locales, $additional_locales );
   }
   
   add_filter( 'gp_automatic_variants_list', 'my_automatic_variants' );
   

2. 使用篩選器 gp_automatic_variants_convert_{variant_locale} 將指定的地區語言加入至轉換程序中：

   語言變體 pt-ao90 的範例：

   /**
    * Actual conversion of the string.
    */
   function convert_translation( $translation ) {
       return do_something( $translation );
   }
   
   add_filter( 'gp_automatic_variants_convert_pt-ao90', 'convert_translation' );
   

   使用方式

3. 對全部的本地化專案來說，如常新增最上層地區語言及語言變體的譯文集即可。

4. 僅需為最上層地區語言進行本地化，然後查看譯文是否自動轉換至語言變體即可。

環境需求

• 支援語言變體的 GlotPress 3.0.0-alpha。