trmnl-i18n 0.1.0 → 0.3.0

data/lib/trmnl/i18n/locales/web_ui/zh-HK.yml

@@ -1,9 +1,10 @@
+---
 zh-HK:
-  # global, logged out, and auth-related
+  locale_name: Chinese (Hong Kong)
   add: 加入
   add_new: 新增
-  ago: 前 # example: "Created 5 mins ago"
-  already_have_account: 我已經有帳戶 # signup form cta
+  ago: 前
+  already_have_account: 我已經有帳戶
   back: 返回
   back_to_all_blog_posts: 返回所有貼文
   blog: 網誌
@@ -11,15 +12,15 @@ zh-HK:
   cancel: 取消
   change_password: 更改密碼
   charge_level: 充電狀態
-  charged: 已充電
+  charged: 電量
   close: 關閉
   confirm_change_password: 更改密碼
   confirm_password: 確認新密碼
   copy: 複製
   copied_to_clipboard: 已複製！
   copy_to_clipboard: 複製至剪貼簿
-  created: 新增於 # example: "Created 5 mins ago"
-  create_an_account: 新增帳戶 # login form cta
+  created: 新增於
+  create_an_account: 新增帳戶
   current_device: 現時裝置
   days: 日
   delete: 刪除
@@ -28,10 +29,10 @@ zh-HK:
   edit: 設定
   email_address: 電郵地址
   export: 匯出
-  fetching: 載入中 # for asynchronous content requests; this message may appear as a placeholder text for 0-2 seconds
+  fetching: 載入中
   first_name: 名字
-  forgot_password: 忘記密碼 # login form link
-  forgot_password_title: 再次輸入 # heading on /password/new (hint: https://www.google.com/search?q=here+we+go+again+meme)
+  forgot_password: 忘記密碼
+  forgot_password_title: 再次輸入
   get_started: 讓我們開始吧！
   identify: 識別
   import: 匯入
@@ -40,37 +41,45 @@ zh-HK:
   keep_me_signed_in: 保持登入狀態
   knowledge_base: 知識庫
   last_name: 姓氏
+  learn_more: Learn more
   loading: 載入中
   login: 登入
   log_out: 登出
-  minimum_characters: 字元（最少） # ex: 8 characters minimum
-  mins: 分鐘 # 'minutes' abbreviation
-  my_playlist: 我的播放清單 # default name for a new playlist group
+  minimum_characters: 字元（最少）
+  mins: 分鐘
+  my_playlist: 我的播放清單
   new_password: 新密碼
   password: 密碼
-  please_wait: 請稍候⋯ # similar to "Fetching", but shown after a long process button click vs on page-load
+  please_wait: 請稍候⋯
   plugin_not_found: 找不到外掛
-  refresh_rates_hint: "__按此__了解重新整理頻率如何運作。"
+  refresh_rates_hint: __按此__了解重新整理頻率如何運作。
   reset_password: 重設密碼
   save: 儲存
   section: 章節
-  sign_in: 登入 # login form cta
-  sign_up: 註冊 # logged out navigation
+  sign_in: 登入
+  sign_up: 註冊
   something_went_wrong: 發生錯誤
-  support: 支援 # bottom navigation tab, links to help center
+  tech_support: 支援
   update: 更新
   view: 查看
-  welcome: 歡迎 # login form heading
-
-  # views by resource (device, plugins, playlists, account, etc)
+  welcome: 歡迎
+  time:
+    formats:
+      shorter: "%-I:%M %p"
+    start_of_week: 0
   account:
     index:
       title: 帳戶
       tagline: 管理帳戶設定
+      api_key_confirm: Are you sure you want to regenerate your API Key? The old key will be invalidated.
+      api_key_hint: See __the docs__ to learn how to configure your local environment.
+      api_key_label: The credential for authenticating local development tools
+      api_key_reset: Regenerate
+      api_key: API Key
       email_address: 電郵地址
       refer_and_earn: 推薦回贈計劃
       refer_and_earn_hint: 使用專屬優惠券與分享TRMNL。每次使用都可賺取收入，按月支付。
