nerd-fonts/readme_tw.md at c90f4ef058dec6f9b079873ffcda07a848bba878

mirror of https://github.com/ryanoasis/nerd-fonts.git synced 2024-11-19 16:39:20 +02:00

Fini Jastrow b4b51f4868 casks: Fix tap command and repo links

Signed-off-by: Fini Jastrow <ulf.fini.jastrow@desy.de>

2024-03-27 08:41:45 +01:00

42 KiB

Raw Blame History

Nerd Fonts 是一個使用大量字體圖示來解決程式設計師在開發過程中缺少合適字體的問題的專案。它可以從流行的字體圖示庫中將大量外部字體引入待開發的專案中，它支持的字體圖示庫包括 Font Awesome ➶, Devicons ➶, Octicons ➶, and others.

下面的桑基圖（Sankey Diagram）展示了 Nerd Fonts 中現有的字形組合：

_{創建圖表的工具為： @SankeyMATIC}

重要提示

master 分支的文件路徑 不穩定！ 驗證你的 repository URI references
除非你想成為開發貢獻者，不然最好不要複製這個 repository。

TL;DR

Nerd Fonts 中包含流行的程式字體和字形。如果你想要的字體沒有在現有的字體庫中，你可以使用 font patcher來自訂字體。更多信息請見 wiki。如果你正在尋找 Vim 外掛，請見 VimDevIcons ➶。

多種字體下載選項

如果你...

選項 1. 需要快速從patched-fonts/ directory下載一個 獨立字體
選項 2. 需要去下載包含粗體、斜體等等一系列字體的 字體家族，請見下載檔案
選項 3. 需要自動安裝或使用腳本，請見安裝腳本
選項 4. 是macOS的使用者，並且想要使用Homebrew，請見 Homebrew Fonts
選項 5. 想要 完全控制，請見複製這個 repo
選項 6. 想要使用 curl command 或者使用 scripts，請見 Ad Hoc Curl 下載
選項 7. 是Arch Linux的使用者，並且想要使用Community packages，請見 Arch Community Repositories
選項 8. 想要打包你自訂的字體，請見字體包
FontForge Python script 可以打包任何字體
- 包括建立Monospaced (fixed-pitch, fixed-width) 或者 double-width (non-monospaced) 字形
- 更多詳情請見 Font Patcher 段落
51 已經打包了字體家族
Over 1,571,470 獨立的組合/變型字體 (更多詳情)
Over 9,000 字形/圖示組合 (更多詳情)
- 當前的字形集包括： Powerline with Extra Symbols, Font Awesome, Material Design Icons, Weather, Devicons, Octicons, Font Logos (Formerly Font Linux), Pomicons, Codeicons
每種字體的Monospaced (fixed-pitch, fixed-width) 和 double-width (non-monospaced) 版本
- 這指的是 Nerd Font 字形本身，並不一定需要將字體作為一個整體考慮
一個開發者/貢獻者提供了 bash script 來為所有字體再打包

字形集

🔍 🔍 你現在可以透過 NerdFonts.com 中的 Cheat Sheet 對字形進行搜索

請見 Wiki: Glyph Sets and Codepoints for more details

Shell 中的 Icon 名稱

請見 Wiki: Icon names in shell

字體包

