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. デスクトップアプリと同一の出力を保証するルール
- フォントまたは画像が欠けているとエクスポートが停止します。 Scribusは欠けたフォントを静かに代替し、レイアウトがずれます。
sla exportは拒否し、何が欠けているかを表示します。フォントをインストールするか(sla fonts --add/--google)、画像パスを修正してください。ユーザーが承諾した場合のみ--allow-missingを渡します。 フォント名は完全に一致する必要があります。例:Latin Modern Sans 10 Bold、DejaVu Sans Book。 - 画像リンクは
.slaファイルからの相対パスです。 文書とそのアセットをユーザーのコンピューター上と同じ相対レイアウトに保つか、フレームが空でエクスポートされます。 - エクスポートは文書の保存されたPDF設定を使用します(圧縮、PDFバージョン、フォント)。リクエストがあった場合のみ上書きします:
--lossless、--outline-fonts、--pdf-version、--pdf-option KEY=VALUE。 - 入力可能なPDFはそのまま機能します。 フォームフィールドがある文書の場合、ツールはデスクトップのエクスポートダイアログと同様にフィールドフォントを完全に埋め込みます。(プレーンなスクリプトによるエクスポートはこれでクラッシュします。アウトラインフォントで回避しないでください。)
- 結果を確認してください。 作成/入力/編集後:
sla export FILE.sla -f png --dpi 72 -d /tmp/previewでPNGを表示します。基準PDFが存在する場合は、sla compareを実行してMATCHが 0.0000% で表示されることを確認します。 - 形式に関する注意。 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"を持つテキストフレーム、ANTYPE3 テキスト、4 チェックボックス、5 コンボ、6 リスト。 - 特に要求がない限り、ユーザーの元のファイルを上書き保存しないでください。新しいファイルに書き込んでください。
7. 何かが失敗した場合
- 「Scribus が終了しました... クラッシュしました」:
sla inspectを実行し、欠けたフォント/画像を修正し、sla resaveを試してファイルがロードできるか確認し、その後ページごとにエクスポート(--pages N)して問題のオブジェクトを見つけてください。 - エンジンのビルドに失敗した場合:
bash /opt/sla/kit/scripts/setup.sh nativeでディストリビューションのScribusを代わりにインストールします(テストではエクスポートも参照と一致しました。保存されたファイルにはそのバージョンが記録されます)。 - ユーザーの文書に必要なフォントでオープンライセンスでないもの(例:Arial、Calibri):ユーザーにフォントファイルを依頼してください。