-      refer_and_earn_redemptions: 兌換次數 # how many times this coupon has been used
+      refer_and_earn_redemptions: 兌換次數
       refer_and_earn_request_code: 索取推薦碼
       device_invoice: 裝置發票
       device_invoice_label: 下載商業文件以作會計用途。
@@ -80,7 +89,7 @@ zh-HK:
       last_name_hint: 可讓TRMNL介面更舒適。
       password_hint: 用於保護你的TRMNL帳戶。
       enable_2fa: 啟用雙重驗證(2FA)？
-      enable_2fa_hint: "__按此__啟用OTP。"
+      enable_2fa_hint: __按此__啟用OTP。
       disable_2fa: 停用雙重驗證(2FA)
       disable_2fa_hint: 如要停用，請提供有效的單次密碼(OTP)，並在上方輸入現時密碼。
       session: 登入狀態
@@ -89,78 +98,91 @@ zh-HK:
       time_zone_hint: 用於判斷重新整理頻率及裝置睡眠時間。
       locale: 地區設定
       locale_hint: 你希望使用哪一種語言？ __按此了解更多__。
-
-    # toast messages
     update:
       success: 成功更新個人資料
+    reset_api_key:
+      success: API key was regenerated successfully
   dashboard:
     index:
       title: 儀表板
-      morning_salutation: 早晨
-      afternoon_salutation: 午安
-      evening_salutation: 晚安
       last_7_days: 過去7日
       last_30_days: 過去30日
       last_90_days: 過去90日
       today: 今日
       yesterday: 昨日
-    health: # partial (widget)
+    health:
       bad: 外掛出現問題
       good: 外掛運作正常
       next_steps: 當有變更時，我們會通知你
-    news: # partial (widget)
+    news:
       title: 新聞
       cta: 查看所有
-    playlists: # partial (widget)
+    playlist_items:
       title: 播放清單
       cta: 編輯播放清單
       pieces_of_content_displayed: 顯示畫面數量
-    plugins: # partial (widget)
+    plugins:
       title: 外掛功能
       cta: 前往外掛列表
       connected: 已連接外掛
       new_and_popular: 最新及熱門項目
     shop:
       title: 商店
-    time_saved: # partial (widget)
+    time_saved:
       title: 已節省時間
       cta: 詳情
+    welcome_message:
+      morning_salutation: 早晨
+      afternoon_salutation: 午安
+      evening_salutation: 晚安
   devices:
     edit:
-      accepts_beta_firmware: 韌體搶先發佈 # true/false toggle to receive new device updates before regular users
+      accepts_beta_firmware: 韌體搶先發佈
       accepts_beta_firmware_hint: 啟用設定後，你會在其他用戶之前取得最新的硬件韌體改進。
       back_to_devices: 返回裝置
       battery_consumption: 電池消耗
       battery_consumption_hint: 啟用「睡眠模式」可節省電量，並延長電池續航時間。
-      developer_perks: 開發者福利 # heading; below this is a list of options for devices with (paid) Developer edition add-on
+      developer_perks: 開發者福利
       developer_perks_hint: 以下選項需要購買「__開發者版本__」。.
       device_credentials: 裝置認證
-      device_credentials_hint: "__按此__了解如何使用裝置認證"
+      device_credentials_hint: __按此__了解如何使用裝置認證
       device_name: 裝置名稱
       device_name_hint: 此名稱可讓TRMNL介面更舒適
+      device_model: Device Model
+      device_model_hint: Your hardware Model
+      device_model_switch_warning: This is a dangerous operation, learn more __here__
       edit_device: 編輯裝置
+      guest_mode: Guest Mode
+      guest_mode_hint: Choose what to display (and for how long) whenever guest mode is enabled.
+      guest_mode_item_placeholder: Choose an item
+      guest_mode_duration_placeholder: Choose a duration
       identify: 識別
       identify_device: 識別裝置
       identify_device_hint: 按下按鈕後，裝置會顯示識別畫面。
       logs: 除錯記錄
       logs_hint: 提供即時串流的原始錯誤記錄，以偵錯你的裝置或外掛。
