此GitHub操作安裝了Fonttools/Fontbakery字體項目質量保證工具,並在用戶指定的FilePath上執行該工具,作為遠程連續集成測試管道的一部分。該動作需要Python v3.8+ Runner環境。
在目錄路徑上創建YAML格式化的GitHub操作配置文件。源存儲庫中的.github/workflows 。請查看GitHub操作文檔,以獲取有關配置文件語法的詳細說明。
請注意:這些步驟要求在執行Fontbakery測試步驟或處於GIT版本控制下並將其推到遠程源存儲庫目錄路徑之前,請在CI工作流程中構建字體。下面的示例假設基於makefile的構建使用默認的make目標。使用您在項目中使用的方法自定義構建命令。
name : Font Bakery QA Tests
on : [push, pull_request]
jobs :
fontbakery :
runs-on : ubuntu-latest
name : Font Bakery QA tests # Customize to edit the string in your GitHub CI UI
steps :
- name : Check out source repository
uses : actions/checkout@v3
- name : Set up Python environment
uses : actions/setup-python@v4
with :
python-version : " 3.11 " # supports any Py3.6+ version available in Actions
- name : Build fonts
run : make # enter your build shell commands here
- name : fontbakery TTF checks
uses : f-actions/font-bakery@v3
with :
subcmd : " check-universal " # fontbakery sub-command
args : " --loglevel WARN " # optional, arguments to fontbakery
path : " path/to/*.ttf " # font path relative to root of repository
version : " latest " # optional, latest PyPI release is default
- name : fontbakery OTF checks
uses : f-actions/font-bakery@v3
with :
subcmd : " check-universal " # fontbakery sub-command
args : " --loglevel WARN " # optional, arguments to fontbakery
path : " path/to/*.otf " # font path relative to root of repository
version : " latest " # optional, latest PyPI release is default有關默認輸入和可選配置設置的詳細信息,請參見下面的輸入部分。
使用以下設置配置操作:
args可選的非路徑參數到Fontbakery可執行子命令。例如,這是可以設置日誌級別的位置。以下限制的設置報告了警告和更高級別的日誌級別:
args: "--loglevel WARN"
有關可用選項的詳細信息,請參見Fontbakery幫助菜單。
path強制使用字體文件的路徑。您可以在此路徑定義中使用通配符。
path: "path/to/*.ttf"
subcmd強制性Fontbakery子命令。這指定了在字體上執行的測試配置文件。
subcmd: "check-universal"
有關其他詳細信息,請參見fontbakery --help或Fontbakery文檔。
version請注意:如果您在此輸入字段中定義了Fontbakery <V0.9.0的安裝,則必須保留在此GitHub操作的v2分支上。我們引入了向後不兼容的更改,該更改將與Fontbakery版本的安裝<V.0.9.0截至v3.0.0 Action Release發行版。
可選的Fontbakery版本應用於測試。這支持PYPI發行和直接源存儲庫主分支安裝。
默認值:“最新” =最新的PYPI發行版。
選項:
"0.7.28" (此方法將Fontbakery軟件包固定在發行版號上) 沒有任何
Apache許可證,v2.0