Communitygithub.com

scribus-sla

実際の Scribus エンジンで .sla ファイルを作成、編集、エクスポートします。デスクトップアプリと同一の出力(PDF、入力可能なPDF、PDF/X、PNG/JPG、SVG、EPS、PS)を実現します。.sla ファイルや Scribus 関連のあらゆるタスクに使用できます。

scribus-sla とは?

scribus-sla は、実際の Scribus デスクトップアプリケーション(デフォルト 1.6.3)をインストールし、そのエンジンを使って .sla 文書を作成、編集、エクスポートするためのAIエージェントスキルです。手動でのレンダリングや .sla ファイルの直接記述は不要で、`sla` コマンドラインツールを通じて操作します。このエンジンで生成された出力は、Scribus 1.6.3 デスクトップアプリからのPDF出力とピクセル単位で一致することが確認されています。対応するエクスポート形式はPDF、入力可能なPDF、PDF/X、PNG、JPG、SVG、EPS、PSです。テンプレートへのデータ埋め込み(プレースホルダー、テキスト、画像の置換)や、Pythonスクリプトによる新規文書作成、既存文書の編集も可能です。フォントや画像の欠落を検出し、それを修正するまでエクスポートを拒否するため、デスクトップアプリと完全に同一の出力が保証されます。このスキルはClaude Code, Cursor, CodexなどのAIエージェントプラットフォームで使用できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Scribus .sla ファイル、本物のScribusで動作

Scribus文書を手動でレンダリングしたり近似したりせず、.sla全体を手書きすることもありません。 このスキルは、実際のScribus(デフォルト1.6.3)とその周りの小さなslaコマンドをインストールします。 この方法でエクスポートしたものは、Scribus 1.6.3デスクトップアプリからエクスポートしたPDFと比較して確認済みです: 11の文書(プレーン、画像入り、入力可能なフォーム)がピクセル単位で一致しました。

1. インストール(セッションごとに1回、初回は2〜4分)

