nerd-fonts/readme_pt-pt.md at 50a18931715fc37c1b9cb3f5fcc5b9520c351746

mirror of https://github.com/ryanoasis/nerd-fonts.git synced 2024-11-19 16:39:20 +02:00

Zach DeCook 91ae09a203 material design icons: Update documentation

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

44 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 Utilizador do Arch (AUR) não-oficial (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 AUR packages vê: Repositório do Utilizador do Arch (AUR) não-oficial
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
Anonymice 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 --cask 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 do Utilizador do Arch (AUR) não-oficial (Arch Linux`

E a opção para utilizadores de Arch Linux que querem utilizar os pacotes do AUR.

Os seguintes tipos de letra estão disponíveis nos pacotes do AUR para Arch Linux:

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

`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 2 (ou 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

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

Modificador de Fontes Nerd Fonts: modifica uma determinada fonte com glifos relacionados à programação e ao desenvolvimento

* Website: https://www.nerdfonts.com
* Versão: 2.2.2
* Website do desenvolvimento: https://github.com/ryanoasis/nerd-fonts
* Histórico de alterações: https://github.com/ryanoasis/nerd-fonts/blob/-/changelog.md

argumentos posicionais:
  font                   Caminho para a fonte a ser modificada (por exemplo, Inconsolata.otf)

argumentos opcionais:
  -h, --help            mostrar esta mensagem de ajuda e sair
  -v, --version         mostrar o número da versão do programa e sair
  -s, --mono, --use-single-width-glyphs
                        Se os glifos devem ser gerados como largura simples e não largura dupla (o padrão é largura dupla)
  -l, --adjust-line-height
                        Se a altura da linha deve ser ajustada (tentar centralizar os separadores de powerline mais uniformemente)
  -q, --quiet, --shutup
                        Não gerar saída de detalhe
  -w, --windows         Limitar o nome da fonte interna a 31 caracteres (para compatibilidade com o Windows)
  -c, --complete        Aderir todos os glifos disponíveis
  --careful             Não substituir os glifos existentes se detectados
  --removeligs, --removeligatures
                        Remove as ligaduras especificadas no ficheiro de configuração JSON
  --postprocess [POSTPROCESS]
                        Especificar um executador para pós-processador
  --configfile [CONFIGFILE]
                        Especificar um caminho para o arquivo de configuração JSON (vê a amostra: src/config.sample.json)
  --custom [CUSTOM]     Especificar um tipo de letra de símbolos personalizada. Todos os novos glifos serão copiados, sem escala aplicada.
  -ext [EXTENSION], --extension [EXTENSION]
                        Alterar o tipo de ficheiro de fonte para criar (por exemplo, ttf, otf)
  -out [OUTPUTDIR], --outputdir [OUTPUTDIR]
                        O diretório para enviar o ficheiro de tipo de letra modificado para
  --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        Mostrar barras de progresso de conclusão percentual por Glyph Set
  --no-progressbars     Não mostrar barras de progresso de conclusão percentual por Glyph Set
  --also-windows        Create two fonts, the normal and the --windows version

Symbol Fonts:
  --fontawesome         Aderir os glifos do Font Awesome (http://fontawesome.io/)
  --fontawesomeextension
                        Aderir os glifos do Font Awesome Extension (https://andrelzgava.github.io/font-awesome-extension/)
  --fontlogos, --fontlinux
                        Aderir os glifos do Font Logos (https://github.com/Lukas-W/font-logos)
  --octicons            Aderir os glifos do Octicons (https://octicons.github.com)
  --powersymbols        Aderir os glifos do IEC Power Symbols (https://unicodepowersymbol.com/)
  --pomicons            Aderir os glifos do Pomicon (https://github.com/gabrielelana/pomicons)
  --powerline           Aderir os glifos do Powerline
  --powerlineextra      Aderir os glifos do Powerline (https://github.com/ryanoasis/powerline-extra-symbols)
  --material, --materialdesignicons, --mdi
                        Aderir os ícones do Material Design (https://github.com/templarian/MaterialDesign)
  --weather, --weathericons
                        Aderir os ícones do Weather (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)

44 KiB Raw Blame History