Communitygithub.com

scribus-sla

실제 Scribus 엔진을 사용하여 Scribus .sla 파일을 생성, 채우기, 편집 및 내보냅니다. 출력물이 데스크톱 앱과 일치합니다 (PDF, 채울 수 있는 PDF, PDF/X, PNG/JPG, SVG, EPS, PS). 모든 .sla 또는 Scribus 작업에 사용합니다.

scribus-sla란 무엇인가요?

이 스킬은 실제 Scribus 1.6.3 엔진을 설치하고, 파일 조작을 위한 `sla` 명령어를 제공합니다. `.sla` 파일을 직접 생성하지 않아도 되며, PDF, 이미지, SVG 등으로 정확하게 내보낼 수 있습니다. 주요 기능으로는 `.sla` 파일 검사(`sla inspect`), 내보내기(`sla export`, 다양한 포맷과 인쇄 옵션 지원), 템플릿 채우기(`sla fill`, 플레이스홀더, 텍스트, 이미지 교체), 새 문서 생성(Scribus Python 스크립트 실행), 기존 문서 편집, 두 PDF 비교 등이 있습니다. 이 스킬은 데스크톱 Scribus와 동일한 출력을 보장하기 위해 엄격한 규칙을 따릅니다. 예를 들어 누락된 글꼴이나 이미지가 있으면 내보내기를 거부하고, 이미지 경로가 `.sla` 파일 기준으로 상대적이어야 합니다. 또한 새 문서나 편집 후에는 항상 미리보기(PNG)를 확인하여 품질을 검증하는 과정이 권장됩니다. 이 스킬은 **Claude Code, Cursor, Codex** 등 AI 에이전트 환경에서 사용할 수 있으며, `apt`, `git`, 네트워크 접근이 필요합니다.

지원 대상~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. 설치 (세션당 한 번, 처음에는 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). 사용자가 실행하는 버전과 일치시킵니다. 엔진에 의해 저장된 파일에는 엔진 버전이 기록됩니다.
  • 루트 권한, apt, github.com 및 archive.ubuntu.com에 대한 네트워크 접근이 필요합니다. [sla-setup] ready:로 시작하는 줄로 완료됩니다. 다른 버전으로 폴백(fallback)되었다는 경고가 표시되면 사용자에게 알리십시오.
  • 엔진은 /home, /tmp, /mnt, /root 아래의 파일만 볼 수 있습니다. 해당 디렉토리에서 작업하십시오.

2. 명령어

sla inspect FILE.sla -v            # 페이지, 글꼴(설치 여부), 이미지(찾을 수 있는지), 이름 있는 항목, {{placeholders}}, 양식 필드
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에서 열고 저장: 파일이 로드됨을 증명하고 정규화(normalize)
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 <명령어> -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는 바로 작동합니다. 양식 필드가 있는 문서의 경우, 데스크톱 내보내기 대화상자와 동일하게 필드 글꼴이 완전히 포함됩니다. (일반 스크립트 내보내기는 이러한 문서에서 충돌이 발생합니다. 글꼴 외곽선 처리(outlined fonts)로 해결하지 마십시오.)
  5. 결과물을 확인하십시오. 생성/채우기/편집 후: sla export FILE.sla -f png --dpi 72 -d /tmp/preview 명령으로 PNG를 확인하십시오. 참조 PDF가 있는 경우 sla compare를 실행하고 0.0000%에서 MATCH가 예상됩니다.
  6. 형식 참고사항. PNG/JPG는 Scribus 자체의 "Save as Image" 기능을 사용합니다 (--raster-via pdf를 사용하면 대신 PDF를 래스터화하며, 크기가 1픽셀 차이날 수 있습니다). SVG와 PS는 내보낸 PDF에서 변환됩니다 (SVG에서는 텍스트가 외곽선으로 변환). EPS는 Scribus 자체 형식이며, 페이지당 하나의 파일입니다.

4. 템플릿 채우기

  • 템플릿 텍스트에 {{name}}을 넣고; --set name=value를 사용하여 해당 위치를 모두 바꿉니다. 플레이스홀더는 하나의 서식 실행(range) 안에 있어야 합니다 (한 번에 입력하고 동일한 글꼴과 크기 유지).
  • --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")).
  • \r은 setText에서 단락을 구분합니다. 단위는 newDocument에 지정된 것을 사용합니다 (포인트 사용).
  • setScaleImageToFrame(True, True, name)은 그림을 프레임에 맞추고 비율을 유지합니다.
  • saveDocAs(path)로 저장한 후, sla inspect와 미리보기(규칙 5)를 수행합니다.
  • 기존 하우스 스타일을 맞추려면 사용자의 문서 중 하나에서 sla inspect -v를 먼저 실행하여 페이지 크기, 글꼴, 색상 및 선 두께를 재사용하십시오.

6. 기존 문서 편집

스크립터 스크립트를 선호합니다 (openDoc, 이름으로 객체 변경, saveDocAs). XML에서 작은 속성 편집도 괜찮습니다. 편집 후 sla resave를 실행하고 미리보기를 수행하십시오. 유용한 XML 정보 (Scribus 1.6):

  • 루트 SCRIBUSUTF8NEW, 하나의 DOCUMENT. 객체는 PAGEOBJECT (페이지), MASTEROBJECT (마스터 페이지), FRAMEOBJECT (인라인). PTYPE: 2 이미지, 4 텍스트, 5 선, 6 도형, 7 폴리라인, 12 그룹.
  • 페이지는 하나의 캔버스에 쌓입니다: 객체의 XPOS/YPOS는 해당 페이지의 PAGEXPOS/PAGEYPOS를 포함합니다.
  • 텍스트는 StoryText에 있습니다: ITEXT CH="..." 실행(runs), 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 exited ... crashed": sla inspect를 실행하고, 누락된 글꼴/이미지를 수정한 후, sla resave를 시도하여 파일이 로드되는지 확인한 다음, 페이지별로(--pages N) 내보내어 문제가 있는 객체를 찾으십시오.
  • 엔진 빌드 실패: bash /opt/sla/kit/scripts/setup.sh native를 실행하면 배포판의 Scribus가 대신 설치됩니다 (테스트에서 이 내보내기도 참조와 일치했습니다; 저장된 파일에는 해당 버전이 기록됩니다).
  • 사용자 문서에 필요한 글꼴이 오픈 라이선스가 아닌 경우 (예: Arial, Calibri): 사용자에게 글꼴 파일을 요청하십시오.

관련 스킬