fontist Download fontistソースコードのダウンロード

fontist

フォントのダウンロード

v1.21.1

ダウンロード

ファンティスト

Windows、Linux、Mac用のフォントを見つけてダウンロードする簡単なライブラリ。

インストール

直接インストールしてください：

gem install fontist

または、アプリケーションのGemfileにこの行を追加して、バンドルの一部として使用します。

 gem "fontist"

そして実行してください：

bundle install

フォーミュラを取得します

インストール後、 fontistコマンドを介してフォーミュラを取得してください。

fontist update

依存関係

次の要件があるFFI-libarchive-binaryに依存します。

Zlib
外国人
openSSL（Linuxのみ）

これらの依存関係は一般にすべてのシステムに存在します。

コマンドラインインターフェイス（CLI）の使用

`fontist`コマンド

これらのコマンドは、コマンドラインを介してフォントで操作できるようにします。

CLIはExitステータスを適切にサポートするため、エラーの場合、ステータスコードを1以下のステータスコードを返します。

検索は、使いやすさのためにケース非感受性です。

すべてのコマンドは、次のグローバルオプションをサポートしています。

--preferred-family: フォントの「優先家族」名を使用して検索します。（「デフォルトの家族」名の代わりに、Fontist v1.10の前のデフォルトです。）

注記	「優先家族」と「デフォルトファミリー」の違いについては、v1.10+を参照してください。

-q, --quiet: できるだけ少ない情報を印刷し、ほとんどが重要なエラーです。
-v, --verbose: ログレベルをデバッグに設定します。インストール中に除外されたフォーミュラを印刷し、フォンティストの開発者向けの情報を印刷します。
-c, --no-cache: ファイルがシステムですでにキャッシュされている場合でも、直接ダウンロードを好みます。

フォントのインストール： `fontist install`

Fontistは、このフォントが既にインストールされているかどうかを確認し、そうでない場合はフォントをインストールし、インストールされたパスを返します。

フォント名は、提供される唯一の引数です。

$ 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.TTF

デフォルトでは、すべてのマッチングスタイル（フォントの「デフォルトファミリ」名に従って）がインストールされています。

注記	V1.10の前に、フォントの「優先ファミリー」名は、検索のスタイルを一致させるために使用されます。その変更の詳細については、v1.10+を参照してください。

Fontist式で指定されたすべてのフォントをインストールするには、 -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

ここでは、 courier_prime 、公開フォンティストフォーミュラリポジトリ（ courier_prime.yml ）にあるフォーミュラのファイル名です。

フォーミュラの人間の読み取り可能な名前を指定することもできます。この名前はファイル名から派生し、アンダースコアはスペースに置き換えられます。それはケースに敏感ではありません。つまり、必要に応じて大文字を使用できます。

$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "

フォーミュラ名によるインストールは、入力が部分的な場合、CLIでの提案をサポートしています。

$ 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:

注記	フォントのファイル名を指定することはまだサポートされていません。

要求されたフォントを備えたいくつかの式がある場合、 fontist 、サイズが制限（300 MB）未満のフォーミュラ間の最新バージョンを検索します。この動作はオプションで変更できます。

注記	フォントのスタイルがいくつかの式に広がっている場合、すべての式から利用可能なすべてのスタイルがインストールされます。

注記	一部の式には、 `min_fontist`属性がある場合があります。これは、インストールできるFontistの最小バージョンを定義します。 `fontist`が古いバージョンの場合、式は使用されません。どの式が検索から除外されたかを確認するために、 `-v, --verbose`オプションを指定できます。

サポートされているオプション：

-f, [--force]: システムに既にインストールされていてもインストールしてください
-F, [--formula]: フォントの代わりにフォーミュラ全体をインストールします
-a, [--accept-all-licenses]: すべてのライセンス契約を受け入れます
-h, [--hide-licenses]: ライセンステキストを非表示にします
-p, [--no-progress]: ダウンロードの進行状況を非表示にします
-V, [--version=VERSION]: 特定のバージョンのフォントをインストールします
-s, [--smallest]: いくつかの場合、ファイルサイズで最小のフォントをインストールします
-n, [--newest]: いくつかの場合、最新バージョンのフォントをインストールします
-S, [--size-limit=N]: インストールする式のファイルサイズの上限を指定します（デフォルトは300 MBです）
-u, [--update-fontconfig]: fontconfigを更新します