+      low_battery_email_notification: Low Battery Email Notification
       mirror: 鏡像共享
       mirror_device: 鏡像共享另一部裝置
       mirror_device_hint: 輸入可共享(shareable)裝置的ID，以鏡像共享其播放清單。你的播放清單仍然會顯示。
-      ota_enabled: 已啟用自動更新
+      mirror_stop: Disconnect Mirroring
+      mirror_sync: Sync Screens
+      ota_enabled: 啟用自動更新
       ota_enabled_hint: 自動安裝新的韌體。如要使用自訂韌體，請關閉此設定。
       sleep_mode: 睡眠模式
       sleep_mode_hint: 調整重新整理頻率，以提升專注度及電池續航時間。
       sleep_screen: 睡眠畫面
       special_function: 特別功能
       special_function_hint: 按兩下裝置背面的按鈕時，會執行特別功能。
-      special_function_learn_more: "__按此__了解特別功能。"
+      special_function_learn_more: __按此__了解特別功能。
       unlink: 取消連結
+      unlink_confirm: Are you sure? This will delete all underlying plugin settings and playlist items, so the device can be added to another account.
       unlink_device: 取消連結裝置
       unlink_device_hint: 如要安全地轉售或轉讓TRMNL裝置，請先取消連結。
+      unlink_device_learn_more: Follow the full guide __here__.
       visibility: 共享狀態
       visibility_hint: 讓其他TRMNL裝置可鏡像共享此裝置的內容。
-      your_device: 你的TRMNL裝置
+      your_device: 你的TRMNL
     index:
       title: 裝置
       tagline: 你的TRMNL裝置
@@ -170,8 +192,6 @@ zh-HK:
       title: 新增裝置
       description: 輸入裝置ID以新增TRMNL裝置到你的帳戶。
       add_device: 新增裝置
-
-    # toast messages
     associate:
       error: 連結裝置時發生錯誤
       success: 成功連結裝置
@@ -201,12 +221,14 @@ zh-HK:
       title: 除錯記錄
       all: 所有
       device: 裝置
-      dump: 內容 # content
+      dump: 內容
       id: ID
       private_plugins: 客製外掛
       source: 來源
       time: 時間
   markups:
+    console_logs:
+      js_logs: JS Logs
     form:
       back_to_plugin_settings: 返回外掛設定
       design_system: 活用我們的原生設計系統
@@ -218,14 +240,17 @@ zh-HK:
       edit_markup_without_preview: 編輯標記碼（略過預覽）
       error_rendering_markup: 轉譯標記碼時發生錯誤
       fix_indentation: 修復縮排
+      go_to_preview: Go To Preview
       live_preview: 即時預覽
       no_changes_to_save: 沒有變更可儲存
+      pop_out_preview: Pop Out Preview
       quickstart_examples: 快速入門範例
       quickstart_example_applied: 已套用！
       quickstart_use_this_example: 套用此範例
       revert: 還原
       revert_confirm: 確定要還原嗎？所有未儲存的變更將會消失。
       save_changes: 儲存變更 (⌘﹢S)
+      separate_preview: Preview is open in a separate window
     merge_variables:
       your_variables: 變數
     no_merge_variables:
@@ -246,36 +271,53 @@ zh-HK:
       error: OTP錯誤
     verify_otp:
       verify: 驗證
+      reset: Reset MFA
+      reset_instructions: Click the button on the back of your TRMNL to generate a reset code
       success: 雙重驗證成功
       error: OTP錯誤
-  playlists:
+  playlist_items:
     index:
       title: 播放清單
       tagline: 選擇此裝置上顯示的畫面
-      add_a_group: 加入群組
+      add_a_group: 新增群組
       add_a_plugin: 加入外掛
       add_first_device_cta: 請先__新增__TRMNL裝置！
       add_to_playlist: 加入至播放清單
       create_first_playlist_cta: 請先__連接__第一個外掛功能，方可新增播放清單！
-      custom: Custom
-      device_default: Device default
+      custom: 自訂
+      device_default: 裝置預設
       display_period_from: 顯示時間
       display_period_to: 至
