install CNS11643 fonts action下载 - install CNS11643 fonts action源码下载

install CNS11643 fonts action

字体下载

v1.1.0

下载

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，希望在这个问题上可以帮上忙。