afdko
4.0.2
Bei AFDKO handelt es sich um eine Reihe von Tools zum Erstellen von OpenType-Schriftartendateien aus PostScript- und TrueType-Schriftartendaten.
Dieses Repository enthält die Datendateien, Python-Skripte und Quellen für die Befehlszeilenprogramme, aus denen AFDKO besteht. Das Projekt verwendet die Apache 2.0 Open Source-Lizenz. Bitte beachten Sie, dass AFDKO mehrere Abhängigkeiten nutzt, die in der Datei „requirements.txt“ aufgeführt sind und automatisch installiert werden, wenn Sie AFDKO mit pip installieren. Bei den meisten dieser Abhängigkeiten handelt es sich um BSD- oder MIT-Lizenzen, mit Ausnahme von tqdm , bei dem es sich um MPL 2.0 handelt.
Eine detailliertere Beschreibung dessen, was im Paket enthalten ist, finden Sie in der AFDKO-Übersicht.
Weitere Informationen, z. B. Links zu Referenzmaterialien und verwandten Projekten, finden Sie im Wiki.
Die Python-Portierung von psautohint wurde als „otfautohint“ (wieder) in das AFDKO-Repository integriert.
Weitere Informationen finden Sie in docs/otfautohint_Notes.md
Für den AFDKO ist Python 3.9 oder höher erforderlich. Es sollte mit jedem Python > 3.9 funktionieren, aber gelegentlich halten Toolchain-Komponenten und -Abhängigkeiten nicht mit den größeren Python-Releases Schritt, sodass es zu einer gewissen Verzögerung beim Aufholen kommen kann.
Releases sind im Python Package Index (PyPI) verfügbar und können mit pip installiert werden.
Hinweis für macOS-Benutzer: Wir empfehlen, nicht das System Python zu verwenden. Unter anderem werden einige Versionen von macOS mit Python 2 ausgeliefert und die neueste Version von AFDKO ist nur für Python 3 verfügbar. Anweisungen zur Verwendung von Brew zur Installation von Python 3 unter macOS finden Sie hier: Python 3 unter Mac OS X installieren. Außerdem :pyenv ist ein großartiges Tool zum Installieren und Verwalten mehrerer Python-Versionen unter macOS.
Hinweis für alle Benutzer: Wir empfehlen DRINGEND die Verwendung einer virtuellen Python-Umgebung ( venv ) und die Verwendung von python -m pip install <package> um alle Pakete zu installieren (nicht nur AFDKO). Der direkte Aufruf pip install kann dazu führen, dass der falsche pip aufgerufen wird und das Paket am falschen Speicherort landet. Die Kombination aus der Verwendung einer venv + python -m pip install trägt dazu bei, sicherzustellen, dass pip-verwaltete Pakete an der richtigen Stelle landen.
Hinweis für Linux-Benutzer (und Benutzer anderer Plattformen, die nicht macOS oder Windows sind): Wenn es kein vorgefertigtes „Rad“ für Ihre Plattform gibt, versucht pip , die C- und C++-Teile des Pakets aus dem Quellcode zu erstellen. Dieser Vorgang ist nur erfolgreich, wenn sowohl die C- und C++-Entwicklungstools als auch libuuid installiert sind. Siehe Build aus dem Quellcode unten.
Option 1 (empfohlen)
Erstellen Sie eine virtuelle Umgebung:
python -m venv afdko_envAktivieren Sie die virtuelle Umgebung:
macOS und Linux
source afdko_env/bin/activateWindows
afdko_env S cripts a ctivate.batafdko installieren:
python -m pip install afdkoDie Installation des afdko in einer virtuellen Umgebung verhindert Konflikte zwischen seinen Abhängigkeiten und anderen global installierten Modulen.
Option 2 (nicht empfohlen, es sei denn, es liegt ein globaler Konflikt vor)
Lokale Benutzerinstallation afdko (Info):
python -m pip install --user afdko
Verwenden Sie die Option -U (oder --upgrade ), um den afdko (und seine Abhängigkeiten) auf die neueste stabile Version zu aktualisieren:
python -m pip install -U afdko
Um Vorabversionen und in der Entwicklung befindliche Versionen zu erhalten, verwenden Sie das Flag --pre :
python -m pip install -U afdko --pre
Um das afdko-Paket zu entfernen, verwenden Sie den folgenden Befehl:
python -m pip uninstall afdko
Zunächst müssen Sie die Entwicklungstools für Ihre Plattform installiert haben.
Installieren Sie diese unter macOS mit:
xcode-select --install
Installieren Sie diese unter Linux (Ubuntu 17.10 LTS oder höher) mit:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
Auf anderen POSIX-ähnlichen Betriebssystemen befinden sich libuuid und seine Header-Dateien möglicherweise in einem Paket mit dem Namen libuuid-devel oder util-linux-libs . Der Quellcode für libuuid wird im util-linux-Repository verwaltet.
Unter Windows benötigen Sie Visual Studio 2017 oder höher.
Um den afdko aus dem Quellcode zu erstellen, klonen Sie das afdko-GitHub-Repository, stellen Sie sicher, dass das wheel Modul installiert ist ( python -m pip install wheel ), wechseln Sie dann cd in das oberste Verzeichnis des afdko und führen Sie Folgendes aus:
python -m pip install .
Wenn Sie AFDKO mit Xcode entwickeln und debuggen möchten, führen Sie Folgendes aus:
CMake -G Xcode .
Weitere Informationen zum Erstellen aus dem Quellcode finden Sie unter docs/FDK_Build_Notes.md.
Notiz
Es ist nicht möglich, den afdko im bearbeitbaren/Entwicklungsmodus mit python -m pip install -e . ; Dies liegt daran, dass das Toolkit binäre ausführbare C-Dateien enthält, die setup.py im Ordner bin/ (oder Scripts/) zu installieren versucht. Dieser Prozess war jedoch nur für die Verwendung mit textbasierten Skripten gedacht (entweder in Python geschrieben oder als Shell-Skript). Sprache). Um dieses Problem zu umgehen (das eigentlich nur die wenigen Kernentwickler von afdko betrifft, die beim Ändern der Quelldateien Live-Feedback benötigen), können Sie alternative Methoden wie das Exportieren eines PYTHONPATH, die Verwendung einer .pth-Datei oder ähnliche Hacks verwenden. Für weitere Details lesen Sie diesen Kommentar.
Der AFDKO wurde so umstrukturiert, dass er als Python-Paket installiert werden kann. Es hängt jetzt vom Python-Interpreter des Benutzers ab und enthält keinen eigenen Python-Interpreter mehr.
Zwei Programme, IS und checkoutlines, wurden gelöscht, da ihr Quellcode nicht als Open-Source-Version verfügbar war. Diese Tools sind in der Release-Version 2.5.65322 und älter verfügbar.
Notiz
Wenn Sie sowohl das alte AFDKO als auch das neue PyPI-afdko-Paket installieren, haben die Tools der neueren Version Vorrang vor den älteren. Dies geschieht, weil pip den Paketpfad des afdko am Anfang der PATH-Umgebungsvariablen des Systems hinzufügt, während das alte Installationsprogramm ihn am Ende hinzufügt; Diese Änderung an PATH wird vom Deinstallationsprogramm nicht rückgängig gemacht. Wenn Sie den Pfad zur neueren Version vollständig entfernen möchten, müssen Sie den PATH bearbeiten. Auf dem Mac bedeutet dies, dass Sie die Zeile in Ihrer Anmeldedatei bearbeiten, die die PATH-Variable festlegt. Unter Windows bedeutet dies, dass Sie die Umgebungsvariable PATH in der Systemsteuerung bearbeiten.