Font Name	Font Name and Repository	ver	*RFN	Status
3270 Nerd Font	3270	3.0.1	NO
Agave	Agave	37	NO
AnonymicePro Nerd Font	Anonymous Pro	1.002	YES
Arimo	Arimo	1.33	NO
Aurulent Sans Mono Nerd Font	Stephen G. Hartke		NO
BigBlueTerminal	VileR		NO
Bitstrom Wera Nerd Font	Bitstream Inc	1.1	YES
Blex Mono	IBM Plex Mono	2.3	YES
Caskaydia Cove Nerd Font	Cascadia Code	2111.01	YES
Code New Roman Nerd Font	Sam Radian	2.0	NO
[Comic Shanns Mono Nerd Font][p-comic]	[Comic Shanns Mono][f-comic]	1.3	NO
Cousine Nerd Font	Cousine	1.211	NO
DaddyTimeMono	DaddyTimeMono	1.2.3	NO
DejaVu Sans Mono Nerd Font	[DejaVu][f-dejavu]	2.37	NO
Droid Sans Mono Nerd Font	Ascender Corp	1.00-113	NO
Fantasque Sans Nerd Font	Fantasque Sans	1.8.0	NO
Fira Code Nerd Font	Fira Code	6.2	NO
Fira Mono Nerd Font	Fira	3.206	NO
Go Mono Nerd Font	Go-Mono	2.010	NO
Gohu Nerd Font	Gohu TTF,Gohu	2.0	NO
Hack Nerd Font	Hack	3.003	NO
Hasklug Nerd Font	Hasklig	1.2	YES
Heavy Data Mono Nerd Font	Vic Fieger	1	NO
Hurmit Nerd Font	[Hermit][f-hermit]	2.0	YES
iM-Writing	iA-Writer	Dec 2018	YES
Inconsolata Nerd Font	[Inconsolata][f-inconsolata]	3.000	NO
Inconsolata Go Nerd Font	[InconsolataGo][f-inconsolatago]	1.013	NO
Inconsolata LGC Nerd Font	[Inconsolata LGC][f-inconsolatalgc]	1.3	NO
Iosevka Nerd Font	Iosevka	22.1.0	NO
[Iosevka Term Nerd Font][p-iosevka-term]	Iosevka Term	22.1.0	NO
JetBrains Mono	JetBrains Mono	2.304	NO
Lekton Nerd Font	[Lekton][f-lekton]	34	NO
Literation Mono Nerd Font	Liberation	2.1.5	YES
Lilex Nerd Font	Lilex	2.300	NO
Meslo Nerd Font	[Meslo][f-meslo]	1.21	NO
Monofur Nerd Font	Tobias B Koehler	1.0	NO
Monoid Nerd Font	Monoid	0.61	NO
Mononoki Nerd Font	Mononoki	1.6	YES
M+ (MPlus) Nerd Font	[M+ Fonts][f-mplus]	2023/03	NO
Noto	[Noto][f-noto]	div	NO
OpenDyslexic	[OpenDyslexic][f-opendyslexic]	2.001	NO
Overpass	[Overpass][f-overpass]	3.0.5	NO
ProFont (Windows tweaked) Nerd Font	[ProFont][f-profont]	2.3	NO
ProFont (x11) Nerd Font	[ProFont][f-profont]	2.2	NO
ProggyClean Nerd Font	Tristan Grimmer	2004/04/15	NO	Imperfect
Roboto Mono	[Roboto Mono][f-roboto]	3.0	NO
Sauce Code Nerd Font	Source	2.038	YES
Shure Tech Mono Nerd Font	Share Tech Mono	1.003	YES
Space Mono Nerd Font	Space Mono	1.001	NO
Terminess Nerd Font	Terminus TTF	4.49.2	YES
Tinos	[Tinos][f-tinos]	1.23	NO
Ubuntu Nerd Font	[Ubuntu Font][f-ubuntu]	0.83	NO
Ubuntu Mono Nerd Font	[Ubuntu Font][f-ubuntu]	0.80	NO
Victor Mono	Victor Mono	1.5.4	NO

_{*RFN = Reserved Font Name}

組合

超過 1,485,000個 獨立的變化/組合(Power Set)字體包：
- 50個 字體合集
- 719個 字體家族
- 2,876個 ‘完全’的變化/組合字體
- 1,485,410個 有可能的 變化/組合字體
- 1,488,286個 總字體數 (2,876 + 1,485,410)
每種字體的組合都是任意 Variations 的組合

Variations

no flags given (defaults to only Seti-UI + Custom and Devicons)
double (variable/proportional) or single (fixed/monospaced) width glyphs
Font Awesome
Font Awesome Extension
Material Design Icons
Weather
GitHub Octicons
Font Logos (Formerly Font Linux)
Powerline Extra Symbols
IEC Power Symbols
Pomicons
Codicons
Windows Compatibility

字體安裝

`選項1: 手動下載並安裝`

安裝特定 單獨字體 的最快方法。

下載你選中的特定字體 patched font

`選項2: 下載發佈存檔`

適用於當你需要archive或者完整的字體家族(Bold, Italic, etc.)的情況。

你可以以壓縮檔的形式從 latest r elease下載所需的字體

`選項3: 腳本安裝`

適用於當你想要自動安裝或者使用 scripts 的情況。

註: Requires cloning the repo as of now

所有字體：

安裝全部的字體包 (警告：字體的數量眾多，需要下載的文件體積巨大)

./install.sh

或是在 Powershell (僅限 Windows)

