nerd-fonts/readme_pl.md at 2ee963285af7d968292ccb9f8b02efb13e4469a7

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

Zach DeCook 91ae09a203 material design icons: Update documentation

2023-01-13 12:59:53 +01:00

45 KiB

Raw Blame History

Nerd Fonts to projekt który pozwala łączyć czcionki przydatne developerom z czcionki zawierającymi dużą ilość glifów (ikon). Projekt w szczególności skupia się na dodaniu dużej ilości dodatkowych glifów z popularnych czcionek zawierających ikony, takich jak: Font Awesome ➶, Devicons ➶, Octicons ➶, i innych.

Poniższy diagram Sankey pokazuje aktualne zestawy dostępnych glifów (ikon):

_{Diagram stworzony przy pomocy @SankeyMATIC}

Ważne uwagi

ścieżki do plików gałęzi master nie są stabilne. Zweryfikuj odwołania URI w swoim repozytorium
klonowanie tego repozytorium nie jest rekomendowane jeśli nie zamierzasz tworzyć kontrybucji deweloperskich

Spis treści

TL;DR

Opcje Instalacji

1 - Ręczna
2 - Pobieranie archiwalnych wydań
3 - Instalacja skryptów
4 - Czcionki Homebrew (macOS (OS X))
5 - Klonowanie repozytorium
6 - Pobieranie za pomocą Ad Hoc Curl
7 - Arch User Repository (AUR) (Arch Linux)
8 - Spatchuj własną czcionke

Funkcje

Zestawy glifów/ikon
Spatchowane czcionki
Kombinacje
Patcher czcionek

Deweloper / Współpracownik

Patcher czcionek
Musisz spatchować je wszystkie - Patcher czcionek!
Inne czcionki do spatchowania
Kontrybucje

Cel projektu

Dodatkowe Informacje

Niestabilne ścieżki plików w gałęzi master
Changelog
Licencja

TL;DR

Nerd Fonts biorą na warsztat popularne czcionki dla programistów i dodają do nich zestawy glifów. Projekt udostępnia także patcher czcionek pozwalający tworzyć własne zestawy, gdyby wśród już istniejących brakowało pożądanej opcji. Aby uzyskać bardziej szczegółowe informacje zajrzyj do wiki. Jeśli szukasz wtyczki do Vim sprawdź sekcję VimDevIcons ➶.

Opcje Instalacji

Jeśli...

Opcja 1. chcesz szybko pobrać wybraną czcionke? zajrzyj do katalogu patched-fonts/
Opcja 2. chcesz pobrać rodzinę czcionek wraz ze wszystkimi wariantami (bold, italic, itp.) zajrzyj do sekcji pobieranie archiwalnych wydań
Opcja 3. chcesz automatycznie zainstalowac lub używać skryptów zajrzyj do sekcji instalacja skryptów
Opcja 4. używasz macOS i chcesz skorzystać z czcionek Homebrew zajrzyj do Czcionki Homebrew
Opcja 5. chcesz mieć pełną kontrolę zajrzyj do sekcji klonowanie Repozytorium
Opcja 6. chcesz użyć komendy curl lub korzystać ze skryptów zajrzyj do sekcji pobieranie za pomocą Ad Hoc Curl
Opcja 7. używasz Arch Linux i chcesz skorzystać z pakietów AUR zajrzyj do sekcji nieoficjalne Arch User Repository (AUR)
Opcja 8. chcesz spatchować własną czcionkę? Jeżeli tak, to zajrzyj do sekcji patcher fontóczcionek

Funkcje

Skrypt FontForge Python do patchowania czcionek
- Zawiera opcję tworzenia glifów Monospaced (fixed-pitch, fixed-width) lub double-width (non-monospaced)
- Aby uzyskać więcej szczegółów zajrzyj do sekcji Patcher Czcionek
50 już spatchowanych rodziny czcionek
Ponad 1,571,470 unikalnych kombinacji/wariacji spatchowanych czcionek (więcej szczegółów)
Ponad 9,000 kombinacji glifów/ikon (więcej szczegółów)
- Aktualne zestawy glifów zawierają: Powerline with Extra Symbols, Font Awesome, Material Design Icons, Weather, Devicons, Octicons, Font Logos (Formerly Font Linux), Pomicons
Monospaced (fixed-pitch, fixed-width) lub double-width (non-monospaced) wersje glifów dla każdej czcionki
- To odnosi się do glifów Nerd Fonts, nie koniecznie do czcionki jako całości
Deweloper/Contributor dostarczył bash script pozwalający re-patchować wszystkie czcionki

Zestawy glifów/ikon

🔍 🔍 Możesz teraz łatwo wyszukiwać glify NerdFonts.com za pomocą Cheat Sheet

Seti-UI + Custom

Bazuje na Seti-UI Icomoon z dodatkowymi niestandardowymi glifami.

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Devicons