-      display_period_validation: Start time must be before end time. Create another group to span overnight hours.
-      every: every
-    playlist: # partial (single item)
+      display_period_validation: 開始時間必須早於結束時間。如要跨越午夜，請新增另一個群組。
+      every: 頻率
+      never_skip: Never skip screens
+      smart_playlist: Smart Playlist
+      smart_playlist_hint: Automatically skip screens whose contents haven't changed in a while.
+      skip_after:
+        one: Skip stale screens after 1 day
+        other: Skip stale screens after %{count} days
+    playlist_item:
+      adjust_schedule: Adjust schedule
       delete: 確定要移除此項目嗎？外掛會保持連接，只是不會在裝置上顯示。
       displayed_now: 正在顯示
       not_displayed_yet: 待處理
       remove_from_playlist: 從播放清單中移除
-
-    # toast messages
+      hide_playlist: Hide this item
+      show_playlist: Show this item
     create:
       error: 更新播放清單時發生錯誤
       success: 已更新播放清單
     destroy:
       error: 移除外掛時發生錯誤
       success: 已從播放清單移除外掛
+    toggle_visibility:
+      success: Playlist item %{change}
+    duplicate:
+      success: Playlist duplicated
+    sort:
+      success: Playlist order updated
+    set_preferences:
+      success: Smart playlist preference updated
     update:
       success: 已更新播放清單順序
   plugins:
@@ -284,9 +326,9 @@ zh-HK:
       tagline: 你會在TRMNL上顯示什麼？
       available: 可使用
       connected: 已連接
-      recipes: 模板(Recipe) # recipe doesn't tranlate well in zh-HK, using 'template' instead
+      recipes: 模板(Recipe)
       recipes_hint: 社群用戶開發的客製外掛，一鍵即可安裝。 __了解更多__
-    search: # partial (search box)
+    search:
       placeholder: 搜尋外掛
     my:
       index:
@@ -302,18 +344,23 @@ zh-HK:
       tagline: 其他用戶將可以安裝此外掛。
       name: 名稱
       category: 類別
+      category_hint: Hold cmd or ctrl to choose up to 3
+      refresh_every: Supported Refresh Interval
+      refresh_every_hint: The fastest refresh interval your plugin can support.
       description: 描述
       description_hint: 最多50個字元
       icon: 圖示
-      icon_hint: 建議使用40×40像素
+      icon_hint: 建議使用512x512像素
       installation_url: 安裝網址
-      installation_url_hint: "__按此__了解安裝流程。"
+      installation_url_hint: __按此__了解安裝流程。
       installation_success_webhook_url: 安裝成功Webhook網址
       knowledge_base_url: 知識庫網址
       management_url: 管理網址
-      management_url_hint: "__按此__了解管理流程。"
+      management_url_hint: __按此__了解管理流程。
       markup_url: 標記碼(Markup)網址
-      markup_url_hint: "__按此__了解畫面生成方式。"
+      markup_url_hint: __按此__了解畫面生成方式。
+      no_screen_padding: No Screen Padding
+      no_screen_padding_hint: Removes the outermost padding in fullscreen mode.
       uninstallation_webhook_url: 解除安裝Webhook網址
     edit:
       title: 編輯外掛
@@ -321,7 +368,13 @@ zh-HK:
       name: 名稱
       description: 描述
   plugin_recipes:
-    connected: Recipe connected
+    connected: 已連接模板
+    connections:
+      one: Connection
+      other: Connections
+    forks:
+      one: Fork
+      other: Forks
     new:
       error: 找不到模板
   plugin_settings:
@@ -330,14 +383,20 @@ zh-HK:
     delete_are_you_sure: 確定要刪除此設定嗎？
     delete: 這樣會完全移除此外掛的設定。如要只從你的裝置隱藏此外掛，請從播放清單將其移除。
     inactive: 停用
-    no_plugin_settings_found: 找不到外掛設定。 # empty state - should not appear
+    no_plugin_settings_found: 找不到外掛設定。
     refreshing_now_please_wait: 正在重新整理，請在幾秒鐘後重新載入此頁面。
     reset_credentials: 成功重設「%{plugin_name}」帳戶
     form:
       active_hint: 在你的裝置上顯示或隱藏此外掛
+      advanced_settings: Advanced Settings
       back_to_plugin: 返回%{plugin}
       back_to_plugins: 返回外掛列表
       connect_with: 連接%{plugin}
