Skip to content

Latest commit

 

History

History
625 lines (484 loc) · 45.6 KB

readme_ja.md

File metadata and controls

625 lines (484 loc) · 45.6 KB

Nerd Fonts Logo

Iconic font aggregator, collection, and patcher

リリース   |   フォント   |   パッチスクリプト   |   Wiki ドキュメント   |   ステッカー   |   VimDevIcons

GitHub release Gitter Build Status Code of Conduct PRs Welcome Nerd Fonts - OS Support Twitter

Nerd Fonts は、たくさんのグリフ (アイコン) を開発者向けのフォントに追加するためのプロジェクトです。とりわけ、著名な「アイコンフォント」からたくさんのグリフを追加することを目的としています。例えば以下のようなフォントです: Font Awesome ➶, Devicons ➶, Octicons ➶, その他.

以下のサンキーダイアグラムにより、現在含まれているグリフセットがわかります。

@SankeyMATIC Diagram

このダイアグラムは @SankeyMATIC を使って作成されました。

重要

目次

TL;DR (長すぎて読めない方へ)

インストール方法一覧

特徴

開発者、あるいは、開発に貢献したい人向け

プロジェクトの目的

追加情報

TL;DR(長すぎて読めない方へ)

Nerd Fonts は著名なプログラミング用フォントにグリフをまとめて追加したものです。たとえ利用したいフォントにパッチが当たっていない場合でも、パッチスクリプトが利用できます。さらに高度な情報が必要でしたら wiki を見てみてください。もし Vim プラグインをお探しでしたら VimDevIcons ➶ をご覧になると良いでしょう。

フォントの様々なダウンロード方法一覧

あなたがもし……

特徴

グリフセット

🔍 🔍 Cheat Sheet を使って NerdFonts.com から簡単にグリフを検索できるようになりました。

Wiki: グリフセットとコードポイントのさらなる詳細を見てください。

シェルでアイコン名を参照する

Wiki: シェルでアイコン名を参照するを見てください。

パッチ済みフォント

フォント名 フォントのリポジトリ *RFN EM サイズ ステータス
3270 Nerd Font 3270 NO 1000 w m2 l
Agave Agave NO 2048 w m2 l
Anonymice Nerd Font Anonymous Pro NO 2048 w m2 l
Arimo Arimo NO 2048 w m2 l
Aurulent Sans Mono Nerd Font NO 1000 w m2 l
BigBlueTerminal NO 1200 w m2 l
Bitstream Vera Sans Mono Nerd Font NO 2048 w m2 l
Blex* IBM Plex Mono YES 1000 w m2 l
Code New Roman Nerd Font NO 2048 w m2 l
Cousine Nerd Font Cousine NO 1000 w m2 l
DaddyTimeMono DaddyTimeMono NO 1024 w m2 l
DejaVu Sans Mono Nerd Font NO 2048 w m2 l
Droid Sans Mono Nerd Font NO 2048 w m2 l
Fantasque Sans Nerd Font Fantasque Sans NO 2048 w m2 l
Fira Code Nerd Font Fira Code NO 1000 w m2 l
Fira Mono Nerd Font Fira NO 1000 w m2 l
Go Mono Nerd Font Go-Mono NO 1000 w m2 l
Gohu Nerd Font Gohu TTF,Gohu NO 1000 w m2 l
Hack Nerd Font Hack NO 2048 w m2 l
Hasklug Nerd Font* Hasklig YES 1000 w m2 l
Heavy Data Mono Nerd Font NO 2048 w m2 l
Hermut Nerd Font NO 1000 w m2 l
iM-Writing* iA-Writer YES 1000 w m2 l
Inconsolata Nerd Font NO 1000 w m2 l
Inconsolata Go Nerd Font NO 1000 w m2 l
Inconsolata LGC Nerd Font NO 1000 w m2 l
Iosevka Nerd Font Iosevka NO 1000 #83
JetBrains Mono JetBrains Mono NO 1000 w m2 l
Lekton Nerd Font NO 1000 w m2 l
Literation Mono Nerd Font* Liberation YES 2048 w m2 l
Meslo Nerd Font NO 2048 w m2 l
Monofur Nerd Font NO 2400 w m2 l
Monoid Nerd Font NO 1536 w m2 l
Mononoki Nerd Font Mononoki NO 1024 w m2 l
M+ (MPlus) Nerd Font NO 1000 w m2 l
Noto NO 1000 w m2 l
OpenDyslexic NO 1000 w m2 l
Overpass NO 1000 w m2 l
ProFont (Windows tweaked) Nerd Font NO 1200 w m2 l
ProFont (x11) Nerd Font NO 1000 w m2 l
ProggyClean Nerd Font NO 2048 Imperfect
Roboto Mono NO 2048 w m2 l
Sauce Code Nerd Font Source YES 1000 w m2 l
Shure Tech Mono Nerd Font* Share Tech Mono YES 1000 w m2 l
Space Mono Nerd Font Space Mono NO 1000 w m2 l
Terminess Nerd Font* Terminus Font YES 1000 w m2 l
Tinos NO 2048 w m2 l
Ubuntu Nerd Font NO 1000 w m2 l
Ubuntu Mono Nerd Font NO 1000 w m2 l
Victor Mono Victor Mono NO 1000 w m2 l

