Pular para o conteúdo
Oleaflyv0.4.12

Fixe uma versão do Typst por projeto, acrescente pacotes do Typst Universe, controle fontes, variantes de compilação e PDFs reproduzíveis, e converta um projeto LaTeX em Typst.

O Oleafly vem com o Typst 0.15.1 e o servidor de linguagem Tinymist 0.15.8, então um projeto Typst novo compila sem nada para instalar. Esta página cobre o que você pode mudar: qual Typst um projeto usa, de onde vêm os pacotes e as fontes dele e como um único código-fonte gera mais de um PDF. Para a sintaxe e a barra de ferramentas, comece por Escrever em Typst.

Abra Configurações → Motores → Typst. O primeiro cartão é Typst (embutido), a versão que acompanha o aplicativo. Se já houver um typst instalado no seu computador, no seu PATH, na pasta do Homebrew ou em ~/.cargo/bin, um segundo cartão o mostra como Typst neste computador. Projetos que fixam exatamente essa versão podem compilar com ela.

Abaixo deles, Versões lista o Typst 0.11 a 0.15, da mais nova para a mais antiga. Cada linha dá a data de lançamento, o tamanho do download, de onde vem a cópia (Embutida, Baixada ou Sistema) e, depois de instalada, a versão do Tinymist que ela usa.

  • Instalar baixa essa versão. O Oleafly tenta o próprio espelho primeiro e o GitHub em segundo lugar, e confere o pacote e o programa dentro dele contra somas de verificação SHA-256 embutidas no aplicativo. Um arquivo que não bate é descartado, e uma instalação que falha ou é cancelada não deixa nada para trás. Os downloads ficam em ~/.oleafly/toolchains/typst/.
  • O botão redondo à esquerda de uma linha instalada torna essa versão a padrão.
  • Remover apaga uma versão baixada. A padrão não pode ser removida, então escolha outra padrão antes.

Projetos Typst novos fixam a versão padrão. O mesmo vale para projetos criados a partir de um modelo, projetos importados e pastas vinculadas. A fixação é guardada no project.json do projeto como um número de versão, e não como um caminho, então continua funcionando depois que você move o projeto ou o abre em outro computador.

Mudar a versão padrão depois não mexe nos projetos existentes. Isso é deliberado: um artigo com versão fixada mantém as mesmas quebras de linha e a mesma contagem de páginas quando o Oleafly traz um Typst mais novo.

Para mudar a versão de um projeto, abra a seta ao lado de Compilar de novo e olhe sob Versão do Typst (deste projeto). Padrão segue a versão escolhida nas Configurações e solta a fixação. As outras entradas são as versões instaladas neste computador, marcadas com [embutido] ou [sistema] onde isso se aplica. Para usar uma versão que não está listada, instale-a primeiro nas Configurações.

Se você abrir um projeto que fixa uma versão que este computador não tem, o Oleafly não vai compilar em silêncio com um Typst diferente. A compilação para com “O Typst 0.13.1 não está instalado”, e a prévia oferece dois botões:

  • Baixar Typst 0.13.1 instala a versão fixada e compila de novo. Ele aparece quando a versão é uma das que o Oleafly oferece.
  • Usar Typst 0.15.1, com o nome da sua versão padrão, solta a fixação e compila de novo com a padrão.

O menu de compilação marca a fixação como [não instalado] até você escolher uma delas.

Com um projeto Typst aberto, a aba Typst nas Configurações mostra Testar uma versão mais nova sempre que um Typst mais novo estiver instalado. Escolha Verificar com o Typst 0.15.1 (ou qual for a versão nomeada). O Oleafly compila o projeto duas vezes em pastas temporárias, uma com a versão atual do projeto e outra com a mais nova. Nada no seu projeto muda.

O relatório mostra se cada compilação deu certo, a contagem de páginas, os erros e os avisos. Ele informa se a contagem de páginas muda. Novo no Typst 0.15.1 lista mensagens que só a versão mais nova relata, e Não é mais relatado pelo Typst 0.15.1 lista as que deixam de aparecer. Clique em uma mensagem para abrir o arquivo dela naquela linha.

Se você gostar do que vir, Mudar para o Typst 0.15.1 fixa o projeto na versão mais nova. Verificar de novo roda as duas compilações outra vez depois de você corrigir algo.

O Tinymist alimenta a autocompletar, a ajuda ao passar o mouse, a renomeação e a formatação em arquivos Typst (veja Inteligência de código). Cada versão secundária do Typst tem o seu próprio lançamento do Tinymist, e um projeto conversa com o que corresponde à versão do Typst dele.

