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ém1.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,
apte acesso de rede agithub.comearchive.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
- Fontes ou imagens ausentes interrompem a exportação. O Scribus substitui uma fonte ausente silenciosamente e o
layout se desloca.
sla exportrecusa e informa o que está faltando. Instale a fonte (sla fonts --add/--google) ou corrija o caminho da imagem. Só passe--allow-missingse o usuário aceitar. Os nomes das fontes devem corresponder exatamente, por exemploLatin Modern Sans 10 Bold,DejaVu Sans Book. - 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. - 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. - 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.)
- Veja o resultado. Após qualquer criação/preenchimento/edição:
sla export FILE.sla -f png --dpi 72 -d /tmp/previewe visualize o PNG. Quando existir um PDF de referência, executesla comparee espereMATCHcom 0.0000%. - Notas de formato. PNG/JPG vêm da opção "Salvar como imagem" do próprio Scribus (use
--raster-via pdfpara 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=valorsubstitui 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=valorsubstitui todo o texto do quadro chamado ITEM, mantendo a formatação da sua primeira execução;\ninicia um novo parágrafo. Nomes são os nomes dos itens mostrados porsla inspect -v(Scribus: Propriedades > Nome).--image ITEM_OU_NOME_DO_ARQUIVO_ANTIGO=nova.pngreliga uma imagem e a ajusta ao seu quadro. Adicione--keep-image-scalepara manter a escala antiga.--data arquivo.jsonrecebe{"placeholders": {}, "text": {}, "images": {}}.--strictfalha 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")). \rsepara parágrafos emsetText. Unidades são as que foram passadas paranewDocument(use pontos).setScaleImageToFrame(True, True, nome)ajusta uma imagem ao seu quadro, mantendo as proporções.- Salve com
saveDocAs(caminho), depoissla inspecte visualize (regra 5). - Para corresponder a um estilo existente, execute
sla inspect -vem 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, umDOCUMENT. Objetos sãoPAGEOBJECT(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/YPOSde um objeto inclui oPAGEXPOS/PAGEYPOSda página. - Texto fica em
StoryText: execuçõesITEXT CH="...",para,trail. Fontes são atributosFONT="...". - Imagens:
PFILE(caminho relativo ao .sla).SCALETYPE="0"ajuste ao quadro (Scribus recalcula a escala ao carregar),SCALETYPE="1"escala livre usandoLOCALSCX/LOCALSCY/LOCALX/LOCALY;RATIO="1"mantém proporções. - O
path/copathde um quadro de texto contêm sua forma: altere-os junto comWIDTH/HEIGHT(ou redimensione em um script scripter comsizeObject, que faz isso por você). - Campos de formulário: um quadro de texto com
ANNOTATION="1",ANTYPE3 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, tentesla resavepara 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 nativeinstala 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.