注記	`install`コマンドは、 `Font.install`ライブラリ呼び出しに似ています。

アンインストールフォント： `fontist uninstall`

Fontistがサポートするフォントをアンインストールします。

アンインストールされたフォントのパスを返すか、フォントがインストールされていないか、フォンティスト式で見つからないことを示すエラーを印刷します。 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.TTF

ステータス： `fontist status`

対応する式でインストールされたフォントパスを印刷します。

$ 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 list`

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-locations`

YAMLファイルで指定されたフォントの場所を入力として返します。

$ fontist manifest-locations MANIFEST_FILE

MANIFEST_FILEは、1つまたは複数のフォントスタイルとフォントスタイルの仕様を含むマニフェストファイルの場所です。

マニフェストファイルmanifest.yml次のようになります。

 Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

次のコマンドは、次の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 "

要求されたフォントの1つ以上が欠落している場合、「3」エラーコードが返され、メッセージが印刷されます。

$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3

マニフェストからフォントをインストール： `fontist manifest-install`

YAMLフォンティストマニフェストからフォントをインストールします。

$ fontist manifest-install --confirm-license manifest.yml

manifest.yaml次のとおりです。

---
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 Config： `fontist config`で動作します

Fontistは、次のパラメーターのシステム全体の設定をサポートしています。

fonts_path: フォントをインストールする場所を設定します（デフォルト： ~/.fontist/fonts ）
open_timeout: ダウンロード中に接続を開くためのタイムアウトを設定します（デフォルト： 10 ）
read_timeout: ダウンロード中に開いた接続を読むためのタイムアウトを設定します（デフォルト： 10 ）

構成に現在の属性を表示します。

$ fontist config show
Current config:
read_timeout: 5

属性に値を割り当てます。

$ fontist config set read_timeout 60

属性のデフォルト値を復元します。

$ fontist config delete read_timeout

fontconfig： `fontist fontconfig`を使用します

FontConfigは、他のプログラムにフォントを提供するように設計されたソフトウェアです。通常、Linuxで使用されますが、MacOSやWindowsでも使用できます。 FontConfigは、Libreoffice、Gimp、およびその他の多くのプログラムで使用されています。

Fontist Fontsを見つけるために、FontConfigを更新してFontistパスを含める必要があります。 installコマンドの--update-fontconfigオプションで、または特別なコマンドを呼び出すことで実行できます。

$ fontist fontconfig update

~/.config/fontconfig/conf.d/10-fontist.confで構成を作成します。

それを削除するには、使用してください：

$ fontist fontconfig remove

キャッシュを使用して作業します

$ fontist cache clear

上記のコマンドは、Fontistのダウンロードキャッシュをクリアします

ヘルプ： `fontist help`

すべてのコマンドのリストは、次のように見ることができます。

fontist help

環境変数を使用した構成

デフォルトでは、fontistは~/.fontistディレクトリを使用してフォントとそのファイルを保存します。 FONTIST_PATH環境変数で変更できます。

FONTIST_PATH= ~ /.fontist_new fontist update

Rubyライブラリを使用します

`Fontist::Font`

Fontist::Font Fontistを使用してフォントに対処するための頼りになる場所です。

このインターフェイスを使用すると、フォントを見つけたり、フォントをインストールしたりできます。

フォントを見つける

Fontist::Font.findインターフェイスは、システムにフォントを検索することができます。

オペレーティングシステム固有のフォントディレクトリ、およびFontist固有の~/.fontistディレクトリも検討します。

 Fontist :: Font . find ( name )

Fontistがフォントを見つけた場合、パスを返します。
それ以外の場合は、サポートされていないフォントエラーが発生するか、その特定のフォントのインストール命令のトリガーディスプレイが表示されます。

フォントを取り付けます