./install.ps1

單獨字體:

安裝你所需的單獨字體

./install.sh <FontName>
./install.sh Hack
./install.sh HeavyData

或是在 Powershell (僅限 Windows):

./install.ps1 <FontName>
./install.ps1 Hack
./install.ps1 HeavyData
./install.ps1 FiraCode, Hack
./install.ps1 CascadiaCode -WindowsCompatibleOnly
./install.ps1 DejaVuSansMono -WhatIf

`選項4: Homebrew 字體`

適用於 macOS 系統的Homebrew使用者。

所有字體都可以透過 Homebrew 字體從 macOS (OS X)平台上找到

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

`選項5: 複製 Repo`

適用於要使用 完全控制, 所有或者多數字體的情況，或者為 Nerd Fonts 的開發 盡一份力的情況。

基於效率考慮，如果你只想使用有限的幾種字體，我們不推薦複製這個 repository。

但是如果你想要複製這個 repo，請確認你shallow複製了它：

git clone --depth 1

如果你想要複製一個子目錄，使用 git sparse-checkout。以下指令至少需要 Git v2.26：

git clone --filter=blob:none --sparse git@github.com:ryanoasis/nerd-fonts
cd nerd-fonts
git sparse-checkout add patched-fonts/JetBrainsMono

`選項6: Ad Hoc Curl 下載`

適用於當你想要使用 curl command 或者在 scripts中使用它的情況。

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/HEAD/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20Nerd%20Font%20Complete.otf

註: deprecated alternative paths: ~/.fonts

macOS (OS X)

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

`選項7: 非官方 Arch Community Repository`

Most fonts are available via Arch Community packages. Some special packages are in AUR.

列表尚未完成，但你可以在這邊找到完整的列表。

`選項8: 打包你的個人字體`

適用於 patching 你的 個人字體 或者完全自訂字體包。

在你的個人字體中使用 Python 命令行腳本去增加新的字形並生成字體包

請見: Font Patcher 的使用方法

這個選項適用於當你不想使用 fonts provided的情況
你需要複製已經生成好的字體到你系統中正確的字體資料夾中

可以透過 VimDevIcons ➶ 打包你選中的字體:

需要: Python 3, python-fontforge package (version 20141231 或者更新版本，請見安裝說明)
OSX 上的替代安裝方法為: brew install fontforge

Linux 上的替代安裝方法: 使用 AppImage
Docker 上的替代安裝方法: Docker Hub

使用:
```
./font-patcher PATH_TO_FONT
```
替代方案: 使用 script flag 透過 FontForge binary 來執行打包:
```
./fontforge -script font-patcher PATH_TO_FONT
```
使用 AppImage:

註: 下載 AppImage 後需執行 chmod u+x 指令. 所有路徑皆需使用絕對路徑，並且需要明確的輸出路徑! 如果所有內容都在同一個目錄下, 你可以使用 $PWD.
```
./FontForge.AppImage -script $PWD/font-patcher $PWD/BaseFont.ttf -out /tmp
```

使用 Docker:

docker run -v /path/to/fonts:/in:Z -v /path/for/output:/out:Z nerdfonts/patcher [OPTIONS]

完整選項:

Nerd Fonts Patcher v3.0.2 (4.4.0) (ff 20230101)
usage: font-patcher [-h] [-v] [-s] [-l] [-q] [-c] [--careful] [--removeligs] [--postprocess [POSTPROCESS]] [--configfile [CONFIGFILE]] [--custom [CUSTOM]]
                    [-ext [EXTENSION]] [-out [OUTPUTDIR]] [--glyphdir [GLYPHDIR]] [--makegroups [{-1,0,1,2,3,4,5,6}]] [--variable-width-glyphs]
                    [--has-no-italic] [--progressbars | --no-progressbars] [--debug [{0,1,2,3}]] [--dry] [--xavgcharwidth [XAVGWIDTH]] [--fontawesome]
                    [--fontawesomeextension] [--fontlogos] [--octicons] [--codicons] [--powersymbols] [--pomicons] [--powerline] [--powerlineextra]
                    [--material] [--weather]
                    font

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

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