+      debug_logs: Debug Logs
+      debug_logs_click_here: Click here
+      debug_logs_click_here_hint: to enable debug logs for this plugin instance.
+      debug_logs_enabled: Debug logs enabled for %{hours} hours.
+      debug_logs_enabled_link: View logs
       disconnect_account: 中斷連接帳戶
       manage_plugin: 設定%{plugin}
       force_refresh: 強制重新整理
@@ -345,6 +404,11 @@ zh-HK:
       force_refresh_click_here: 按此
       force_refresh_click_here_hint: 立即生成新的畫面
       learn_more: 前往知識庫以了解此外掛
+      learn_more_fork: This plugin was forked from a Recipe.
+      learn_more_fork_original: See Original
+      learn_more_recipe_author: Need help? Contact %{recipe_author} on Discord.
+      learn_more_recipe_long: This plugin is a community Recipe and is not maintained by TRMNL.
+      learn_more_recipe_short: 'Note: this plugin is a Recipe.'
       linked_account: 已連結帳戶
       linked_account_success: 成功連接%{plugin_name}
       link_oauth: 連接帳戶
@@ -355,24 +419,30 @@ zh-HK:
       plugin_uuid: 外掛UUID
       plugin_uuid_hint: 用於發送Webhook API請求。
       preview: 預覽圖（裝置會顯示實際資料）
+      recipe_cta_heading_published: This plugin is a Recipe
+      recipe_cta_heading_in_review: Recipe in review
+      recipe_cta_heading_not_published: Publish as a Recipe?
+      recipe_cta_body_published: Changes will be reflected on existing installs and future installs/forks.
+      recipe_cta_body_in_review: This plugin has been submitted to our team. Stand by.
+      recipe_cta_body_not_published: Submit this plugin for others to install. __Learn more__.
+      recipe_cta_confirm: Are you sure? Our team will review and get back to you within a couple days. You may continue making changes.
       refresh_rate: 重新整理頻率
       refresh_rate_hint: 設定此外掛每隔多久後擷取新資料。
       refreshed: 已重新整理
       remove_plugin: 移除外掛
       remove_plugin_hint: 移除外掛後，亦會從你的播放清單中移除
       synced: 已同步
-      refresh_paused: Refresh Paused
-      refresh_paused_hint: Auto-refresh is paused. Add to playlist to start again.
-      refresh_paused_mashup: Refreshing Mashups
-      refresh_paused_mashup_hint: Auto-refresh paused for fullscreen. Mashups are updating.
+      refresh_paused: 已暫停更新
+      refresh_paused_hint: 自動更新已暫停，請加入至播放清單以重新開始。
+      refresh_paused_mashup: 只更新混搭畫面
+      refresh_paused_mashup_hint: 已暫停全螢幕的自動更新，混搭畫面(Mashup)仍會更新。
+      refresh_stopped: Auto-refresh stopped. Please fix the plugin error to continue.
       visit_docs: 前往文件
     import:
       archive_too_large: ZIP檔案太大（最多%{max_mb} MB）
       missing_entry: ZIP檔案未包含「%{filename}」
-      entry_too_large: 「%{filename}」太大
-      malformed: 「%{filename}」格式不符
-
-    # toast messages
+      entry_too_large: "「%{filename}」太大"
+      malformed: "「%{filename}」格式不符"
     create:
       success: 已新增外掛，並加入至你的
       playlist: 播放清單
@@ -383,17 +453,29 @@ zh-HK:
       success: 成功更新外掛設定
     add_to_playlist:
       success: 外掛已加入至播放清單
-
   referral_code:
     create:
       request_received: 已收到請求，請查看收件箱
+  recipes:
+    index:
+      newest_to_oldest: Newest to Oldest
+      oldest_to_newest: Oldest to Newest
+      most_popular: Most Popular
+      install: Install
+      fork: Fork
+  schedules:
+    form:
+      add: Add a custom schedule
+      append: And during…
+      no_schedule: This screen will be shown at all times.
+      some_schedule: Only show this screen during…
+      to: to
+      copy_prompt: Copy schedule from…
   upgrade:
     index:
       title: 升級裝置：
       tagline: 解鎖自訂外掛及__更多__功能。
