fontist
v1.21.1
Eine einfache Bibliothek, um Schriftarten für Windows, Linux und Mac zu finden und herunterzuladen.
Installieren Sie es direkt als:
gem install fontist Oder verwenden Sie es als Teil Ihres Bundle, indem Sie diese Zeile zur Gemfile Ihrer Anwendung hinzufügen:
gem "fontist"Und dann ausführen:
bundle install Nach der Installation holen Sie sich bitte Formeln über den Befehl fontist :
fontist updateHängt vom FFI-Libarchive-Binär ab, der die folgenden Anforderungen hat:
Zlib
Expat
OpenSSL (nur für Linux)
Diese Abhängigkeiten sind im Allgemeinen in allen Systemen vorhanden.
fontistDiese Befehle ermöglichen es, über die Befehlszeile mit Schriftarten zu arbeiten.
Die CLI unterstützt den Exit -Status ordnungsgemäß, so dass in einem Fehlerfall ein Statuscode höher oder gleich als 1 zurückgibt.
Suchvorgänge sind unempfindlich für einfache Gebrauchten.
Alle Befehle unterstützen die folgenden globalen Optionen:
--preferred-familySuchen Sie mit dem Namen "bevorzugter Familien" einer Schriftart. (Anstelle des Namens "Standardfamilie", der Standard vor Fontist v1.10.)
Notiz | Sehen Sie sich die Unterschiede zwischen „bevorzugter Familie“ und „Standardfamilie“ an. |
-q, --quietDrucken Sie so wenig Informationen wie möglich, meist kritische Fehler.
-v, --verboseStellen Sie die Protokollebene auf Debugg ein. Es druckt Formeln, die während der Installation und Informationen für Entwickler von Schriftarten ausgeschlossen sind.
-c, --no-cacheBevorzugen Sie einen direkten Download auch, wenn eine Datei bereits in einem System zwischengespeichert wird.
fontist installFontist prüft, ob diese Schriftart bereits installiert ist. Wenn nicht, installiert sie die Schriftart und gibt ihre installierten Pfade zurück.
Der Schriftname ist das einzige Argument, das geliefert wird.
$ 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.TTFStandardmäßig werden alle übereinstimmenden Stile (gemäß dem "Standardfamiliennamen" der Schriftart) installiert.
Notiz | Vor V1.10 wird der Name der Schriftart „Preferred Family“ verwendet, um Stile für die Suche abzustimmen. Weitere Informationen zu dieser Änderung finden Sie in V1.10+. |
Um alle in einer Schriftartformel angegebenen Schriftarten zu installieren, verwenden Sie die 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 Hier ist courier_prime der Dateiname der Formel im öffentlichen Fontist -Formel -Repository ( courier_prime.yml ).
Sie können auch den menschlich lesbaren Namen der Formel angeben. Dieser Name leitet sich aus dem Dateinamen ab, wobei Unterstriche durch Räume ersetzt werden. Es ist kein Fallempfindlichkeit, dh Sie können Großbuchstaben verwenden, wenn Sie es vorziehen.
$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "Die Installation durch den Formelnamen unterstützt Vorschläge in CLI, wenn die Eingabe teilweise ist:
$ 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: Notiz | Das Angeben des Dateinamens der Schrift wird noch nicht unterstützt. |
Wenn es mehrere Formeln mit einer angeforderten Schriftart gibt, sucht fontist nach der neuesten Version der Schrift unter Formeln mit einer Größe unter einem Grenze (300 MB). Dieses Verhalten kann mit Optionen geändert werden.
Notiz | Wenn sich Stile einer Schrift unter mehreren Formeln verteilt, würden alle verfügbaren Stile aller Formeln installiert. |
Notiz | Einige Formeln haben möglicherweise das min_fontist Attribut, das die minimale Version des Schriftarts definiert, durch die sie installiert werden können. Wenn fontist eine ältere Version hat, wird die Formel vermieden. Um zu sehen, welche Formeln von der Suche ausgeschlossen wurden, kann die Option -v, --verbose -Option angegeben werden. |
Unterstützte Optionen:
-f, [--force]Installieren auch, wenn bereits im System installiert
-F, [--formula]Installieren Sie die ganze Formel anstelle einer Schriftart
-a, [--accept-all-licenses]Akzeptieren Sie alle Lizenzvereinbarungen
-h, [--hide-licenses]Lizenztexte ausblenden
-p, [--no-progress]Download -Fortschritt ausblenden
-V, [--version=VERSION]Installieren Sie eine bestimmte Version einer Schriftart
-s, [--smallest]Installieren Sie die kleinste Schrift nach Dateigröße, falls mehrere
-n, [--newest]Installieren Sie die neueste Version einer Schriftart, falls mehrere
-S, [--size-limit=N]Geben Sie die obere Grenze an, damit die Dateigröße einer Formel installiert wird (Standard ist 300 MB).
-u, [--update-fontconfig]Aktualisieren Sie Fontconfig
Notiz | Der Befehl install ähnelt dem Anruf der Font.install . |
fontist uninstallDeinstalliert jede Schriftart, die von Schriftarten unterstützt wird.
Gibt Pfade einer deinstallierten Schriftart zurück oder druckt einen Fehler aus, der zeigt, dass die Schriftart nicht installiert ist oder nicht in Fontist -Formeln gefunden werden kann. Aliased als 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 statusDrucke installiert Schriftart Pfade mit einer entsprechenden Formel.
$ 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 listListet der Installationsstatus von von Fontist unterstützten Schriftarten auf.
$ 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-locationsGibt als Eingabeposition von Schriftarten zurück, die in einer YAML -Datei angegeben sind.
$ fontist manifest-locations MANIFEST_FILE MANIFEST_FILE ist der Ort einer Manifestdatei, die die Spezifikation eines oder mehrere Schriftarten und Schriftarten enthält.
Eine Manifest -Datei manifest.yml könnte aussehen:
Segoe UI :
- Regular
- Bold
Roboto Mono :
- RegularDer folgende Befehl gibt die folgende YAML -Ausgabe zurück:
$ 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 "Wenn ein oder mehrere der angeforderten Schriftarten fehlen, wird der "3" -Fehlercode zurückgegeben und eine Nachricht gedruckt:
$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3fontist manifest-installInstallieren Sie Schriftarten aus einem Yaml -Schriftartenmanifest:
$ fontist manifest-install --confirm-license manifest.yml Wo manifest.yaml ist:
---
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 unterstützt systemweite Einstellungen für die folgenden Parameter:
fonts_path Legt Pfad fest, wo die Schriftarten installiert werden sollen (Standard: ~/.fontist/fonts )
open_timeout Legt Zeitlimit für das Öffnen einer Verbindung beim Download fest (Standard: 10 )
read_timeout Legt Timeout für das Lesen der geöffneten Verbindung während des Downloads fest (Standard: 10 )
Zeigen Sie aktuelle Attribute in der Konfiguration:
$ fontist config show
Current config:
read_timeout: 5Weisen Sie einem Attribut einen Wert zu:
$ fontist config set read_timeout 60Stellen Sie einen Standardwert eines Attributs wieder her:
$ fontist config delete read_timeoutfontist fontconfigFontconfig ist eine Software, die für andere Programme Schriftarten bereitstellt. Es wird normalerweise unter Linux verwendet, aber auch unter macOS und Windows verfügbar. Fontconfig wird von Libreoffice, GIMP und vielen anderen Programmen verwendet.
Es sollte fontist -Schriftarten finden. Fontconfig sollte aktualisiert werden, um Schriftarten aufzunehmen. Es kann mit der Option --update-fontconfig des install oder durch Aufrufen eines besonderen:
$ fontist fontconfig update Es würde eine Konfiguration in ~/.config/fontconfig/conf.d/10-fontist.conf erstellen.
Um es zu entfernen, verwenden Sie bitte:
$ fontist fontconfig remove$ fontist cache clearDer obige Befehl löscht den Download -Cache von Fontist
fontist helpDie Liste aller Befehle konnte sehen, wie:
fontist help Standardmäßig verwendet Fontist das ~/.fontist Verzeichnis, um Schriftarten und seine Dateien zu speichern. Es könnte mit der Umgebungsvariablen FONTIST_PATH geändert werden.
FONTIST_PATH= ~ /.fontist_new fontist updateFontist::Font Die Fontist::Font ist Ihre Anlaufstelle, um mit einer Schriftart mit Schriftarten umzugehen.
Mit dieser Schnittstelle können Sie eine Schriftart oder eine Schriftart installieren.
Die Fontist::Font.find -Schnittstelle kann eine Schriftart in Ihrem System verwendet werden.
Es wird in die operativssystemspezifischen Schriftverzeichnisse sowie das fontistspezifische ~/.fontist Verzeichnis untersucht.
Fontist :: Font . find ( name )Wenn Fontist eine Schriftart findet, wird die Pfade zurückgegeben.
Andernfalls wird entweder einen nicht unterstützten Schriftart Fehler angezeigt oder die Anzeige von Installationsanweisungen für diese bestimmte Schriftart ausgelöst.
Die Schnittstelle Fontist::Font.install kann verwendet werden, um eine unterstützte Schriftart zu installieren.
Diese Schnittstelle überprüft zuerst, wenn Sie bereits diese Schriftart installiert haben oder nicht, und wenn Sie dies tun, gibt es die Pfade zurück.
Wenn Sie keine Schriftart haben, diese Schriftart jedoch vom Schriftart unterstützt wird, wird die Schriftart heruntergeladen und in ~/.fontist -Verzeichnis kopiert und auch die Pfade zurückgegeben.
Fontist :: Font . install ( name , confirmation : "no" )Wenn Probleme mit der bereitgestellten Schriftart entdeckt werden, wie beispielsweise die Schriftart nicht unterstützt, würden diese Fehler aufgeworfen.
Die Fontist::Font -Schnittstelle enthält eine Schnittstelle, um alle unterstützten Schriftarten aufzulisten.
Dies kann nützlich sein, wenn Sie den Namen der Schriftart oder die verfügbaren Stile kennenlernen möchten. Sie können dies tun, indem Sie:
Fontist :: Font . all Die Rückgabewerte sind OpenStruct -Objekte, sodass Sie problemlos eine andere Operation durchführen können, die Sie in jedem Ruby -Objekt ausführen würden.
Fontist::Formula Das fontist Juwn verwendet intern die Fontist::Formula -Schnittstelle, um eine registrierte Formel oder Schriftarten zu finden, die von einer beliebigen Formel unterstützt wird. Wenn Sie nichts damit tun müssen, sollten Sie nicht direkt mit dieser Schnittstelle arbeiten müssen. Aber wenn Sie dies tun, sind dies die öffentliche Schnittstelle, die sie bietet.
Mit der Fontist::Formula.find -Schnittstelle können Sie eine der registrierten Formel finden. Diese Schnittstelle nimmt einen Schriftnamen als Argument an und schaut durch jede der registrierten Formel, die diese Schriftinstallation anbietet. Verwendungen:
Fontist :: Formula . find ( "Calibri" )Diese Methode sucht und gibt eine Schriftartenformel für das bereitgestellte Schlüsselwort durch und gibt eine weitere Bearbeitung ermöglicht, z. B. Lizenzprüfungen oder mit der Installation der Schriftart in Ihrem System.
Normalerweise kann jeder Schriftname mehrerer Stile oder Sammlung zugeordnet werden, beispielsweise die Calibri -Schriftart enthält möglicherweise eine regular , bold oder italic Styles -Schriftarten. Wenn Sie eine Schnittstelle wünschen, die die vollständige Liste zurückgeben kann, ist dies Ihr Freund.
Sie können es als folgenden verwenden:
Fontist :: Formula . find_fonts ( "Calibri" ) Die Schnittstelle Fontist::Formula enthält eine Schnittstelle zur Auflistung aller registrierten Schriftarten. Dies kann nützlich sein, wenn Sie den Namen der Formel wissen möchten oder welche Art von Schriftarten mit dieser Formel installiert werden können. Verwendungen:
Fontist :: Formula . all Die Rückgabewerte sind OpenStruct -Objekte, sodass Sie problemlos eine andere Operation durchführen können, die Sie in jedem Ruby -Objekt ausführen würden.
Fontist::Manifest Fontist kann um die bevorzugten Familiennamen umgestellt werden. Dieses Format wurde vor V1.10 verwendet.
Fontist . preferred_family = true Fontist::Manifest::LocationsMit Fontist können Sie im folgenden Format Schriftstellen von Schriftarten aus einem definierten Manifest -Hash finden:
{
"Segoe UI" => [ "Regular" , "Bold" ] ,
"Roboto Mono" => [ "Regular" ]
}Das Aufrufen des folgenden Codes gibt einen verschachtelten Hash mit Schriftart und Namen zurück. Der Schriftname ist nützlich, um eine bestimmte Schriftart in einer Schriftstellungsdatei (TTC) auszuwählen.
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::InstallMit Fontist können Sie nicht nur Schriftstellen erhalten, sondern auch Schriftarten aus dem Manifest installieren:
Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )Es werden Schriftarten installiert und ihre Standorte zurückgeben:
{
"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" ]
}
}
} Beide Befehle unterstützen eine YAML -Datei als Eingabe mit einer aus der Methode from_file . Zum Beispiel, wenn es eine manifest.yml -Datei gibt, die Folgendes enthält:
---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular Anschließend würden die folgenden Anrufe Schriftnamen und Pfade zurückgeben, wie aus der aus der from_hash -Methode (siehe Fontist::Manifest::Install und Fontist::Manifest::Locations ).
Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )Fontist::FontconfigFontist unterstützt die Arbeit mit Fontconfig über die Ruby -Schnittstelle:
Fontist :: Fontconfig . update # let detect fontist fonts
Fontist :: Fontconfig . remove # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists Neuere Versionen von macOS bieten On-Demand-Installationen einer Vielzahl von lizenzierten Schriftarten. Diese macOS-spezifischen Add-On-Schriftarten können über Schriftarten installiert werden.
Eine typische Verwendung zur Installation von MacOS-Add-On-Schriftarten besteht darin, CI-Jobs in MacOS-Umgebungen zu ermöglichen, diese speziell lizenzierten Schriftarten zu verwenden, die auf anderen Plattformen nicht verfügbar sind.
Dieser Blog -Beitrag beschreibt, wie dies funktioniert:
Fontist Blog: Installieren von macOS-spezifischen Add-On-Schriftarten
Zum Beispiel ist die Schriftart "Canela" eine kommerzielle Schriftart, die mit macOS kostenlos ausgestattet ist.
Führen Sie diesen Befehl aus, um Canela auf macOS zu installieren.
$ fontist install CanelaDie vollständige Liste der verfügbaren Schriftarten in verschiedenen MacOS -Versionen finden Sie auf der Apple Support -Website:
Schriftarten in MacOS 13 Ventura
Schriftarten in macOS 12 Montemay
Schriftarten in macOS 11 Big Sur
Warnung | Fontist erlaubt es nicht, macOS-spezifische Schriftarten auf Nicht-Makos-Plattformen zu installieren, da diese Schriftarten eingestuft werden. |
NISC18030.ttf (GB18030 Bitmap) - macOS, Weitere Informationen in der Ausgabe NISC18030
Die vollständige Liste der bekannten problematischen Schriftarten:
Liste der Schriftarten, die von der Nutzung ausgeschlossen sind
Fontist verwendet Git intern, um Formeln und Schriftarten abzurufen.
Um die GIT -Funktionalität hinter einem Proxy zu verwenden, müssen Sie Ihre eigene Git -Konfiguration über den Befehl git config oder die Präferenzdatei ~/.gitconfig aktualisieren.
Es gibt viele Möglichkeiten, Ihre lokale GIT -Installation so zu konfigurieren, dass sie Proxys verwenden.
Die einfachste, globale Art, einen Proxy für Git festzulegen, ist die folgende.
Für http
git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}Für HTTPS müssen Sie möglicherweise SSL/TLS -Überprüfungsfehler verarbeiten, nachdem Sie den Proxy festgelegt haben, da sich das Verschlüsselungsende an Ihrem HTTPS -Proxy -Endpunkt befindet:
git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}Für Socken müssen Sie sich für das Sockenprotokoll entscheiden
git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} 'Zum Beispiel,
git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] ' Die Liste der unterstützten Sockenprotokolle für das Feld {protocol} :
socks:// : Für Socken unten v5
socks5:// : Für Socken v5
socks5h:// : Für Socken unterhalb von V5 + Hostauflösung über Socken
Sie könnten tatsächlich ein anderes Proxy -Verhalten für einzelne Git -Repositories festlegen. Weitere Informationen zum Verwenden von Git -Proxies finden Sie in dieser großartigen Anleitung (dank des GitHub -Benutzer Evantoli).
Ein Fontist -Repository ist ein Git -Repo, das YAML -Formeldateien enthält. Fontist-Formeln können in einem Fontist-Repository (siehe Beispiele) manuell erstellt oder aus einem Schriftart-Archiv automatisch generiert werden.
Auf ein Fontist -Repository kann entweder über HTTPS oder SSH zugegriffen werden. Im Falle von SSH sollte ein entsprechender SSH-Schlüssel mit ssh-agent eingerichtet werden, um auf dieses benutzerdefinierte Repository zuzugreifen.
Der Befehl fontist repo setup holt die Formeln eines benutzerdefinierten Repositorys und speichert den Namen und die URL des Repositorys für die spätere Verwendung.
Der Befehl fontist repo setup verwendet die folgende syntax.
fontist repo setup NAME URL Intern werden alle benutzerdefinierten Fontist -Repository -Informationen unter ~/.fontist/formulas/Formulas/private gespeichert.
Bei einem Schriftart -Repository mit dem Namen "ACME" über eine URL oder eine SSH -Adresse beispielsweise: "ACME":
fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.gitfontist repo listSobald das benutzerdefinierte Fontist -Repository eingerichtet ist, kann man Schriftarten aus dem Repo über seine Formeln installieren:
fontist install " custom font " Wenn das Repository für benutzerdefinierte Fontist -Formel aktualisiert wird, wird der Befehl repo update verwendet, um die neuesten Änderungen abzurufen:
fontist repo update NAMEBeispielsweise wird bei einem Fontist -Repository namens "ACME" der folgende Befehl verwendet.
fontist repo update acmeWenn ein registriertes Schriftart -Repository entfernen muss, kann das Repo mit:
fontist repo remove acmeCustom Fontist Formeln und Fontist -Repositories können privat gemacht werden, um eine Authentifizierung zu erfordern.
Für HTTPS- und SSH -Git -Fontist -Repositories
Die Genehmigung von privaten Archiven in privaten Formeln kann mit Kopfzeilen implementiert werden.
Hier ist ein Beispiel, das mit Github -Veröffentlichungen funktioniert:
resources :
fonts.zip :
urls :
- url : https://example.com/repos/acme/formulas/releases/assets/38777461
headers :
Accept : application/octet-stream
Authorization : token ghp_1234567890abcdefghi Wenn das Repository für das Fontist -Formel ein Github -Repo ist, kann ein Token auf der Seite GitHub -Einstellungen> Tokens erhalten werden. Dieses Token sollte zumindest den repo -Bereich für den Zugang zu diesen Vermögenswerten haben.
Fontist-Formeln können in Yaml leicht von Hand hergestellt werden. Die automatische Generationmethode wird jedoch für die Genauigkeit und Bequemlichkeit von Daten empfohlen.
Eine Formel könnte aus einem Schriftenarchiv erzeugt werden.
Mit dem Befehl fontist create-formula ermöglicht das Erkennen aller Schriftartdateien aus einem Schriftart-Archiv in einer Vielzahl von Formaten (die von Ausgrabungen unterstützt werden, einschließlich ZIP, 7Z, GZIP, TAR, CAB, EXE).
Der Befehl fontist create-formula unterstützt Archive an Remote-URLs oder lokalen Dateipfaden.
Geben Sie für Dateipfade den Dateipfad als Argument an:
wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zipGeben Sie für URLs einfach die URL als Argument an:
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zipUm die erstellte Formel zu testen, kann man die Formel in den privaten Formel -Repository -Speicherort des Benutzers kopieren.
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/ Der Befehl fontist create-formula erstellt Schriftformeln unter Verwendung von Informationen, die in den Abschnitt OTF-Metadaten eingebettet sind.
Einige Schriftarten (z. B. ältere Schriftarten) enthalten jedoch häufig inkonsistente oder unvollständige Metadateninformationen. Einige Schriftarten wenden beispielsweise verschiedene OTF Family für verschiedene Schriftstile an. Dies führt dazu, dass alle Schriftarten nicht in derselben Familie registriert werden.
Autoren der Schriftartformel können diese Situation mithilfe der override: Taste korrigieren, mit der die Formel über die von den Schriftartmetadaten erhaltenen Metadateninformationen überschreiben kann.
Notiz | Der override führt zu einer Änderung der Schriftartdateien, sondern nur zur Aktualisierung von Informationen, die von Schriftarten intern verwendet werden. |
Der override existiert unter der Definition einzelner Schriftstile:
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 Zum Beispiel verwenden die von Adobe 1994 veröffentlichten "Frrutiger" -Schriftarten die einzelnen Schriftstile dar, und haben diese Namen in das Bereich der OTF Family eingebettet, wie z. B. "Frrutiger 45 Light". Diese Schriftarten verwenden auch das OTF Preferred Family , das aufgrund ihres Alters eine neuere Ergänzung zu OTF ist.
So kann die override -Eigenschaft alle relevanten Stile erzwingen, die unter demselben Familiennamen registriert werden sollen (indem der Wert bevorzugt die Wertschöpfung 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
- ... In diesem obigen Fragment kann Schriftarten korrekte Indizes generieren und die Installation aller Frutiger -Schriftarten mit einem einzigen Befehl ermöglichen:
$ fontist install " Frutiger " --preferred-family Fontist -Versionen jenseits von V1.10 verwenden ein neues Formelformat. Führen Sie nach dem Upgrade fontist update aus, um die neuesten Formeln abzurufen.
Ab V1.10 verwendet Fontist beim Gruppierstil die "Standardfamilie" anstelle der "bevorzugten Familie".
Beispielsweise wird eine Anfrage für die Schriftart "Lato" vor V1.10 alle Stile zurückgeben: "Schwarz", "schwarz italisch", "mutig" und 15 andere Stile.
Ab V1.10 wird Fontist nur die 4 Standardstile zurückgeben: „regulär“, „Italic“, „mutig“ und „mutig Italic“.
Um andere Stile zu holen, müssen Sie die genaue Schriftart „Unterfamilie“ wie „Lato Black“ oder „Lato Heavy“ angeben oder die Option --preferred-family mit CLI und Fontist.preferred_family = true mit der Ruby-Bibliothek verwenden.
Notiz | Vor V1.10 gab es einen Fehler mit der Schriftformel „Kurier“, mit der die Schriftart installiert wurde, als sie den Schriftnamen „Courier“ anforderte, aber der Ort der Schriftart war nur mit dem vollständigen Namen „Courier New“ erhältlich. Ab V1.10 wurde das Verhalten konsistent gemacht - nur der richtige „Kurier -neue“ Name sollte verwendet werden. |
Fontist -Versionen jenseits von V1.16 behandeln das font des install unterschiedlich. Stellen Sie nach dem Upgrade sicher, dass alle erforderlichen Schriftarten angegeben werden, wenn fontist install , fontist manifest-install (und deren entsprechende Ruby Interface Font.install und Manifest::Install ) oder die Option -F, --formula verwendet werden.
Ab V1.16 installiert Fontist nur Schriftarten anstelle einer ganzen Formel, sofern nicht ausdrücklich angegeben. jetzt geändert.
Beispielsweise wird eine Installationsanforderung für die Schriftart "Arial" vor V1.16 alle in der Formel "ms_trueType" gefundenen Schriftarten, "Arial", "Trebuchet MS", "Verdana" und "Times New Roman" festgelegt.
Ab V1.16 wird Fontist nur die angeforderte „Arial“ -Schriftart installiert.
Um alle Schriftarten aus einer Formel zu installieren, kann die Option -F, --formula verwendet werden:
$ fontist install --formula ms_truetype Warnung | Dieser Abschnitt gilt nur für Fontist -Betreuer. |
Um ein neues Attribut hinzuzufügen, ändern Sie die Art und Weise, wie die Formel behandelt wird oder die Struktur vollständig ersetzt. Es gibt zwei Möglichkeiten, ein Formelformat zu ändern:
Verwenden Sie das Attribut min_fontist in einer Formel. Es ist eine Anforderung an, dass Schriftarten die Formel nur dann installieren, wenn ihre Version gleich oder mehr als eine angegebene Version ist.
Verwenden Sie einen neuen Zweig in den Formeln Repo, z. "V2", "v3", "v4" usw. Nach dem Erstellen eines neuen Zweigs sollte er in Fontist.formulas_version definiert werden
Notiz | Durch die Verwendung einer neuen Filiale müssen alle Benutzer das gesamte Formeln neu herunterladen. Da diese Methode einen signifikanten Overhead aufweist, sollte der erstere ( min_fontist ) nach Möglichkeit verwendet werden. |
Google Fonts bietet wahrscheinlich die größte Sammlung weit verbreiteter, frei und offen lizenzierter Schriftarten.
Die Formelbibliothek von Fontist beinhaltet die Unterstützung aller offen lizenzierten Schriftarten, die über Google-Schriftarten bereitgestellt werden, und pflegt Fontist-Formeln für alle dieser Schriftarten.
Ein GHA -Workflow überprüft täglich auf aktualisierten Schriftarten auf Google -Schriftarten. Falls ein Update gefunden wird, wird das Repo vom Workflow hinzugefügt.
SIL International ist eine international anerkannte gemeinnützige Organisation, die weltweit Sprachgemeinschaften dient.
SIL liefert eine Reihe einzigartiger Schriftarten, die kleinere Sprachgemeinschaften unterstützen, die mit Unicode -Code häufig (noch) nicht (noch) von Mainstream -Schriftarten unterstützt werden.
Fontist strebt alle SIL -Schriftarten an und stellt ihre Formeln im Standard -Repository für Fontist -Formel zur Verfügung.
Sie können aktualisiert werden mit:
fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push MacOS bietet Schriftarten, die manuell mit Font Book.app heruntergeladen werden können.
So aktualisieren Sie MacOS -Formeln:
fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git pushKlonen Sie das Repository.
git clone https://github.com/fontist/fontistRichten Sie Ihre Umgebung ein.
bin/setupFühren Sie die Testsuite aus
bin/rspecAlle offiziellen Schriftartenformeln werden im Formeln -Repository aufbewahrt.
Wenn Sie ein neues Formel -Repository hinzufügen oder Einstellungen für eine vorhandene ändern möchten, finden Sie in der Dokumentation.
Das Freisetzung erfolgt automatisch mit GitHub -Aktionen. Einfach mit gem-release beenden und markieren.
Für eine Patch -Release (0.0.x) Verwendung:
gem bump --version patch --tag --pushFür eine kleine Veröffentlichung (0.x.0) Verwendung:
gem bump --version minor --tag --pushErstens, danke, dass Sie beigetragen haben! Wir lieben es, Anfragen von allen zu ziehen. Durch die Teilnahme an diesem Projekt gewähren Sie Ribose das Recht, eine unbegrenzte Anzahl nicht ausschließlicher Lizenzen oder Unterlizenzen an Dritte zu gewähren oder zu übertragen, im Rahmen des Urheberrechts, der den Beitrag zur Verwendung des Beitrags auf alle Weise abdeckt.
Wir folgen den Regeln von Sandi Metz für dieses Juwel, Sie können die Beschreibung der Regeln hier lesen. Alle neuen Code sollten diese Regeln befolgen. Wenn Sie Änderungen in einer bereits bestehenden Datei vornehmen, die gegen diese Regeln verstoßen, sollten Sie die Verstöße im Rahmen Ihres Beitrags festlegen.
Hier sind einige technische Richtlinien, die folgt:
Öffnen Sie ein Problem, um eine neue Funktion zu besprechen.
Schreiben Sie Tests, um Ihre neue Funktion zu unterstützen.
Stellen Sie sicher, dass die gesamte Testsuite lokal und auf CI verläuft.
Öffnen Sie eine Pull -Anfrage.
Machen Sie Ihre Commits nach dem Feedback.
Party!
Dieses Juwel wird durch Ribose entwickelt, gewartet und finanziert.