positional arguments:
  font                  The path to the font to patch (e.g., Inconsolata.otf)

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -s, --mono, --use-single-width-glyphs
                        Whether to generate the glyphs as single-width not double-width (default is double-width)
  -l, --adjust-line-height
                        Whether to adjust line heights (attempt to center powerline separators more evenly)
  -q, --quiet, --shutup
                        Do not generate verbose output
  -c, --complete        Add all available Glyphs
  --careful             Do not overwrite existing glyphs if detected
  --removeligs, --removeligatures
                        Removes ligatures specificed in JSON configuration file
  --postprocess [POSTPROCESS]
                        Specify a Script for Post Processing
  --configfile [CONFIGFILE]
                        Specify a file path for JSON configuration file (see sample: src/config.sample.json)
  --custom [CUSTOM]     Specify a custom symbol font, all glyphs will be copied; absolute path suggested
  -ext [EXTENSION], --extension [EXTENSION]
                        Change font file type to create (e.g., ttf, otf)
  -out [OUTPUTDIR], --outputdir [OUTPUTDIR]
                        The directory to output the patched font file to
  --glyphdir [GLYPHDIR]
                        Path to glyphs to be used for patching
  --makegroups [{-1,0,1,2,3,4,5,6}]
                        Use alternative method to name patched fonts (recommended)
  --variable-width-glyphs
                        Do not adjust advance width (no "overhang")
  --has-no-italic       Font family does not have Italic (but Oblique)
  --progressbars        Show percentage completion progress bars per Glyph Set (default)
  --no-progressbars     Don't show percentage completion progress bars per Glyph Set
  --debug [{0,1,2,3}]   Verbose mode (optional: 1=just to file; 2*=just to terminal; 3=display and file)
  --dry                 Do neither patch nor store the font, to check naming
  --xavgcharwidth [XAVGWIDTH]
                        Adjust xAvgCharWidth (optional: concrete value)

Symbol Fonts:
  --fontawesome         Add Font Awesome Glyphs (http://fontawesome.io/)
  --fontawesomeextension
                        Add Font Awesome Extension Glyphs (https://andrelzgava.github.io/font-awesome-extension/)
  --fontlogos, --fontlinux
                        Add Font Logos Glyphs (https://github.com/Lukas-W/font-logos)
  --octicons            Add Octicons Glyphs (https://octicons.github.com)
  --codicons            Add Codicons Glyphs (https://github.com/microsoft/vscode-codicons)
  --powersymbols        Add IEC Power Symbols (https://unicodepowersymbol.com/)
  --pomicons            Add Pomicon Glyphs (https://github.com/gabrielelana/pomicons)
  --powerline           Add Powerline Glyphs
  --powerlineextra      Add Powerline Glyphs (https://github.com/ryanoasis/powerline-extra-symbols)
  --material, --materialdesignicons, --mdi
                        Add Material Design Icons (https://github.com/templarian/MaterialDesign)
  --weather, --weathericons
                        Add Weather Icons (https://github.com/erikflowers/weather-icons)

範例

./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

./FontForge.AppImage -script /tmp/nerdfonts/font-patcher /tmp/nerdfonts/CascadiaMonoPL-Semibold.ttf --fontawesome -out /tmp
./FontForge.AppImage -script $PWD/font-patcher $PWD/CascadiaMonoPL-Semibold.ttf --octicons -out $HOME

docker run --rm -v ~/myfont/patchme:/in:Z -v ~/myfont/patched:/out:Z nerdfonts/patcher
docker run --rm -v ~/Desktop/myfont/patchme:/in:Z -v ~/Desktop/myfont/patched:/out:Z nerdfonts/patcher --fontawesome

Gotta Patch 'em All Font Patcher!

針對貢獻者和開發者使用
在未打包的路徑中 re-patches 所有字體:
```
./gotta-patch-em-all-font-patcher\!.sh
```

可以選擇限制到特定字體名稱模式:

./gotta-patch-em-all-font-patcher\!.sh Hermit

貢獻

請見 contributing.md

不穩定的文件路徑

⚠️ 警告: 基於後續的新版本發佈，文件路徑有可能被改變 (特別是 major version bumps)

注意 release 分支不是 ~~master 分支~~因為路徑會因為新版本發佈而改變

舉例:
- ✅ Use: https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
- ❌ Instead of: https://github.com/ryanoasis/nerd-fonts/blob/master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf

其他的好字體

一個包含更多好字體的列表，可惜的是，因為授權問題我們不能提供或分享它們:

專案目的

請見 Wiki: Project Purpose

更新日誌

請見 changelog.md

授權

請見 LICENSE

42 KiB Raw Blame History