Czcionki zawierające ikony, stworzyne dla deweloperów, jedi programowani (?), ninja, HTTPsterów, ewangelistów i nerdsówsic (?) ). / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Font Awesome

Czcionki zawierające ikony, i zestaw narzędzi CSS. / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Rozszerzenie Font Awesome

Proste rozszerzenie Font Awesome. / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Material Design Icons

2000+ ikon w stylu Material Design stworzonych przez społeczność. / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Czcionki pogodowe

215 ikon pogodowych i CSS. / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Octicons

Ikony GitHuba. / (repo) / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com*

_{* Aby uniknąć konfliktów między zestawami ikon, zostały one zmodyfikowane jako 'Complete' czcionki. Aby zobaczyć oryginalne codepoints zajrzyj do Wiki.}

Powerline Extra Symbols

Dodatkowe separatory Powerline i glify numerów kolumn (CN). / (repo)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

IEC Power Symbols

Dodaje nowe znaki do Unicode / (strona)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Czcionki Logo (Formerly Font Linux)

Font-logos to font zawierający ikony z logo popularnych dystrybucji linuksowych i innych programów typu open source do umieszczenia na stronach internetowych. / (repo)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Pomicons

8 symboli "Pomodoro Technique"®. / (repo)

🔍 📑 Zobacz zestaw na stronie NerdFonts.com

Nazwy ikon w shell

Download provided .sh files from bin/scripts/lib/ directory somewhere, recommended locations are ~/.local/share/fonts/ or ~/bin/.

i_all.sh - helper pozwalający załadować wszystkie pobrane pliki naraz
i_dev.sh - Devicons (198 ikon, 8 bez ustalonej nazwy)
i_fa.sh - Font Awesome (675 icons, 111 aliasów)
i_fae.sh - Font Awesome Extension (170 ikon)
i_iec.sh - IEC Power Symbols (5 ikon)
i_logos.sh - Font Logos (20 ikon)
i_oct.sh - Octicons (172 ikon)
i_ple.sh - Powerline Extra Symbols (37 ikon, 2 aliasy, 16 bez ustalonej nazwy)
i_pom.sh - Pomicons (11 ikon)
i_seti.sh - Seti-UI + Custom (50 ikon, 2 aliasy, 5 bez ustalonej nazwy)

Then source the required file(s) and output $i_* variables to see icons:

source ~/.local/share/fonts/i_oct.sh
echo $i_oct_heart
# Output:
# ♥

NOTE: Musisz użyć jednego z Nerd Fontów, aby zobaczyć prawidłowe ikony dla niektórych zestawów ikon (Devicons, Font Awesome Extension, Font Logos), ale inne zestawy powinny również działać z ich standardowymi czcionkami.

Spatchowane czcionki

Nazwa fontu	Nazwa fontu i repozytorium	*RFN	Rozmiar EM	Status
3270 Nerd Font	3270	NO	1000
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	YES	1000
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 = Zarezerwowana nazwa fontu [Reserved Font Name]}

Kombinacje

Ponad 1,485,000 unikalnych wariacji/kombinacji (Power Set) spatchowanych fontów:
- 50 spatchowanych fontów (typefaces)
- 719 spatchowanych rodzin fontów (font families)
- 2,876 'kompletne' wariacje/kombinacje
- '1,485,410' możliwe wariacje/kombinacje
- 1,488,286 suma wszystkich kombinacji (2,876 + 1,428,110)
Kombinacje dla każdego fontu są dowolnymi kombinacjami wariacji

Wariacje

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 (Wcześniej Font Linux)
Powerline Extra Symbols
IEC Power Symbols
Pomicons
Windows Compatibility

Instalacja fontów

`Option 1: Download and Install Manually`

Najlepsza opcja aby szybko pobrać wybrany font.

Pobierz wybrany spatchowany font

`Option 2: Release Archive Download`

Najlepsza opcja jeśli potrzebujesz archiwum albo kompletnej rodziny fontów i ich wariantów (Bold, Italic, itp.).

czcionki są dostepne do pobrania jako paczki w sekcji ostatnie wydania

`Option 3: Instalacja skryptów`

Najlepsza opcja jeśli chcesz zautomatyzować instalacje lub skorzystać ze skryptów.

Uwaga: Tylo dla Linux & macOS (OS X) Uwaga: Od teraz wymaga kolonowania repo

Wszystkie czcionki:

Instalucje wszystkie spatchowane (Ostrzeżenie: Jest to duża ilość fontów o dużym łączym rozmiarze)

./install.sh

Wybrany font:

Instaluje pojedynczy font

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

`Opcja 4: Czcionki Homebrew`

Najlepsza opcja jeśli używasz macOS i chcesz skorzystac z Homebrew.

Wszystkie czcionki są dostępne na Homebrew Fonts na macOS (OS X)

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

`Opcja 5: Klonowanie Repo`

