fontist
v1.21.1
Una biblioteca simple para encontrar y descargar fuentes para Windows, Linux y Mac.
Instálelo directamente como:
gem install fontist O úselo como parte de su paquete agregando esta línea al Gemfile de su aplicación:
gem "fontist"Y luego ejecutar:
bundle install Después de la instalación, obtenga fórmulas a través del comando fontist :
fontist updateDepende de FFI-Libarchive-Binary que tenga los siguientes requisitos:
zlib
Expatriado
OpenSSL (solo para Linux)
Estas dependencias generalmente están presentes en todos los sistemas.
fontistEstos comandos hacen posible operar con fuentes a través de la línea de comandos.
La CLI admite correctamente el estado de salida, por lo que en un caso de error devuelve un código de estado más alto o igual que 1 .
Las búsquedas son insensibles a los casos para facilitar el uso.
Todos los comandos admiten las siguientes opciones globales:
--preferred-familyBusque usando el nombre de "familia preferida" de una fuente. (En lugar del nombre de la "familia predeterminada", el valor predeterminado antes del fontista v1.10).
Nota | Consulte a V1.10+ para las diferencias entre la "familia preferida" y la "familia predeterminada". |
-q, --quietImprima la menor información posible, en su mayoría errores críticos.
-v, --verboseEstablezca el nivel de registro para depurar. Imprime fórmulas excluidas durante la instalación e información para los desarrolladores de Fontist.
-c, --no-cachePrefiera la descarga directa incluso cuando un archivo ya está en caché en un sistema.
fontist installFontist verifica si esta fuente ya está instalada y, si no, instala la fuente y devuelve sus rutas instaladas.
El nombre de la fuente es el único argumento que se suministrará.
$ fontist install " segoe ui "
These fonts are found or installed:
- /Users/user/.fontist/fonts/SEGOEUI.TTF
- /Users/user/.fontist/fonts/SEGOEUIB.TTF
- /Users/user/.fontist/fonts/SEGOEUII.TTF
- /Users/user/.fontist/fonts/SEGOEUIZ.TTFPor defecto, se instalan todos los estilos de coincidencia (de acuerdo con el nombre de la "familia predeterminada" de la fuente).
Nota | Antes de V1.10, el nombre de la "familia preferida" de la fuente se usa para hacer coincidir los estilos para la búsqueda. Vea a V1.10+ para obtener detalles sobre ese cambio. |
Para instalar todas las fuentes especificadas en una fórmula de fontista, use la opción -F, --formula .
$ fontist install --formula ' courier_prime '
Downloading font ...
Installing font " courier_prime " .
Fonts installed at:
- /Users/user/.fontist/fonts/Courier Prime Bold Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime Bold.ttf
- /Users/user/.fontist/fonts/Courier Prime Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime.ttf Aquí, courier_prime es el nombre de archivo de la fórmula ubicada en el repositorio de fórmula de fontista público ( courier_prime.yml ).
También puede especificar el nombre legible por humanos de la fórmula. Este nombre se deriva del nombre de archivo, con subrayos reemplazados por espacios. No es sensible al caso, lo que significa que puede usar letras mayúsculas si lo prefiere.
$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "La instalación por el nombre de la fórmula admite sugerencias en CLI cuando la entrada es parcial:
$ fontist install --formula ' noto s '
Formula ' noto s ' not found. Did you mean ?
[0] Google/Noto Sans
[1] Google/Noto Serif
Please type number or press ENTER to skip installation: Nota | La especificación del nombre de archivo de la fuente aún no es compatible. |
Si hay varias fórmulas con una fuente solicitada, entonces fontist busca la versión más reciente de la fuente entre las fórmulas con tamaño por debajo de un límite (300 MB). Este comportamiento se puede cambiar con opciones.
Nota | Si los estilos de una fuente se extienden entre varias fórmulas, entonces se instalarían todos los estilos disponibles de todas las fórmulas. |
Nota | Algunas fórmulas pueden tener el atributo min_fontist , que define la versión mínima de Fontist por la cual se pueden instalar. Si fontist es de una versión anterior, entonces se evita que la fórmula se use. Para ver qué fórmulas se excluyeron de la búsqueda, se puede especificar la opción -v, --verbose . |
Opciones compatibles:
-f, [--force]Instalar incluso si ya está instalado en el sistema
-F, [--formula]Instale una fórmula completa en lugar de una fuente
-a, [--accept-all-licenses]Acepte todos los acuerdos de licencia
-h, [--hide-licenses]Ocultar textos de licencia
-p, [--no-progress]Ocultar el progreso de descarga
-V, [--version=VERSION]Instalar una versión particular de una fuente
-s, [--smallest]Instale la fuente más pequeña por tamaño de archivo si varios
-n, [--newest]Instale la versión más reciente de una fuente si varias
-S, [--size-limit=N]Especifique el límite superior para el tamaño del archivo de una fórmula a instalar (el valor predeterminado es de 300 MB)
-u, [--update-fontconfig]Actualizar FontConfig
Nota | El comando install es similar a la llamada de la biblioteca Font.install . |
fontist uninstallDesinstale cualquier fuente respaldada por Fontist.
Devuelve rutas de una fuente desinstalada, o imprime un error que dice que la fuente no está instalada o no se puede encontrar en fórmulas fontistas. Alias como remove .
$ fontist uninstall " segoe ui "
These fonts are removed:
/Users/user/.fontist/fonts/SEGOEUII.TTF
/Users/user/.fontist/fonts/SEGOEUIZ.TTF
/Users/user/.fontist/fonts/SEGOEUIB.TTF
/Users/user/.fontist/fonts/SEGOEUI.TTFfontist statusImprime rutas de fuente instaladas con una fórmula correspondiente.
$ fontist status " segoe ui "
Fonts found at:
- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)fontist listEnumera el estado de instalación de las fuentes compatibles con Fontist.
$ fontist list " segoe ui "
segoe_ui
Segoe UI
Regular (installed)
Bold (installed)
Italic (installed)
Bold Italic (installed)$ fontist list " roboto mono "
google/roboto_mono
Roboto Mono
Regular (not installed)
Italic (not installed)fontist manifest-locationsDevuelve ubicaciones de fuentes especificadas en un archivo YAML como una entrada.
$ fontist manifest-locations MANIFEST_FILE MANIFEST_FILE es la ubicación de un archivo manifiesto que contiene especificación de una o múltiples estilos de fuentes y fuentes.
Un archivo manifiesto manifest.yml podría parecer:
Segoe UI :
- Regular
- Bold
Roboto Mono :
- RegularEl siguiente comando devolverá la siguiente salida YAML:
$ fontist manifest-locations manifest.yml---
Segoe UI :
Regular :
full_name : Segoe UI
paths :
- " /Users/user/.fontist/fonts/SEGOEUI.TTF "
Bold :
full_name : Segoe UI Bold
paths :
- " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
Regular :
full_name : Roboto Mono Regular
paths :
- " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "Si faltan una o más de las fuentes solicitadas, se devolvería el código de error "3" y se imprimió un mensaje:
$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3fontist manifest-installInstale las fuentes desde un manifiesto Fontist Yaml:
$ fontist manifest-install --confirm-license manifest.yml Donde manifest.yaml es:
---
Segoe UI :
Regular :
full_name : Segoe UI
paths :
- " /Users/user/.fontist/fonts/SEGOEUI.TTF "
Bold :
full_name : Segoe UI Bold
paths :
- " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
Regular :
full_name : Roboto Mono Regular
paths :
- " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "fontist configFontist admite la configuración de todo el sistema para los siguientes parámetros:
fonts_path Establece ruta dónde instalar fuentes (predeterminado: ~/.fontist/fonts )
open_timeout Establece tiempo de espera para abrir una conexión durante la descarga (predeterminado: 10 )
read_timeout Establece tiempo de espera para leer la conexión abierta durante la descarga (predeterminado: 10 )
Mostrar los atributos actuales en la configuración:
$ fontist config show
Current config:
read_timeout: 5Asigne un valor a un atributo:
$ fontist config set read_timeout 60Restaurar un valor predeterminado de un atributo:
$ fontist config delete read_timeoutfontist fontconfigFontConfig es un software diseñado para proporcionar fuentes a otros programas. Por lo general, se usa en Linux, pero también está disponible en macOS y Windows. FontConfig es utilizado por LibreOffice, GIMP y muchos otros programas.
Pedir para encontrar fuentes de fontistas, FontConfig debe actualizarse para incluir rutas de fontistas. Se puede hacer con la opción --update-fontconfig del comando install , o llamando a uno especial:
$ fontist fontconfig update Crearía una configuración en ~/.config/fontconfig/conf.d/10-fontist.conf .
Para eliminarlo, use:
$ fontist fontconfig remove$ fontist cache clearEl comando anterior borrará el caché de descarga de Fontist
fontist helpLa lista de todos los comandos podría verse por:
fontist help Por defecto, el fontista usa el directorio ~/.fontist para almacenar fuentes y sus archivos. Podría cambiarse con la variable de entorno FONTIST_PATH .
FONTIST_PATH= ~ /.fontist_new fontist updateFontist::Font El Fontist::Font es su lugar favorito para lidiar con cualquier fuente usando Fontist.
Esta interfaz le permite encontrar una fuente o instalar una fuente.
La interfaz Fontist::Font.find se puede utilizar una fuente de búsqueda en su sistema.
Buscará los directorios de fuentes específicos del sistema operativo, y también el directorio de fontist específico ~/.fontist .
Fontist :: Font . find ( name )Si Fontist encuentra una fuente, entonces devolverá las rutas.
De lo contrario, aumentará un error de fuente no compatible o activará la visualización de instrucciones de instalación para esa fuente específica.
La interfaz Fontist::Font.install se puede usar para instalar cualquier fuente compatible.
Esta interfaz primero verifica si ya tiene esa fuente instalada o no y si lo hace, devolverá las rutas.
Si no tiene una fuente pero esa fuente es compatible con Fontist, descargará la fuente y la copiará en el directorio ~/.fontist y también devolverá las rutas.
Fontist :: Font . install ( name , confirmation : "no" )Si hay problemas detectados con la fuente proporcionada, como la fuente no es compatible, esos errores se plantearían.
La interfaz Fontist::Font expone una interfaz para enumerar todas las fuentes compatibles.
Esto podría ser útil si desea saber el nombre de la fuente o los estilos disponibles. Puedes hacerlo usando:
Fontist :: Font . all Los valores de retorno son objetos OpenStruct , por lo que puede hacer fácilmente cualquier otra operación que haga en cualquier objeto Ruby.
Fontist::Formula La GEM fontist usa internamente la interfaz Fontist::Formula para encontrar una fórmula o fuentes registradas respaldadas por cualquier fórmula. A menos que deba hacer cualquier cosa que no necesite trabajar directamente con esta interfaz. Pero si lo hace, esta es la interfaz pública que ofrece.
La interfaz Fontist::Formula.find le permite encontrar cualquiera de la fórmula registrada. Esta interfaz toma un nombre de fuente como argumento y mira a través de cada una de las fórmula registrada que ofrece esta instalación de fuentes. Uso:
Fontist :: Formula . find ( "Calibri" )Este método buscará y devolverá una fórmula de fontista para la palabra clave proporcionada que permite un procesamiento adicional, como verificaciones de licencias o procedimiento con la instalación de la fuente en su sistema.
Normalmente, cada nombre de fuente se puede asociar con múltiples estilos o colección, por ejemplo, la fuente de Calibri puede contener una fuente regular , bold o de estilos italic y si desea una interfaz que pueda devolver la lista completa, entonces este es su amigo.
Puedes usarlo como lo sigue:
Fontist :: Formula . find_fonts ( "Calibri" ) La interfaz Fontist::Formula expone una interfaz para enumerar toda la fórmula de fuente registrada. Esto podría ser útil si desea saber el nombre de la fórmula o qué tipo de fuentes se pueden instalar utilizando esa fórmula. Uso:
Fontist :: Formula . all Los valores de retorno son objetos OpenStruct , por lo que puede hacer fácilmente cualquier otra operación que haga en cualquier objeto Ruby.
Fontist::Manifest El fontista se puede cambiar para usar los apellidos preferidos. Este formato se usó antes de V1.10.
Fontist . preferred_family = true Fontist::Manifest::LocationsFontist le permite encontrar ubicaciones de fuentes de un hash de manifiesto definido en el siguiente formato:
{
"Segoe UI" => [ "Regular" , "Bold" ] ,
"Roboto Mono" => [ "Regular" ]
}Llamar al siguiente código devuelve un hash anidado con rutas y nombres de fuentes. El nombre de la fuente es útil para elegir una fuente específica en un archivo de recopilación de fuentes (TTC).
Fontist :: Manifest :: Locations . from_hash ( manifest ) {
"Segoe UI" => {
"Regular" => {
"full_name" => "Segoe UI" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ]
} ,
"Bold" => {
"full_name" => "Segoe UI Bold" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
}
} ,
"Roboto Mono" => {
"Regular" => {
"full_name" => nil ,
"paths" => [ ]
}
}
} Fontist::Manifest::InstallFontist le permite no solo obtener ubicaciones de fuentes, sino también instalar fuentes desde el manifiesto:
Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )Instalará fuentes y devolverá sus ubicaciones:
{
"Segoe UI" => {
"Regular" => {
"full_name" => "Segoe UI" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ] } ,
"Bold" => {
"full_name" => "Segoe UI Bold" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
}
} ,
"Roboto Mono" => {
"Regular" => {
"full_name" => "Roboto Mono Regular" ,
"paths" => [ "/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf" ]
}
}
} Ambos comandos admiten un archivo YAML como una entrada con un método from_file . Por ejemplo, si hay un archivo manifest.yml que contiene:
---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular Luego, las siguientes llamadas devolverían los nombres y rutas de fuentes, como desde el método from_hash (ver Fontist::Manifest::Install y Fontist::Manifest::Locations ).
Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )Fontist::FontconfigFontist admite el trabajo con FontConfig a través de la interfaz Ruby:
Fontist :: Fontconfig . update # let detect fontist fonts
Fontist :: Fontconfig . remove # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists Las versiones más nuevas de MacOS proporcionan instalaciones a pedido de una amplia gama de fuentes con licencia. Estas fuentes complementarias específicas de MacOS se pueden instalar a través de Fontist.
Un uso típico para instalar fuentes complementarios de MacOS es permitir que los trabajos de CI en entornos MacOS usen estas fuentes especialmente licenciadas que no están disponibles en otras plataformas.
Esta publicación de blog describe cómo funciona esto:
Blog de Fontist: Instalación de fuentes complementarias específicas de MacOS
Por ejemplo, la fuente "Canela" es una fuente comercial que viene gratis con macOS.
Ejecute este comando para instalar Canela en macOS.
$ fontist install CanelaLa lista completa de fuentes disponibles en varias versiones de MacOS se puede encontrar en el sitio de soporte de Apple:
Fuentes en macOS 13 ventura
Fuentes en macOS 12 Monteray
Fuentes en macOS 11 Big Sur
Advertencia | Fontist no permite instalar fuentes específicas de MacOS en plataformas que no son de MACOS debido a las restricciones de licencia de fuentes de esas fuentes. |
NISC18030.TTF (GB18030 Bitmap) - MacOS, más información en el número de NISC18030
La lista completa de fuentes problemáticas conocidas:
Lista de fuentes excluidas del uso
Fontist usa Git internamente para obtener fórmulas y fuentes.
Para usar la funcionalidad Git detrás de un proxy, debe actualizar su propia configuración Git a través del comando git config o el archivo de preferencia ~/.gitconfig .
Hay muchas maneras de configurar su instalación local de Git para usar proxies.
La forma más simple y global de establecer un proxy para GIT es la siguiente.
Para http
git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}Para HTTPS, es posible que deba manejar los errores de verificación SSL/TLS después de establecer el proxy ya que el extremo de cifrado se encuentra en su punto final de proxy HTTPS:
git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}Para los calcetines, deberá decidir sobre el protocolo de calcetines
git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} 'Por ejemplo,
git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] ' La lista de protocolos de calcetines compatibles para el campo {protocol} :
socks:// : para calcetines debajo de v5
socks5:// : para calcetines v5
socks5h:// : para calcetines debajo de la resolución de host V5 + a través de calcetines
En realidad, podría establecer diferentes comportamientos de proxy para repositorios de GIT individuales; consulte esta gran guía sobre cómo usar proxies GIT (gracias al usuario de GitHub Evantoli).
Un repositorio de fontistas es un repositorio Git que contiene archivos de fórmula YAML. Las fórmulas de fontistas se pueden crear manualmente dentro de un repositorio de fontistas (ver ejemplos) o generarse automáticamente desde un archivo de fuentes.
Se puede acceder a un repositorio de fontistas, ya sea a través de HTTPS o SSH. En el caso de SSH, se debe configurar una clave SSH correspondiente con ssh-agent para acceder a este repositorio personalizado.
El comando fontist repo setup obtiene las fórmulas de un repositorio personalizado y almacena el nombre y la URL del repositorio para su uso posterior.
El comando fontist repo setup usa la siguiente sintaxis.
fontist repo setup NAME URL Internamente, toda la información del repositorio de fontistas personalizados se almacena en ~/.fontist/formulas/Formulas/private .
Por ejemplo, dado un repositorio fontista llamado "ACME" accesible a través de una URL o una dirección SSH:
fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.gitfontist repo listUna vez que se configura el repositorio de fontistas personalizados, se puede instalar fuentes desde el repositorio a través de sus fórmulas:
fontist install " custom font " Si se actualiza el repositorio de fórmula de fontista personalizado, el comando repo update se usa para extraer los cambios más recientes:
fontist repo update NAMEPor ejemplo, dado un repositorio fontista llamado "ACME", se usa el siguiente comando.
fontist repo update acmeSi es necesario eliminar un repositorio de fontistas registrado, el repositorio se puede eliminar con:
fontist repo remove acmeLas fórmulas de fontistas personalizadas y los repositorios de fontistas se pueden hacer privado para requerir autenticación.
Para repositorios de fontistas HTTPS y SSH Git
La autorización de archivos privados en fórmulas privadas se puede implementar con encabezados.
Aquí hay un ejemplo que funciona con las versiones de GitHub:
resources :
fonts.zip :
urls :
- url : https://example.com/repos/acme/formulas/releases/assets/38777461
headers :
Accept : application/octet-stream
Authorization : token ghp_1234567890abcdefghi Si el repositorio de fórmula de fontista es un repositorio de GitHub, se puede obtener un token en la página de tokens de configuración de GitHub. Este token debería tener al menos el alcance repo para el acceso a estos activos.
Las fórmulas fontistas se pueden hacer fácilmente en YAML. Sin embargo, se recomienda el método de generación automática para la precisión y la conveniencia de los datos.
Se podría generar una fórmula a partir de un archivo de fuentes.
El comando fontist create-formula permite detectar todos los archivos de fuentes de un archivo de fuentes en una multitud de formatos (aquellos apoyados por excavado, incluyendo Zip, 7Z, GZIP, TAR, CAB, EXE).
El comando fontist create-formula admite archivos ubicados en URL remotas o rutas de archivos locales.
Para las rutas de archivo, especifique la ruta del archivo como argumento:
wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zipPara las URL, simplemente especifique la URL como el argumento:
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zipPara probar la fórmula creada, uno puede copiar la fórmula en la ubicación del repositorio de fórmula privada del usuario.
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/ El comando fontist create-formula crea fórmulas de fuentes utilizando información integrada en la sección de metadatos OTF.
Sin embargo, algunas fuentes (como las fuentes más antiguas) a menudo contienen información de metadatos inconsistente o imperfecta. Algunas fuentes, por ejemplo, aplican diferentes valores Family OTF para diferentes estilos de fuentes. Esto dará como resultado que todos los estilos de fuentes no se registren en la misma familia.
Los autores de la fórmula de Fontist pueden rectificar esta situación utilizando la clave override: que permite que la fórmula anule la información de metadatos obtenida de los metadatos de fuente.
Nota | La clave override no causa ningún cambio en los archivos de fuentes, es solo para actualizar la información utilizada por Fontist internamente. |
La clave override existe bajo la definición de estilos de fuente individuales:
resources :
...
fonts :
- name : Original font name
styles :
- family_name : Original family name
type : Original style
override :
family_name : Overridden family name
type : Overridden style
preferred_family_name : Overridden preferred family name Por ejemplo, las fuentes "frutiger" publicadas por Adobe en 1994 usan números para representar los estilos de fuentes individuales y tienen esos nombres incrustados en el campo Family OTF, como "Frutiger 45 Light". Estas fuentes tampoco usan el campo Preferred Family OTF, que es una adición más reciente a OTF, debido a su edad.
Aquí es cómo la propiedad override puede hacer cumplir todos los estilos relevantes para registrarse bajo el mismo apellido (anulando el valor preferred_family_name ):
...
resources :
...
fonts :
- name : Frutiger 45 Light
styles :
- family_name : Frutiger 45 Light
type : Regular
full_name : Frutiger-Light
post_script_name : Frutiger-Light
override :
preferred_family_name : Frutiger
- ... Este fragmento anterior permitirá que Fontist genere índices correctos y permitirá la instalación de todas las fuentes Frutiger con un solo comando:
$ fontist install " Frutiger " --preferred-family Las versiones fontistas más allá de V1.10 utilizan un nuevo formato de fórmula. Después de la actualización, ejecute fontist update para obtener las últimas fórmulas.
A partir de V1.10, Fontist usa la "familia predeterminada" en lugar de la "familia preferida" al agrupar los estilos.
Por ejemplo, una solicitud para la fuente "lato" antes de V1.10 devolverá todos los estilos: "negro", "negro italic", "en negrita" y otros 15 estilos.
Desde V1.10 en adelante, Fontist devolverá solo los 4 estilos predeterminados: "regular", "cursiva", "audaz" y "en negrita en cursiva".
Para obtener otros estilos, debe especificar la "subfamilia" de fuentes exacta, como "Lato Black", o "Lato Heavy", o usar la opción --preferred-family con CLI y Fontist.preferred_family = true con la biblioteca Ruby.
Nota | Antes de V1.10, había un error con la fórmula de fuentes "Courier", que permitía instalar la fuente al solicitar el nombre de fuente "Courier", pero su ubicación de fuente solo se podía obtener utilizando el nombre completo de la fuente "Courier New". Desde V1.10 en adelante, el comportamiento se ha hecho consistente, solo se debe usar el nombre apropiado de "mensajería nueva". |
Las versiones fontistas más allá de V1.16 tratan el argumento font del comando install de manera diferente. Después de la actualización, asegúrese de especificar todas las fuentes requeridas cuando se usan fontist install , fontist manifest-install (y su correspondiente interfaz de Ruby Font.install y Manifest::Install ), o use la opción -F, --formula .
A partir de V1.16, Fontist instala solo fuentes solicitadas en lugar de una fórmula completa, a menos que se especifique explícitamente. cambiado ahora.
Por ejemplo, una solicitud de instalación para la fuente "Arial" antes de V1.16 configurará todas las fuentes que se encuentran en la fórmula "MS_Truetype": "Arial", "Trebuchet MS", "Verdana" y "Times New Roman".
Desde V1.16 en adelante, Fontist instalará solo la fuente "Arial" solicitada.
Para instalar todas las fuentes desde una fórmula, se puede usar la opción -F, --formula :
$ fontist install --formula ms_truetype Advertencia | Esta sección es solo para mantenedores de fontistas. |
Para agregar un nuevo atributo, cambie cómo se trata la fórmula o reemplaza por completo la estructura, hay 2 formas de cambiar un formato de fórmula:
Use el atributo min_fontist en una fórmula. Establece un requisito para que Fontist instale la fórmula solo si su versión es igual o más que una versión especificada.
Use una nueva rama en el repositorio de las fórmulas, por ejemplo, "V2", "V3", "V4", etc. Después de crear una nueva rama, debe definirse en Fontist.formulas_version
Nota | El uso de una nueva rama requeriría que todos los usuarios vuelvan a descargar todo el repositorio de fórmulas. Dado que este método tiene una sobrecarga significativa, la primera ( min_fontist ) debe usarse siempre que sea posible. |
Google Fonts proporciona probablemente la mayor colección de fuentes ampliamente utilizadas, libremente y abiertamente con licencia.
La biblioteca de fórmulas de Fontist incluye soporte para todas las fuentes licenciadas abiertamente proporcionadas a través de Google Fonts, y mantiene fórmulas de fontistas para todas esas fuentes.
Un flujo de trabajo GHA verifica las fuentes actualizadas en Google Fonts diariamente. En caso de que se encuentre una actualización, se agrega al repositorio por el flujo de trabajo.
SIL International es una organización sin fines de lucro basada en la fe internacionalmente reconocida que sirve a comunidades lingüísticas en todo el mundo.
SIL proporciona una serie de fuentes únicas que admiten comunidades de idiomas más pequeñas que con código Unicode a menudo no (todavía) compatibles con las fuentes convencionales.
Fontist tiene como objetivo admitir todas las fuentes SIL y proporciona sus fórmulas en el repositorio de fórmulas de fontista predeterminado.
Se pueden actualizar con:
fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push MacOS proporciona fuentes que se pueden descargar manualmente con Font Book.app .
Para actualizar las fórmulas MacOS:
fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git pushClon el repositorio.
git clone https://github.com/fontist/fontistConfigurar su entorno.
bin/setupEjecute la suite de prueba
bin/rspecTodas las fórmulas de fontistas oficiales se mantienen en el repositorio de fórmulas.
Si desea agregar un nuevo repositorio de fórmulas o cambiar la configuración para uno existente, consulte su documentación.
La liberación se realiza automáticamente con acciones de GitHub. Solo golpea y etiqueta con gem-release .
Para una liberación de parche (0.0.x) use:
gem bump --version patch --tag --pushPara una liberación menor (0.x.0) Use:
gem bump --version minor --tag --pushPrimero, ¡gracias por contribuir! Nos encantan las solicitudes de TODOS. Al participar en este proyecto, usted otorga a Ribose el derecho de otorgar o transferir un número ilimitado de licencias o subgrimes no exclusivas a terceros, bajo los derechos de autor que cubren la contribución para usar la contribución de todos modos.
Estamos siguiendo las reglas de Sandi Metz para esta joya, puede leer la descripción de las reglas aquí. Todo el código nuevo debe seguir estas reglas. Si realiza cambios en un archivo preexistente que viola estas reglas, debe arreglar las violaciones como parte de su contribución.
Aquí hay algunas pautas técnicas a seguir:
Abra un tema para discutir una nueva característica.
Escriba pruebas para admitir su nueva función.
Asegúrese de que toda la suite de prueba pase localmente y en CI.
Abra una solicitud de extracción.
Aplastan sus compromisos después de recibir comentarios.
¡Fiesta!
Esta gema se desarrolla, mantiene y financia por Ribose.
