afdko
4.0.2
AFDKO es un conjunto de herramientas para crear archivos de fuentes OpenType a partir de datos de fuentes PostScript y TrueType.
Este repositorio contiene los archivos de datos, los scripts de Python y las fuentes de los programas de línea de comandos que componen AFDKO. El proyecto utiliza la licencia Apache 2.0 Open Source. Tenga en cuenta que AFDKO utiliza varias dependencias, enumeradas en el archivo requisitos.txt, que se instalarán automáticamente si instala AFDKO con pip . La mayoría de estas dependencias son licencia BSD o MIT, a excepción de tqdm , que es MPL 2.0.
Consulte la descripción general de AFDKO para obtener una descripción más detallada de lo que se incluye en el paquete.
Consulte la wiki para obtener información adicional, como enlaces a materiales de referencia y proyectos relacionados.
El puerto Python de psautohint se (re)integró en el repositorio de AFDKO como "otfautohint"
Puede encontrar más información en docs/otfautohint_Notes.md
El AFDKO requiere Python 3.9 o posterior. Debería funcionar con cualquier Python > 3.9, pero ocasionalmente los componentes y dependencias de la cadena de herramientas no siguen el ritmo de las principales versiones de Python, por lo que puede haber algún retraso hasta que se pongan al día.
Las versiones están disponibles en el índice de paquetes de Python (PyPI) y se pueden instalar con pip.
Nota para usuarios de macOS: recomendamos no utilizar el sistema Python. Entre otras razones, algunas versiones de macOS se envían con Python 2 y la última versión de AFDKO solo está disponible para Python 3. Puede encontrar instrucciones para usar Brew para instalar Python 3 en macOS aquí: Instalación de Python 3 en Mac OS X. También : pyenv es una gran herramienta para instalar y administrar múltiples versiones de Python en macOS.
Nota para todos los usuarios: recomendamos ENCARECIDAMENTE el uso de un entorno virtual Python ( venv ) y el uso de python -m pip install <package> para instalar todos los paquetes (no solo AFDKO). Llamar pip install directamente puede provocar que se llame al pip incorrecto y que el paquete llegue a la ubicación incorrecta. La combinación del uso de una python -m pip install venv + python -m pip ayuda a garantizar que los paquetes administrados por pip lleguen al lugar correcto.
Nota para usuarios de Linux (y usuarios de otras plataformas que no sean macOS o Windows): cuando no haya una "rueda" prediseñada para su plataforma, pip intentará compilar las partes C y C++ del paquete desde el código fuente. Este proceso sólo tendrá éxito si están instalados las herramientas de desarrollo C y C++ y libuuid. Vea la compilación desde la fuente a continuación.
Opción 1 (recomendada)
Crea un entorno virtual:
python -m venv afdko_envActivar el entorno virtual:
macOS y Linux
source afdko_env/bin/activateventanas
afdko_env S cripts a ctivate.batInstalar afdko:
python -m pip install afdkoLa instalación de afdko dentro de un entorno virtual evita conflictos entre sus dependencias y otros módulos instalados globalmente.
Opción 2 (no recomendada a menos que haya un conflicto global)
Instalación de usuario local afdko (información):
python -m pip install --user afdko
Utilice la opción -U (o --upgrade ) para actualizar afdko (y sus dependencias) a la versión estable más reciente:
python -m pip install -U afdko
Para obtener versiones preliminares y en desarrollo, utilice el indicador --pre :
python -m pip install -U afdko --pre
Para eliminar el paquete afdko utilice el comando:
python -m pip uninstall afdko
Primero debes haber instalado las herramientas de desarrollo para tu plataforma.
En macOS, instálelos con:
xcode-select --install
En Linux (Ubuntu 17.10 LTS o posterior), instálelos con:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
En otros sistemas operativos tipo POSIX, libuuid y sus archivos de encabezado pueden estar en un paquete llamado libuuid-devel o util-linux-libs . El código fuente de libuuid se mantiene en el repositorio util-linux.
En Windows, necesita Visual Studio 2017 o posterior.
Para compilar afdko desde el código fuente, clone el repositorio de afdko GitHub, asegúrese de que el módulo wheel esté instalado ( python -m pip install wheel ), luego cd al directorio de nivel superior de afdko y ejecute:
python -m pip install .
Si desea desarrollar y depurar AFDKO usando Xcode, ejecute:
CMake -G Xcode .
Para obtener más información sobre la compilación desde el código fuente, consulte docs/FDK_Build_Notes.md.
Nota
No es posible instalar afdko en modo editable/desarrollo usando python -m pip install -e . ; Esto se debe a que el kit de herramientas incluye ejecutables binarios de C que setup.py intenta instalar en la carpeta bin/ (o Scripts/); sin embargo, este proceso solo estaba destinado a usarse con scripts basados en texto (ya sea escritos en Python o en un script de shell). idioma). Para solucionar este problema (que en realidad solo afecta a los pocos desarrolladores principales de afdko que necesitan obtener comentarios en vivo a medida que modifican los archivos fuente), puede usar métodos alternativos como exportar un PYTHONPATH, usar un archivo .pth o trucos similares. Para más detalles lea este comentario.
El AFDKO ha sido reestructurado para que pueda instalarse como un paquete Python. Ahora depende del intérprete de Python del usuario y ya no contiene su propio intérprete de Python.
Se descartaron dos programas, IS y checkoutlines, porque su código fuente no podía ser de código abierto. Estas herramientas están disponibles en la versión 2.5.65322 y anteriores.
Nota
Si instala el antiguo AFDKO y el nuevo paquete PyPI afdko, las herramientas de la versión más nueva tendrán prioridad sobre la anterior. Esto sucede porque pip agrega la ruta del paquete afdko al principio de la variable de entorno PATH del sistema, mientras que el instalador anterior la agrega al final; El desinstalador no deshace esta modificación de PATH. Si desea eliminar por completo la ruta a la versión más nueva, deberá editar la RUTA. En Mac, esto significa editar la línea en su archivo de inicio de sesión que establece la variable PATH. En Windows, esto significa editar la variable de entorno PATH en el Panel de control del sistema.
