nerd-fonts/readme_uk.md at e398a3847c6e7dfe8807f4fe44c64f5853bb7f17

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

Fini Jastrow d4cbb31397 Update changelog to v3.0.2 (and readme)

Drop the detailed translations because I can not keep this up to date
anyhow. Having the current options in the readme is more important I
guess. This whole translation business is a problem on its own and not
solved.

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

2023-06-05 12:02:16 +02:00

46 KiB

Raw Blame History

Nerd Fonts це проект, який виправляє шрифти для розробників за допомогою великої кількісті гліфів (інакше кажучи іконок). Спеціально для додавання великої кількості додаткових гліфів від популярних 'іконних шрифтів' таких як Font Awesome ➶, Devicons ➶, Octicons ➶, та інших.

Наступна Sankey flow діаграма показує включені поточні набори гліфів:

_{Діаграма, створена за допомогою @SankeyMATIC}

Важливі повідомлення

шляхи до файлів в гілці master не вважаються стабільними. Verify your repository URI references
клонування цього репозиторію не рекомендується (через розміри репозиторію) якщо тільки ви не плануєте розвивати проект

Зміст

Надто довго. Не читав

Налаштування по установці

1 - Посібник
2 - Архів завантажень релізів
3 - Установчі скрипти
4 - Нативні шрифти (macOS (OS X))
5 - Клонування репозиторію
6 - Конкретний випадок завантаження за допомогою Curl
7 - Репозиторій користувачів Arch (Community) (Arch Linux)
8 - Налаштуйте свій власний шрифт

Особливості

Набори гліфів/іконок
Виправлені шрифти
Комбінації
Патчер шрифтів

Розробник/Контриб'ютор

Патчер шрифтів
Збираємося патчить їх всіх, Патчер Усіх Шрифтів!
Інші хороші шрифти для патча
Розвиток проекту

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

Додаткова інформація

Нестабільні шляхи до файлів в гілці master
Журнал змін
Ліцензія

Надто довго. Не читав

Nerd Fonts використовує популярні програмні шрифти і додає купу Значків. Існує також патчер шрифтів, якщо бажаний шрифт ще не виправлений. Для отримання більш детальної інформації дивись wiki. Якщо ви шукаєте плагін Vim, дивись VimDevIcons ➶.

Різні параметри завантаження шрифтів

Якщо ви...

Варіант 1. бажаю швидко завантажити індивідуальний шрифт з patched-fonts/ каталогу
Варіант 2. бажаю завантажити пакет варіацій сімейства шрифтів (жирний, курсив, тощо), дивись завантажити архів
Варіант 3. бажаю автоматизувати встановлення або використання в скриптах, дивись Встановити скрипти
Варіант 4. Я на macOS та бажаю використовувати нативні шрифти, дивись Нативні Шрифти
Варіант 5. бажаю повний контроль, дивись клонування репозиторії
Варіант 6. бажаю використовувати curl команду або використовувати в скриптах дивись Конкретний випадок завантаження за допомогою Curl
Варіант 7. Я на Arch Linux та бажаю використовувати Community packages, дивись Неофіційні репозиторії користувачів Arch
Варіант 8. Бажаю пропатчити власний шрифт, дивись Патчер шрифтів

Особливості

FontForge Python script щоб патчити будь-який шрифт
- Включає можливість створення Monospaced (фіксованої ширини) чи подвійної ширини (non-monospaced) glyphs
- Докладніше дивись розділ Патчер шрифтів
50 вже виправлені сімейства шрифтів
Понад 1,571,470 унікальних комбінацій / варіацій пропатченних шрифтів (детальніше)
Понад 9,000 гліфів / іконок у поєднанні (детальніше)
- Поточні набори гліфів включають: Powerline with Extra Symbols, Font Awesome, Material Design Icons, Weather, Devicons, Octicons, Font Logos (Раніше Font Linux), Pomicons
Monospaced (фіксованої ширини) чи подвійної ширини (non-monospaced) версія кожного шрифту
- Це стосується Nerd Font гліфів, але не обов'язково Шрифту в цілому
Розробник/Контриб'ютор постачає bash скріпт щоб повторно пропатчити всі шрифти

Набори гліфів

🔍 🔍 Тепер ви можете легко шукати гліфи на NerdFonts.com за допомогою Cheat Sheet

Дивись Wiki: Набори гліфів та Коди детальніше

Імена іконок в shell

Дивись Wiki: Імена іконок в shell

Пропатченні шрифти

