nerd-fonts/readme_pt-pt.md at db900abe1e5efd0eb94d15f1298ef1d48c233831

mirror of https://github.com/ryanoasis/nerd-fonts.git synced 2024-11-25 16:47:37 +02:00

King Art e0fa68b1f1 doc: Correct name for AnonymicePro Nerd Font

2023-10-17 15:23:27 +02:00

42 KiB

Raw Blame History

Nerd Fonts é um projeto que adere um grande número de glifos (ícones) a tipos de letra desenhados para programadores. Estes glifos são provenientes de vários «tipos de letra icónicos», tais como: Font Awesome ➶, Devicons ➶, Octicons ➶, entre outros.

O diagram Sankey mostra os conjuntos de glifos incluídos abaixo:

_{Diagrama criado utilizando @SankeyMATIC}.

Avisos Importantes

Os caminhos dos ficheiros no branch master não são considerados estáveis. Verifica as referências URI do teu repositório.
Fazer clone deste repositório não é recomendado (devido ao tamanho do repositório). Apenas deves dar clone ao repositório caso pretendas contribuir para o desenvolvimento do projeto.

Índice de Conteúdo

TL;DR

Opções de instalação

1 - Manualmente
2 - Transferência do ficheiro de lançamento
3 - Execução de instalação
4 - Tipos de letras do Homebrew (macOS (OS X))
5 - Dar clone ao repositório
6 - Transferir ad hoc com curl
7 - Repositório do Community do Arch (Arch Linux)
8 - Criar o teu tipo de letra

Características

Conjuntos de glifos/ícones
Tipo de letra modificados
Combinações
Modificador de tipo de letra

Desenvolvedor / Contribuidor

Modificador de tipo de letra
Modificador de fontes– «Modifica tudo!»
Outros bons tipos de letra para modificar
Contribuir

Motivação do projeto

Informações Adicionais

Ficheiros instáveis no branch master
Histórico de alterações
Licença

TL;DR

Nerd Fonts adere um conjunto de glifos a tipos de letra populares feitos para programação. Existe também um modificador de tipo de letra, caso o tipo de letra que queiras utilizar ainda não esteja modificado. Para mais informação lê a wiki. Caso estejas à procura do plugin para Vim, vê: VimDevIcons ➶.

Diferentes opções para transferir os tipos de letra

Se tu...

Opção 1. queres rapidamente utilizar um tipo de letra individual, transfere-o do diretório: patched-fonts/
Opção 2. queres transferir uma família de tipos de letra com variações (negrito, itálico, etc.) vê: Transferir um ficheiro
Opção 3. queres automatizar a instalação ou utilizar um executador vê: Execução de instalação
Opção 4. utilizas macOS e queres utilizar Homebrew vê: Tipos de letras do Homebrew
Opção 5. queres controlo total, então vê: Dar clone ao repositório
Opção 6. queres utilizar o comando curl ou executadores vê: Transferir ad hoc com curl
Opção 7. utilizas Arch Linux e queres utilizar o Community packages vê: Repositório do Utilizador do Community
Opção 8. queres modificar o teu tipo de letra vê: Modificador de tipo de letra

Características

Um executador de FontForge em Python para modificar qualquer tipo de letra
- Inclui a opção de criar glifos monoespaçados (de largura fixa) ou glifos de largura dupla (não monoespaçados)
- Para mais detalhes, vê a seção Modificador de tipo de letra
Já existem 50 tipos de letra modificados
Mais de 1,428,000 combinações/variações únicas de tipos de letra modificados (mais detalhes)
Cerca de 9,000 glifos/ícones combinados (mais detalhes)
- Os atuais conjuntos de glifos incluem: Powerline with Extra Symbols, Font Awesome, Material Design Icons, Weather, Devicons, Octicons, Font Logos (Antigamente Font Linux), Pomicons
Versões de glifos monoespaçados (de largura fixa) ou glifos de largura dupla (não monoespaçados) para cada tipo de letra
- Isto refere-se aos glifos do Nerd Font, não necessariamente ao tipo de letra
Um desenvolvedor/contribuidor criou um executador em Unix Shell para modificar novamente todos os tipos de letra

Conjuntos de glifos