O Tinymist embutido cobre o Typst 0.15. Quando você abre um projeto fixado em uma linha mais antiga, o Oleafly baixa o Tinymist correspondente em segundo plano, com a mesma verificação de soma, e o status diz “Baixando o Tinymist 0.13.30 para corresponder à versão do Typst deste projeto.” Se o download falhar, o Oleafly tenta de novo mais tarde. Quando as Configurações encontram downloads do Tinymist de que nenhum Typst instalado precisa mais, elas oferecem Remover downloads não usados do servidor de linguagem.

As versões mais antigas existem para que projetos começados nelas continuem compilando da mesma forma. Alguns recursos dependem do que a própria versão do Typst dá suporte:

Recurso0.110.120.130.14 e posteriores
Só fontes do projetoNãoSimSimSim
Compilação reproduzívelNãoSimSimSim
Intervalos de páginas na exportação para PNG e SVGNãoSimSimSim
PDF/ANãoPDF/A-2bPDF/A-2b, PDF/A-3bTodos os níveis de PDF/A que o Typst oferece
PDF/UA-1NãoNãoNãoSim
Pacotes mantidos na pasta do projetoNãoSimSimSim
Exportação para HTML, e exportação para Word ou Markdown pelo HTML do TypstNãoNãoSimSim
Sincronização entre código-fonte e PDFNãoNãoSimSim
PDF marcado em toda compilaçãoNãoNãoNãoSim

O seletor de fontes consegue dizer de onde vem cada fonte no Typst 0.15 e posteriores. Quando uma configuração não pode ser aplicada à versão que um projeto usa, o menu de compilação a marca com Precisa de um Typst mais novo.

Escolha Pacotes Typst, o ícone de pacote na ponta direita da barra de ferramentas do Typst. Busque no Typst Universe por nome, palavra-chave ou categoria. Cada pacote mostra a versão mais recente dele, e um pacote que precisa de um Typst mais novo do que o que o projeto usa avisa: “Precisa do Typst 0.14.0. Este projeto usa o Typst 0.13.1.”

Inserir importação escreve a linha #import no topo do arquivo Typst aberto. Copiar importação a coloca na área de transferência.

O Typst baixa um pacote @preview na primeira vez que uma compilação o importa e o mantém em um cache que todos os projetos compartilham. A lista de pacotes também fica em cache. Sem conexão, o diálogo mostra a última lista buscada, com a data dela.

Quando uma importação nomeia um lançamento mais antigo do que o que está no Typst Universe, o número de versão dela fica sublinhado, com uma dica como “cetz 0.4.2 está disponível. Esta importação usa 0.3.4.” O cartão da dica oferece Atualizar para 0.4.2, que muda o número de versão na importação. Leia o changelog do pacote antes de aceitar, porque um lançamento novo pode mudar a forma de chamar o pacote. Passar o mouse sobre uma importação também oferece Abrir no Typst Universe.

Sob Pacotes do projeto no mesmo diálogo, Incorporar os pacotes ao projeto copia todos os pacotes que o projeto importa para uma pasta typst-packages no topo do projeto. Ele também copia os pacotes que esses pacotes importam e liga Usar pacotes da pasta do projeto.

De então em diante o Typst procura em typst-packages primeiro. Um projeto com pacotes incorporados compila sem conexão e em qualquer computador, e a pasta pode entrar no Git junto com o seu código-fonte. Um pacote que você não incorporou continua vindo do cache compartilhado. Isso precisa do Typst 0.12 ou mais novo, e em um projeto fixado no 0.11 o diálogo pede que você troque de versão primeiro.

Se um pacote ainda não estiver no cache, o diálogo o nomeia: “Estes pacotes não estão no cache de pacotes: …”. Compile uma vez com conexão e depois incorpore de novo.

Com o Modo offline ligado em Configurações → Geral, o Typst não consegue baixar nada. Cada pacote tem de já estar no cache compartilhado ou em typst-packages. Se um não estiver, a compilação falha e a mensagem nomeia o pacote, para você saber o que buscar na próxima vez que estiver com conexão.

O Typst encontra fontes em quatro lugares: as fontes embutidas no Typst, as fontes instaladas no seu computador, os pacotes de fontes que você baixa no Oleafly e pastas de fontes dentro do projeto. Coloque arquivos de fonte em uma pasta chamada fonts no topo do projeto, e tanto o compilador quanto o servidor de linguagem as pegam. Pastas extras podem ser listadas sob typst.font_paths no project.json. Pastas fora do projeto são ignoradas.