Fontist::Font.installインターフェイスを使用して、サポートされているフォントをインストールできます。

このインターフェイスは、最初にそのフォントがインストールされているかどうかを確認し、そうであればパスを返します。

フォントがないが、そのフォントがフォンティストによってサポートされている場合、フォントをダウンロードして~/.fontistディレクトリにコピーし、パスを返します。

 Fontist :: Font . install ( name , confirmation : "no" )

フォントがサポートされていないなど、提供されたフォントで検出された問題がある場合、それらのエラーは発生します。

すべてのフォントをリストします

Fontist::Font Interfaceは、インターフェイスを公開して、サポートされているすべてのフォントをリストします。

これは、フォントの名前または使用可能なスタイルを知りたい場合に役立つ場合があります。使用することでそれを行うことができます。

 Fontist :: Font . all

戻り値はOpenStructオブジェクトであるため、Rubyオブジェクトで実行する他の操作を簡単に実行できます。

`Fontist::Formula`

fontist GEMは、任意の式でサポートされている登録式またはフォントを見つけるためにFontist::Formulaインターフェイスを内部的に使用します。場合を除き、このインターフェイスを直接操作する必要はないということを行う必要があります。しかし、もしそうなら、これらはそれが提供するパブリックインターフェースです。

式を見つけます

Fontist::Formula.findインターフェイスを使用すると、登録式のいずれかを見つけることができます。このインターフェイスは、フォント名を引数として受け取り、このフォントインストールを提供する登録式の各式を調べます。使用法：

 Fontist :: Formula . find ( "Calibri" )

このメソッドは、ライセンスチェックやシステムにフォントのインストールを続行するなど、さらなる処理を可能にする提供されたキーワードのフォンティスト式を検索して返します。

フォーミュラでサポートされているフォントスタイルをリストします

通常、各フォント名は複数のスタイルまたはコレクションに関連付けることができます。たとえば、 Calibriフォントにはregular 、 bold 、またはitalicスタイルフォントが含まれる場合があります。完全なリストを返すことができるインターフェイスが必要な場合は、これがあなたの友人です。

次のように使用できます。

 Fontist :: Formula . find_fonts ( "Calibri" )

すべての式をリストします

Fontist::Formula Interfaceは、インターフェイスを公開して、登録されたすべてのフォント式をリストします。これは、式の名前や、その式を使用してインストールできるフォントをインストールできる場合に役立つ場合があります。使用法：

 Fontist :: Formula . all

戻り値はOpenStructオブジェクトであるため、Rubyオブジェクトで実行する他の操作を簡単に実行できます。

`Fontist::Manifest`

グローバルオプション

フォンティストは、好みの姓を使用するように切り替えることができます。この形式は、v1.10より前に使用されました。

 Fontist . preferred_family = true

`Fontist::Manifest::Locations`

Fontistでは、次の形式で定義されたマニフェストハッシュからフォントの場所を見つけることができます。

 {
  "Segoe UI" => [ "Regular" , "Bold" ] ,
  "Roboto Mono" => [ "Regular" ]
}

