AFDKO は、PostScript および TrueType フォント データから OpenType フォント ファイルを構築するためのツール セットです。
このリポジトリには、AFDKO を構成するコマンド ライン プログラムのデータ ファイル、Python スクリプト、ソースが含まれています。このプロジェクトでは、Apache 2.0 オープンソース ライセンスを使用します。 AFDKO は、requirements.txt ファイルにリストされているいくつかの依存関係を利用することに注意してください。これらの依存関係は、AFDKO をpip
でインストールすると自動的にインストールされます。これらの依存関係のほとんどは、MPL 2.0 であるtqdm
を除き、BSD または MIT ライセンスです。
パッケージに含まれる内容の詳細については、AFDKO の概要を参照してください。
参考資料や関連プロジェクトへのリンクなどの追加情報については、Wiki を参照してください。
psautohint の Python ポートは、「otfautohint」として AFDKO リポジトリに (再) 統合されました。
詳細については、docs/otfautohint_Notes.md を参照してください。
AFDKO には Python 3.9 以降が必要です。 3.9 以降のすべての Python で動作するはずですが、ツールチェーンのコンポーネントと依存関係が Python のメジャー リリースに追いついていない場合があり、追いつくまでに多少の遅れが生じる可能性があります。
リリースは Python Package Index (PyPI) で入手でき、pip を使用してインストールできます。
macOS ユーザーへの注意: システム Python を使用しないことをお勧めします。他の理由としては、macOS の一部のバージョンには Python 2 が同梱されており、AFDKO の最新バージョンは Python 3 でのみ利用可能です。Brew を使用して Python 3 を macOS にインストールする手順については、「Mac OS X への Python 3 のインストール」を参照してください。 : pyenv は、macOS に複数の Python バージョンをインストールして管理するための優れたツールです。
すべてのユーザーへの注意: 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
)、次に afdko の最上位ディレクトリにcd
て実行します。
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 またはシェル スクリプトで記述されたもの) でのみ使用されることを意図していました。言語)。この問題を回避するには (ソース ファイルを変更するときにライブ フィードバックを取得する必要がある少数のコア afdko 開発者にのみ影響します)、.pth ファイルや同様のハックを使用して PYTHONPATH をエクスポートするなどの代替方法を使用できます。詳細については、このコメントをお読みください。
AFDKO は、Python パッケージとしてインストールできるように再構築されました。ユーザーの Python インタープリターに依存するようになり、独自の Python インタープリターは含まれなくなりました。
ISとcheckoutlines の2 つのプログラムは、ソース コードをオープンソース化できなかったため、削除されました。これらのツールは、リリース バージョン 2.5.65322 以降で利用できます。
注記
古い AFDKO と新しい PyPI afdko パッケージをインストールすると、新しいバージョンのツールが古いバージョンよりも優先されます。これは、pip が afdko のパッケージ パスをシステムの PATH 環境変数の先頭に追加するのに対し、古いインストーラーは末尾に追加するために発生します。 PATH へのこの変更は、アンインストーラーによって元に戻されません。新しいバージョンへのパスを完全に削除したい場合は、PATH を編集する必要があります。 Mac では、これはログイン ファイル内の PATH 変数を設定する行を編集することを意味します。 Windows では、これはシステムのコントロール パネルで PATH 環境変数を編集することを意味します。