Communitygithub.com

scribus-sla

Crie, preencha, edite e exporte arquivos .sla do Scribus com o motor real do Scribus, garantindo que a saída corresponda ao aplicativo desktop (PDF, PDF preenchível, PDF/X, PNG/JPG, SVG, EPS, PS). Use para qualquer tarefa envolvendo .sla ou Scribus.

O que é scribus-sla?

A habilidade **scribus-sla** permite que agentes de IA manipulem arquivos .sla do Scribus usando o motor real do Scribus (padrão 1.6.3), em vez de tentar renderizar ou gerar manualmente o formato XML complexo. Isso garante que PDFs exportados — incluindo PDFs preenchíveis, PDF/X, PNG, JPG, SVG, EPS e PS — sejam pixel-perfect em relação ao aplicativo desktop, conforme verificado em 11 documentos de teste. A ferramenta instala o Scribus e um pequeno comando `sla` que oferece operações como inspeção de documentos (fontes, imagens, placeholders, campos de formulário), exportação com configurações de PDF salvas ou personalizadas, preenchimento de modelos via placeholders ou substituição direta de texto/imagem, criação de novos documentos via scripts Python do Scribus (scripter), edição de XML com validação automática e comparação pixel a pixel de PDFs. Ela segue regras rígidas para manter a fidelidade: fontes ou imagens ausentes interrompem a exportação, links de imagem devem ser relativos ao arquivo .sla, e a exportação usa as configurações de PDF salvas no documento, a menos que sejam solicitadas substituições. A habilidade também fornece dicas detalhadas de XML para edição direta e tratamento de falhas, como instalação de fontes ou fallback para o Scribus nativo da distribuição. Suporta qualquer plataforma Linux com apt e acesso à rede, e é ideal para automação de layout, preenchimento de formulários e geração de documentos prontos para impressão.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JessNco/scribus-sla/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Arquivos .sla do Scribus, feitos com o Scribus real

Nunca renderize manualmente ou aproxime um documento do Scribus, e nunca escreva um arquivo .sla inteiro manualmente. Esta habilidade instala o Scribus real (padrão 1.6.3) e um pequeno comando sla em torno dele. As exportações feitas desta forma foram verificadas contra PDFs exportados do aplicativo desktop Scribus 1.6.3: 11 documentos (simples, com imagens e formulários preenchíveis) corresponderam pixel por pixel.

1. Instalação (uma vez por sessão, 2-4 minutos na primeira vez)

[ -d /opt/sla/kit/.git ] || git clone --depth 1 https://github.com/JessNco/scribus-sla /opt/sla/kit
bash /opt/sla/kit/scripts/setup.sh
  • Outra versão do Scribus: bash /opt/sla/kit/scripts/setup.sh 1.6.5 (também 1.6.1, native). Corresponda à versão que o usuário executa; um arquivo salvo pelo motor carrega a versão do motor.
  • Precisa de root, apt e acesso de rede a github.com e archive.ubuntu.com. Termina com uma linha começando com [sla-setup] ready:. Se ele avisar que caiu para outra versão, avise o usuário.
  • O motor só pode ver arquivos em /home, /tmp, /mnt, /root. Trabalhe nesses diretórios.

2. Comandos

sla inspect FILE.sla -v            # páginas, fontes (instaladas?), imagens (encontradas?), itens nomeados, {{placeholders}}, campos de formulário
sla export FILE.sla                # PDF ao lado do .sla, usando as configurações de PDF salvas no próprio documento
sla export FILE.sla -f pdf,png,svg,eps,ps,jpg --dpi 300 -d OUTDIR --pages 1,3-5
sla export FILE.sla --pdf-version x4 --crop-marks --bleed 8.5      # PDF para impressão (x1a, x3, x4; --cmyk; --profile)
sla fill TEMPLATE.sla OUT.sla --set nome=Valor --text nome_do_quadro="Novo texto" --image nome_do_quadro=nova.png
sla resave IN.sla OUT.sla          # abre no Scribus e salva: prova que o arquivo carrega, normaliza-o
sla run SCRIPT.py [args]           # executa um script Python (scripter) do Scribus; é assim que novos documentos são criados
sla compare A.pdf B.pdf --out DIR  # comparação de pixels, mesmo renderizador e DPI para ambos; escreve imagens de diferença
sla fonts --grep sans              # nomes exatos das fontes como o Scribus as escreve
sla fonts --add FILE_OU_DIR        # instala os arquivos de fonte do usuário
sla fonts --google "Comic Relief"  # famílias de código aberto do Google Fonts

sla <comando> -h lista todas as opções.

