Skip to content
type

GitHub Action

Install CNS11643 fonts

v1.1.0 Latest version

Install CNS11643 fonts

type

Install CNS11643 fonts

Install CNS11643 fonts

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Install CNS11643 fonts

uses: hms5232/[email protected]

Learn more about this action in hms5232/install-CNS11643-fonts-action

Choose a version

install-CNS11643-fonts-action

在 GitHub action 執行時安裝 CNS11643 全字庫字型,以利環境有正確的中文字型可用

需求

  • Ubuntu runner(已測試完成)

使用方式

簡易設定

最基本的設定方式:

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA

顯示 action name:

steps:
  - name: Install CNS11643 fonts
    uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA

指定安裝字型

在不指定的情況下,會安裝正楷體及正宋體。如果想指定要安裝的字型:

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA
    with:
      kai: 'true'  # 正楷體
      sung: 'true'  # 正宋體

※由於 GitHub action 的問題,目前還不支援輸入布林值,故請使用字串!詳見:actions/runner#1483
⚠️ 此問題在其他類型的 action 修復了,但在複合(composite)action 則還沒,詳細請見:actions/runner#2238

客製下載旗標(flag)

下載字型的工具是 wget,如果有 debug 或其他需求,可以使用 download-flag 參數指示 wget 輸出或行為。

預設情況:

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA
    with:
      download-flag: '-nv'  # 本 action 預設值,代表 no verbose

通常輸出(正常使用 wget 沒特別指定時):

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA
    with:
      download-flag: '-v'  # wget 預設值,代表 verbose

debug 輸出:

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA
    with:
      download-flag: '-d'  # 代表 debug

其他參數請見 wget 文件。

由於此參數為直接注入輸入指令中,請小心使用!

進階設定建議

細節請見各項設定的後方說明:

steps:
  - uses: hms5232/install-CNS11643-fonts-action@v1  # 依照需求設定版本號或是 SHA
    with:
      kai: 'true'  # 正楷體
      sung: 'true'  # 正宋體
    timeout-minutes: 10  # 因為是即時下載,為避免因為伺服器問題卡住流程或耗盡額度,建議設定一個執行時限。此範例為十分鐘
  # 下一個步驟
  - name: your next step
    if: always()  # 避免字型安裝失敗導致中斷流程

Release 策略

本專案依照語意化版本號(SemVer)更新版本號。

主版本號會切出分支管理,例如:v1;次版及修補版本號則使用 tag 功能,例如:v1.0.6

緣起

先前在 GitHub action 上執行一些測試時,偶然發現和 local 執行的結果不同。一查發現原來是在 runner 環境中沒有中文字型的關係,所以所有中文字的部分都變成了方框。上網找了半天也沒找到有比較快的解法,就使用之前寫過的快速安裝 shell 手稿,在開始測試之前先執行安裝就解決了。

雖然這個需求只要不要在 runner 中使用中文,換成英文就好了。但畢竟有一個解法在那邊,就想說動手做成一個可以重複使用的 composite action 給大家使用吧!如果也有出現和我相同需求的人,就可以省下時間去研究安裝中文字型的時間(另外還有很多人忽略的,很多字型都不是免費或是可以合法在這種狀況下使用的)結果就是在你們眼前的 repo,希望在這個問題上可以幫上忙。

額外說明

授權

Copyright © 2022 hms5232

本專案使用 Apache 2.0 開源許可證;而 CNS11643 相關使用規範請依照〈政府資料開放授權條款〉相關規定。