🔍 🔍 Agora podes procurar facilmente por glifos no NerdFonts.com através da Cheat Sheet

Vê Wiki: Conjuntos de glifos e pontos de código para obteres mais detalhes

Nomes dos ícones em Unix Shell

See Wiki: Nomes dos ícones em Unix Shell

Tipos de letra

Nome do tipo de letra	Nome do tipo de letra e repositório	*RFN	Tamanho EM	Estado
3270 Nerd Font	3270	NÃO	1000
Agave	Agave	NÃO	2048
AnonymicePro Nerd Font	Anonymous Pro	NÃO	2048
Arimo	Arimo	NÃO	2048
Aurulent Sans Mono Nerd Font		NÃO	1000
BigBlueTerminal		NÃO	1200
Bitstream Vera Sans Mono Nerd Font		NÃO	2048
Blex*	IBM Plex Mono	SIM	1000
Caskaydia Cove Nerd Font*	Cascadia Code	SIM	2048
Code New Roman Nerd Font		NÃO	2048
Cousine Nerd Font	Cousine	NÃO	1000
DaddyTimeMono	DaddyTimeMono	NÃO	1024
DejaVu Sans Mono Nerd Font		NÃO	2048
Droid Sans Mono Nerd Font		NÃO	2048
Fantasque Sans Nerd Font	Fantasque Sans	NÃO	2048
Fira Code Nerd Font	Fira Code	NÃO	1000
Fira Mono Nerd Font	Fira	NÃO	1000
Go Mono Nerd Font	Go-Mono	NÃO	1000
Gohu Nerd Font	Gohu TTF,Gohu	NÃO	1000
Hack Nerd Font	Hack	NÃO	2048
Hasklug Nerd Font*	Hasklig	SIM	1000
Heavy Data Mono Nerd Font		NÃO	2048
Hermut Nerd Font		NÃO	1000
iM-Writing*	iA-Writer	SIM	1000
Inconsolata Nerd Font		NÃO	1000
Inconsolata Go Nerd Font		NÃO	1000
Inconsolata LGC Nerd Font		NÃO	1000
Iosevka Nerd Font	Iosevka	NÃO	1000	#83
JetBrains Mono	JetBrains Mono	NÃO	1000
Lekton Nerd Font		NÃO	1000
Literation Mono Nerd Font*	Liberation	SIM	2048
Meslo Nerd Font		NÃO	2048
Monofur Nerd Font		NÃO	2400
Monoid Nerd Font		NÃO	1536
Mononoki Nerd Font	Mononoki	NÃO	1024
M+ (MPlus) Nerd Font		NÃO	1000
Noto		NÃO	1000
OpenDyslexic		NÃO	1000
Overpass		NÃO	1000
ProFont (Windows tweaked) Nerd Font		NÃO	1200
ProFont (x11) Nerd Font		NÃO	1000
ProggyClean Nerd Font		NÃO	2048	Imperfeito
Roboto Mono		NÃO	2048
Sauce Code Nerd Font	Source	SIM	1000
Shure Tech Mono Nerd Font*	Share Tech Mono	SIM	1000
Space Mono Nerd Font	Space Mono	NÃO	1000
Terminess Nerd Font*	Terminus Font	SIM	1000
Tinos		NÃO	2048
Ubuntu Nerd Font		NÃO	1000
Ubuntu Mono Nerd Font		NÃO	1000
Victor Mono	Victor Mono	NÃO	1000

_{*RFN = Nome reservado do tipo de letra}

Combinações

Há mais de 1,485,000 variações/combinações únicas (Power Set) de tipos de letra modificados:
- 50 tipos de letra modificado
- 719 famílias de tipo de letra modificadas
- 2,876 variações/combinações «completas»
- '1,485,410' variações/combinações possíveis
- - 1,488,286 combinações totais calculadas (2,876 + 1,428,110)
As combinações para cada tipo de letra são quaisquer combinações de Variações

Variações

não são utilizados parâmetros (utiliza por definição Seti-UI + Custom e Devicons)
glifos de largura dupla (variável/proportional) ou normal (fixo/monoespaçado)
Font Awesome
Font Awesome Extension
Material Design Icons
Weather
GitHub Octicons
Font Logos (Antigamente Font Linux)
Powerline Extra Symbols
IEC Power Symbols
Pomicons
Compatibilidade com Windows

