afdko
4.0.2
L'AFDKO est un ensemble d'outils permettant de créer des fichiers de polices OpenType à partir de données de polices PostScript et TrueType.
Ce référentiel contient les fichiers de données, les scripts Python et les sources des programmes de ligne de commande qui composent l'AFDKO. Le projet utilise la licence Apache 2.0 Open Source. Veuillez noter que l'AFDKO utilise plusieurs dépendances, répertoriées dans le fichier Requirements.txt, qui seront automatiquement installées si vous installez AFDKO avec pip . La plupart de ces dépendances sont sous licence BSD ou MIT, à l'exception de tqdm , qui est MPL 2.0.
Veuillez vous référer à l'aperçu de l'AFDKO pour une description plus détaillée de ce qui est inclus dans le package.
Veuillez consulter le wiki pour plus d'informations, telles que des liens vers des documents de référence et des projets connexes.
Le portage Python de psautohint a été (ré)intégré au dépôt AFDKO sous le nom "otfautohint"
Plus d'informations peuvent être trouvées dans docs/otfautohint_Notes.md
L'AFDKO nécessite Python 3.9 ou version ultérieure. Il devrait fonctionner avec n'importe quel Python > 3.9, mais il arrive parfois que les composants et les dépendances de la chaîne d'outils ne suivent pas le rythme des versions majeures de Python, il peut donc y avoir un certain décalage pendant qu'ils rattrapent leur retard.
Les versions sont disponibles sur Python Package Index (PyPI) et peuvent être installées avec pip.
Remarque pour les utilisateurs de macOS : nous vous recommandons de ne pas utiliser le système Python. Entre autres raisons, certaines versions de macOS sont livrées avec Python 2 et la dernière version de l'AFDKO n'est disponible que pour Python 3. Vous pouvez trouver des instructions pour utiliser Brew pour installer Python 3 sur macOS ici : Installer Python 3 sur Mac OS X. Également : pyenv est un excellent outil pour installer et gérer plusieurs versions de Python sur macOS.
Note à tous les utilisateurs : nous recommandons FORTEMENT l'utilisation d'un environnement virtuel Python ( venv ) et l'utilisation de python -m pip install <package> pour installer tous les packages (pas seulement AFDKO). L'appel direct pip install peut entraîner l'appel du mauvais pip et l'atterrissage du package au mauvais endroit. La combinaison de l'utilisation d'une installation venv + python -m pip install permet de garantir que les packages gérés par pip atterrissent au bon endroit.
Remarque pour les utilisateurs de Linux (et les utilisateurs d'autres plates-formes autres que macOS ou Windows) : lorsqu'il n'y a pas de « roue » prédéfinie pour votre plate-forme, pip tentera de créer les parties C et C++ du package à partir des sources. Ce processus ne réussira que si les outils de développement C et C++ ainsi que libuuid sont installés. Voir la construction à partir des sources ci-dessous.
Option 1 (recommandée)
Créez un environnement virtuel :
python -m venv afdko_envActivez l'environnement virtuel :
macOS et Linux
source afdko_env/bin/activateFenêtres
afdko_env S cripts a ctivate.batInstallez afdko :
python -m pip install afdkoL'installation d'afdko dans un environnement virtuel évite les conflits entre ses dépendances et les autres modules installés globalement.
Option 2 (non recommandée sauf en cas de conflit mondial)
Installation utilisateur locale afdko (info) :
python -m pip install --user afdko
Utilisez l'option -U (ou --upgrade ) pour mettre à jour l'afdko (et ses dépendances) vers la version stable la plus récente :
python -m pip install -U afdko
Pour obtenir les versions préliminaires et en développement, utilisez l'indicateur --pre :
python -m pip install -U afdko --pre
Pour supprimer le package afdko, utilisez la commande :
python -m pip uninstall afdko
Vous devez d’abord avoir installé les outils de développement pour votre plateforme.
Sur macOS, installez-les avec :
xcode-select --install
Sous Linux (Ubuntu 17.10 LTS ou version ultérieure), installez-les avec :
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
Sur d'autres systèmes d'exploitation de type POSIX, libuuid et ses fichiers d'en-tête peuvent se trouver dans un package nommé libuuid-devel ou util-linux-libs . Le code source de libuuid est conservé dans le référentiel util-linux.
Sous Windows, vous avez besoin de Visual Studio 2017 ou version ultérieure.
Pour créer l' afdko à partir des sources, clonez le référentiel afdko GitHub, assurez-vous que le module wheel est installé ( python -m pip install wheel ), puis cd dans le répertoire de niveau supérieur de l'afdko et exécutez :
python -m pip install .
Si vous souhaitez développer et déboguer AFDKO à l'aide de Xcode, exécutez :
CMake -G Xcode .
Pour plus d'informations sur la construction à partir des sources, voir docs/FDK_Build_Notes.md.
Note
Il n'est pas possible d'installer l'afdko en mode édition/développement en utilisant python -m pip install -e . ; en effet, la boîte à outils inclut des exécutables binaires C que setup.py essaie d'installer dans le dossier bin/ (ou Scripts/). Cependant, ce processus était uniquement destiné à être utilisé avec des scripts basés sur du texte (écrits en Python ou en script shell). langue). Pour contourner ce problème (qui n'affecte en réalité que les quelques développeurs principaux d'afdko qui ont besoin d'obtenir des commentaires en direct lorsqu'ils modifient les fichiers sources), vous pouvez utiliser des méthodes alternatives comme l'exportation d'un PYTHONPATH, l'utilisation d'un fichier .pth ou des hacks similaires. Pour plus de détails, lisez ce commentaire.
L'AFDKO a été restructuré afin qu'il puisse être installé sous forme de package Python. Il dépend désormais de l'interpréteur Python de l'utilisateur, et ne contient plus son propre interpréteur Python.
Deux programmes, IS et checkoutlines, ont été abandonnés car leur code source ne pouvait pas être open source. Ces outils sont disponibles dans la version 2.5.65322 et antérieure.
Note
Si vous installez l'ancien AFDKO ainsi que le nouveau package PyPI afdko, les outils de la version la plus récente auront priorité sur l'ancienne. Cela se produit parce que pip ajoute le chemin du package afdko au début de la variable d'environnement PATH du système, alors que l'ancien programme d'installation l'ajoute à la fin ; cette modification de PATH n'est pas annulée par le programme de désinstallation. Si vous souhaitez supprimer complètement le chemin d'accès à la version la plus récente, vous devrez modifier le PATH. Sur Mac, cela signifie modifier la ligne de votre fichier de connexion qui définit la variable PATH. Sous Windows, cela signifie modifier la variable d'environnement PATH dans le panneau de configuration du système.
