44 KiB
Nerd Fonts est un projet qui regroupe les polices ciblées par les développeurs proposant ainsi un nombre élevé de glyphes (icônes). Précisément pour ajouter un nombre élevé de glyphes supplémentaires à partir de « polices iconiques » populaires telles que Font Awesome ➶, Devicons ➶, Octicons ➶, et d'autres.
Le diagramme de Sankey suivant montre les ensembles de glyphes actuels inclus :
Quick Navigation
Latest Release ➶ | Fonts | Patcher | VimDevIcons ➶ | Font Package Downloads ➶ |
---|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
Important Notices
- La branche
master
n'est pas considérée comme stable. Vérifiez votre branche de référence - Cloner ce dépôt n'est pas recommandé sauf si vous souhaitez contribuer au développement
Table des matières
- 1 - Manuel
- 2 - Téléchargement d'une archive de release
- 3 - Install Script
- 4 - Homebrew Fonts (macOS (OS X))
- 5 - Cloner le dépôt
- 6 - Téléchargement Ad Hoc avec Curl
- 7 - Arch Community dépôt
- 8 - Générer votre propre police
Informations additionnelles
TL;DR
Nerd Fonts récupère des polices de programmation populaires et ajoute de nombreux glyphes. Un généreur de polices est aussi disponible si vous souhaitez ajouter une police non présente. Pour plus d'informations précises, vous pouvez consulter le wiki. Plugin vim disponible ici : VimDevIcons ➶.
Plusieurs options de téléchargement des polices
Si vous...
Option 1.
voulez récupérer rapidement une police individuelle téléchargée depuis le dossierpatched-fonts/
Option 2.
voulez télécharger un package de famille de polices ainsi que ses variations (bold, italic, etc.), voir télécharger une archiveOption 3.
voulez une installation automatique ou utiliser des scripts, voir Installation via un scriptOption 4.
vous êtes sur macOS et que vous voulez utiliser Homebrew, voir Homebrew FontsOption 5.
voulez un contrôle total, voir cloner le dépôtOption 6.
voulez utiliser la commandecurl
ou pour l'utiliser via des scripts, voir Téléchargement Ad Hoc avec CurlOption 7.
êtes sur Arch Linux et que vous voulez utiliser les Community packages, voir Dépôts Arch CommunityOption 8.
générer votre propre police Générateur de police
Fonctionnalités
- Un script Python FontForge pour générer n'importe quelle police
- Includes an option to create Monospaced (fixed-pitch, fixed-width) or double-width (non-monospaced) glyphs
- Incluant une option permettant de créer des glyphes Monospaced (fixed-pitch, fixed-width) ou double-width (non-monospaced)
- For more details see the Font Patcher section
- Pour plus de détails, voir la section Générateur de font
- Déjà
50
familles de polices générées - Plus de
1,571,470
unique variantes/combinaisons uniques de fonts générées (plus de détail) - Plus de
1,600
glyphes/icones combinés (plus de détail)- Les ensembles de glyphes actuels incluent : Powerline with Extra Symbols, Font Awesome, Material Design Icons, Weather, Devicons, Octicons, Font Logos (Anciennement Font Linux), Pomicons
- Monospaced (fixed-pitch, fixed-width) ou double-width (non-monospaced) pour chaque version de glyphes de chaque police
- Ceci fait référence aux glyphes de Nerd Font et pas nécessairement à la police dans son ensemble
- Un script bash fourni pour développeur/contributeur pour re-générer toutes les polices
Ensembles de glyphes
🔍 🔍 Vous pouvez désormais rechercher facilement des glyphes sur NerdFonts.com [via la table de référence][]
Seti-UI + Custom
Based off of Seti-UI Icomoon with extra custom glyphs. Basé sur Seti-UI Icomoon avec des glyphes supplémentaires.
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Devicons
Une police iconique faite pour les développeurs, jedis du code, ninjas, HTTPsters, evangelists et nerds(sic). / (dépôt) / (website)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Font Awesome
Une police iconique et une boîte à outils CSS. / (dépôt) / (website)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Font Awesome Extension
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Material Design Icons
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Weather
215 icônes et CSS sur le thème de la météo. / (dépôt) / (website)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Octicons
🔍 📑 Voir l'ensemble sur le website NerdFonts.com*
* Pour éviter des conflits entre des jeux d'icônes, ceux-ci ont été modifiés dans les polices 'complètes'. Pour voir les codepoints originaux, voir le Wiki.
Powerline Extra Symbols
Fournit des glyphes de séparateur et un glyphe de numéro de colonne pour Powerline (CN). / (dépôt)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
IEC Power Symbols
Ajoute de nouveaux caractères dans Unicode / (website)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Font Logos (Formerly Font Linux)
Font-logos est une police d'icônes contenant des logos de distributions linux populaires et d'autres logiciels open source pour les inclure dans des sites web. / (dépôt)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Pomicons
8 symboles pour la "Pomodoro Technique"®. / (dépôt)
🔍 📑 Voir l'ensemble sur le website NerdFonts.com
Noms d'icônes en Shell
Le téléchargement fourni des fichiers .sh
dans le dossier bin/scripts/lib/, les dossiers recommandés sont ~/.local/share/fonts/
ou ~/bin/
.
i_all.sh
- un helper pour charger tous les fichiers que vous avez téléchager d'un coupi_dev.sh
- Devicons (198 icônes, dont 8 qui n'ont pas de nom)i_fa.sh
- Font Awesome (675 icônes, 111 alias)i_fae.sh
- Font Awesome Extension (170 icônes)i_iec.sh
- IEC Power Symbols (5 icônes)i_logos.sh
- Font Logos (20 icônes)i_oct.sh
- Octicons (172 icônes)i_ple.sh
- Powerline Extra Symbols (37 icônes, 2 alias, dont 16 qui n'ont pas de nom)i_pom.sh
- Pomicons (11 icônes)i_seti.sh
- Seti-UI + Custom (50 icônes, 2 alias, dont 5 qui n'ont pas de nom)
Puis source
le(s) file(s) requis et afficher les variables $i_*
pour voir les icônes :
source ~/.local/share/fonts/i_oct.sh
echo $i_oct_heart
# Output:
# ♥
NOTE : Vous devez utiliser l'une des Nerd fonts pour voir les bonnes icônes de certains jeux d'icônes (Devicons, Font Awesome Extension, Font Logos), mais d'autres jeux devraient aussi fonctionner avec leurs polices standard.
Polices disponibles
*RFN = Reserved Font Name (Nom de police réservé)
Combinaisons
- Plus de
1,485,000
variantes/combinaisons uniques de fonts générées :50
polices de caractères719
familles de polices9,000+
'complètes' variantes/combinaisons'1,485,410'
possibles variantes/combinaisons1,488,286
total des combinaisons calculées (2,876 + 1,428,110)
- Les combinaisons pour chaque police sont une combinaison de Variations
Variations
- no flags given (defaults to only 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 (Anciennement Font Linux)
- Powerline Extra Symbols
- IEC Power Symbols
- Pomicons
- Compatible avec Windows
Installation de police
Option 1: Téléchargement et installion manuelle
Meilleure option pour l'installation rapide d'une police spécifique individuelle.
Télécharger la police générée spécifique de votre choix
Option 2: Téléchargement d'une archive de release
Meilleure option si vous voulez une archive ou une police complète ainsi que ses variations (Bold, Italic, etc.).
Les polices sont disponibles pour téléchargement au format archives dans la section latest release
Option 3: Installation via un script
Meilleure option si vous voulez automatiser l'installation ou pour l'utilisation via des scripts.
Note: Seulement pour Linux & macOS (OS X) Note: Requiert le clonage du dépôt
Toutes les polices :
- Installation de toutes les polices (Attention : Il y a beaucoup de polices, ce qui peut augmenter fortement la taille)
./install.sh
Police unique:
- Installation d'une police unique de votre choix
./install.sh <FontName>
./install.sh Hack
./install.sh HeavyData
Option 4: Homebrew Fonts
La meilleure option si vous êtes sur macOS et que vous voulez utiliser Homebrew.
Toutes les polices sont disponibles via Homebrew Cask sur macOS (OS X)
brew install font-hack-nerd-font
Option 5: Cloner le dépôt
La meilleure option pour un contrôle total, de toutes ou la plupart des polices, ou contribuer au développement.
Cloner ce dépôt n'est pas requis ni efficace si vous êtes simplement intéressé par un ensemble limité de polices.
Cependant, si vous voulez quand même cloner le dépôt, assurez-vous de le cloner superficiellement :
git clone --depth 1
Option 6: Téléchargement Ad Hoc avec Curl
Option si vous voulez utiliser la commande
curl
ou pour l'utiliser via des scripts.
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
Note: chemins alternatifs dépréciés: ~/.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
Option 7: Dépôts Arch Community
L'option pour Arch Linux et voulant utiliser les AUR packages.
Most fonts are available via Arch Community packages. Some special packages are in AUR.
Option 8: Générer votre propre police
L'option pour générer votre propre police ou customiser la police générée.
Utilisez le script en ligne de commande Python fourni pour générer une police corrigée à partir de votre propre police pour obtenir les nouveaux glyphes supplémentaires
Voir: Font Patcher pour utilisation
- Utiliser cette option si vous ne voulez pas utiliser l'une des polices fournies
- Vous devriez quand même copier la police générée dans le bon dossier de votre système
Générer la police de votre choix pour l'utiliser avec VimDevIcons ➶:
- Requis : Python 3,
python-fontforge
package (version20141231
ou plus récente, voir les instructions d'installation) - Méthode alternative sur OSX :
brew install fontforge
- Utilisation:
./font-patcher PATH_TO_FONT
- Autre utilisation: Exécuter le patcher avec le binaire FontForge en utilisant l'option script
./fontforge -script font-patcher PATH_TO_FONT
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)
Exemples
./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!
-
Pour les contributeurs ou les développeurs
-
re-patches toutes les polices dans le dossier unpatched:
./gotta-patch-em-all-font-patcher\!.sh
- pour limiter à un seul nom de police :
./gotta-patch-em-all-font-patcher\!.sh Hermit
Contribuer
Voir contributing.md
Instabilité des chemins de fichiers
⚠️ Attention: Les chemins des fichiers peuvent changer en fonction des releases (notamment lors de releases majeures)
Prendre en référence la branche release et non la branche master car les chemins de fichiers sont sujets à modifications entre les releases
- Par exemple:
- ✅ Utiliser :
https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
- ❌ Au lieu de :
https://github.com/ryanoasis/nerd-fonts/blob/
master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
- ✅ Utiliser :
D'autres bonnes polices à ajouter
- Une liste de bonnes polices supplémentaires à ajouter mais que je ne peux pas fournir ou partager en raison de leur licence :
- Input Mono (restriction de licence)
- Peut-être avec un hébergement externe :)
- PragmataPro (non gratuite)
- Consolas (propriétaire)
Motivation du projet
Changelog
Voir changelog.md
Licence
MIT © Ryan L McIntyre