fontist
v1.21.1
Une bibliothèque simple pour trouver et télécharger des polices pour Windows, Linux et Mac.
Installez-le directement en tant que:
gem install fontist Ou utilisez-le dans le cadre de votre paquet en ajoutant cette ligne à Gemfile de votre application:
gem "fontist"Puis exécuter:
bundle install Après l'installation, veuillez récupérer les formules via la commande fontist :
fontist updateCela dépend du FFI-libarchive-binaire qui a les exigences suivantes:
zrib
Expatrié
OpenSSL (pour Linux uniquement)
Ces dépendances sont généralement présentes sur tous les systèmes.
fontistCes commandes permettent de fonctionner avec des polices via la ligne de commande.
La CLI prend correctement en charge l'état de sortie, donc dans un cas d'erreur, il renvoie un code d'état supérieur ou égal à 1 .
Les recherches sont insensibles à la facilité d'utilisation.
Toutes les commandes prennent en charge les options globales suivantes:
--preferred-familyRecherchez en utilisant le nom «Famille préféré» d'une police. (Au lieu du nom de «famille par défaut», la valeur par défaut avant le politiste v1.10.)
Note | Voir la v1.10 + pour les différences entre la «famille préférée» et la «famille par défaut». |
-q, --quietImprimez le moins d'informations possible, principalement des erreurs critiques.
-v, --verboseDéfinissez le niveau du journal pour déboguer. Il imprime les formules exclues lors de l'installation et des informations pour les développeurs de politistes.
-c, --no-cachePréférez le téléchargement direct même lorsqu'un fichier est déjà mis en cache dans un système.
fontist installLe politiste vérifie si cette police est déjà installée, et sinon, installe la police et renvoie ses chemins installés.
Le nom de police est le seul argument à fournir.
$ 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.TTFPar défaut, tous les styles correspondants (selon le nom de la «famille par défaut» de la police) sont installés.
Note | Avant la v1.10, le nom de la «famille préférée» de la police est utilisé pour correspondre aux styles pour la recherche. Voir vers v1.10 + pour plus de détails sur ce changement. |
Pour installer toutes les polices spécifiées dans une formule de fertiste, utilisez l'option -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 Ici, courier_prime est le nom de fichier de la formule située au référentiel de formule du politiste public ( courier_prime.yml ).
Vous pouvez également spécifier le nom lisible par l'homme de la formule. Ce nom est dérivé du nom de fichier, avec des soulignements remplacés par des espaces. Ce n'est pas sensible au cas, ce qui signifie que vous pouvez utiliser des majuscules si vous préférez.
$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "L'installation par le nom de formule prend en charge les suggestions dans la CLI lorsque la saisie est partielle:
$ 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: Note | La spécification du nom de fichier de la police n'est pas encore prise en charge. |
S'il existe plusieurs formules avec une police demandée, fontist recherche la dernière version de la police parmi les formules avec une taille inférieure à une limite (300 Mo). Ce comportement peut être modifié avec les options.
Note | Si les styles d'une police sont répartis entre plusieurs formules, tous les styles disponibles de toutes les formules seraient installés. |
Note | Certaines formules peuvent avoir l'attribut min_fontist , qui définit la version minimale du politiste par lequel ils peuvent être installés. Si fontist est d'une version plus ancienne, la formule est évitée pour l'utiliser. Afin de voir quelles formules ont été exclues de la recherche, l'option -v, --verbose peut être spécifiée. |
Options prises en charge:
-f, [--force]Installer même s'il est déjà installé dans le système
-F, [--formula]Installez une formule entière au lieu d'une police
-a, [--accept-all-licenses]Acceptez tous les accords de licence
-h, [--hide-licenses]Masquer les textes de licence
-p, [--no-progress]Masquer les progrès de téléchargement
-V, [--version=VERSION]Installez une version particulière d'une police
-s, [--smallest]Installez la plus petite police par la taille du fichier si plusieurs
-n, [--newest]Installez la dernière version d'une police si plusieurs
-S, [--size-limit=N]Spécifiez la limite supérieure pour la taille du fichier d'une formule à installer (par défaut est de 300 Mo)
-u, [--update-fontconfig]Mettre à jour FontConfig
Note | La commande install est similaire à l'appel de bibliothèque Font.install . |
fontist uninstallDésinstaller toute police soutenue par un politiste.
Renvoie les chemins d'une police désinstallée, ou imprime une erreur indiquant que la police n'est pas installée ou n'a pas pu être trouvée dans les formules polistes. Aliasé comme 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 des chemins de police installés avec une formule correspondante.
$ 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 listRépertorie l'état d'installation des polices prises en charge par le fonttiste.
$ 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-locationsRenvoie les emplacements des polices spécifiées dans un fichier YAML comme entrée.
$ fontist manifest-locations MANIFEST_FILE MANIFEST_FILE est l'emplacement d'un fichier manifeste qui contient la spécification d'un ou des styles de police et de police multiples.
Un fichier manifeste manifest.yml pourrait ressembler:
Segoe UI :
- Regular
- Bold
Roboto Mono :
- RegularLa commande suivante renverra la sortie YAML suivante:
$ 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 une ou plusieurs polices demandées sont manquantes, le code d'erreur "3" serait renvoyé et un message imprimé:
$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3fontist manifest-installInstallez les polices à partir d'un manifeste de polistes YAML:
$ fontist manifest-install --confirm-license manifest.yml Où manifest.yaml est:
---
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 configLe politiste prend en charge les paramètres à l'échelle du système pour les paramètres suivants:
fonts_path Définit le chemin où installer des polices (par défaut: ~/.fontist/fonts )
open_timeout Définit le délai d'ouverture d'une connexion pendant le téléchargement (par défaut: 10 )
read_timeout Définit le délai de lecture de la connexion ouverte pendant le téléchargement (par défaut: 10 )
Afficher les attributs actuels dans la configuration:
$ fontist config show
Current config:
read_timeout: 5Attribuer une valeur à un attribut:
$ fontist config set read_timeout 60Restaurer une valeur par défaut d'un attribut:
$ fontist config delete read_timeoutfontist fontconfigFontConfig est un logiciel conçu pour fournir des polices à d'autres programmes. Il est généralement utilisé sur Linux, mais également disponible sur macOS et Windows. Fontconfig est utilisé par LibreOffice, GIMP et de nombreux autres programmes.
Il afin de trouver des polices de politistes, FontConfig doit être mis à jour pour inclure des trajets de polistes. Cela peut être fait avec l'option --update-fontconfig de la commande install , ou en appelant une spéciale:
$ fontist fontconfig update Il créerait une configuration dans ~/.config/fontconfig/conf.d/10-fontist.conf .
Pour le supprimer, veuillez utiliser:
$ fontist fontconfig remove$ fontist cache clearLa commande ci-dessus effacera le cache de téléchargement de Fontist
fontist helpLa liste de toutes les commandes pouvait être vue par:
fontist help Par défaut, Fontist utilise le répertoire ~/.fontist pour stocker les polices et ses fichiers. Il pourrait être modifié avec la variable d'environnement FONTIST_PATH .
FONTIST_PATH= ~ /.fontist_new fontist updateFontist::Font Le Fontist::Font est votre endroit de prédilection pour faire face à n'importe quelle police utilisant un politiste.
Cette interface vous permet de trouver une police ou d'installer une police.
L'interface Fontist::Font.find peut être utilisée une police dans votre système.
Il examinera les répertoires de polices spécifiques au système d'exploitation, ainsi que dans le répertoire final ~/.fontist
Fontist :: Font . find ( name )Si le politiste trouve une police, il renverra les chemins.
Sinon, il augmentera une erreur de police non soutenue, soit déclenchera l'affichage des instructions d'installation pour cette police spécifique.
L'interface Fontist::Font.install peut être utilisée pour installer toute police prise en charge.
Cette interface vérifie d'abord si vous avez déjà cette police installée ou non et si vous le faites, il renverra les chemins.
Si vous n'avez pas de police mais que cette police est prise en charge par Fontist, il téléchargera la police et le copiera dans le répertoire ~/.fontist et renverra également les chemins.
Fontist :: Font . install ( name , confirmation : "no" )S'il y a des problèmes détectés avec la police fournie, comme la police n'est pas soutenue, ces erreurs seraient augmentées.
L'interface Fontist::Font expose une interface pour répertorier toutes les polices prises en charge.
Cela peut être utile si vous souhaitez connaître le nom de la police ou les styles disponibles. Vous pouvez le faire en utilisant:
Fontist :: Font . all Les valeurs de retour sont des objets OpenStruct , vous pouvez donc facilement effectuer toute autre opération que vous feriez dans n'importe quel objet Ruby.
Fontist::Formula Le GEM fontist utilise en interne l'interface Fontist::Formula pour trouver une formule ou des polices enregistrées prises en charge par n'importe quelle formule. Sauf si vous devez faire quoi que ce soit avec cela, vous ne devriez pas avoir besoin de travailler directement avec cette interface. Mais si vous le faites, ce sont l'interface publique qu'il propose.
L'interface Fontist::Formula.find vous permet de trouver l'une des formules enregistrées. Cette interface prend un nom de police comme argument et examine chacune des formules enregistrées qui offre cette installation de police. Usages:
Fontist :: Formula . find ( "Calibri" )Cette méthode recherchera et renverra une formule de fertiste pour le mot clé fourni qui permet un traitement ultérieur, tel que les vérifications de licence ou procéder à l'installation de la police dans votre système.
Normalement, chaque nom de police peut être associé à plusieurs styles ou collection, par exemple, la police Calibri peut contenir des polices de styles regular , bold ou italic et si vous voulez une interface qui peut renvoyer la liste complète, c'est votre ami.
Vous pouvez l'utiliser comme suivant:
Fontist :: Formula . find_fonts ( "Calibri" ) L'interface Fontist::Formula expose une interface pour répertorier toutes les formules de police enregistrées. Cela peut être utile si vous souhaitez connaître le nom de la formule ou quel type polisses peut être installé en utilisant cette formule. Usages:
Fontist :: Formula . all Les valeurs de retour sont des objets OpenStruct , vous pouvez donc facilement effectuer toute autre opération que vous feriez dans n'importe quel objet Ruby.
Fontist::Manifest Le politiste peut être commuté pour utiliser les noms de famille préférés. Ce format a été utilisé avant la V1.10.
Fontist . preferred_family = true Fontist::Manifest::LocationsLe politiste vous permet de trouver des emplacements de police d'un hachage manifeste défini dans le format suivant:
{
"Segoe UI" => [ "Regular" , "Bold" ] ,
"Roboto Mono" => [ "Regular" ]
}L'appel du code suivant renvoie un hachage imbriqué avec des chemins de police et des noms. Le nom de la police est utile pour choisir une police spécifique dans un fichier de collecte de polices (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 vous permet non seulement d'obtenir des emplacements de police, mais aussi d'installer des polices à partir du manifeste:
Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )Il installera les polices et renvoie leurs emplacements:
{
"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" ]
}
}
} Les deux commandes prennent en charge un fichier YAML en tant qu'entrée avec une méthode from_file . Par exemple, s'il existe un fichier manifest.yml contenant:
---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular Ensuite, les appels suivants rendraient les noms et les chemins de police, comme à partir de la méthode from_hash (voir Fontist::Manifest::Install et Fontist::Manifest::Locations ).
Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )Fontist::FontconfigSoutien du politiste Le travail avec FontConfig via l'interface 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 Les versions plus récentes de macOS fournissent des installations à la demande d'une large gamme de polices agréées. Ces polices complémentaires spécifiques au macOS peuvent être installées via un politiste.
Une utilisation typique pour installer des polices complémentaires MacOS consiste à permettre aux travaux CI sur les environnements MacOS d'utiliser ces polices spécialement autorisées non disponibles sur d'autres plates-formes.
Ce billet de blog décrit comment cela fonctionne:
Blog politiste: Installation des polices complémentaires spécifiques à MacOS
Par exemple, la police "Canela" est une police commerciale qui est gratuite avec macOS.
Exécutez cette commande pour installer Canela sur macOS.
$ fontist install CanelaLa liste complète des polices disponibles sur diverses versions macOS peut être trouvée sur le site de support Apple:
Polices dans MacOS 13 Ventura
Polières en macOS 12 Monteray
Polières en macOS 11 Big Sur
Avertissement | Le politiste n'autorise pas d'installer des polices spécifiques au macOS sur les plates-formes non MacOS en raison des restrictions de licence de police de ces polices. |
NISC18030.TTF (GB18030 Bitmap) - MacOS, plus d'informations dans le numéro NISC18030
La liste complète des polices problématiques connues:
Liste des polices exclues de l'utilisation
Le politiste utilise GIT en interne pour récupérer des formules et des polices.
Afin d'utiliser la fonctionnalité GIT derrière un proxy, vous devez mettre à jour votre propre configuration GIT via la commande git config ou le fichier de préférence ~/.gitconfig .
Il existe de nombreuses façons de configurer votre installation GIT locale pour utiliser des proxys.
La façon la plus simple et la plus globale de définir un proxy pour GIT est la suivante.
Pour http
git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}Pour HTTPS, vous devrez peut-être gérer les erreurs de vérification SSL / TLS après la définition du proxy car l'extrémité de chiffrement est située à votre point de terminaison proxy HTTPS:
git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}Pour les chaussettes, vous devrez décider du protocole de chaussettes
git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} 'Par exemple,
git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] ' La liste des protocoles de chaussettes pris en charge pour le champ {protocol} :
socks:// : pour les chaussettes en dessous de v5
socks5:// : pour les chaussettes v5
socks5h:// : pour les chaussettes en dessous de la résolution de l'hôte V5 + via les chaussettes
Vous pouvez réellement définir un comportement de proxy différent pour les référentiels GIT individuels - veuillez consulter ce grand guide sur la façon d'utiliser les proxys GIT (grâce à l'utilisateur GitHub Evantoli).
Un référentiel de polistes est un dépôt GIT qui contient des fichiers de formule YAML. Les formules polistes peuvent être créées manuellement dans un référentiel de polistes (voir des exemples) ou généré automatiquement à partir d'une archive de police.
Un référentiel de polistes peut être accessible via HTTPS ou SSH. Dans le cas de SSH, une clé SSH correspondante doit être configurée avec ssh-agent afin d'accéder à ce référentiel personnalisé.
La commande fontist repo setup obtient les formules d'un référentiel personnalisé et stocke le nom et l'URL du référentiel pour une utilisation ultérieure.
La commande fontist repo setup utilise la syntaxe suivante.
fontist repo setup NAME URL En interne, toutes les informations sur le référentiel de polistes personnalisées sont stockées à ~/.fontist/formulas/Formulas/private .
Par exemple, étant donné un référentiel de polistes appelé "acme" accessible via une URL ou une adresse SSH:
fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.gitfontist repo listUne fois le référentiel de polit personnalisé configuré, on peut installer des polices à partir du dépôt via ses formules:
fontist install " custom font " Si le référentiel de formule de polistes personnalisés est mis à jour, la commande repo update est utilisée pour tirer les dernières modifications:
fontist repo update NAMEPar exemple, étant donné un référentiel de polistes appelé "ACME", la commande suivante est utilisée.
fontist repo update acmeS'il est nécessaire de supprimer un référentiel de polistes enregistré, le repo peut être supprimé avec:
fontist repo remove acmeLes formules de polistes personnalisées et les référentiels de polistes peuvent être rendus privés pour nécessiter une authentification.
Pour les référentiels de polistes HTTPS et SSH Git
L'autorisation d'archives privées dans des formules privées peut être mise en œuvre avec des en-têtes.
Voici un exemple qui fonctionne avec les sorties 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 le référentiel de formule politaire est un repo GitHub, un jeton peut être obtenu sur la page GitHub Paramètres> Tokens. Ce jeton devrait avoir au moins la portée repo pour l'accès à ces actifs.
Les formules polistes peuvent être facilement fabriquées à la main dans YAML. Cependant, la méthode de génération automatique est recommandée pour la précision et la commodité des données.
Une formule pourrait être générée à partir d'une archive de polices.
La commande fontist create-formula permet de détecter tous les fichiers de police à partir d'une archive de police dans une multitude de formats (ceux pris en charge par excavation, y compris Zip, 7Z, GZIP, TAR, CAB, EXE).
La commande fontist create-formula prend en charge les archives situées sur des URL distantes ou des chemins de fichier locaux.
Pour les chemins de fichier, spécifiez le chemin du fichier comme argument:
wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zipPour les URL, spécifiez simplement l'URL comme argument:
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zipPour tester la formule créée, on peut copier la formule dans l'emplacement du référentiel de formule privé de l'utilisateur.
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/ La commande fontist create-formula crée des formules de police à l'aide d'informations intégrées dans la section des métadonnées OTF.
Cependant, certaines polices (comme les polices plus anciennes) contiennent souvent des informations de métadonnées incohérentes ou imparfaites. Certaines polices par exemple applique différentes valeurs Family OTF pour différents styles de police. Cela entraînera que tous les styles de police ne sont pas enregistrés dans la même famille.
Les auteurs de formules polistes peuvent rectifier cette situation en utilisant la clé override: qui permet à la formule de remplacer les informations de métadonnées obtenues à partir des métadonnées de police.
Note | La clé override ne provoque aucune modification des fichiers de police, il s'agit uniquement de mettre à jour les informations utilisées par le politiste en interne. |
La clé override existe sous la définition des styles de police individuels:
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 Par exemple, les polices "Frutiger" publiées par Adobe en 1994 utilisent des nombres pour représenter les styles de police individuels, et ont ces noms intégrés dans le domaine Family OTF, tels que "Frutiger 45 Light". Ces polices n'utilisent pas non plus le champ Preferred Family OTF, qui est un ajout plus récent à l'OTF, en raison de leur âge.
Voici comment la propriété override peut appliquer tous les styles pertinents à enregistrer sous le même nom de famille (en remplaçant la valeur 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
- ... Ce fragment ci-dessus permettra au politiste de générer des index corrects et de permettre l'installation de toutes les polices Frutiger avec une seule commande:
$ fontist install " Frutiger " --preferred-family Les versions polistes au-delà de V1.10 utilisent un nouveau format de formule. Après la mise à niveau, veuillez exécuter fontist update pour récupérer les dernières formules.
À partir de V1.10, Fontist utilise la «famille par défaut» au lieu de la «famille préférée» lors du regroupement des styles.
Par exemple, une demande de police «Lato» avant la V1.10 renverra tous les styles: «noir», «italique noire», «audacieux» et 15 autres styles.
À partir de V1.10, Fontist ne renverra que les 4 styles par défaut: «RETUAL», «Italique», «Bold» et «Italique audacieux».
Afin de récupérer d'autres styles, vous devez spécifier la police exacte «sous-famille», telle que «Lato Black», ou «Lato Heavy», ou utiliser l'option --preferred-family avec CLI et Fontist.preferred_family = true avec la bibliothèque Ruby.
Note | Avant la V1.10, il y avait un bug avec la formule de police «Courier», qui a permis à la police d'être installée lors de la demande du nom de la police «Courier», mais son emplacement de police n'a été obtenu qu'en utilisant le nom de police complet de «Courier New». À partir de la v1.10, le comportement a été rendu cohérent - seul le nom «nouveau» de Courier »doit être utilisé. |
Les versions polistes au-delà de V1.16 traitent différemment l'argument de font de la commande install . Après la mise à niveau, veuillez vous assurer que toutes les polices requises sont spécifiées lors de l'utilisation fontist install , fontist manifest-install (et de leur interface Ruby correspondante Font.install et Manifest::Install ), ou utilisez l'option -F, --formula formula.
À partir de la v1.16, le politiste installe uniquement les polices demandées au lieu d'une formule entière, sauf si spécifiée explicitement. changé maintenant.
Par exemple, une demande d'installation pour la police «Arial» avant la V1.16 configurera toutes les polices trouvées dans la formule «MS_TrUETYPE»: «Arial», «Trebuchet MS», «Verdana» et «Times New Roman».
À partir de la v1.16, Fontist n'installera que la police «Arial» demandée.
Pour installer toutes les polices à partir d'une formule, l'option -F, --formula peut être utilisée:
$ fontist install --formula ms_truetype Avertissement | Cette section est uniquement destinée aux responsables. |
Pour ajouter un nouvel attribut, modifiez la façon dont la formule est traitée ou remplace complètement la structure, il existe 2 façons de modifier un format de formule:
Utilisez l'attribut min_fontist dans une formule. Il définit une exigence pour le politiste d'installer la formule uniquement si sa version est égale ou supérieure à une version spécifiée.
Utilisez une nouvelle branche dans le repo des formules, par exemple "v2", "v3", "v4", etc. Après avoir créé une nouvelle branche, elle doit être définie dans Fontist.formulas_version
Note | L'utilisation d'une nouvelle branche obligerait tous les utilisateurs à redémarrer l'intégralité des formules. Étant donné que cette méthode a une surcharge importante, la première ( min_fontist ) doit être utilisée chaque fois que possible. |
Google Fonts fournit probablement la plus grande collection de polices largement utilisées, librement et ouvertement sous licence.
La bibliothèque de formule de Fontist comprend la prise en charge de toutes les polices sous licence ouvertement fournies par le biais de polices Google, et maintient des formules polistes pour toutes ces polices.
Un workflow GHA vérifie quotidiennement les polices mises à jour sur Google. Dans le cas où une mise à jour est trouvée, elle est ajoutée au dépôt par le workflow.
SIL International est une organisation à but non lucratif confessionnelle internationalement reconnue qui dessert les communautés linguistiques du monde entier.
SIL fournit un certain nombre de polices uniques qui prennent en charge les communautés linguistiques plus petites qui avec le code Unicode ne sont souvent pas (encore) prises en charge par des polices grand public.
Fontist vise à prendre en charge toutes les polices SIL et fournit leurs formules dans le référentiel de formule politaire par défaut.
Ils peuvent être mis à jour avec:
fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push MacOS fournit des polices qui peuvent être téléchargées manuellement avec Font Book.app .
Pour mettre à jour les formules macOS:
fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git pushClone le référentiel.
git clone https://github.com/fontist/fontistConfigurez votre environnement.
bin/setupExécutez la suite de test
bin/rspecToutes les formules polistes officielles sont conservées dans le référentiel de formules.
Si vous souhaitez ajouter un nouveau référentiel de formule ou modifier les paramètres pour un paramètre existant, veuillez vous référer à sa documentation.
La libération se fait automatiquement avec des actions GitHub. Il suffit de bosser et d'étiqueter avec gem-release .
Pour une version de patch (0.0.x) Utiliser:
gem bump --version patch --tag --pushPour une version mineure (0.x.0) Utiliser:
gem bump --version minor --tag --pushTout d'abord, merci d'avoir contribué! Nous aimons les demandes de traction de tout le monde. En participant à ce projet, vous accordez par la présente le droit d'accorder ou de transférer un nombre illimité de licences ou de sous-licences non exclusives à des tiers, en vertu du droit d'auteur couvrant la contribution à l'utilisation de la contribution par tous les moyens.
Nous suivons les règles de Sandi Metz pour ce joyau, vous pouvez lire la description des règles ici. Tous les nouveaux code doivent suivre ces règles. Si vous apportez des modifications dans un fichier préexistant qui viole ces règles, vous devez corriger les violations dans le cadre de votre contribution.
Voici quelques directives techniques à suivre:
Ouvrez un problème pour discuter d'une nouvelle fonctionnalité.
Écrivez des tests pour prendre en charge votre nouvelle fonctionnalité.
Assurez-vous que toute la suite de test passe localement et sur CI.
Ouvrez une demande de traction.
Écraser vos commits après avoir reçu des commentaires.
Faire la fête!
Ce joyau est développé, entretenu et financé par Ribose.