Opções de instalação

`Opção 1: Transferir e instalar Manualmente`

Melhor opção para obter rapidamente um tipo de letra específico.

Transfere o tipo de letra modificado que quiseres

`Opção 2: Transferência do Ficheiro de Lançamento`

Melhor opção caso queiras um ficheiro ou a família completa do tipo de letra com as diferentes variações (negrito, itálico, etc.).

Os tipos de letra estão disponíveis como pacotes na última versão

`Opção 3: Execução de instalação`

Melhor opção caso queiras automatizar a instalção ou utilizar em executadores.

Nota: Apenas para Linux & macOS (OS X) Nota: Por agora, implica dar clone do repositório

Todos os tipos de letra:

Instala todos os tipos de letra modificados (Atenção: São muitos tipos de letra, ocupando assim muito espaço do disco)

./install.sh

Um único tipo de letra:

Instala um único tipo de letra à tua escolha

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

`Opção 4: Tipos de Letra do Homebrew`

Melhor opção caso utilizes macOS e queres utilizar Homebrew.

Todos os tipos de letra estão disponíveis através de Homebrew Cask Fonts para macOS (OS X)

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

`Opção 5: Dar clone ao repositório`

Melhor opção para obter controlo total, total ou maioritário dos tipos de letra, ou para contribuir para o desenvolvimento do projeto.

Dar clone a este repoitório não é necessário nem eficiente (devido ao grande tamanho do repositório) caso queiras apenas instalar um número limitado de tipos de letra.

No entanto, se quiseres dar clone ao repositório garante que fazes um clone superficial:

git clone --depth 1

`Opção 6: Transferir ad hoc com curl`

Caso queiras utilizar o comando curl ou utilizar em executadores.

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: caminhos alternativos deprecados: ~/.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

`Opção 7: Repositório Arch Linux`

Most fonts are available via Arch Community packages. Some special packages are in AUR.

`Opção 8: Criar o teu tipo de letra`

A opção a utilizar caso queiras modificar o teu tipo de letra or personalizar por completo um tipo de letra já modificado.

Utiliza o executador de linha de comandos em Python fornecido para gerar um tipo de letra modificado com glifos através dum tipo de letra teu

Vê: Modificador de tipo de letra para instruções de utilização

utiliza esta opção caso não queiras utilizar um dos tipos de letra já disponíveis
depois de modificares, vais precisar de copiar o tipo de letra gerado para o diretório de tipos de letra do teu sistema operativo

Modificar o tipo de letra à tua escolha com VimDevIcons ➶:

requer: Python 3, o pacote python-fontforge (versão 20141231 ou mais recente, vê as instruções de instalação (em inglês))
método alternativo para macOS: brew install fontforge
Utilização:

./font-patcher CAMINHO_PARA_O_TIPO_DE_LETRA

Utilização alternativa: Executa o modificador com o binário de FontForge utilizando parâmetro -script:

./fontforge -script font-patcher CAMINHO_PARA_O_TIPO_DE_LETRA

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)

Exemplos

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

Modificador de fontes – «Modifica tudo!»

para contribuidor ou desenvolvedor, utiliza
modifica novamente todos os tipos de letra no diretório por modificar:

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

podes, opcionalmente, limitar para um certo padrão de nome:

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

Contribuir

Vê contributing.md

Ficheiros instáveis no branch `master`

⚠️ Aviso: Os caminhos dos ficheiros podem mudar consoante as versões (especialmente em versões com grandes alterações)

Utiliza o branch release e não o branch ~~master~~, visto que os camihnos estão sujeitos a alterações na altura do lançamento da nova versão

Por exemplo:
- ✅ Utiliza: https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf
- ❌ Em vez de: https://github.com/ryanoasis/nerd-fonts/blob/master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf

Outros bons tipos de letra para modificar

lista de outros bons tipos de letra a modificar que não podem ser distribuídos devido às suas licenças:
Input Mono (restrição de licença)
- Possivelmente será disponibilizada com hospedagem externa :)
PragmataPro (paga)
Consolas (proprietária)
Operator Mono (paga)
Dank Mono (paga)

42 KiB Raw Blame History