fontist
v1.21.1
Uma biblioteca simples para encontrar e baixar fontes para Windows, Linux e Mac.
Instale -o diretamente como:
gem install fontist Ou use -o como parte do seu pacote adicionando esta linha ao Gemfile do seu aplicativo:
gem "fontist"E depois execute:
bundle install Após a instalação, busque fórmulas através do comando fontist :
fontist updateDepende do FFI-Libarchive-Binário, que possui os seguintes requisitos:
zlib
Expat
OpenSSL (somente para Linux)
Essas dependências geralmente estão presentes em todos os sistemas.
fontistEsses comandos possibilitam operar com fontes via linha de comando.
A CLI suporta corretamente o status de saída; portanto, em um caso de erro, ele retorna um código de status mais alto ou igual a 1 .
As pesquisas são insensíveis ao caso para facilitar o uso.
Todos os comandos suportam as seguintes opções globais:
--preferred-familyPesquise usando o nome da “família preferida” de uma fonte. (Em vez do nome "Família padrão", o padrão antes do Fontist v1.10.)
Observação | Consulte a v1.10+ para obter as diferenças entre "família preferida" e "família padrão". |
-q, --quietImprima o mínimo de informações possível, principalmente erros críticos.
-v, --verboseDefina o nível de log para depurar. Ele imprime as fórmulas excluídas durante a instalação e as informações para desenvolvedores de Fontist.
-c, --no-cachePrefira download direto mesmo quando um arquivo já está em cache em um sistema.
fontist installO Fontist verifica se essa fonte já está instalada e, se não, instala a fonte e retorna seus caminhos instalados.
O nome da fonte é o único argumento a ser fornecido.
$ fontist install " segoe ui "
These fonts are found or installed:
- /Users/user/.fontist/fonts/SEGOEUI.TTF
- /Users/user/.fontist/fonts/SEGOEUIB.TTF
- /Users/user/.fontist/fonts/SEGOEUII.TTF
- /Users/user/.fontist/fonts/SEGOEUIZ.TTFPor padrão, todos os estilos correspondentes (de acordo com o nome da "família padrão" da fonte) são instalados.
Observação | Antes da v1.10, o nome da “família preferido” da fonte é usado para combinar estilos para pesquisa. Consulte a v1.10+ para obter detalhes dessa alteração. |
Para instalar todas as fontes especificadas em uma fórmula de fontistas, use a opção -F, --formula .
$ fontist install --formula ' courier_prime '
Downloading font ...
Installing font " courier_prime " .
Fonts installed at:
- /Users/user/.fontist/fonts/Courier Prime Bold Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime Bold.ttf
- /Users/user/.fontist/fonts/Courier Prime Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime.ttf Aqui, courier_prime é o nome do arquivo da fórmula localizada no repositório público de fórmula Fontist ( courier_prime.yml ).
Você também pode especificar o nome legível pelo homem da fórmula. Este nome é derivado do nome do arquivo, com sublinhados substituídos por espaços. Não é sensível ao minúsculo, o que significa que você pode usar letras maiúsculas, se preferir.
$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "A instalação pelo nome da fórmula suporta sugestões na CLI quando a entrada é parcial:
$ fontist install --formula ' noto s '
Formula ' noto s ' not found. Did you mean ?
[0] Google/Noto Sans
[1] Google/Noto Serif
Please type number or press ENTER to skip installation: Observação | Especificar o nome do arquivo da fonte ainda não é suportado. |
Se houver várias fórmulas com uma fonte solicitada, fontist busca a versão mais recente da fonte entre fórmulas com tamanho abaixo de um limite (300 MB). Esse comportamento pode ser alterado com as opções.
Observação | Se os estilos de uma fonte estiverem espalhados entre várias fórmulas, todos os estilos disponíveis de todas as fórmulas serão instalados. |
Observação | Algumas fórmulas podem ter o atributo min_fontist , que define a versão mínima do Fontist, pela qual elas podem ser instaladas. Se fontist for de uma versão mais antiga, a fórmula será evitada para usar. Para ver quais fórmulas foram excluídas da pesquisa, a opção -v, --verbose pode ser especificada. |
Opções suportadas:
-f, [--force]Instale mesmo se já instalado no sistema
-F, [--formula]Instale a fórmula inteira em vez de uma fonte
-a, [--accept-all-licenses]Aceitar todos os contratos de licença
-h, [--hide-licenses]Ocultar textos de licença
-p, [--no-progress]Ocultar o progresso do download
-V, [--version=VERSION]Instale a versão específica de uma fonte
-s, [--smallest]Instale a menor fonte por tamanho do arquivo se vários
-n, [--newest]Instale a versão mais recente de uma fonte se vários
-S, [--size-limit=N]Especifique o limite superior para o tamanho do arquivo de uma fórmula a ser instalada (o padrão é de 300 MB)
-u, [--update-fontconfig]Atualize o FontConfig
Observação | O comando install é semelhante à chamada da biblioteca Font.install . |
fontist uninstallDesinstala qualquer fonte suportada pela Fontist.
Retorna os caminhos de uma fonte desinstalada ou imprime um erro informando que a fonte não está instalada ou não pode ser encontrada nas fórmulas de fontistas. Aliases como remove .
$ fontist uninstall " segoe ui "
These fonts are removed:
/Users/user/.fontist/fonts/SEGOEUII.TTF
/Users/user/.fontist/fonts/SEGOEUIZ.TTF
/Users/user/.fontist/fonts/SEGOEUIB.TTF
/Users/user/.fontist/fonts/SEGOEUI.TTFfontist statusImpressões instaladas para a fonte com uma fórmula correspondente.
$ fontist status " segoe ui "
Fonts found at:
- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)fontist listLista o status de instalação de fontes suportadas pelo Fontist.
$ fontist list " segoe ui "
segoe_ui
Segoe UI
Regular (installed)
Bold (installed)
Italic (installed)
Bold Italic (installed)$ fontist list " roboto mono "
google/roboto_mono
Roboto Mono
Regular (not installed)
Italic (not installed)fontist manifest-locationsRetorna os locais das fontes especificadas em um arquivo YAML como uma entrada.
$ fontist manifest-locations MANIFEST_FILE MANIFEST_FILE é o local de um arquivo de manifesto que contém especificação de um ou vários estilos de fonte e fonte.
Um arquivo manifesto manifest.yml poderia parecer:
Segoe UI :
- Regular
- Bold
Roboto Mono :
- RegularO comando a seguir retornará a seguinte saída YAML:
$ fontist manifest-locations manifest.yml---
Segoe UI :
Regular :
full_name : Segoe UI
paths :
- " /Users/user/.fontist/fonts/SEGOEUI.TTF "
Bold :
full_name : Segoe UI Bold
paths :
- " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
Regular :
full_name : Roboto Mono Regular
paths :
- " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "Se uma ou mais fontes solicitadas estiverem faltando, o código de erro "3" será retornado e uma mensagem impressa:
$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3fontist manifest-installInstale fontes de um manifesto de fontista YAML:
$ fontist manifest-install --confirm-license manifest.yml Onde manifest.yaml está:
---
Segoe UI :
Regular :
full_name : Segoe UI
paths :
- " /Users/user/.fontist/fonts/SEGOEUI.TTF "
Bold :
full_name : Segoe UI Bold
paths :
- " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
Regular :
full_name : Roboto Mono Regular
paths :
- " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "fontist configO Fontist suporta configurações em todo o sistema para os seguintes parâmetros:
fonts_path Define o caminho onde instalar fontes (padrão: ~/.fontist/fonts )
open_timeout Define o tempo limite para abrir uma conexão durante o download (padrão: 10 )
read_timeout Define o tempo limite para a leitura da conexão aberta durante o download (padrão: 10 )
Mostre atributos atuais na configuração:
$ fontist config show
Current config:
read_timeout: 5Atribua um valor a um atributo:
$ fontist config set read_timeout 60Restaure um valor padrão de um atributo:
$ fontist config delete read_timeoutfontist fontconfigO FontConfig é um software projetado para fornecer fontes para outros programas. Normalmente é usado no Linux, mas também disponível no macOS e Windows. O FontConfig é usado pelo LibreOffice, GIMP e muitos outros programas.
Era para encontrar fontes de fontistas, o FontConfig deve ser atualizado para incluir caminhos de fontistas. Isso pode ser feito com a opção --update-fontconfig do comando install ou chamando um especial:
$ fontist fontconfig update Isso criaria uma configuração em ~/.config/fontconfig/conf.d/10-fontist.conf .
Para removê -lo, use:
$ fontist fontconfig remove$ fontist cache clearO comando acima vai limpar o cache de download do Fontist
fontist helpLista de todos os comandos pode ser vista por:
fontist help Por padrão, o Fontist usa o diretório ~/.fontist para armazenar fontes e seus arquivos. Pode ser alterado com a variável de ambiente FONTIST_PATH .
FONTIST_PATH= ~ /.fontist_new fontist updateFontist::Font O Fontist::Font é o seu local preferido para lidar com qualquer fonte usando o Fontist.
Essa interface permite encontrar uma fonte ou instalar uma fonte.
A interface Fontist::Font.find pode ser usada para encontrar uma fonte no seu sistema.
Ele analisará os diretórios de fonte específicos do sistema operacional e também o diretório ~/.fontist específico do Fontist.
Fontist :: Font . find ( name )Se o Fontist encontrar uma fonte, ela retornará os caminhos.
Caso contrário, ele aumentará um erro de fonte não suportado ou acionará a exibição das instruções de instalação para essa fonte específica.
A interface Fontist::Font.install pode ser usada para instalar qualquer fonte suportada.
Esta interface primeiro verifica se você já possui essa fonte instalada ou não e se o fizer, ela retornará os caminhos.
Se você não possui uma fonte, mas essa fonte é suportada pelo Fontist, ela baixará a fonte e a copiará para o diretório ~/.fontist e também retornará os caminhos.
Fontist :: Font . install ( name , confirmation : "no" )Se houver problemas detectados com a fonte fornecida, como a fonte não for suportada, esses erros serão levantados.
A interface Fontist::Font expõe uma interface para listar todas as fontes suportadas.
Isso pode ser útil se quiser saber o nome da fonte ou os estilos disponíveis. Você pode fazer isso usando:
Fontist :: Font . all Os valores de retorno são objetos OpenStruct , para que você possa fazer facilmente qualquer outra operação que faria em qualquer objeto Ruby.
Fontist::Formula A gema fontist usa internamente a interface Fontist::Formula para encontrar uma fórmula ou fontes registradas suportadas por qualquer fórmula. A menos que você precise fazer qualquer coisa que não precise trabalhar diretamente com essa interface. Mas se você o fizer, essas são a interface pública que ele oferece.
A interface Fontist::Formula.find permite encontrar qualquer uma das fórmulas registradas. Essa interface toma um nome de fonte como um argumento e examina cada uma das fórmulas registradas que oferece esta instalação de fonte. Usos:
Fontist :: Formula . find ( "Calibri" )Este método pesquisará e retornará uma fórmula de Fontista para a palavra -chave fornecida que permite um processamento adicional, como verificações de licença ou processo com a instalação da fonte em seu sistema.
Normalmente, cada nome de fonte pode ser associado a vários estilos ou coleções, por exemplo, a fonte Calibri pode contém uma fonte de estilos regular , bold ou italic e se você deseja uma interface que possa retornar a lista completa, esse é o seu amigo.
Você pode usá -lo como seguinte:
Fontist :: Formula . find_fonts ( "Calibri" ) A interface Fontist::Formula expõe uma interface para listar toda a fórmula de fonte registrada. Isso pode ser útil se quiser saber o nome da fórmula ou que tipo de fontes podem ser instaladas usando essa fórmula. Usos:
Fontist :: Formula . all Os valores de retorno são objetos OpenStruct , para que você possa fazer facilmente qualquer outra operação que faria em qualquer objeto Ruby.
Fontist::Manifest O Fontist pode ser alterado para usar os nomes de família preferidos. Este formato foi usado antes da v1.10.
Fontist . preferred_family = true Fontist::Manifest::LocationsO Fontist permite encontrar locais de fontes de um hash de manifesto definido no seguinte formato:
{
"Segoe UI" => [ "Regular" , "Bold" ] ,
"Roboto Mono" => [ "Regular" ]
}Chamar o código a seguir retorna um hash aninhado com caminhos e nomes de fonte. O nome da fonte é útil para escolher uma fonte específica em um arquivo de coleta de fontes (TTC).
Fontist :: Manifest :: Locations . from_hash ( manifest ) {
"Segoe UI" => {
"Regular" => {
"full_name" => "Segoe UI" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ]
} ,
"Bold" => {
"full_name" => "Segoe UI Bold" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
}
} ,
"Roboto Mono" => {
"Regular" => {
"full_name" => nil ,
"paths" => [ ]
}
}
} Fontist::Manifest::InstallO Fontist permite que você não apenas obtenha localizações de fontes, mas também para instalar fontes a partir do manifesto:
Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )Ele instalará fontes e retornará seus locais:
{
"Segoe UI" => {
"Regular" => {
"full_name" => "Segoe UI" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ] } ,
"Bold" => {
"full_name" => "Segoe UI Bold" ,
"paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
}
} ,
"Roboto Mono" => {
"Regular" => {
"full_name" => "Roboto Mono Regular" ,
"paths" => [ "/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf" ]
}
}
} Ambos os comandos suportam um arquivo YAML como uma entrada com um método from_file . Por exemplo, se houver um arquivo manifest.yml contendo:
---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular Em seguida, as seguintes chamadas retornariam nomes e caminhos de fontes, como do método from_hash (consulte Fontist::Manifest::Install and Fontist::Manifest::Locations ).
Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )Fontist::FontconfigFontist suporta trabalhar com FontConfig através da interface Ruby:
Fontist :: Fontconfig . update # let detect fontist fonts
Fontist :: Fontconfig . remove # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists As versões mais recentes do macOS fornecem instalações sob demanda de uma ampla gama de fontes licenciadas. Essas fontes complementares específicas do MacOS podem ser instaladas via Fontist.
Um uso típico para a instalação de fontes de complemento do MacOS é permitir que trabalhos de IC em ambientes MacOS usem essas fontes especialmente licenciadas que não estão disponíveis em outras plataformas.
Esta postagem do blog descreve como isso funciona:
Blog de Fontistas: Instalando fontes complementares específicas do macOS
Por exemplo, a fonte "Canela" é uma fonte comercial que vem gratuita com macOS.
Execute este comando para instalar Canela no macOS.
$ fontist install CanelaA lista completa das fontes disponíveis em várias versões do MacOS pode ser encontrada no site de suporte da Apple:
Fontes no macOS 13 Ventura
Fontes no macOS 12 Monteray
Fontes no macOS 11 Big Sur
Aviso | O Fontist não permite a instalação de fontes específicas do MacOS em plataformas que não são de macos devido a restrições de licença de fonte dessas fontes. |
NISC18030.TTF (GB18030 BITMAP) - MacOS, mais informações na edição do NISC18030
A lista completa de fontes problemáticas conhecidas:
Lista de fontes excluídas do uso
O Fontist usa o Git internamente para buscar fórmulas e fontes.
Para usar a funcionalidade Git por trás de um proxy, você precisa atualizar sua própria configuração Git através do comando git config ou o arquivo de preferência ~/.gitconfig .
Existem muitas maneiras de configurar a instalação do seu git local para usar proxies.
A maneira mais simples e global de definir um proxy para o Git é a seguinte.
Para http
git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}Para HTTPS, pode ser necessário lidar com erros de verificação SSL/TLS após definir o proxy, pois a extremidade da criptografia está localizada no seu endpoint HTTPS Proxy:
git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}Para meias, você precisará decidir sobre o protocolo de meias
git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} 'Por exemplo,
git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] ' A lista de protocolos de meias suportados para o campo {protocol} :
socks:// : para meias abaixo de V5
socks5:// : para meias v5
socks5h:// : para meias abaixo da resolução do host V5 + via meias
Na verdade, você pode definir um comportamento de proxy diferente para repositórios individuais do GIT - consulte este ótimo guia sobre como usar proxies Git (graças ao usuário do GitHub evantoli).
Um repositório de fontistas é um repo Git que contém arquivos de fórmula YAML. As fórmulas de fontistas podem ser criadas manualmente dentro de um repositório de fontistas (ver exemplos) ou geradas automaticamente a partir de um arquivo de fonte.
Um repositório de fontistas pode ser acessado por HTTPS ou SSH. No caso de SSH, uma chave SSH correspondente deve ser configurada com ssh-agent para acessar este repositório personalizado.
O comando fontist repo setup busca as fórmulas de um repositório personalizado e armazena o nome e o URL do repositório para uso posterior.
O comando fontist repo setup usa a seguinte sintaxe.
fontist repo setup NAME URL Internamente, todas as informações personalizadas do repositório de fontos são armazenadas em ~/.fontist/formulas/Formulas/private .
Por exemplo, dado um repositório de fontistas chamado "acme" acessível por meio de um URL ou um endereço SSH:
fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.gitfontist repo listDepois que o repositório de fontistas personalizado é configurado, pode -se instalar fontes a partir do repositório através de suas fórmulas:
fontist install " custom font " Se o repositório de fórmula fontista personalizado for atualizado, o comando repo update será usado para puxar as alterações mais recentes:
fontist repo update NAMEPor exemplo, dado um repositório de fontistas chamado "acme", o seguinte comando é usado.
fontist repo update acmeSe houver necessidade de remover um repositório de fontistas registrado, o repositório poderá ser removido com:
fontist repo remove acmeAs fórmulas de fontistas personalizadas e os repositórios de fontistas podem ser tornados privados para exigir autenticação.
Para repositórios de fontistas HTTPS e SSH GIT
A autorização de arquivos privados em fórmulas privadas pode ser implementada com cabeçalhos.
Aqui está um exemplo que funciona com os lançamentos do GitHub:
resources :
fonts.zip :
urls :
- url : https://example.com/repos/acme/formulas/releases/assets/38777461
headers :
Accept : application/octet-stream
Authorization : token ghp_1234567890abcdefghi Se o repositório de fórmula de Fontista for um repositório do GitHub, um token poderá ser obtido na página Configurações do GitHub> Tokens. Esse token deve ter pelo menos o escopo repo para acesso a esses ativos.
As fórmulas de fontistas podem ser facilmente artesanais em YAML. No entanto, o método de geração automática é recomendada para precisão e conveniência dos dados.
Uma fórmula pode ser gerada a partir de um arquivo de fontes.
O comando fontist create-formula permite a detecção de todos os arquivos de fonte de um arquivo de fonte em uma infinidade de formatos (aqueles suportados por escavado, incluindo zip, 7z, gzip, alcatrão, táxi, exe).
O comando fontist create-formula suporta arquivos localizados em URLs remotos ou caminhos de arquivos locais.
Para caminhos de arquivo, especifique o caminho do arquivo como argumento:
wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zipPara URLs, basta especificar o URL como o argumento:
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zipPara testar a fórmula criada, pode -se copiar a fórmula no local do repositório de fórmula privada do usuário.
fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/ O comando fontist create-formula cria fórmulas de fonte usando informações incorporadas na seção Metadados OTF.
No entanto, algumas fontes (como fontes mais antigas) geralmente contêm informações de metadados inconsistentes ou imperfeitos. Algumas fontes, por exemplo, aplicam diferentes valores Family OTF para diferentes estilos de fonte. Isso resultará em todos os estilos de fonte não serem registrados na mesma família.
Os autores de fórmula de fontistas podem corrigir essa situação usando a override: chave, que permite que a fórmula substitua as informações de metadados obtidas nos metadados da fonte.
Observação | A chave override não causa nenhuma alteração nos arquivos de fonte, é apenas para atualizar as informações usadas pelo Fontist internamente. |
A chave override existe sob a definição de estilos de fonte individuais:
resources :
...
fonts :
- name : Original font name
styles :
- family_name : Original family name
type : Original style
override :
family_name : Overridden family name
type : Overridden style
preferred_family_name : Overridden preferred family name Por exemplo, as fontes "Frutiger" publicadas pela Adobe em 1994 usam números para representar os estilos de fonte individuais e ter esses nomes incorporados no campo Family OTF, como "Frutiger 45 Light". Essas fontes também não usam o campo Preferred Family da OTF, que é uma adição mais recente ao OTF, devido à sua idade.
Aqui está como a propriedade override pode aplicar todos os estilos relevantes a serem registrados no mesmo nome de família (substituindo o valor preferred_family_name ):
...
resources :
...
fonts :
- name : Frutiger 45 Light
styles :
- family_name : Frutiger 45 Light
type : Regular
full_name : Frutiger-Light
post_script_name : Frutiger-Light
override :
preferred_family_name : Frutiger
- ... Este fragmento acima permitirá que o Fontist gere índices corretos e permitirá a instalação de todas as fontes Frutiger com um único comando:
$ fontist install " Frutiger " --preferred-family As versões de fontistas além da v1.10 utilizam um novo formato de fórmula. Após a atualização, execute fontist update para buscar as últimas fórmulas.
A partir da v1.10, o Fontist usa a "família padrão" em vez da "família preferida" ao agrupar os estilos.
Por exemplo, uma solicitação para a fonte "Lato" antes da v1.10 retornará todos os estilos: "Black", "Black Italic", "Bold" e outros 15 estilos.
A partir da v1.10, o Fontist retornará apenas os 4 estilos padrão: "regular", "itálico", "ousado" e "ousado em itálico".
Para buscar outros estilos, você deve especificar a fonte exata "subfamília", como "Lato Black", ou "Lato Heavy", ou usar a opção --preferred-family com CLI e Fontist.preferred_family = true com a biblioteca Ruby.
Observação | Antes da v1.10, havia um bug com a fórmula da fonte "Courier", que permitia a instalação da fonte ao solicitar o nome da fonte "Courier", mas a localização da fonte só era possível usar o nome completo da fonte "Courier New". A partir da v1.10, o comportamento foi tornado consistente - apenas o nome "novo correio" adequado deve ser usado. |
As versões de fontistas além da v1.16 trata o argumento font do comando install de maneira diferente. Após a atualização, verifique se todas as fontes necessárias são especificadas ao usar fontist install , fontist manifest-install (e a correspondente Ruby Interface Font.install e Manifest::Install ) ou use a opção -F, --formula .
A partir da v1.16, as instalações do Fontist solicitaram apenas fontes em vez de uma fórmula inteira, a menos que especificado explicitamente. mudou agora.
Por exemplo, uma solicitação de instalação para a fonte "Arial" antes da v1.16 configurará todas as fontes encontradas na fórmula "ms_truetype": "Arial", "Trebuchet MS", "Verdana" e "Times New Roman".
A partir da v1.16, o Fontist instalará apenas a fonte “Arial” solicitada.
Para instalar todas as fontes a partir de uma fórmula, a opção -F, --formula pode ser usada:
$ fontist install --formula ms_truetype Aviso | Esta seção é apenas para mantenedores de fontistas. |
Para adicionar um novo atributo, mude como a fórmula é tratada ou substitua completamente a estrutura, existem 2 maneiras de alterar um formato de fórmula:
Use o atributo min_fontist em uma fórmula. Ele define um requisito para o Fontist instalar a fórmula apenas se sua versão for igual ou mais que uma versão especificada.
Use uma nova filial no repositório de fórmulas, por exemplo, "v2", "v3", "v4", etc. Depois de criar um novo ramo, deve ser definido em Fontist.formulas_version
Observação | O uso de uma nova ramificação exigiria que todos os usuários baixassem novamente o repositório inteiro de fórmulas. Como esse método tem uma sobrecarga significativa, o primeiro ( min_fontist ) deve ser usado sempre que possível. |
O Google Fonts fornece provavelmente a maior coleção de fontes amplamente usadas, livre e abertamente licenciadas.
A biblioteca de fórmula da Fontist inclui suporte para todas as fontes licenciadas abertamente fornecidas através do Google Fontes e mantém fórmulas de fontistas para todas essas fontes.
Um fluxo de trabalho do GHA verifica fontes atualizadas no Google Fonts diariamente. Caso encontre uma atualização, ela é adicionada ao repo pelo fluxo de trabalho.
A SIL International é uma organização sem fins lucrativos baseada em fé reconhecida internacionalmente que serve comunidades de idiomas em todo o mundo.
O SIL fornece uma série de fontes exclusivas que suportam comunidades de linguagem menores que, com o código Unicode, geralmente ainda não (ainda) suportadas pelas fontes convencionais.
A Fontist visa suportar todas as fontes SIL e fornece suas fórmulas no repositório de fórmula de fontistas padrão.
Eles podem ser atualizados com:
fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push O MacOS fornece fontes que podem ser baixadas manualmente com Font Book.app .
Para atualizar as fórmulas macos:
fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git pushClone o repositório.
git clone https://github.com/fontist/fontistConfigure seu ambiente.
bin/setupExecute a suíte de teste
bin/rspecTodas as fórmulas de fontistas oficiais são mantidas no repositório de fórmulas.
Se você deseja adicionar um novo repositório de fórmula ou alterar configurações para uma existente, consulte sua documentação.
A liberação é feita automaticamente com as ações do GitHub. Basta bater e marcar com gem-release .
Para uma liberação de patch (0.0.x), use:
gem bump --version patch --tag --pushPara uma liberação menor (0.x.0), use:
gem bump --version minor --tag --pushPrimeiro, obrigado por contribuir! Adoramos puxar pedidos de todos. Ao participar deste projeto, você concede ao Ribose o direito de conceder ou transferir um número ilimitado de licenças ou sub-soluços não exclusivos para terceiros, sob os direitos autorais que cobrem a contribuição para usar a contribuição por todos os meios.
Estamos seguindo as regras de Sandi Metz para esta jóia, você pode ler a descrição das regras aqui. Todo o novo código deve seguir estas regras. Se você fizer alterações em um arquivo pré-existente que viole essas regras, você deve corrigir as violações como parte de sua contribuição.
Aqui estão algumas diretrizes técnicas a seguir:
Abra um problema para discutir um novo recurso.
Escreva testes para apoiar seu novo recurso.
Verifique se a suíte de teste inteira passa localmente e no CI.
Abra um pedido de tração.
Squash seus compromissos depois de receber feedback.
Festa!
Esta jóia é desenvolvida, mantida e financiada pela Ribose.
