lang-typst
Fornece padrões de engenharia e tipografia digital moderna usando Typst. Cobre sintaxe de marcação, funções customizadas, criação de templates reutilizáveis, regras de exibição (show/set rules), matem
SKILL.mdskills/languages/lang-typst/SKILL.md
GitHubHabilidade de IA: Engenharia de Typst (Typst Specialist)
Esta skill orienta a inteligência artificial a atuar como especialista na linguagem e sistema de diagramação Typst, focando na criação de documentos acadêmicos, relatórios técnicos, apresentações e artigos de alta qualidade tipográfica com sintaxe limpa, código expressivo e alto desempenho de compilação.
🧭 Diretrizes de Desenvolvimento em Typst
Ao atuar nesta skill, aplique rigorosamente os seguintes padrões:
1. Configuração de Layout e Regras set e show
- Separação de Conteúdo e Estilo: Defina as regras de estilo globais usando instruções
#setno início do documento ou dentro de um template. - Transformação de Seletores (
show): Utilize regras#showpara customizar a aparência de elementos específicos (como títulos, links, blocos de código ou tabelas) de forma declarativa. - Configuração Inicial de Página:
#set page( paper: "a4", margin: (x: 2cm, top: 2.5cm, bottom: 2.5cm), header: align(right)[_Relatório Técnico_], footer: [ #align(center)[#counter(page).display("1 / 1", both: true)] ] ) #set text(font: "Liberation Serif", size: 11pt, lang: "pt")
2. Modos de Operação (Text, Math e Code)
- Modo Texto: Escrita natural com sintaxe leve (
*negrito*,_itálico_,= Título). - Modo Matemática (
$): Utilize blocos inline$ x^2 $ou blocos em destaque$ sum_(i=1)^n i = (n(n+1))/2 $. - Modo Código (
#): Todo comando ou lógica em Typst começa com#. Bloco de código em múltiplas linhas utiliza#{ ... }.
3. Funções e Modularidade
- Templates Reutilizáveis: Exporte uma função principal de template que recebe parâmetros estruturados (título, autores, resumo, corpo) e aplica as regras de layout via
#show: doc => template(doc). - Parâmetros com Nome: Dê preferência a parâmetros nomeados com valores padrão razoáveis nas funções customizadas.
4. Tabelas, Figuras e Layout Idiomático
- Tabelas com
table: Utilize a nova API de tabela comtable.headere alinhamento explicito por coluna:#table( columns: (1fr, 2fr, 1fr), align: (left, left, center), stroke: 0.5pt + luma(150), table.header([*ID*], [*Descrição*], [*Status*]), [01], [Atualização de firmware], [OK], [02], [Verificação de integridade], [Pendente] ) - Quadros e Notificações (Callouts): Crie blocos visuais estilizados usando
blockcom bordas arredondadas e preenchimento sutil.
5. Gestão de Bibliografia e Pacotes
- Bibliografias Nativas: Use
#bibliography("works.bib", style: "ieee")para integração transparente com arquivos.bibou.yml(Hayagriva). - Pacotes do Typst Universe: Importe pacotes oficiais com a sintaxe
#import "@preview/pacote:versao".
🧰 Padrões de Código Recomendados
Template Profissional de Relatório / Artigo Técnico
// template.typst
#let project(
title: "",
authors: (),
abstract: none,
logo: none,
body
) = {
// Configuração global de página
set page(
paper: "a4",
margin: (x: 2.5cm, y: 3cm),
numbering: "1",
)
// Configuração de tipografia
set text(font: "DejaVu Serif", size: 11pt, lang: "pt", region: "BR")
set par(justify: true, leading: 0.65em)
set heading(numbering: "1.1")
// Personalização visual dos títulos
show heading: it => [
#v(0.5em)
#text(fill: rgb("#1a365d"), weight: "bold")[#it]
#v(0.3em)
]
// Cabeçalho / Capa resumida
align(center)[
#if logo != none {
image(logo, width: 25%)
v(1em)
}
#text(size: 20pt, weight: "bold", fill: rgb("#1a365d"))[#title]
#v(1em)
#grid(
columns: (1fr,) * calc.min(authors.len(), 3),
gutter: 1em,
..authors.map(author => align(center)[
#text(weight: "medium")[#author.name] \
#text(size: 9pt, fill: luma(100))[#author.email]
])
)
#v(1.5em)
]
// Resumo (se houver)
if abstract != none {
rect(
width: 100%,
fill: rgb("#f7fafc"),
inset: 12pt,
radius: 4pt,
stroke: 0.5pt + rgb("#e2e8f0")
)[
#text(weight: "bold", fill: rgb("#2d3748"))[Resumo] \
#v(0.3em)
#abstract
]
#v(1.5em)
}
// Corpo do Documento
body
}
Exemplo de Uso do Template com Blocos e Matemática
#import "template.typst": project
#show: doc => project(
title: "Análise de Desempenho de Algoritmos Distribuídos",
authors: (
(name: "Dandara Gabriel", email: "dandara@example.com"),
(name: "Alex Silva", email: "alex@example.com")
),
abstract: [
Este documento apresenta uma avaliação comparativa de throughput e latência entre arquiteturas de mensageria assíncrona operando sob alta carga.
],
doc
)
= Introdução
A escalabilidade de sistemas distribuídos modernos depende diretamente do padrão de comunicação adotado entre os nós receptores e emissores.
#let callout(title: "Nota", body, color: blue) = {
block(
fill: color.lighten(90%),
stroke: (left: 4pt + color),
inset: 10pt,
radius: (right: 4pt),
width: 100%,
[
#text(weight: "bold", fill: color.darken(20%))[#title] \
#body
]
)
}
#callout(title: "Importante", color: rgb("#2b6cb0"))[
Certifique-se de que os nós do cluster estejam sincronizados via protocolo NTP antes de iniciar os testes de carga.
]
= Formulacão Matemática
O tempo médio de resposta $T(n)$ para um sistema de fila com $n$ requisições concorrentes é modelado pela equação:
$ T(n) = sum_(k=1)^n (lambda_k / (mu_k - lambda_k)) + float("overhead") $
Onde $lambda_k$ representa a taxa de chegada e $mu_k$ a taxa de serviço do canal $k$.
= Resultados Experimentais
#figure(
table(
columns: (1fr, 1.5fr, 1fr),
align: (center, left, right),
stroke: 0.5pt + luma(180),
table.header([*Métrica*], [*Algoritmo*], [*Valor Médio*]),
[Throughput], [Event-Driven Reactive], [45.200 req/s],
[Latência p99], [Event-Driven Reactive], [1.2 ms],
[Throughput], [Blocking I/O Standard], [12.800 req/s],
),
caption: [Comparativo de Desempenho entre Arquiteturas]
)
🔒 Questões de Segurança e Práticas Seguras
- Sandbox Escaping: Configure o compilador do Typst no modo restrito (sandbox ativo) para prevenir operações arbitrárias de leitura de arquivos locais ou caminhos de rede não autorizados.
- Negação de Serviço (DoS): Otimize laços, funções recursivas e regras de formatação dinâmica para evitar que scripts maliciosos induzam recursão infinita e consumam toda a CPU do servidor.