nerd-fonts/readme_ru.md at 9be4cddc86632b1ceded2a443fb64be153e9923e

mirror of https://github.com/ryanoasis/nerd-fonts.git synced 2024-11-25 16:47:37 +02:00

Fini Jastrow 882e04271e Drop support for Python 2

[why]
Python 2 is long since EOL.

With the last commit we want to use Enums, which are not available in
Python 2.

I believe Python 2 broke some time before already, I stopped caring for
Python 2 some time ago.

This does not change any existing code. It just documents that there are
no efforts anymore to support Python 2.

This is PR #1121

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

2023-02-12 17:30:31 +01:00

41 KiB

Raw Blame History

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

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

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

@SankeyMATIC Diagram

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

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

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

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

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

Содержание

TL;DR

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

1 - Руководство
2 - Архив Выпусков
3 - Установочный Скрипт
4 - Шрифты Homebrew (macOS (OS X))
5 - Клонировать репозиторий
6 - Скачать Ad Hoc Curl
7 - Пользовательский репозиторий Arch (Community) (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 и хотите использовать Community packages, смотрите Пользовательский репозиторий Arch (Community)
Вариант 8. хотите улучшить свой собственный шрифт, смотрите Улучшитель Шрифтов

Особенности

Python скрипт FontForge для улучшения любого шрифта
- Включена возможность создания Моноширинных (с фиксированным шагом, с фиксированной шириной) или двойных (не моноширинных) глифов
- Для получения дополнительной информации смотрите раздел Улучшитель шрифтов
50 улучшенных семейства шрифтов
Более 1,571,470 уникальных комбинаций/вариантов улучшенненных шрифтов (больше информации)
Более 9,000 комбинаций глифов/значков (больше информации)
- Текущие наборы глифов включают: 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	Размер 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 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 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/HEAD/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/HEAD/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20Nerd%20Font%20Complete.otf

`Вариант 7: Пользовательский репозиторий Arch (Community)`

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

`Вариант 8: Улучшить Свой Шрифт`

Опция для исправления Вашего собственного шрифта или полная настройка улучшенного шрифта.

Используйте Python-скрипт для командной строки, чтобы создавать улучшенный шрифт из вашего собственного шрифта с дополнительными новыми символами.

Смотрите: Font Patcher для использования

используйте эту опцию, если вы не хотите использовать один из предоставленных шрифтов
Вас всё равно придётся копировать созданный шрифт в корректную директорую шрифтов в Вашей системе

Исправление шрифта по собственному выбору для использования с VimDevIcons ➶:

требуется: 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/-/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 (патентованный)

41 KiB Raw Blame History