*RFN = Reserved Font Name (予約済みフォント名)

組み合わせ

  • 1,571,470 を超える、パッチ済みフォントの変種とその組み合わせ (冪集合)。
    • 50 のパッチ済みフォント書体。
    • 697 のパッチ済みフォントファミリー。
    • 2,788 の「完全な」変種とその組み合わせ。
    • 1,571,470理論上可能な 変種とその組み合わせ。
    • 合計 1,574,258 になる組み合わせ (2,788 + 1,571,470)。
  • 各々のフォントの「組み合わせ」はそれぞれの変種の組み合わせを表しています。

変種

フォントのインストール

その 1: 手動でダウンロードとインストールを行う

すぐさま特定のフォントを手に入れたい場合に一番適した選択肢です。

パッチ済みフォントから選んでダウンロードしてください。

その 2: リリースアーカイブからダウンロードする

アーカイブや書式の完全なフォントファミリーを手に入れたい場合に一番適した選択肢です。

最新リリースからフォントのパッケージをダウンロード可能です。

その 3: インストールスクリプト

インストールを自動化したい場合やスクリプト内で利用したい場合に一番適した選択肢です。

注意: Linux と macOS (OS X) でのみ可能です。
注意: 今の所、リポジトリのクローンが必要です。

全てのフォント

  • 全てのパッチ済みフォントをインストールします (警告: 大変たくさんのフォントがありますので、消費する容量に気をつけてください)。
./install.sh

一つのフォント

  • 好きなフォントを一つインストールします。
./install.sh <FontName>
./install.sh Hack
./install.sh HeavyData

その 4: Homebrew Fonts

macOS で、かつ、Homebrew を使いたい場合に一番適した選択肢です。

macOS (OS X) では Homebrew Cask Fonts を通じて全てのフォントが利用できます。

brew tap homebrew/cask-fonts
brew cask install font-hack-nerd-font

その 5: リポジトリをクローンする

全てを管理したい、または、全てのフォントが欲しい、または、開発に貢献したい場合に一番適した選択肢です。

もし単に一部のフォントセットだけが入り用ならば、リポジトリのクローンは不要なだけでなく、非効率です (リポジトリのサイズがほとんどの要因です)。

しかしながら、それでもリポジトリをクローンしたいのでしたら、必ず shallow クローンを行いましょう。

git clone --depth 1

その 6: Curl で直接ダウンロード

curl コマンド、または、スクリプト内で利用したい場合の選択肢です。

Linux

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts && curl -fLo "Droid Sans Mono for Powerline Nerd Font Complete.otf" https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20Nerd%20Font%20Complete.otf

注意: 以前別の選択肢として利用できたパス (~/.fonts) は deprecated になりました。

macOS (OS X)

cd ~/Library/Fonts && curl -fLo "Droid Sans Mono for Powerline Nerd Font Complete.otf" https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20Nerd%20Font%20Complete.otf

その 7: 非公式 Arch User Repository (AUR)

Arch Linux、かつ、 AUR packages を使いたい場合の選択肢です。

Arch Linux 上の AUR packages で以下のフォントが利用できます。

その 8: 自分でフォントにパッチを当てる

自分で好きなフォントにパッチを当てたり、フォントを十分にカスタマイズしたい場合の選択肢です。

下記に添付の Python スクリプトを使うことで、好きなフォントにグリフを追加することができます。

使い方は Font Patcher をみてください。

  • このリポジトリで提供済みのフォントを利用したくない場合に、この作業を行なってください。
  • 作成したフォントは、システムのフォントディレクトリーに正しくコピーする必要があります。

Nerd Fonts Patcher

VimDevIcons ➶ で利用するために自分で選んだフォントにパッチを当てる方法:

  • 必要なもの: Python2 (or Python3) と python-fontforge パッケージ (バージョン 20141231 以降、インストール方法はこちら)
  • OSX では別の方法もあります: brew install fontforge
  • 使い方:
./font-patcher PATH_TO_FONT
  • もう一つの使い方: script フラグを使うと FontForge のバイナリでスクリプトが実行できます。
./fontforge -script font-patcher PATH_TO_FONT
usage: font-patcher [-h] [-v] [-s] [-l] [-q] [-w] [-c] [--fontawesome]
                    [--fontawesomeextension] [--fontlinux] [--octicons]
                    [--powersymbols] [--pomicons] [--powerline]
                    [--powerlineextra] [--material] [--weather]
                    [--custom [CUSTOM]] [--postprocess [POSTPROCESS]]
                    [--removeligs] [--configfile [CONFIGFILE]]
                    [--progressbars | --no-progressbars] [--careful]
                    [-ext [EXTENSION]] [-out [OUTPUTDIR]]
                    font