Najlepsza opcja jeśli potrzebujesz pełnej kontroli, wszystkie lub większość fontów, lub dodajesz kontrybucje deweloperskie.

Klonowanie tego repozytorium nie jest wymagane ani wydajne jeśli interesuje cię ograniczona ilość fontów.

Jeśli jednak chcesz sklonować repo upewnij się, by wykonać shallow clone:

git clone --depth 1

`Opcja 6: Pobieranie za pomocą Ad Hoc Curl`

Opcja jeśli chcesz skorzystać z komendy curl albo ze skryptów.

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

Uwaga: przestarzała ścieżka alternatywna: ~/.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

`Opcja 7: Nieoficjalne Arch User Repository (AUR)`

Opcja dla Arch Linux jeśli chcesz wykorzystać Pakietów AUR (Arch User Repository).

Następujące czcionki są dostępne za pośrednictwem Pakietów AUR na Arch Linux:

The list is not complete, but you can search for a complete list here.

`Option 8: Spatchuj własny font`

Opcja jeśli chcesz spatchować swój własny font albo stworzyć w pełni niestandardowy spatchowany font.

Użyj dołączonego skryptu Pythona by wygenerować spatchowany font i dodać dodatkowe glify.

Zobacz: Patcher fontów

użyj tej opcji jeśli nie chcesz korzystać z spatchowanych fontów
nadal będziesz musiał skopiować wygenerowany font do właściwego katalogu w twoim systemie

Patchowanie wybranych przez ciebie fontów z wykorzystaniem VimDevIcons ➶:

wymagania: Python 2 (lub Python 3), python-fontforge package (wersja 20141231 lub nowsza, zobacz instrukcje instalacji)
alternatywan metoda instalacji na OSX: brew install fontforge
Użycie:

./font-patcher PATH_TO_FONT

Alternatywne użycie: Uruchom patchera za pomocą binarnej czcionki FontForge za pomocą flagi skryptu:

./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)

Przykłady

./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

Musisz spatchować je wszystkie - Patcher fontów!

do użytków osób dodających kontrybucje lub deweloperów
re-patchuje wszystkie czcionki w niespatchowanym katalogu:

./gotta-patch-em-all-font-patcher\!.sh

opcjonalnie można ograniczyć do wskazanych wzorów nazw fontów:

./gotta-patch-em-all-font-patcher\!.sh Hermit

Kontrybucje

Zobacz contributing.md

Niestabilne ścieżki plików w gałęzi master

⚠️ Warning: Ścieżki plików mogą się różnić w zależności od wydania (zwłaszcza główne wersje)

Odwołuj się do gałęzi danego release a nie do gałęzi ~~master~~ ponieważ ścieżki są uzaleznione od zmian w każdym z wydań

Na przykład:
- ✅ Używaj: https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
- ❌ Zamiast: https://github.com/ryanoasis/nerd-fonts/blob/master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf

Inne czcionki do spatchowania

lista innych ciekawych fontów nadających się do patchowania, które nie mogły zostać włączone do projektu ze względó licencyjnych:
Input Mono (ograniczenia licencyjne) coming with external hosting :)
PragmataPro (nie jest darmowy)
Consolas (prawnie zastrzeżony)
Operator Mono (nie jest darmowy)
Dank Mono (nie jest darmowy)

45 KiB Raw Blame History

Ważne uwagi

Spis treści

TL;DR

Opcje Instalacji

Funkcje

Zestawy glifów/ikon

Seti-UI + Custom

🔍 📑 Zobacz zestaw na stronie NerdFonts.com*

Czcionki Logo (Formerly Font Linux)

Nazwy ikon w shell

Spatchowane czcionki

Kombinacje

Wariacje

Instalacja fontów

Option 1: Download and Install Manually

Option 2: Release Archive Download

Option 3: Instalacja skryptów

Wszystkie czcionki:

Wybrany font:

Opcja 4: Czcionki Homebrew

Opcja 5: Klonowanie Repo

Opcja 6: Pobieranie za pomocą Ad Hoc Curl

Linux

macOS (OS X)

Opcja 7: Nieoficjalne Arch User Repository (AUR)

Option 8: Spatchuj własny font

Przykłady

Musisz spatchować je wszystkie - Patcher fontów!

Kontrybucje

Niestabilne ścieżki plików w gałęzi master

Inne czcionki do spatchowania

Cel projektu

Changelog

Licencja

45 KiB

Raw Blame History

`Option 1: Download and Install Manually`

`Option 2: Release Archive Download`

`Option 3: Instalacja skryptów`

`Opcja 4: Czcionki Homebrew`

`Opcja 5: Klonowanie Repo`

`Opcja 6: Pobieranie za pomocą Ad Hoc Curl`

`Opcja 7: Nieoficjalne Arch User Repository (AUR)`

`Option 8: Spatchuj własny font`