Sob Fontes (deste projeto) no menu de compilação, Usar fontes do sistema é o padrão. Só fontes do projeto impede o Typst de ler as fontes instaladas neste computador. O PDF então sai igual em toda máquina e, se o documento pedir uma fonte que o projeto não inclui, você descobre no seu próprio computador, e não no de um coautor.

Para escolher a fonte do texto, abra Configurações do documento, o ícone de controles deslizantes na barra de ferramentas do Typst, e clique em Fonte do texto. A lista mostra toda família que o Typst consegue encontrar com as configurações de fonte atuais do projeto. No Typst 0.15 e posteriores, cada família traz um rótulo Projeto, Sistema, Pacote de fontes ou Embutida. Escolha uma e clique em Aplicar, e o Oleafly a escreve nas regras #set do documento.

Configurações → Downloads → Fontes tem cinco pacotes de fontes gratuitos para o Typst: Chinês, japonês e coreano, Texto clássico, Sans e serifadas modernas, Código e Ícones e emoji. Depois que um pacote é baixado, todo projeto Typst pode usar as fontes dele pelo nome, e o mesmo vale para os downloads de Lato, PT Sans e PT Serif nessa aba. Um pacote só entra nas compilações depois que o download termina por inteiro, então um download pela metade nunca afeta um build.

Projetos definidos como Só fontes do projeto ou Compilação reproduzível não leem pacotes de fontes. Para esses, copie o arquivo de fonte para a pasta fonts do projeto.

Depois de cada compilação, o Oleafly procura caracteres que nenhuma fonte disponível conseguiu desenhar. O Typst os desenha como caixas. Quando encontra algum, a compilação recebe um aviso e uma faixa aparece acima do editor:

  • Caixas vazias significam que nenhuma fonte que o Typst pode usar tem os caracteres, e o aviso cita alguns. Quando um pacote de fontes os cobre, como o pacote Chinês, japonês e coreano faz com o texto CJK e o pacote Ícones e emoji faz com emoji, a faixa oferece Baixar fontes com o tamanho do download, e o log oferece Baixar e compilar. Caso contrário, acrescente à pasta fonts do projeto uma fonte que os tenha.
  • Caixas com um ponto de interrogação significam que o Typst desenhou os caracteres com uma fonte substituta. Nomeie uma fonte que os tenha em Fonte do texto, em Configurações do documento, ou em uma lista de fontes como #set text(font: ("Libertinus Serif", "Apple SD Gothic Neo")).
  • Em um projeto definido como Só fontes do projeto, pacotes de fontes e fontes do sistema não valem. Acrescente uma fonte à pasta fonts, ou mude o projeto para Usar fontes do sistema e Compilação padrão.

Configurações do documento, na faixa, abre o painel onde você escolhe a fonte do texto. Feche a faixa para escondê-la para esse aviso.

Uma variante de compilação é um conjunto nomeado de valores que o seu documento lê por meio de sys.inputs. Use variantes quando um único código-fonte precisa gerar PDFs diferentes, como uma cópia anônima para avaliação e uma versão pronta para publicação, ou um rascunho com marca d’água.

O documento decide o que cada valor faz. Os valores sempre chegam como texto:

#let draft = sys.inputs.at("draft", default: "false") == "true"
#if draft [*Draft. Do not circulate.*]

Para configurar uma variante:

  1. Abra Configurações do documento e role até Variantes de compilação.
  2. Escolha Adicionar variante e dê um nome a ela, por exemplo review.
  3. Escolha Adicionar valor, depois digite draft sob Nome e true sob Valor.
  4. Escolha Aplicar.
  5. Abra o menu de compilação. Variante (deste projeto) agora lista review. Escolha-a e compile.

Nenhuma variante compila sem nenhum valor de variante. A variante que você escolhe fica lembrada só neste computador, então um coautor pode compilar outra a partir do mesmo projeto. As variantes em si ficam salvas no project.json. As exportações também usam a variante selecionada.

Valores que toda compilação deveria receber vão sob typst.inputs no project.json. Quando uma variante define um valor com o mesmo nome, a variante vence.

Sob Compilação (deste projeto) no menu de compilação, Compilação reproduzível faz os mesmos códigos-fonte gerarem o mesmo PDF em qualquer computador. Ela usa só as fontes do projeto e as fontes embutidas do Typst, e data o PDF com o último commit do Git. Um projeto que não é um repositório Git recebe uma data fixa de 1º de janeiro de 1970.