[ -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
  • 別のScribusバージョン:bash /opt/sla/kit/scripts/setup.sh 1.6.5(1.6.1、nativeも可)。 ユーザーが実行しているバージョンに合わせてください。エンジンによって保存されたファイルにはそのエンジンのバージョンが記録されます。
  • root権限、apt、およびgithub.comとarchive.ubuntu.comへのネットワークアクセスが必要です。最後に [sla-setup] ready: で始まる行が表示されます。別のバージョンにフォールバックしたと警告が出た場合は、ユーザーに伝えてください。
  • エンジンは /home、/tmp、/mnt、/root 以下のファイルのみ参照できます。そこで作業してください。

2. コマンド

sla inspect FILE.sla -v            # ページ、フォント(インストール済み?)、画像(見つかった?)、名前付きアイテム、{{プレースホルダー}}、フォームフィールド
sla export FILE.sla                # .slaの隣にPDFを出力、文書自身の保存されたPDF設定を使用
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(x1a, x3, x4; --cmyk; --profile)
sla fill TEMPLATE.sla OUT.sla --set name=Value --text frame_name="新しいテキスト" --image frame_name=new.png
sla resave IN.sla OUT.sla          # Scribusで開いて保存:ファイルがロードできることを確認、正規化する
sla run SCRIPT.py [args]           # Scribus Python(スクリプター)スクリプトを実行;これで新しい文書を作成する
sla compare A.pdf B.pdf --out DIR  # ピクセル比較、両方に同じレンダラーとDPIを使用;差分画像を書き込む
sla fonts --grep sans              # Scribusが綴る通りの正確なフォント名
sla fonts --add FILE_OR_DIR        # ユーザーのフォントファイルをインストール
sla fonts --google "Comic Relief"  # Google Fontsからのオープンライセンスファミリー

sla <command> -h ですべてのオプションを表示します。

3. デスクトップアプリと同一の出力を保証するルール

  1. フォントまたは画像が欠けているとエクスポートが停止します。 Scribusは欠けたフォントを静かに代替し、レイアウトがずれます。sla export は拒否し、何が欠けているかを表示します。フォントをインストールするか(sla fonts --add/--google)、画像パスを修正してください。ユーザーが承諾した場合のみ --allow-missing を渡します。 フォント名は完全に一致する必要があります。例:Latin Modern Sans 10 Bold、DejaVu Sans Book。
  2. 画像リンクは .sla ファイルからの相対パスです。 文書とそのアセットをユーザーのコンピューター上と同じ相対レイアウトに保つか、フレームが空でエクスポートされます。
  3. エクスポートは文書の保存されたPDF設定を使用します(圧縮、PDFバージョン、フォント)。リクエストがあった場合のみ上書きします:--lossless、--outline-fonts、--pdf-version、--pdf-option KEY=VALUE。
  4. 入力可能なPDFはそのまま機能します。 フォームフィールドがある文書の場合、ツールはデスクトップのエクスポートダイアログと同様にフィールドフォントを完全に埋め込みます。(プレーンなスクリプトによるエクスポートはこれでクラッシュします。アウトラインフォントで回避しないでください。)
  5. 結果を確認してください。 作成/入力/編集後:sla export FILE.sla -f png --dpi 72 -d /tmp/preview でPNGを表示します。基準PDFが存在する場合は、sla compare を実行して MATCH が 0.0000% で表示されることを確認します。
  6. 形式に関する注意。 PNG/JPGはScribus自身の「画像として保存」から生成されます(--raster-via pdf を使用してPDFをラスタライズすることも可能。サイズが1ピクセル異なる場合があります)。SVGとPSはエクスポートされたPDFから変換されます(SVGではテキストがアウトラインになります)。EPSはScribus独自のもので、ページごとに1ファイルです。

4. テンプレートへのデータ埋め込み

  • テンプレートテキストに {{name}} を配置します。--set name=value ですべての出現箇所を置き換えます。プレースホルダーは1つの書式設定ラン内に収める必要があります(一度に入力し、同じフォントとサイズで一貫させる)。
  • --text ITEM=value は、ITEMという名前のフレーム全体のテキストを置き換え、最初のランの書式を保持します。\n は新しい段落を開始します。名前は sla inspect -v で表示されるアイテム名です(Scribus:プロパティ > 名前)。
  • --image ITEM_OR_OLD_FILENAME=new.png は画像を再リンクし、フレームに合わせてフィットします。--keep-image-scale を追加すると、古いスケールを維持します。
  • --data file.json は {"placeholders": {}, "text": {}, "images": {}} を受け取ります。--strict を指定すると、一致するキーがない場合に失敗します。
  • 結果はScribusによって再保存されるため、本物のScribusファイルになります。

5. 新しい文書の作成

スクリプタースクリプトを作成し、sla run で実行します。完全なテスト済みの例が /opt/sla/kit/examples/new_document.py にインストールされています(ページ設定、色、スタイル、テキスト、図形、線、画像、保存)。それをコピーして適応させてください。必須事項:

  • スクリプトを try: ... finally: os._exit(0) でラップしないと、Scribusが終了しません。
  • 最初に色とスタイルを定義し、すべてのオブジェクトに名前を付けます(createText(x, y, w, h, "name"))。
  • setText では \r が段落を区切ります。単位は newDocument に与えられたものに依存します(ポイントを使用してください)。
  • setScaleImageToFrame(True, True, name) は画像をフレームに合わせてフィットし、比率を保持します。
  • saveDocAs(path) で保存し、その後 sla inspect とプレビューを行います(ルール5)。
  • 既存のハウススタイルに合わせるには、最初にユーザーの文書の1つで sla inspect -v を実行し、そのページサイズ、フォント、色、線の太さを再利用します。

6. 既存の文書の編集

スクリプタースクリプト(openDoc、オブジェクトを名前で変更、saveDocAs)を推奨します。XMLでの小さな属性編集は問題ありません。その後 sla resave を実行し、プレビューしてください。便利なXMLの事実(Scribus 1.6):

  • ルート SCRIBUSUTF8NEW、1つの DOCUMENT。オブジェクトは PAGEOBJECT(ページ)、MASTEROBJECT(マスターページ)、FRAMEOBJECT(インライン)。PTYPE:2 画像、4 テキスト、5 線、6 シェイプ、7 ポリライン、12 グループ。
  • ページは1つのキャンバス上に積み重ねられています。オブジェクトの XPOS/YPOS にはそのページの PAGEXPOS/PAGEYPOS が含まれます。
  • テキストは StoryText 内にあります:ITEXT CH="..." のラン、para、trail。フォントは FONT="..." 属性で指定されます。
  • 画像:PFILE(.sla からの相対パス)。SCALETYPE="0" はフレームにフィット(Scribusはロード時にスケールを再計算)、SCALETYPE="1" は LOCALSCX/LOCALSCY/LOCALX/LOCALY を使用した自由スケーリング。RATIO="1" は比率を保持します。
  • テキストフレームの path/copath はその形状を保持します。WIDTH/HEIGHT と一緒に変更するか(またはスクリプタースクリプトで sizeObject を使用すると自動的に行われます)。
  • フォームフィールド:ANNOTATION="1" を持つテキストフレーム、ANTYPE 3 テキスト、4 チェックボックス、5 コンボ、6 リスト。
  • 特に要求がない限り、ユーザーの元のファイルを上書き保存しないでください。新しいファイルに書き込んでください。

7. 何かが失敗した場合

  • 「Scribus が終了しました... クラッシュしました」:sla inspect を実行し、欠けたフォント/画像を修正し、sla resave を試してファイルがロードできるか確認し、その後ページごとにエクスポート(--pages N)して問題のオブジェクトを見つけてください。
  • エンジンのビルドに失敗した場合:bash /opt/sla/kit/scripts/setup.sh native でディストリビューションのScribusを代わりにインストールします(テストではエクスポートも参照と一致しました。保存されたファイルにはそのバージョンが記録されます)。
  • ユーザーの文書に必要なフォントでオープンライセンスでないもの(例:Arial、Calibri):ユーザーにフォントファイルを依頼してください。

関連スキル