AFDKO 是一組用於從 PostScript 和 TrueType 字體資料建立 OpenType 字體檔案的工具。
該儲存庫包含資料檔案、Python 腳本以及構成 AFDKO 的命令列程式的原始程式碼。此專案使用 Apache 2.0 開源許可證。請注意,AFDKO 使用requirements.txt 檔案中列出的多個依賴項,如果您使用pip
安裝 AFDKO,這些依賴項將自動安裝。大多數依賴項都是 BSD 或 MIT 許可證, tqdm
除外,它是 MPL 2.0。
請參閱 AFDKO 概述,以了解軟體包中所含內容的更詳細說明。
請參閱 wiki 以了解更多信息,例如參考材料和相關項目的連結。
psautohint 的 Python 連接埠作為「otfautohint」(重新)整合到 AFDKO 儲存庫中
更多資訊可以在 docs/otfautohint_Notes.md 中找到
AFDKO 需要 Python 3.9 或更高版本。它應該適用於任何高於 3.9 的 Python,但有時工具鏈元件和依賴項無法與主要 Python 版本保持同步,因此在趕上時可能會有一些延遲時間。
版本可在 Python 套件索引 (PyPI) 上找到,並且可以使用 pip 安裝。
macOS 使用者註意:我們建議您不要使用系統 Python。除其他原因外,某些版本的macOS 隨附了Python 2,而最新版本的AFDKO 僅適用於Python 3。 Python 3。
所有使用者請注意:我們強烈建議使用 Python 虛擬環境 ( venv
) 並使用python -m pip install <package>
來安裝所有套件(而不僅僅是 AFDKO)。直接呼叫pip install
可能會導致呼叫錯誤的pip
,並且套件登陸到錯誤的位置。使用venv
+ python -m pip install
的組合有助於確保 pip 管理的套件放置在正確的位置。
Linux 使用者(以及 macOS 或 Windows 以外的其他平台的使用者)請注意:當您的平台沒有預先建置的「輪子」時, pip
將嘗試從原始程式碼建置套件的 C 和 C++ 部分。只有安裝了 C 和 C++ 開發工具以及 libuuid 時,此過程才會成功。請參閱下面的從原始碼建置。
選項 1(建議)
建立虛擬環境:
python -m venv afdko_env
啟動虛擬環境:
macOS 和 Linux
source afdko_env/bin/activate
視窗
afdko_env S cripts a ctivate.bat
安裝afdko:
python -m pip install afdko
在虛擬環境中安裝afdko可防止其相依性與全域安裝的其他模組之間發生衝突。
選項 2(不推薦,除非有全域衝突)
本機用戶安裝afdko(資訊):
python -m pip install --user afdko
使用-U
(或--upgrade
)選項將 afdko (及其依賴項)更新至最新的穩定版本:
python -m pip install -U afdko
若要取得預發布版本和開發中版本,請使用--pre
標誌:
python -m pip install -U afdko --pre
若要移除 afdko 軟體包,請使用以下命令:
python -m pip uninstall afdko
首先,您必須安裝適合您平台的開發工具。
在 macOS 上,使用以下命令安裝它們:
xcode-select --install
在 Linux(Ubuntu 17.10 LTS 或更高版本)上,使用以下命令安裝它們:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
在其他類似 POSIX 的作業系統上, libuuid
及其頭檔可能位於名為libuuid-devel
或util-linux-libs
的套件中。 libuuid
的原始碼維護在 util-linux 儲存庫中。
在 Windows 上,您需要 Visual Studio 2017 或更高版本。
若要從原始程式碼建置afdko ,請複製 afdko GitHub 儲存庫,確保安裝了wheel
模組( python -m pip install wheel
),然後cd
到 afdko 的頂級目錄,並運行:
python -m pip install .
如果您想使用 Xcode 開發和調試 AFDKO,請運行:
CMake -G Xcode .
有關從原始程式碼建置的更多信息,請參閱 docs/FDK_Build_Notes.md。
筆記
無法使用python -m pip install -e .
;這是因為該工具包包含 setup.py 嘗試安裝在 bin/(或 Scripts/)資料夾中的二進位 C 可執行文件,但是此過程僅適用於基於文字的腳本(用 Python 或 shell 腳本編寫)語言) 。要解決這個問題(這實際上只會影響少數核心 afdko 開發人員,他們在修改原始檔案時需要獲得即時回饋),您可以使用替代方法,例如匯出 PYTHONPATH、使用 .pth 檔案或類似的 hack。有關更多詳細信息,請閱讀此評論。
AFDKO 已經過重組,因此可以作為 Python 套件安裝。它現在依賴使用者的Python解釋器,並且不再包含自己的Python解釋器。
IS和checkoutlines這兩個程式因原始碼無法開源而被放棄。這些工具在 2.5.65322 及更早版本中可用。
筆記
如果您安裝舊版 AFDKO 以及新版 PyPI afdko 軟體包,則新版本中的工具將優先於舊版本。發生這種情況是因為 pip 將 afdko 的套件路徑添加到系統 PATH 環境變數的開頭,而舊安裝程式將其添加在末尾;卸載程式不會撤銷對 PATH 的此修改。如果您想完全刪除新版本的路徑,則必須編輯 PATH。在 Mac 上,這意味著編輯登入檔案中設定 PATH 變數的行。在 Windows 上,這意味著在系統的控制面板中編輯 PATH 環境變數。