nerd-fonts/readme_ru.md

[][репозиторий]             

Nerd Fonts - это проект, который улучшает шрифты с большим количеством глифов (значков). В частности, добавляет большое количество значков из популярных 'символьных шрифтов', таких как Font Awesome ➶, Devicons ➶, Octicons ➶ и других.

На следующей Sankey-диаграме показаны текущие наборы глифов:

_{Диаграма создана с помощью @SankeyMATIC}

Быстрая Навигация

Последняя Версия ➶	Шрифты	Улучшатель шрифтов	VimDevIcons ➶	Скачать Пакеты Шрифтов ➶

Важные Замечания

• Пути к файлам ветки master нестабильны. Проверить свою ссылку на репозиторий
• Клонировать этот репозиторий не рекомендуется, если Вы не собираетесь участвовать в разработке

Содержание

TL;DR

Параметры Установки

• 1 - Руководство
• 2 - Архив Выпусков
• 3 - Установочный Скрипт
• 4 - Шрифты Homebrew (macOS (OS X))
• 5 - Клонировать репозиторий
• 6 - Скачать Ad Hoc Curl
• 7 - Пользовательский репозиторий Arch (AUR) (Arch Linux)
• 8 - Исправить свой собственный шрифт

Особенности

• Наборы Глифов/Значков
• Исправленные шрифты
• Комбинации
• Улучшитель Шрифтов

Разработчикам / Контрибьютерам

• Улучшитель Шрифтов
• Прокачай все шрифты!
• Другие хорошие шрифты для улучшения
• Сотрудничество в разработке

Мотивация проекта

Дополнительная информация

• Нестабильные пути к файлам в master
• Журнал изменений
• Лицензия

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 Linux, 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 Linux

Font-linux содержит логотипы популярных дистрибутивов 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_linux.sh - Font Linux (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 Linux), но остальные наборы должны работать со стандартными шрифтами тоже.

Исправленные Шрифты

Название Шрифта	Название Шрифта и Репозиторий	*RFN	Размер EM	Статус
3270 Nerd Font	3270	НЕТ	1000
Anonymice Nerd Font	Anonymous Pro	НЕТ	2048
Aurulent Sans Mono Nerd Font		НЕТ	1000
Bitstream Vera Sans Mono Nerd Font		НЕТ	2048
Code New Roman Nerd Font		НЕТ	2048
DejaVu Sans Mono Nerd Font		НЕТ	2048
Droid Sans Mono Nerd Font		НЕТ	2048
Fantasque Sans Nerd Font	Fantasque Sans	НЕТ	2048
Fura Code Nerd Font	Fira	ДА	1000
Fura Mono Nerd Font	Fira	ДА	1000
Gohu Nerd Font	Gohu	НЕТ	1000
Hasklug Nerd Font	Hasklig	ДА	1000
Heavy Data Mono Nerd Font		НЕТ	2048
Hermut Nerd Font		НЕТ	1000
Inconsolata Nerd Font		НЕТ	1000
Inconsolata Go Nerd Font		НЕТ	1000
Iosevka Nerd Font	Iosevka	ДА	1000	#83
JetBrains Mono	JetBrains Mono	NO	1000
Knack Nerd Font	Hack	ДА	2048
Lekton Nerd Font		НЕТ	1000
Literation Mono Nerd Font	Liberation	ДА	2048
Meslo Nerd Font		НЕТ	2048
Monofur Nerd Font		НЕТ	2400
Monoid Nerd Font		НЕТ	1536
Mononoki Nerd Font	Mononoki	НЕТ	1024
M+ (MPlus) Nerd Font		НЕТ	1000
ProFont (Windows tweaked) Nerd Font		НЕТ	1200
ProFont (x11) Nerd Font		НЕТ	1000	[FAILING]
ProggyClean Nerd Font		НЕТ	2048	[FAILING]
Roboto Mono		НЕТ	2048	[FAILING]
Sauce Code Nerd Font	Source	ДА	1000
Shure Tech Mono Nerd Font	Share Tech Mono	ДА	1000
Space Mono Nerd Font	Space Mono	НЕТ	1000
Terminess Nerd Font	Terminus Font	ДА	1000
Ubuntu Nerd Font		НЕТ	1000
Ubuntu Mono Nerd Font		НЕТ	1000

_{*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 Linux
• 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 cask install 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:

• Nerd Fonts Complete (double-width)
• Nerd Fonts Complete (single-width)
• Nerd Fonts DejaVu Complete
• Nerd Fonts Source Code Pro Complete
• Nerd Fonts Git (out of date)
• Nerd Fonts Fira Code
• Nerd Fonts Terminus
• Nerd Fonts Liberation Mono
• Nerd Fonts Go Mono
• Nerd Fonts Anonymous Pro
• Nerd Fonts Noto
• Nerd Fonts Inconsolata

Вариант 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] [--fontawesome]
                    [--fontawesomeextension] [--fontlinux] [--octicons]
                    [--powersymbols] [--pomicons] [--powerline]
                    [--powerlineextra] [--custom [CUSTOM]]
                    [--postprocess [POSTPROCESS]]
                    [--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: 1.2.0
* 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)

optional arguments:
  -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
  --fontawesome         Add Font Awesome Glyphs (http://fontawesome.io/)
  --fontawesomeextension
                        Add Font Awesome Extension Glyphs (https://andrelzgava.github.io/font-awesome-extension/)
  --fontlinux           Add Font Linux Glyphs (https://github.com/Lukas-W/font-linux)
  --octicons            Add Octicons Glyphs (https://octicons.github.com)
  --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)
  --custom [CUSTOM]     Specify a custom symbol font. All new glyphs will be copied, with no scaling applied.
  --postprocess [POSTPROCESS]
                        Specify a Script for Post Processing
  --progressbars        Show percentage completion progress bars per Glyph Set
  --no-progressbars     Don't show percentage completion progress bars per Glyph Set
  --careful             Do not overwrite existing glyphs if detected
  -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

Примеры

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