Nerd Fonts Font Patcher: patches a given font with programming and development related glyphs

* Website: https://www.nerdfonts.com
* Version: 2.0.0
* Development Website: https://github.com/ryanoasis/nerd-fonts
* Changelog: https://github.com/ryanoasis/nerd-fonts/blob/master/changelog.md

positional arguments:
  font                  パッチを当てるフォントのパス。(例: Inconsolata.otf)

optional arguments:
  -h, --help            このヘルプメッセージを表示して終了します。
  -v, --version         プログラムのバージョン番号を表示して終了します。
  -s, --mono, --use-single-width-glyphs
                        全角ではなく、半角のグリフを生成するかどうか指定します(デフォルトでは全角です)。
  -l, --adjust-line-height
                        行高を合わせるかどうか指定します (Powerline セパレータがちょうど真ん中になるようにします)。
  -q, --quiet, --shutup
                        デバッグメッセージを表示しません。
  -w, --windows         内部で利用するフォント名を 31 文字に制限します (Windows の互換性のためのオプションです)。
  -c, --complete        全ての利用可能なグリフを追加します。
  --fontawesome         Font Awesome のグリフを追加します (http://fontawesome.io/)。
  --fontawesomeextension
                        Font Awesome Extension のグリフを追加します (https://andrelzgava.github.io/font-awesome-extension/)。
  --fontlinux, --fontlogos
                        Font Linux とその他のオープンソースのグリフを追加します (https://github.com/Lukas-W/font-logos)。
  --octicons            Octicons Glyphs のグリフを追加します (https://octicons.github.com)。
  --powersymbols        IEC Power Symbols のグリフを追加します (https://unicodepowersymbol.com/)。
  --pomicons            Pomicon のグリフを追加します (https://github.com/gabrielelana/pomicons)。
  --powerline           Powerline グリフを追加します。
  --powerlineextra      Powerline Extra のグリフを追加します (https://github.com/ryanoasis/powerline-extra-symbols)。
  --material, --materialdesignicons, --mdi
                        Material Design Icons のグリフを追加します (https://github.com/templarian/MaterialDesign)。
  --weather, --weathericons
                        Weather Icons のグリフを追加します (https://github.com/erikflowers/weather-icons)。
  --custom [CUSTOM]     カスタムのシンボルフォントを指定します。全てのグリフがコピーされますが、大きさは変更されません。
  --postprocess [POSTPROCESS]
                        あと処理を行うためのスクリプトを指定します。
  --removeligs, --removeligatures
                        設定ファイルの JSON で指定されたリガチャを除きます。
  --configfile [CONFIGFILE]
                        設定ファイルの JSON を指定します (src/config.sample.json の例を見てください)。
  --progressbars        グリフセットごとに進捗を百分率で表示します。
  --no-progressbars     グリフセットごとの進捗を表示しません。
  --careful             既に存在するグリフがあれば、それを上書きしないようにします。
  -ext [EXTENSION], --extension [EXTENSION]
                        作成するフォントのファイルタイプを変更します (例: ttf, otf)。
  -out [OUTPUTDIR], --outputdir [OUTPUTDIR]
                        パッチを当てたファイルを保存するディレクトリ。

Examples

./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf -s -q
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --use-single-width-glyphs --quiet
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf -w
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --windows --quiet
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --windows --pomicons --quiet
./font-patcher Inconsolata.otf --fontawesome
./font-patcher Inconsolata.otf --fontawesome --octicons --pomicons
./font-patcher Inconsolata.otf

とにかく全部のフォントにパッチを当てて!

  • 開発に貢献したい人、あるいは開発者用です。

  • まだパッチを当てていないディレクトリーの、全てのフォントに再度パッチを当てます。

./gotta-patch-em-all-font-patcher\!.sh
  • オプションで、フォント名のパターンを指定して制限することもできます。
./gotta-patch-em-all-font-patcher\!.sh Hermit

開発に貢献する

contributing.md を見てください。

ファイルパスはいつも同じではありません

⚠️ 警告: ファイルパスはリリースごとに変わることがあります (特にメジャーバージョンが上がった場合)。

パスはリリースごとの変更に影響を受けやすいため、master ブランチではなく、リリースタグを参照してください。

  • 例:
    • ✅ こちらを使ってください: https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
    • ❌ ダメな例: https://github.com/ryanoasis/nerd-fonts/blob/master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf

パッチを当てるのに適したその他のフォント

  • パッチを当てるのに適したフォントのうち、このリポジトリで提供されていない、あるいは、ライセンスの関係で提供できないものを列挙しておきます。:
  • Input Mono (ライセンス制限)
    • 外部でのホスティングにより提供できるかも :)
  • PragmataPro (有料)
  • Consolas (プロプライエタリ)
  • Operator Mono (有料)
  • Dank Mono (有料)

プロジェクトの目的

Wiki: Project Purpose を見てください。

更新履歴

changelog.md を見てください。

ライセンス

MIT © Ryan L McIntyre