nerd-fonts/readme_fr.md

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 :

_{Diagramme créé avec @SankeyMATIC}

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

TL;DR

Options d'installation

• 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

Fonctionnalités

• Glyph/Icon sets
• Polices générées
• Combinations
• Générateur de police

Développeur/Contributeur

• Générateur de police
• Gotta Patch 'em All Font Patcher!
• D'autres bonnes polices à ajouter
• Contribuer

Motivation du projet

Informations additionnelles

• Instabilité des chemins de fichiers sur master
• Changelog
• Licence

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 dossier patched-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 archive
• Option 3. voulez une installation automatique ou utiliser des scripts, voir Installation via un script
• Option 4. vous êtes sur macOS et que vous voulez utiliser Homebrew, voir Homebrew Fonts
• Option 5. voulez un contrôle total, voir cloner le dépôt
• Option 6. voulez utiliser la commande curl ou pour l'utiliser via des scripts, voir Téléchargement Ad Hoc avec Curl
• Option 7. êtes sur Arch Linux et que vous voulez utiliser les Community packages, voir Dépôts Arch Community
• Option 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

Extension de la police Font Awesome. / (dépôt) / (website)

🔍 📑 Voir l'ensemble sur le website NerdFonts.com

Material Design Icons

Plus de 2000 icônes Material Design. / (dépôt) / (website)

🔍 📑 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

Icônes GitHub. / (dépôt) / (website)

🔍 📑 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 coup
• i_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

Nom de la police	Nom de la police et dépôt	*RFN	EM Size	Statut
3270 Nerd Font	3270	NO	1000
AnonymicePro 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
Code New Roman Nerd Font		NO	2048
Cousine Nerd Font	Cousine	NO	1000
DejaVu Sans Mono Nerd Font		NO	2048
Droid Sans Mono Nerd Font		NO	2048
Fantasque Sans Nerd Font	Fantasque Sans	NO	2048
Fura Code Nerd Font*	Fira	YES	1000
Fura Mono Nerd Font*	Fira	YES	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
Inconsolata Nerd Font		NO	1000
Inconsolata Go Nerd Font		NO	1000
Inconsolata LGC Nerd Font		NO	1000
Iosevka Nerd Font	Iosevka	YES	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		YES	2048
Ubuntu Nerd Font		NO	1000
Ubuntu Mono Nerd Font		NO	1000

_{*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ères
  • 719 familles de polices
  • 9,000+ 'complètes' variantes/combinaisons
  • '1,485,410' possibles variantes/combinaisons
  • 1,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 Fonts sur macOS (OS X)

brew tap homebrew/cask-fonts
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 (version 20141231 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

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

Voir Wiki: Project Purpose

Changelog

Voir changelog.md

Licence

MIT © Ryan L McIntyre