次のコードを呼び出すと、フォントパスと名前が付いたネストされたハッシュが返されます。フォント名は、フォントコレクションファイル（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::Install`

FONTISTでは、フォントの場所を取得するだけでなく、マニフェストからフォントをインストールすることもできます。

 Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )

フォントをインストールし、場所を返します。

 {
  "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" ]
    }
  }
}

YAML形式のサポート

どちらのコマンドも、 from_fileメソッドを使用した入力としてyamlファイルをサポートします。たとえば、 manifest.ymlファイルがある場合：

---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

次に、 from_hashメソッドからのように、次の呼び出しはフォント名とパスを返します（ Fontist::Manifest::Install and Fontist::Manifest::Locations参照）。

 Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )

`Fontist::Fontconfig`

Fontistは、Rubyインターフェイスを介してFontConfigでの作業をサポートしています。

 Fontist :: Fontconfig . update              # let detect fontist fonts
Fontist :: Fontconfig . remove              # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists

プラットフォーム固有の機能

MacOS固有のアドオンフォント

MacOSの新しいバージョンは、幅広いライセンスフォントのオンデマンドインストールを提供します。これらのMacOS固有のアドオンフォントは、Fontistを介してインストールできます。

MACOSアドオンフォントをインストールするための典型的な用途は、MacOS環境でのCIジョブが他のプラットフォームで使用できないこれらの特別にライセンスされたフォントを使用できるようにすることです。

このブログ投稿では、これがどのように機能するかについて説明しています。

Fontist Blog：MacOS固有のアドオンフォントのインストール

たとえば、「Canela」フォントは、MacOSに無料で付属するコマーシャルフォントです。

このコマンドを実行して、MacOSにCanelaをインストールします。

$ fontist install Canela

さまざまなMacOSバージョンの使用可能なフォントの完全なリストは、Appleサポートサイトにあります。

MacOS 13 Venturaのフォント
MacOS 12 Monterayのフォント
Macos 11 Big Surのフォント

警告	Fontistでは、これらのフォントのフォントライセンス制限により、非MacosプラットフォームにMacOS固有のフォントをインストールすることはできません。

既知の問題のあるフォント

nisc18030.ttf（gb18030ビットマップ） - macos、nisc18030号の詳細情報

既知の問題のあるフォントの完全なリスト：

使用状況から除外されたフォントのリスト

高度な使用

プロキシサーバーの使用

Fontistは、式とフォントを取得するために内部的にGitを使用します。

プロキシの背後にあるGIT機能を使用するには、 git configコマンドまたは~/.gitconfig優先ファイルを介して独自のgit構成を更新する必要があります。

プロキシを使用するようにローカルGitインストールを構成する方法はたくさんあります。

GITのプロキシを設定する最も簡単でグローバルな方法は、次のとおりです。

httpの場合

git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}

HTTPSの場合、暗号化のエンドはHTTPSプロキシエンドポイントにあるため、プロキシを設定した後、SSL/TLS検証エラーを処理する必要があります。
```
git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}
```

靴下の場合、ソックスプロトコルを決定する必要があります

git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '

例えば、

git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] '

{protocol}フィールドのサポートされているソックスプロトコルのリスト：

socks:// ：v5以下の靴下の場合
socks5:// ：socks v5の場合
socks5h:// ：靴下を介したv5 +ホスト解像度の靴下の場合

実際に個々のGITリポジトリの異なるプロキシ動作を設定できます。GITプロキシの使用方法に関するこの素晴らしいガイドをご覧ください（GitHubユーザーEvantoliのおかげ）。

カスタムフォンティストリポジトリ

一般的な

Fontist Repositoryは、YAMLフォーミュラファイルを含むGITリポジトリです。フォンティスト式は、フォンティストリポジトリ内で手動で作成することができます（例を参照）、またはフォントアーカイブから自動生成されます。

Fontistリポジトリには、HTTPSまたはSSHからアクセスできます。 SSHの場合、このカスタムリポジトリにアクセスするために、対応するSSHキーをssh-agentでセットアップする必要があります。

フォンティストリポジトリの登録

fontist repo setupコマンドは、カスタムリポジトリの公式を取得し、後で使用するためにリポジトリの名前とURLを保存します。

fontist repo setupコマンドは、次の構文を使用します。

fontist repo setup NAME URL

内部的には、すべてのカスタムフォンティストリポジトリ情報は~/.fontist/formulas/Formulas/privateに保存されます。

たとえば、URLまたはSSHアドレスを介してアクセス可能な「ACME」と呼ばれるフォンティストリポジトリを与えられています。

fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.git

カスタムフォンティストリポジトリのリスト

fontist repo list

フォンティストリポジトリからフォントをインストールします

カスタムフォンティストリポジトリがセットアップされると、フォーミュラを介してリポジトリからフォントをインストールできます。

fontist install " custom font "

登録されたフォンティストリポジトリの更新

カスタムフォンティストフォーミュラリポジトリが更新されている場合、 repo updateコマンドを使用して最新の変更をプルします。

fontist repo update NAME

たとえば、「ACME」と呼ばれるフォンティストリポジトリを与えられている場合、次のコマンドが使用されます。

fontist repo update acme

登録されたフォンティストリポジトリの削除

登録されているフォンティストリポジトリを削除する必要がある場合は、次のことを削除できます。

fontist repo remove acme

プライベートアクセス

カスタムフォンティストフォーミュラとフォンティストリポジトリは、認証を必要とするためにプライベートにすることができます。

HTTPSおよびSSH gitフォンティストリポジトリの場合

プライベートフォーミュラまたはプライベートフォーミュラリポジトリの認証

プライベートフォーミュラ内のプライベートアーカイブの承認は、ヘッダーで実装できます。

GitHubリリースで動作する例は次のとおりです。

 resources :
  fonts.zip :
    urls :
    - url : https://example.com/repos/acme/formulas/releases/assets/38777461
      headers :
        Accept : application/octet-stream
        Authorization : token ghp_1234567890abcdefghi

Fontist Formula RepositoryがGitHubリポジトリの場合、GitHub設定> Tokensページでトークンを取得できます。このトークンには、少なくともこれらの資産にアクセスするためのrepo範囲が必要です。

フォンティスト式を作成します

一般的な

ヤムルでは、ファンティスト式を簡単に手作りすることができます。ただし、データの正確性と利便性には、自動生成方法が推奨されます。

フォントアーカイブからフォンティスト式を自動生成します

フォントアーカイブから式を生成できます。

fontist create-formulaコマンドにより、多数の形式でフォントアーカイブからすべてのフォントファイルを検出できます（ZIP、7Z、GZIP、TAR、CAB、EXEなど、Excavateでサポートされているもの）。

fontist create-formulaコマンドは、リモートURLまたはローカルファイルパスにあるアーカイブをサポートしています。

ファイルパスの場合、ファイルパスを引数として指定します。

wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zip

URLの場合、URLを引数として指定するだけです。

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zip

作成された式をテストするには、式をユーザーのプライベートフォーミュラリポジトリの場所にコピーできます。

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/

フォンティスト式のオーバーライドフォントメタデータ

fontist create-formulaコマンドは、OTFメタデータセクションに埋め込まれた情報を使用してフォント式を作成します。

ただし、一部のフォント（古いフォントなど）には、一貫性のないまたは不完全なメタデータ情報が含まれていることがよくあります。たとえば、一部のフォントは、さまざまなフォントスタイルに異なるOTF Family値を適用します。これにより、すべてのフォントスタイルが同じ家族に登録されていません。

フォンティスト式の著者は、 override: Keyを使用してこの状況を是正できます。これにより、フォーントメタデータから得られたメタデータ情報をオーバーライドできます。

注記	`override`キーは、フォントファイルに変更を引き起こすことはありません。これは、Fontistが内部で使用する情報を更新するためだけです。

overrideキーは、個々のフォントスタイルの定義の下に存在します。

 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

たとえば、1994年にAdobeが発行した「Frutiger」フォントは、個々のフォントスタイルを表すために数字を使用し、「Frutiger 45 Light」などのOTF Familyフィールドにそれらの名前を埋め込んでいます。また、これらのフォントは、OTF Preferred Familyフィールドを使用しません。これは、年齢のためにOTFに最近追加されたものです。

overrideプロパティが、同じ姓で登録するすべての関連スタイルを実施する方法（ 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
  - ...

上記のこのフラグメントにより、Fontistは正しいインデックスを生成し、単一のコマンドを使用してすべてのFrutigerフォントをインストールできます。

$ fontist install " Frutiger " --preferred-family

フォンティストのアップグレード

v1.10+へ

v1.10を超えるフォンティストバージョンは、新しい式形式を使用します。アップグレード後、 fontist updateを実行して最新の式を取得してください。

V1.10から始めて、Fontistは、スタイルをグループ化するときに「優先家族」ではなく「デフォルトファミリー」を使用します。

たとえば、v1.10の前の「lato」フォントのリクエストは、「黒」、「ブラックイタリック」、「太字」、その他15のスタイルのすべてのスタイルを返します。

V1.10以降、Fontistは4つのデフォルトスタイルのみを返します：「レギュラー」、「イタリック」、「太字」、「太字イタリック」。

他のスタイルを取得するには、「Lato Black」や「Lato Heavy」などの正確なフォント「サブファミリー」を指定するか、CLIとFontist.preferred_family = true Ruby Libraryを使用して--preferred-familyオプションを使用する必要があります。

注記	v1.10の前に、「クーリエ」フォント式のバグがあり、フォント名「クーリエ」を要求するときにフォントをインストールすることができましたが、フォントの場所は完全な「クーリエの新しい」フォント名を使用してのみ取得できました。 V1.10以降、動作は一貫しています。適切な「宅配便の新しい」名前のみを使用する必要があります。

v1.16+へ

v1.16を超えるフォンティストバージョンは、 installコマンドのfont引数を異なって扱います。アップグレード後、 fontist install 、 fontist manifest-install （および対応するRubyインターフェイスFont.install and Manifest::Install ）を使用するときに、必要なすべてのフォントが指定されていることを確認するか、 -F, --formulaオプションを使用します。

V1.16から、Fontistは、明示的に指定されていない限り、式全体の代わりに要求されたフォントのみをインストールします。今変更されました。

たとえば、v1.16より前の「arial」フォントのインストール要求は、「ms_trueType」フォーミュラ（「arial」、「trebuchet ms」、「verdana」、「times new Roman」にあるすべてのフォントをセットアップします。

V1.16以降、Fontistは要求された「Arial」フォントのみをインストールします。

フォーミュラからすべてのフォントをインストールするには、 -F, --formulaオプションを使用できます。

$ fontist install --formula ms_truetype

メンテナンス（フォンティストメンテナーのみ！）

警告	このセクションは、フォンティストメンテナー専用です。

フォーミュラバージョン化

新しい属性を追加するには、式の扱い方を変更するか、構造を完全に置き換える方法を変更するには、式形式を変更する2つの方法があります。

式でmin_fontist属性を使用します。バージョンが等しいか、指定されたバージョンを超えている場合にのみ、Fontistが式をインストールする要件を設定します。
フォーミュラレポの新しいブランチを使用します。たとえば、「V2」、「V3」、「V4」など。新しいブランチを作成した後、 Fontist.formulas_versionで定義する必要があります。

注記	新しいブランチを使用すると、すべてのユーザーがフォーミュラリポジトリ全体を再ダウンロードする必要があります。この方法には大きなオーバーヘッドがあるため、前者（ `min_fontist` ）を可能な限り使用する必要があります。

Googleフォントからフォーミュラを動的にインポートします

Google Fontsは、おそらく広く使用され、自由に、公然とライセンスされたフォントの最大のコレクションを提供します。

Fontistのフォーミュラライブラリには、Googleフォントを介して提供されるすべての公然とライセンスのフォントのサポートが含まれており、そのようなすべてのフォントのフォンティスト式を維持しています。

GHAワークフローは、毎日Googleフォントの更新されたフォントをチェックします。更新が見つかった場合は、ワークフローによってレポに追加されます。

SILから式を動的にインポートします

SIL Internationalは、世界中の言語コミュニティにサービスを提供する国際的に認められた信仰に基づいた非営利組織です。

SILは、ユニコードコードを使用して主流のフォントでサポートされていないことが多い小規模な言語コミュニティをサポートする多くのユニークなフォントを提供します。

Fontistは、すべてのSILフォントをサポートすることを目的としており、デフォルトのFontistフォーミュラリポジトリに式を提供します。

で更新できます：

fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push

macOSからの式を動的にインポートします

MacOSは、 Font Book.appで手動でダウンロードできるフォントを提供します。

macOSフォーミュラを更新するには：

fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git push

発達

設定

リポジトリをクローンします。

git clone https://github.com/fontist/fontist

環境をセットアップします。

bin/setup

テストスイートを実行します

bin/rspec

フォーミュラストレージ

すべての公式フォンティスト式は、式リポジトリに保持されます。

既存の式リポジトリまたは変更設定を追加する場合は、そのドキュメントを参照してください。

リリース

リリースは、GitHubアクションで自動的に行われます。 gem-releaseでバンプしてタグを付けるだけです。

パッチリリース（0.0.x）の使用：使用：

gem bump --version patch --tag --push

マイナーリリース（0.x.0）の使用：

gem bump --version minor --tag --push

貢献

まず、貢献してくれてありがとう！私たちは皆からのプルリクエストが大好きです。このプロジェクトに参加することにより、ここにリボースに、無制限の数の非排他的ライセンスまたはサブライセンスを第三者に付与または譲渡する権利を付与します。

この宝石に関するSandi Metzのルールに従っています。ここでルールの説明を読むことができます。すべての新しいコードは、これらのルールに従う必要があります。これらのルールに違反する既存のファイルに変更を加える場合は、貢献の一部として違反を修正する必要があります。

以下に次のような技術的なガイドラインがあります。

問題を開き、新しい機能について議論します。
新機能をサポートするテストを作成します。
テストスイート全体がローカルおよびCIで通過することを確認してください。
プルリクエストを開きます。
フィードバックを受け取った後、コミットを押しつぶします。
パーティー！

クレジット

この宝石は、リボースによって開発、維持、資金提供されています。

拡大する

追加情報

バージョン v1.21.1
タイプフォントのダウンロード
更新時間 2025-07-29
サイズ 22.86MB
から Github

fontist

ファンティスト

インストール

フォーミュラを取得します

依存関係

コマンドラインインターフェイス（CLI）の使用

fontistコマンド

フォントのインストール： fontist install

アンインストールフォント： fontist uninstall

ステータス： fontist status

リスト： fontist list

リストインストールされたフォントパス： fontist manifest-locations

マニフェストからフォントをインストール： fontist manifest-install

Fontist Config： fontist configで動作します

fontconfig： fontist fontconfigを使用します

キャッシュを使用して作業します

ヘルプ： fontist help

環境変数を使用した構成

Rubyライブラリを使用します

Fontist::Font

フォントを見つける

フォントを取り付けます

すべてのフォントをリストします

Fontist::Formula

式を見つけます

フォーミュラでサポートされているフォントスタイルをリストします

すべての式をリストします

Fontist::Manifest

グローバルオプション

Fontist::Manifest::Locations

Fontist::Manifest::Install

YAML形式のサポート

Fontist::Fontconfig

プラットフォーム固有の機能

MacOS固有のアドオンフォント

既知の問題のあるフォント

高度な使用

プロキシサーバーの使用

カスタムフォンティストリポジトリ

一般的な

フォンティストリポジトリの登録

カスタムフォンティストリポジトリのリスト

フォンティストリポジトリからフォントをインストールします

登録されたフォンティストリポジトリの更新

登録されたフォンティストリポジトリの削除

プライベートアクセス

プライベートフォーミュラまたはプライベートフォーミュラリポジトリの認証

フォンティスト式を作成します

一般的な

フォントアーカイブからフォンティスト式を自動生成します

フォンティスト式のオーバーライドフォントメタデータ

フォンティストのアップグレード

v1.10+へ

v1.16+へ

メンテナンス（フォンティストメンテナーのみ！）

フォーミュラバージョン化

Googleフォントからフォーミュラを動的にインポートします

SILから式を動的にインポートします

macOSからの式を動的にインポートします

発達

設定

フォーミュラストレージ

リリース

貢献

クレジット

`fontist`コマンド

フォントのインストール： `fontist install`

アンインストールフォント： `fontist uninstall`

ステータス： `fontist status`

リスト： `fontist list`

リストインストールされたフォントパス： `fontist manifest-locations`

マニフェストからフォントをインストール： `fontist manifest-install`

Fontist Config： `fontist config`で動作します

fontconfig： `fontist fontconfig`を使用します

ヘルプ： `fontist help`

`Fontist::Font`

`Fontist::Formula`

`Fontist::Manifest`

`Fontist::Manifest::Locations`

`Fontist::Manifest::Install`

`Fontist::Fontconfig`