Signed-off-by: Fini Jastrow <ulf.fini.jastrow@desy.de>
43 KiB
Nerd Fonts - это проект, который улучшает шрифты с большим количеством глифов (значков). В частности, добавляет большое количество значков из популярных 'символьных шрифтов', таких как Font Awesome ➶, Devicons ➶, Octicons ➶ и других.
На следующей Sankey-диаграме показаны текущие наборы глифов:
Диаграма создана с помощью @SankeyMATIC
Быстрая Навигация
Последняя Версия ➶ | Шрифты | Улучшатель шрифтов | VimDevIcons ➶ | Скачать Пакеты Шрифтов ➶ |
---|---|---|---|---|
Важные Замечания
- Пути к файлам ветки
master
нестабильны. Проверить свою ссылку на репозиторий - Клонировать этот репозиторий не рекомендуется, если Вы не собираетесь участвовать в разработке
Содержание
- 1 - Руководство
- 2 - Архив Выпусков
- 3 - Установочный Скрипт
- 4 - Шрифты Homebrew (macOS (OS X))
- 5 - Клонировать репозиторий
- 6 - Скачать Ad Hoc Curl
- 7 - Пользовательский репозиторий Arch (AUR) (Arch Linux)
- 8 - Исправить свой собственный шрифт
Разработчикам / Контрибьютерам
- Улучшитель Шрифтов
- Прокачай все шрифты!
- Другие хорошие шрифты для улучшения
- Сотрудничество в разработке
Дополнительная информация
TL;DR
Nerd Fonts использует популярные программные шрифты и добавляет кучу Значков. Существует также Исправитель шрифтов, если нужный Вам шрифт ещё не исправлен. Более подробную информацию смотрите в wiki. Если Вы ищете плагин Vim, смотрите VimDevIcons ➶.
Различные варианты загрузки шрифтов
Если Вы...
Вариант 1.
хотите быстро взять отдельный шрифт, то скачайте из директорииpatched-fonts/
Вариант 2.
хотите скачать пакет вариаций (bold, italic и т.д.) семейства шрифтов, смотрите скачать архивВариант 3.
хотите автоматизировать установку или использовать в скриптах, смотрите установка скриптомВариант 4.
пользователь macOS и хотите использовать Homebrew, смотрите Homebrew FontsВариант 5.
хотите полный контроль, смотрите клонировать репозиторийВариант 6.
хотите использоватьcurl
команду или использовать её в скриптах, смотрите Ad Hoc Curl DownloadВариант 7.
пользователь Arch Linux и хотите использовать AUR packages, смотрите Пользовательский репозиторий Arch (AUR)Вариант 8.
хотите улучшить свой собственный шрифт, смотрите Улучшитель Шрифтов
Особенности
- Python скрипт FontForge для улучшения любого шрифта
- Включена возможность создания Моноширинных (с фиксированным шагом, с фиксированной шириной) или двойных (не моноширинных) глифов
- Для получения дополнительной информации смотрите раздел Улучшитель шрифтов
50
улучшенных семейства шрифтов- Более
1,571,470
уникальных комбинаций/вариантов улучшенненных шрифтов (больше информации) - Более
1,300
комбинаций глифов/значков (больше информации)- Текущие наборы глифов включают: Powerline with Extra Symbols, Font Awesome, Devicons, Octicons, Font Logos, Pomicons
- Моноширинная (фиксированный шаг, фиксированная ширина) или "двойные (не моноширинные) глифы" версии каждого шрифта
- Это относится к самим символам Nerd Font, не обязательно ко всему шрифту в целом
- Разработчик/Помощник предоставил bash скрипт для повторного исправления всех шрифтов
Наборы значков
🔍 🔍 Теперь Вы можете легко искать глифы на NerdFonts.com через Cheat Sheet
Seti-UI + Custom
Основан на Seti-UI Icomoon с дополнительными пользовательскимим глифами.
Devicons
"Символьный" шрифт, созданный для разработчиков, джедаев, ниндзя, HTTPстеров, евангелистов и ботаников. / (репозиторий) / (сайт)
Font Awesome
"Символьный" шрифт и набор инструментов CSS. / (репозиторий) / (сайт)
Font Awesome Extension
Простое удивительное расширение значков / (репозиторий) / (сайт)
Octicons
Иконки из GitHub'а. / (репозиторий) / (сайт)
Полный набор кодовых точек шрифта Nerd:*
* Чтобы избежать конфликтов между наборами значков, они были изменены в 'Полных' шрифтах. Оригинальные кодовые точки: Wiki.
Powerline Extra Symbols
Предоставляет дополнительные символы разделителей и символ номера столбца (CN). / (репозиторий)
IEC Power Symbols
Добавляет новые символы в Unicode / (сайт)
Font Logos
Font-logos содержит логотипы популярных дистрибутивов Linux, включая веб-сайты. / (репозиторий)
Pomicons
8 значков для "Метод Помидора"®. / (репозиторий)
Имена значков в shell
Загрузите предоставленные .sh
файлы из директории bin/scripts/lib/, рекомендуемое расположение ~/.local/share/fonts/
или ~/bin/
.
i_all.sh
- помощник для загрузки всех файлов, которые вы однажды скачалиi_dev.sh
- Devicons (198 иконок, 8 не имеют установленного имени)i_fa.sh
- Font Awesome (675 иконок, 111 псевдонимов)i_fae.sh
- Font Awesome Extension (170 иконок)i_iec.sh
- IEC Power Symbols (5 иконок)i_logos.sh
- Font Logos (20 иконок)i_oct.sh
- Octicons (172 иконок)i_ple.sh
- Powerline Extra Symbols (37 иконок, 2 псевдонима, 16 не имеют установленного имени)i_pom.sh
- Pomicons (11 иконок)i_seti.sh
- Seti-UI + Custom (50 иконок, 2 псевдонима, 5 без установленного имени)
Затем откройте исходники
требуемых файлов и выведите $i_*
переменные, чтобы увидеть значки:
source ~/.local/share/fonts/i_oct.sh
echo $i_oct_heart
# Output:
# ♥
ЗАМЕЧАНИЕ: Вы должны использовать один из Nerd Fonts, чтобы видеть правильные значки для некоторых наборов (Devicons, Font Awesome Extension, Font Logos), но остальные наборы должны работать со стандартными шрифтами тоже.
Исправленные Шрифты
*RFN (Reserved Font Name) — зарезервированное название шрифта
Комбинации
- Более
1,485,000
уникальных вариантов/комбинаций (Power Set) улучшенных шрифтов:50
улучшенных набора шрифтов719
улучшенных семейств шрифтов2,876
'выполненных' вариантов/комбинаций'1,485,410'
возможных варианта/комбинации1,488,286
всего вычислено комбинаций (2,876 + 1,428,110)
- Комбинация для каждого шрифта - это любая комбинация Вариаций
Вариации
- не указаны флаги (по умолчанию Seti-UI + Custom и Devicons)
- двойная (variable/proportional) или обычная (fixed/monospaced) ширина символов
- Font Awesome
- Font Awesome Extension
- GitHub Octicons
- Font Logos
- Powerline Extra Symbols
- IEC Power Symbols
- Pomicons
- Совместимость с Windows
Установка
Вариант 1: Скачать и установить вручную
Лучший вариант для быстрого получения конкретного индивидуального шрифта.
Скачайте конкретный улучшенный шрифт на Ваш выбор
Вариант 2: Скачать журнал версий
Лучший вариант, если вам нужен архив или полное семейство шрифтовых вариаций (Bold, Italic и т.д.).
Шрифты доступны для скачивания в виде пакетов в последней версии
Вариант 3: Установить скрипт
Лучший вариант, если вы хотите автоматизировать установку или использовать в скриптах.
Замечание: Только для Linux & macOS (OS X) Замечание: Необходимо клонировать текущее состояние репозитория
Все шрифты:
- Установить все улучшенные шрифты (Замечание: Многие шрифты занимают много памяти)
./install.sh
Один шрифт:
- Установка одного шрифта по Вашему выбору
./install.sh <FontName>
./install.sh Hack
./install.sh HeavyData
Вариант 4: Homebrew Fonts
Лучший вариант, если у Вас macOS и Вы хотите использовать Homebrew.
Все шрифты доступны через Homebrew Fonts на macOS (OS X)
brew tap caskroom/fonts
brew install --cask font-hack-nerd-font
Вариант 5: Клонировать Репозиторий
Лучший выбор для полного контроля всех или большинства шрифтов, или для помощи в разработке.
Клонирование этого репозитория не требуется и неэффективно, если Вас интересует только ограниченный набор шрифтов.
Однако, если Вы хотите клонировать репозиторий, обязательно выполните мелкое клонирование:
git clone --depth 1
Вариант 6: Скачать Ad Hoc 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
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 (AUR)
Вариант для Arch Linux и использования AUR packages.
Следующие шрифты доступны через AUR packages на Arch Linux:
The list is not complete, but you can search for a complete list here.
Вариант 8: Улучшить Свой Шрифт
Опция для исправления Вашего собственного шрифта или полная настройка улучшенного шрифта.
Используйте Python-скрипт для командной строки, чтобы создавать улучшенный шрифт из вашего собственного шрифта с дополнительными новыми символами.
Смотрите: Font Patcher для использования
- используйте эту опцию, если вы не хотите использовать один из предоставленных шрифтов
- Вас всё равно придётся копировать созданный шрифт в корректную директорую шрифтов в Вашей системе
Исправление шрифта по собственному выбору для использования с VimDevIcons ➶:
- требуется: Python 2 (или Python 3), python-fontforge package (версия 20141231 или более поздние, смотрите инструкцию по установке)
- альтернативный способ установки на macOS (OS X):
brew install fontforge
- Используйте:
./font-patcher PATH_TO_FONT
- Альтернативное использование: Запустите патчер с помощью двоичного файла FontForge, используя флаг скрипта:
./fontforge -script font-patcher PATH_TO_FONT
usage: font-patcher [-h] [-v] [-s] [-l] [-q] [-w] [-c] [--careful]
[--removeligs] [--postprocess [POSTPROCESS]]
[--configfile [CONFIGFILE]] [--custom [CUSTOM]]
[-ext [EXTENSION]] [-out [OUTPUTDIR]]
[--glyphdir [GLYPHDIR]] [--makegroups]
[--variable-width-glyphs]
[--progressbars | --no-progressbars] [--also-windows]
[--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: 2.2.2
* Development Website: https://github.com/ryanoasis/nerd-fonts
* Changelog: https://github.com/ryanoasis/nerd-fonts/blob/master/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
-w, --windows Limit the internal font name to 31 characters (for Windows compatibility)
-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 new glyphs will be copied, with no scaling applied.
-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 Use alternative method to name patched fonts (experimental)
--variable-width-glyphs
Do not adjust advance width (no "overhang")
--progressbars Show percentage completion progress bars per Glyph Set
--no-progressbars Don't show percentage completion progress bars per Glyph Set
--also-windows Create two fonts, the normal and the --windows version
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
Давайте прокачаем все шрифты!
-
для использования Контрибьюторами или Разработчиками
-
улучшайте все шрифты в 'неулучшенном' каталоге:
./gotta-patch-em-all-font-patcher\!.sh
- можно задать определенный шаблон имени шрифта:
./gotta-patch-em-all-font-patcher\!.sh Hermit
Сотрудничество в разработке
Смотрите contributing.md
Нестабильные пути к файлам
⚠️ Предупреждение: Пути файлов могут изменяться в зависимости от релизов (особенно после крупных релизов)
Ссылка на ветвь release, а не на ветку 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 (патентованный)
Мотивация Проекта
Смотрите Wiki: Project Purpose
Журнал Изменений
Смотрите changelog.md
Лицензия
MIT © Ryan L McIntyre