fontship

Sobre a fonte

A fonte é um kit de ferramentas para gerar fontes e ferramentas para um fluxo de trabalho colaborativo.

Desenvolvido na Liga do Tipo Movimentável com as necessidades de projetos de fontes de código aberto em mente, a Fontship automatiza o processo de transformar suas fontes de design em arquivos de fontes prontos para a produção e agrupá-los para publicar. Sim, você pode dar as mesmas etapas manualmente. Sim, você pode escrever seus próprios scripts para realizar o mesmo trabalho. O que a fonte traz para a mesa é um pacote completo de todas as ferramentas que você precisa para reunir com a maioria dos bits conectados.

Uma fontes de construção de fontes é completamente automatizada, as compilações automáticas de CI e lançamentos de publicação estão a apenas um pequeno passo. Como um bônus adicional, tudo é cuidadosamente organizado para facilitar a colaboração remota assíncrona por meio de sistemas de controle de versão (como o GIT) o mais fácil possível. Os designers nem precisam usar as mesmas ferramentas de design!

Quase todos os aspectos das etapas de construção e do fluxo de trabalho podem ser aprimorados por projeto, mas as configurações da caixa devem funcionar para construir a maioria dos projetos de fontes.

Configurar

A fonte pode ser usada de qualquer uma das três maneiras diferentes:

1. Remotamente por meio de um corredor de CI que responde a eventos em um repositório Git remoto.
2. Localmente, através de uma imagem do Docker com tudo incluído para uma configuração com poucos aborrecimentos.
3. Localmente através de uma instalação regular do utilitário do sistema (desde que todas as dependências necessárias também sejam instaladas).

NOTA: Um quarto método suportado até a v0.5.0, a inclusão direta dos arquivos de regra do Fontship no makefile existente do seu projeto, foi prejudicada. Dependendo do seu projeto, esse uso pode ou não continuar funcionando com limitações por enquanto, mas novos recursos adicionados à CLI serão assumidos nas regras daqui para frente.

Configuração do CI

Construa suas fontes sem instalar ou executar nada localmente! Basta empurrar suas fontes para um repositório Git remoto e deixar a fontels fazer o resto.

Para uso com ações do GitHub, adicione um arquivo de configuração ao seu repositório, como .github/workflows/fontship.yml :

 name : Fontship
on : [push, pull_request]
jobs :
  fontship :
    runs-on : ubuntu-latest
    name : Fontship
    steps :
      - name : Checkout
        uses : actions/checkout@v2
        with :
          fetch-depth : 0
      - name : Fetch tags
        run : git fetch --prune --tags
      - name : Fontship
        uses : theleagueof/fontship@latest

No momento atual, a Fontship usa apenas as fontes no diretório do projeto atual, não as publica em nenhum lugar. Você precisará postar os artefatos resultantes por (por exemplo, anexando -os a cada execução de CI ou publicando -os em lançamentos) como outra etapa do fluxo de trabalho do seu projeto. Para exemplos completos de trabalho, consulte os fluxos de trabalho da liga Spartan ou Libertinus.

Outros corredores de IC podem ser facilmente suportados, consulte a edição nº 32 para obter detalhes ou solicitar configurações de amostra para o seu favorito.

Configuração do Docker

As imagens pré -construídas do Docker estão disponíveis no Docker Hub, pacotes do GitHub, ou você pode construí -las você mesmo.

A maneira mais fácil de instanciar um contêiner do Docker com todos os argumentos certos é definir um alias (que pode ser adicionado ao arquivo RC do seu shell para persistir):

Usando o Docker Hub como exemplo, um pseudônimo pode ser:

$ alias fontship= ' docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" theleagueof/fontship:latest '

O Docker puxará automaticamente os contêineres necessários para executar isso na primeira vez que você o usar, após o qual usará o cache do contêiner local. Para iniciar o download sem executar fontship ou atualizar manualmente seu cache mais tarde (por exemplo, quando mais recente for atualizado para uma nova versão), use docker pull theleagueof/fontship:latest .

Você pode substituir mais o mais recente (que sempre será a tag de versão lançada recentemente) por Master para usar a construção mais fresca, com um nome de tag como v0.3.2 para usar explicitamente uma versão específica ou com a cabeça para usar uma imagem construída localmente.

Para construir uma imagem do Docker localmente, você deseja clonar este repositório e executar ./bootstrap.sh ou baixar e extrair as fontes de uma versão, depois execute:

$ ./configure
$ make docker

Configuração do sistema

Se você usar o Arch Linux, poderá instalar este pacote AUR (pré -construído neste repositório).

Caso contrário, para instalar e usar localmente a partir da fonte, você precisará de algumas dependências:

• Git,
• GNU Core Utilities Plus diffutils , bsdtar , entr , zsh ,
• GNU make (4.2+) com as ferramentas do AutoConf correspondentes,
• Python 3 Plus Módulos variados, consulte o arquivo requisitos.txt ,
• Ferramentas de ferrugem, incluindo cargo e rustc para construir a CLI,
• E um punhado de outros utilitários da CLI relacionados à fonte, a saber: sfnt2woff-zopfli , psautohint , ttfautohint e woff2_compress .

Para instalar o software no seu computador, clone este repositório e execute ./bootstrap.sh ou faça o download e extraia a versão mais recente, depois execute:

$ ./configure
$ make
$ sudo make install

Uso

Prédio

Para construir todos os formatos possíveis para o seu projeto de fonte, execute

$ fontship make all

Para gerar apenas um formato específico, tente:

# Just static OTF fonts
$ fontship make otf

# All static formats
$ fontship make static

# All variable formats
$ fontship make variable

# Just variable TTF format
$ fontship make variable-ttf

Se você estiver interessado apenas em um arquivo específico (por exemplo, uma instância de peso estática), poderá especificar o nome exato do arquivo que espera obter a reconstrução mais rápida possível desse arquivo:

$ fontship make FooBar-Black.otf

Publicação

Quando tudo estiver pronto ou você deseja enviar uma fonte (ou enviar uma amostra para um amigo), você deseja criar o pacote de distribuição:

$ fontship make dist

Versão

A configuração da versão da fonte em todas as fontes geradas é determinada pela tag no repositório Git. As tags de versão devem estar em conformidade com o formato MAJOR.MINOR descrito pelo OpenFV.