Назва шрифту	Назва шрифту та репозіторія	*RFN	EM Розмір	Статус
3270 Nerd Font	3270	NO	1000
Agave	Agave	NO	2048
Anonymice Nerd Font	Anonymous Pro	NO	2048
Arimo	Arimo	NO	2048
Aurulent Sans Mono Nerd Font		NO	1000
BigBlueTerminal		NO	1200
Bitstream Vera Sans Mono Nerd Font		NO	2048
Blex*	IBM Plex Mono	YES	1000
Code New Roman Nerd Font		NO	2048
Cousine Nerd Font	Cousine	NO	1000
DaddyTimeMono	DaddyTimeMono	NO	1024
DejaVu Sans Mono Nerd Font		NO	2048
Droid Sans Mono Nerd Font		NO	2048
Fantasque Sans Nerd Font	Fantasque Sans	NO	2048
Fira Code Nerd Font	Fira Code	NO	1000
Fira Mono Nerd Font	Fira	NO	1000
Go Mono Nerd Font	Go-Mono	NO	1000
Gohu Nerd Font	Gohu TTF,Gohu	NO	1000
Hack Nerd Font	Hack	NO	2048
Hasklug Nerd Font*	Hasklig	YES	1000
Heavy Data Mono Nerd Font		NO	2048
Hermut Nerd Font		NO	1000
iM-Writing*	iA-Writer	YES	1000
Inconsolata Nerd Font		NO	1000
Inconsolata Go Nerd Font		NO	1000
Inconsolata LGC Nerd Font		NO	1000
Iosevka Nerd Font	Iosevka	NO	1000	#83
JetBrains Mono	JetBrains Mono	NO	1000
Lekton Nerd Font		NO	1000
Literation Mono Nerd Font*	Liberation	YES	2048
Meslo Nerd Font		NO	2048
Monofur Nerd Font		NO	2400
Monoid Nerd Font		NO	1536
Mononoki Nerd Font	Mononoki	NO	1024
M+ (MPlus) Nerd Font		NO	1000
Noto		NO	1000
OpenDyslexic		NO	1000
Overpass		NO	1000
ProFont (Windows tweaked) Nerd Font		NO	1200
ProFont (x11) Nerd Font		NO	1000
ProggyClean Nerd Font		NO	2048	Imperfect
Roboto Mono		NO	2048
Sauce Code Nerd Font	Source	YES	1000
Shure Tech Mono Nerd Font*	Share Tech Mono	YES	1000
Space Mono Nerd Font	Space Mono	NO	1000
Terminess Nerd Font*	Terminus Font	YES	1000
Tinos		NO	2048
Ubuntu Nerd Font		NO	1000
Ubuntu Mono Nerd Font		NO	1000
Victor Mono	Victor Mono	NO	1000

_{*RFN = Зарезервоване ім'я шрифту}

Комбінації

Понад 1,485,000 унікальні варіанти / комбінації (Power Set) пропатченних шрифтів:
- 50 пропатченних типів шрифтів
- 719 пропатченних сімейств шрифтів
- 2,876 'завершених' варіацій / комбінацій
- 1,485,410 можливих варіацій / комбінацій
- 1,488,286 загальна кількість обчислених комбінацій (2,876 + 1,485,410)
Комбінації для кожного шрифту - це будь-яка комбінація варіації

Варіації

Не дано додаткових параметрів (базові параметри 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 (Раніше Font Linux)
Powerline Extra Symbols
IEC Power Symbols
Pomicons
Сумісність з Windows

Встановлення шрифту

`Варіант 1: Завантажити та встановити самостійно`

Найкращий варіант для швидкого завантаження індивідуального шрифта.

Завантажте конкретний пропатченний шрифт на ваш вибір

`Варіант 2: Завантажити реліз архіву`

Найкращий варіант, якщо ви хочете archive або повне сімейство шрифтів в варіації (жирний, курсивний тощо)

Шрифти доступні для завантаження як пакети в останньому релізі

`Варіант 3: Встановити скрипти`

Найкращий варіант, якщо ви хочете автоматизувати встановлення або для використання в скриптах.

Примітка: Лише для Linux та macOS (OS X) Примітка: необхідне клонування репозиторію станом на даний час

Усі шрифти:

Встановлює всі пропатченні шрифти (Увага: Це багато шрифтів, що додають до великого розміру)

./install.sh

Одиничний шрифт:

Встановлює єдиний шрифт на ваш вибір

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

`Варіант 4: Нативні шрифти`

Найкращий варіант, якщо ви використовуєте macOS і хочете використовувати нативні шрифти.

Усі шрифти доступні через нативні Cask Fonts on macOS (OS X)

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

`Варіант 5: Клонування репозиторію`

Найкращий варіант для повного контролю, всіх чи майже всіх шрифтів, чи контриб'юції до розробки.

Клонування цього репозиторію не не потрібне (в основному за рахунок розміру репозиторію) якщо вас просто цікавить обмежений набір шрифтів.

Однак якщо ви хочете клонувати увесь проект, не забудьте зробити неглибоке клонування:

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/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, щоб створити виправлений шрифт із власного, щоб отримати нові доповненні гліфи

Дивіться: Патчер шрифтів для використання

оберіть цю опцію, якщо ви не бажаєте використовувати один із наданих шрифтів
вам все одно доведеться скопіювати згенерований шрифт у правильну директорію шрифтів у вашій системі

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

вимагає: Python 3, python-fontforge пакет (версіі 20141231 чи пізніше, дивись інструкції по встановленню)
альтернативний метод інсталювання на OSX: brew install fontforge
Використання:

    ./font-patcher ШЛЯХ_ДО_ШРИФТА

Альтернативне використання: Виконайте патч із FontForge binary використовуючи параметри:

    ./fontforge -script font-patcher ШЛЯХ_ДО_ШРИФТА

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

Збираємося патчитити "їх усіх", Патчер Усіх Шрифтів!

для використанням контриб'ютором або розробником
повторні патчі всіх шрифтів в не патченому каталозі:

./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 (не вільний)

46 KiB Raw Blame History