3. Regras que mantêm a saída idêntica ao aplicativo desktop

  1. Fontes ou imagens ausentes interrompem a exportação. O Scribus substitui uma fonte ausente silenciosamente e o layout se desloca. sla export recusa e informa o que está faltando. Instale a fonte (sla fonts --add/--google) ou corrija o caminho da imagem. Só passe --allow-missing se o usuário aceitar. Os nomes das fontes devem corresponder exatamente, por exemplo Latin Modern Sans 10 Bold, DejaVu Sans Book.
  2. Links de imagem são relativos ao arquivo .sla. Mantenha um documento e seus ativos no mesmo layout relativo do computador do usuário, ou os quadros exportarão vazios.
  3. A exportação usa as configurações de PDF salvas no documento (compressão, versão do PDF, fontes). Substitua apenas sob solicitação: --lossless, --outline-fonts, --pdf-version, --pdf-option CHAVE=VALOR.
  4. PDFs preenchíveis funcionam sem problemas. Para documentos com campos de formulário, a ferramenta incorpora a fonte do campo por completo, como a caixa de diálogo de exportação do desktop faz. (A exportação simples por script trava nesses documentos; não contorne com fontes convertidas em contorno.)
  5. Veja o resultado. Após qualquer criação/preenchimento/edição: sla export FILE.sla -f png --dpi 72 -d /tmp/preview e visualize o PNG. Quando existir um PDF de referência, execute sla compare e espere MATCH com 0.0000%.
  6. Notas de formato. PNG/JPG vêm da opção "Salvar como imagem" do próprio Scribus (use --raster-via pdf para rasterizar o PDF; os tamanhos podem diferir em um pixel). SVG e PS são convertidos a partir do PDF exportado (o texto vira contorno no SVG). EPS é do próprio Scribus, um arquivo por página.

4. Preenchendo um modelo

  • Coloque {{nome}} no texto do modelo; --set nome=valor substitui em todos os lugares. Um placeholder deve estar em uma única execução de formatação (digite de uma vez, mesma fonte e tamanho do início ao fim).
  • --text ITEM=valor substitui todo o texto do quadro chamado ITEM, mantendo a formatação da sua primeira execução; \n inicia um novo parágrafo. Nomes são os nomes dos itens mostrados por sla inspect -v (Scribus: Propriedades > Nome).
  • --image ITEM_OU_NOME_DO_ARQUIVO_ANTIGO=nova.png religa uma imagem e a ajusta ao seu quadro. Adicione --keep-image-scale para manter a escala antiga.
  • --data arquivo.json recebe {"placeholders": {}, "text": {}, "images": {}}. --strict falha se uma chave não corresponder a nada.
  • O resultado é re-salvo pelo Scribus, portanto é um arquivo Scribus genuíno.

5. Criando um novo documento

Escreva um script scripter e execute-o com sla run. Um exemplo completo e testado está instalado em /opt/sla/kit/examples/new_document.py (configuração de página, cores, estilos, texto, formas, linhas, imagem, salvar). Copie e adapte. Essenciais:

  • Envolva o script em try: ... finally: os._exit(0) ou o Scribus nunca sai.
  • Defina cores e estilos primeiro; nomeie cada objeto (createText(x, y, w, h, "nome")).
  • \r separa parágrafos em setText. Unidades são as que foram passadas para newDocument (use pontos).
  • setScaleImageToFrame(True, True, nome) ajusta uma imagem ao seu quadro, mantendo as proporções.
  • Salve com saveDocAs(caminho), depois sla inspect e visualize (regra 5).
  • Para corresponder a um estilo existente, execute sla inspect -v em um dos documentos do usuário primeiro e reutilize seu tamanho de página, fontes, cores e espessuras de linha.

6. Editando um documento existente

Prefira um script scripter (openDoc, altere objetos por nome, saveDocAs). Pequenas edições de atributos no XML são aceitáveis; execute sla resave depois e visualize. Fatos úteis sobre XML (Scribus 1.6):

  • Raiz SCRIBUSUTF8NEW, um DOCUMENT. Objetos são PAGEOBJECT (páginas), MASTEROBJECT (páginas mestre), FRAMEOBJECT (em linha). PTYPE: 2 imagem, 4 texto, 5 linha, 6 forma, 7 polilinha, 12 grupo.
  • As páginas são empilhadas em uma tela: o XPOS/YPOS de um objeto inclui o PAGEXPOS/PAGEYPOS da página.
  • Texto fica em StoryText: execuções ITEXT CH="...", para, trail. Fontes são atributos FONT="...".
  • Imagens: PFILE (caminho relativo ao .sla). SCALETYPE="0" ajuste ao quadro (Scribus recalcula a escala ao carregar), SCALETYPE="1" escala livre usando LOCALSCX/LOCALSCY/LOCALX/LOCALY; RATIO="1" mantém proporções.
  • O path/copath de um quadro de texto contêm sua forma: altere-os junto com WIDTH/HEIGHT (ou redimensione em um script scripter com sizeObject, que faz isso por você).
  • Campos de formulário: um quadro de texto com ANNOTATION="1", ANTYPE 3 texto, 4 caixa de seleção, 5 combinação, 6 lista.
  • Não salve sobre o original do usuário; escreva um novo arquivo a menos que seja solicitado.

7. Se algo falhar

  • "O Scribus saiu... travou": execute sla inspect, corrija fontes/imagens ausentes, tente sla resave para ver se o arquivo carrega, depois exporte página por página (--pages N) para encontrar o objeto.
  • Falha na construção do motor: bash /opt/sla/kit/scripts/setup.sh native instala o Scribus da distribuição (as exportações também corresponderam às referências nos testes; os arquivos salvos carregam essa versão).
  • Fontes necessárias para o documento do usuário que não são de código aberto (ex.: Arial, Calibri): peça ao usuário os arquivos de fonte.

Habilidades Relacionadas