Isso importa quando um PDF precisa bater com uma soma de verificação, para um depósito em arquivo ou uma comparação na CI. É preciso o Typst 0.12 ou posterior. Enquanto está ligada, Usar fontes do sistema fica indisponível. Compilação padrão é a opção predefinida.

O Typst compilando enquanto você digita: cada nova linha aparece no PDF.
O Typst compilando enquanto você digita: cada nova linha aparece no PDF. Abrir captura de tela completa

Defina Compilação automática como Ligada no menu de compilação. Em um projeto Typst, o Oleafly então mantém um processo do Typst em execução. O arquivo aberto se salva um momento depois que você para de digitar, o Typst o compila e a prévia recarrega na mesma posição de rolagem. Não existe uma configuração separada de prévia ao vivo: a Compilação automática é a prévia ao vivo.

Enquanto o Typst inicia, o menu mostra “Iniciando o Typst”. Se ele parar depois de erros repetidos, o menu avisa, e a sua próxima edição o inicia de novo. Parar a compilação encerra o processo, e a edição seguinte também o inicia de novo. Projetos LaTeX e Markdown tratam a Compilação automática de forma diferente; veja Compilação.

O comando oleafly compila projetos sem abrir o aplicativo. Ele acompanha o Oleafly, e a Ferramenta de linha de comando mostra como colocá-lo no seu PATH.

Para um projeto Typst, oleafly build e oleafly watch leem o project.json e usam as mesmas configurações do aplicativo: a versão fixada, os pacotes incorporados, as pastas de fontes, o interruptor de fontes do sistema, os inputs e as compilações reproduzíveis.

  • --variant review compila uma variante. Um nome que o projeto não define interrompe a compilação, e a mensagem lista as variantes que ele tem.
  • --offline bloqueia downloads de pacotes, como o Modo offline do aplicativo.
  • Um projeto com versão fixada compila só com aquele Typst exato. A CLI olha OLEAFLY_TYPST, depois as versões que o aplicativo baixou, depois o typst ao lado da CLI e por fim o seu PATH. Se nenhuma informar a versão fixada, a compilação para antes de o Typst rodar e diz como instalá-la.
  • Um projeto sem fixação usa OLEAFLY_TYPST quando ele está definido. Caso contrário, usa a versão padrão que você escolheu em Configurações → Downloads ou com oleafly typst default e, sem uma versão padrão escolhida, o Typst embutido ou o do seu PATH.
  • oleafly doctor lista todo Typst que ele encontrou e as configurações que uma compilação usaria. Ele falha quando a versão fixada está ausente.

Se uma configuração não pode ser aplicada ao Typst em uso, a compilação imprime uma nota, por exemplo que o Typst 0.11.1 não consegue ignorar as fontes do sistema. Os erros no terminal incluem as próprias dicas do Typst.

Abra o projeto LaTeX, pressione ⌘K (Ctrl+K) e execute Converter em um projeto Typst. Dê um nome ao projeto novo e escolha Converter. O projeto LaTeX permanece exatamente como estava. O Oleafly constrói um projeto Typst separado a partir dele:

  • O Pandoc converte o texto, a matemática, as figuras e as tabelas. Se o Pandoc ainda não estiver configurado, o Oleafly o configura primeiro.
  • Cada arquivo trazido com \input, \include ou \subfile se torna um arquivo .typ próprio.
  • Os arquivos BibTeX são copiados sem alterações.
  • O Typst compila o projeto novo para verificá-lo.

O relatório então diz se o projeto compila e conta o que foi convertido: arquivos de origem, figuras, tabelas, equações destacadas, referências cruzadas, fórmulas que o conversor matemático reparou e arquivos copiados, junto com o estilo de bibliografia que ele escolheu. Precisa de atenção lista o que corrigir à mão, como um include ou uma imagem ausente, um formato de imagem que o Typst não consegue mostrar, matemática que o conversor não conseguiu tratar, um estilo BibTeX sem correspondência no Typst ou um rótulo em uma linha de uma equação de várias linhas, que agora aponta para a equação inteira. Os erros e avisos de compilação têm link para o arquivo e a linha deles.

Escolha Abrir o projeto Typst para mudar para ele. O projeto novo fixa a sua versão padrão do Typst. Enquanto o Oleafly continuar aberto, Mostrar o relatório de conversão para Typst na paleta de comandos traz o relatório de volta.

Para converter um único arquivo em vez de um projeto inteiro, use LaTeX para Typst na página Ferramentas.

Visualização da imagem

Não foi possível carregar as respostas da IA

Tente de novo ou pesquise na documentação.