43 KiB
Versões | Tipos de Letra | Modificador de Tipo de Letra | Documentação Wiki | Autocolantes | VimDevIcons
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
- 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
- Modificador de tipo de letra
- Modificador de fontes– «Modifica tudo!»
- Outros bons tipos de letra para modificar
- Contribuir
Informações Adicionais
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 ficheiroOpção 3.
queres automatizar a instalação ou utilizar um executador vê: Execução de instalaçãoOpção 4.
utilizas macOS e queres utilizar Homebrew vê: Tipos de letras do HomebrewOpção 5.
queres controlo total, então vê: Dar clone ao repositórioOpção 6.
queres utilizar o comandocurl
ou executadores vê: Transferir ad hoc comcurl
Opção 7.
utilizas Arch Linux e queres utilizar o AUR packages vê: Repositório do Utilizador do Arch (AUR) não-oficialOpçã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
2,600
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
*RFN = Nome reservado do tipo de letra
Combinações
- Há mais de
1,428,000
variações/combinações únicas (Power Set) de tipos de letra modificados:50
tipos de letra modificado697
famílias de tipo de letra modificadas2,788
variações/combinações «completas»1,428,110
variações/combinações possíveis1,430,898
combinações totais calculadas (2,788 + 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 Logos (Antigamente Font Linux)
-
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 cask 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/master/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/master/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:
- Nerd Fonts Complete (largua fixa)
- Nerd Fonts Complete (largura simples) (desatualizado)
- Nerd Fonts DejaVu Complete
- Nerd Fonts Source Code Pro Complete
- Nerd Fonts Git (desatualizado)
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ão20141231
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] [--fontawesome]
[--fontawesomeextension] [--fontlinux] [--octicons]
[--powersymbols] [--pomicons] [--powerline]
[--powerlineextra] [--material] [--weather]
[--custom [CUSTOM]] [--postprocess [POSTPROCESS]]
[--removeligs] [--configfile [CONFIGFILE]]
[--progressbars | --no-progressbars] [--careful]
[-ext [EXTENSION]] [-out [OUTPUTDIR]]
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.0.0
* Website do desenvolvimento: https://github.com/ryanoasis/nerd-fonts
* Histórico de alterações: https://github.com/ryanoasis/nerd-fonts/blob/master/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
--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/)
--fontlinux, --fontlogos
Aderir os glifos do Font Linux e doutros glifos de código-aberto (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)
--custom [CUSTOM] Especificar um tipo de letra de símbolos personalizada. Todos os novos glifos serão copiados, sem escala aplicada.
--postprocess [POSTPROCESS]
Especificar um executador para pós-processador
--removeligs, --removeligatures
Remove as ligaduras especificadas no ficheiro de configuração JSON
--configfile [CONFIGFILE]
Especificar um caminho para o arquivo de configuração JSON (vê a amostra: src/config.sample.json)
--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
--careful Não substituir os glifos existentes se detectados
-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
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
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
- ✅ Utiliza:
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)
Motivação do projeto
Histórico de Alterações
Vê changelog.md
Licença
MIT © Ryan L McIntyre