-      pay: 付款 # button text; ex "Pay $20"
+      pay: 付款
       error: 裝置「%{device_name}」已經升級，請切換至另一部裝置
-
-    # toast messages
     confirm:
       success: 已啟用開發者版本附加元件

data/lib/trmnl/i18n/synchronization/processor.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "cogger"
+require "refinements"
+require "yaml"
+
+require_relative "value_reducer"
+
+module TRMNL
+  module I18n
+    module Synchronization
+      # Copies new key/value pairs from the source locale (typically 'en') to destination locales.
+      class Processor
+        using Refinements::Hash
+
+        def initialize repository, reducer: ValueReducer, logger: Cogger.new(id: "trmnl-i18n")
+          @repository = repository
+          @reducer = reducer
+          @logger = logger
+        end
+
+        def call source_locale = "en"
+          repository.locales.each do |destination_locale|
+            log_info "Syncing #{repository.name}/#{destination_locale}..."
+
+            destination_root = repository.load destination_locale
+            result = add_missing_contents source_locale, destination_locale, destination_root
+
+            repository.save destination_locale, result
+          end
+        end
+
+        private
+
+        attr_reader :repository, :reducer, :logger
+
+        def log_info(message) = logger.info { message }
+
+        # :reek:FeatureEnvy
+        def add_missing_contents source_locale, destination_locale, destination_root
+          destination_contents = destination_root[destination_locale]
+          contents_to_merge = reduce source_locale, destination_locale
+          destination_root[destination_locale] = contents_to_merge.deep_merge destination_contents
+          destination_root
+        end
+
+        # :reek:ControlParameter
+        def reduce source_locale, destination_locale
+          repository.load(source_locale)[source_locale].then do |contents|
+            destination_locale == "raw" ? reducer.call(contents) : contents
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/i18n/synchronization/repo.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "refinements"
+require "yaml"
+
+module TRMNL
+  module I18n
+    module Synchronization
+      # Represents a directory containing YAML files named "{locale}.yml"
+      class Repo
+        using Refinements::Pathname
+
+        def self.all
+          Pathname(__dir__).join("../locales")
+                           .directories
+                           .map { |directory| new directory }
+        end
+
+        def initialize directory
+          @directory = Pathname directory
+        end
+
+        def name = directory.name.to_s
+
+        def load(locale) = YAML.load_file locale_path(locale)
+
+        def save locale, data
+          locale_path(locale).open "w" do |file|
+            Psych.dump data, file, indentation: 2, line_width: -1
+          end
+        end
+
+        def locales = directory.files("*.yml").map { |path| path.name.to_s }
+
+        private
+
+        attr_reader :directory
+
+        def locale_path(locale) = directory.join "#{locale}.yml"
+      end
+    end
+  end
+end

data/lib/trmnl/i18n/synchronization/value_reducer.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module I18n
+    module Synchronization
+      # Reduces a nested structure into key/value pairs with flattened values.
+      ValueReducer = lambda do |initial_value, path = ""|
+        case initial_value
+          when Array
+            initial_value.map.with_index do |item, index|
+              ValueReducer.call item, "#{path}[#{index}]"
+            end
+          when Hash
+            initial_value.each.with_object({}) do |(key, value), result|
+              next_path = path.empty? ? key : "#{path}.#{key}"
+              result[key] = ValueReducer.call value, next_path
+            end
+          else path
+        end
+      end
+    end
+  end
+end

data/trmnl-i18n.gemspec

@@ -2,9 +2,9 @@
 
 Gem::Specification.new do |spec|
   spec.name = "trmnl-i18n"
-  spec.version = "0.1.0"
-  spec.authors = ["Brooke Kuhlmann"]
-  spec.email = ["brooke@alchemists.io"]
+  spec.version = "0.3.0"
+  spec.authors = ["TRMNL"]
+  spec.email = ["engineering@usetrmnl.com"]
   spec.homepage = "https://github.com/usetrmnl/trmnl-i18n"
   spec.summary = "A collection of TRMNL locales."
   spec.license = "MIT"