48 KiB
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 (AUR) (Arch Linux)
- 8 - Налаштуйте свій власний шрифт
- Патчер шрифтів
- Збираємося патчить їх всіх, Патчер Всіх Шрифтів!
- Інші хороші шріфті для патча
- Контриб'юция
Додаткова інформація
Надто довго. Не читав
Nerd Fonts використовує популярні програмні шрифти і додає купу Значків. Існує також патчер шрифтів доступний, якщо бажаний шрифт ще не виправлений. Для отримання більш детальної інформації дивись wiki. Якщо ви шукаєте плагін Vim, дивись VimDevIcons ➶.
Різні параметри завантаження шрифтів
Якщо ви...
Варіант 1.
бажаю швидко завантажити індивідуальний шрифт зpatched-fonts/
каталогуВаріант 2.
бажаю завантажити сімейство шрифтів пакет варіацій (жирний, курсив тощо.) дивись завантажити архівВаріант 3.
бажаю автоматизувати встановлення або використання в скриптах дивись Встановити скриптиВаріант 4.
Я на macOS та бажаю використовувати рідні шрифти дивись Рідні ШрифтиВаріант 5.
бажаю повний контроль дивись клонування репозиторіїВаріант 6.
бажаю використовуватиcurl
команду або використовувати в скриптах дивись Конкретний випадок завантаження за допомогою CurlВаріант 7.
Я на Arch Linux та бажаю використовувати AUR packages дивись Неофіційні репозиторії користувачів ArchВаріант 8.
бажаю патчити власний шрифт дивись Патчер шрифтів
Особливості
- FontForge Python script щоб патчити будь-який шрифт
- Включає можливість створення Monospaced (фіксований крок, фіксована ширина) чи подвійної ширини (non-monospaced) glyphs
- Докладніше дивись Патчер шрифтів розділ
50
вже виправлені сімейства шрифтів- Понад
1,571,470
унікальні комбінації / варіації пропатченних шрифтів (детальніше) - Понад
2,600
гліфи / іконки у поєднанні (детальніше)- Поточні набори гліфів включають: 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 = Зарезервоване ім'я шрифту
Комбінації
- Понад
1,571,470
унікальні варіанти / комбінації (Power Set) пропатченних шрифтів:50
пропатченних типів шрифтів697
пропатченних сімейства шрифтів2,788
'завершених' варіації / комбінації1,571,470
можливих варіації / комбінації1,574,258
загальна кількість обчислених комбінацій (2,788 + 1,571,470)
- Комбінації для кожного шрифту - це будь-яка комбінація варіації
Варіації
- Не дано додаткових параметрів (базові параметри 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 cask 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/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 пакети.
Наступні шрифти доступні через AUR пакети на Arch Linux:
- Nerd Fonts Complete (подвійної ширини)
- Nerd Fonts Complete (одинарної ширини)
- Nerd Fonts DejaVu Complete
- Nerd Fonts Source Code Pro Complete
- Nerd Fonts Git (застарілий)
Варіант 8: Налаштуйте свій власний шрифт
Варіант для пропатчити твій особистий шрифт чи повністю налаштувати пропатченний шрифт.
Використовуйте наданий сценарій командної строки Python, щоб створити виправлений шрифт із власного шрифту, щоб отримати нові доповненні гліфи
Дивіться: Патчер шрифтів для використання
- використовуйте цю опцію, якщо ви не бажаете використовувати один із наданих шрифтів
- вам все одно доведеться скопіювати згенерований шрифт у правильну директорію шрифтів у вашій системі
Виправлення шрифту за власним вибором для використання з VimDevIcons ➶:
- вимагає: Python 2 (чи Python 3),
python-fontforge
пакет (версіі20141231
чи пізніше, дивись інструкції по встановленню) - альтернативний метод установки на OSX:
brew install fontforge
- Використання:
./font-patcher ШЛЯХ_ДО_ШРИФТА
- Альтернативне використання: Виконайте патч із FontForge binary використовуючи параметри:
./fontforge -script font-patcher ШЛЯХ_ДО_ШРИФТА
usage: font-patcher [-h] [-v] [-s] [-l] [-q] [-w] [-c] [--fontawesome]
[--fontawesomeextension] [--fontlinux] [--octicons]
[--powersymbols] [--pomicons] [--powerline]
[--powerlineextra] [--material] [--weather]
[--custom [CUSTOM]] [--postprocess [POSTPROCESS]]
[--removeligs] [--configfile [CONFIGFILE]]
[--progressbars | --no-progressbars] [--careful]
[-ext [EXTENSION]] [-out [OUTPUTDIR]]
font
Nerd Fonts Font Patcher: виправляє заданий шрифт програмістами та гліфами, пов'язаними з розробкою
* Веб-сайт: https://www.nerdfonts.com
* Версія: 2.0.0
* Веб-сайт для розробки: https://github.com/ryanoasis/nerd-fonts
* Журнал змін: https://github.com/ryanoasis/nerd-fonts/blob/master/changelog.md
позиційні аргументи:
font Шлях до шрифту для виправлення (наприклад Inconsolata.otf)
необов'язкові аргументи:
-h, --help показати це довідкове повідомлення та завершує виконання
-v, --version показати номер версії програми та завершує виконання
-s, --mono, --use-single-width-glyphs
Чи генерувати гліфи як одноширочну, а не подвійну(зазвичай double-width)
-l, --adjust-line-height
Чи регулювати висоту лінії (намагання більш рівномірно централізувати розподільчі лінії)
-q, --quiet, --shutup
Не генерувати звіт
-w, --windows Обмежте внутрішнє ім'я шрифту до 31 символу (для сумісністі з Windows)
-c, --complete Додайте всі доступні гліфи
--fontawesome Додайте Font Awesome гліфи (http://fontawesome.io/)
--fontawesomeextension
Додайте Font Awesome Extension гліфи (https://andrelzgava.github.io/font-awesome-extension/)
--fontlinux, --fontlogos
Додайте Font Linux та шнші open source гліфи (https://github.com/Lukas-W/font-logos)
--octicons Додайте Octicons гліфи (https://octicons.github.com)
--powersymbols Додайте IEC Power Symbols (https://unicodepowersymbol.com/)
--pomicons Додайте Pomicon гліфи (https://github.com/gabrielelana/pomicons)
--powerline Додайте Powerline гліфи
--powerlineextra Додайте Powerline гліфи (https://github.com/ryanoasis/powerline-extra-symbols)
--material, --materialdesignicons, --mdi
Додайте Material Design іконки (https://github.com/templarian/MaterialDesign)
--weather, --weathericons
Додайте Weather іконки (https://github.com/erikflowers/weather-icons)
--custom [CUSTOM] Вкажіть спеціальний шрифт символу. Усі нові гліфи будуть скопійовані без масштабування.
--postprocess [POSTPROCESS]
Вкажіть скріпт для постобробки
--removeligs, --removeligatures
Видаляє лігатури, вказані у файлі конфігурації JSON
--configfile [CONFIGFILE]
Вкажіть шлях до файлу конфігурації JSON (див. зразок: src/config.sample.json)
--progressbars Показати відсоткові смуги виконання обробки кожного гліфу
--no-progressbars Не показувати відсоткові смуги виконання обробки кожного гліфу
--careful Не перезаписуйте наявні гліфи, якщо вони виявлені
-ext [EXTENSION], --extension [EXTENSION]
Змініть тип файлу шрифту для створення (наприклад, ttf, otf)
-out [OUTPUTDIR], --outputdir [OUTPUTDIR]
Каталог для виводу виправленого файлу шрифту
Приклади
./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 (не вільний)
Мотивація проекту
Дивись Wiki: Мета проекту
Журнал змін
Дивись changelog.md
Ліцензія
MIT © Ryan L McIntyre