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. 데스크톱 앱과 동일한 출력을 유지하는 규칙
- 글꼴이나 이미지가 없으면 내보내기가 중지됩니다. 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는 바로 작동합니다. 양식 필드가 있는 문서의 경우, 데스크톱 내보내기 대화상자와 동일하게 필드 글꼴이 완전히 포함됩니다. (일반 스크립트 내보내기는 이러한 문서에서 충돌이 발생합니다. 글꼴 외곽선 처리(outlined fonts)로 해결하지 마십시오.)
- 결과물을 확인하십시오. 생성/채우기/편집 후:
sla export FILE.sla -f png --dpi 72 -d /tmp/preview명령으로 PNG를 확인하십시오. 참조 PDF가 있는 경우sla compare를 실행하고 0.0000%에서MATCH가 예상됩니다. - 형식 참고사항. 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",ANTYPE3 텍스트, 4 체크박스, 5 콤보, 6 목록인 텍스트 프레임. - 사용자의 원본 파일을 덮어쓰지 마십시오. 요청이 없는 한 새 파일을 작성하십시오.
7. 문제 발생 시
- "Scribus exited ... crashed":
sla inspect를 실행하고, 누락된 글꼴/이미지를 수정한 후,sla resave를 시도하여 파일이 로드되는지 확인한 다음, 페이지별로(--pages N) 내보내어 문제가 있는 객체를 찾으십시오. - 엔진 빌드 실패:
bash /opt/sla/kit/scripts/setup.sh native를 실행하면 배포판의 Scribus가 대신 설치됩니다 (테스트에서 이 내보내기도 참조와 일치했습니다; 저장된 파일에는 해당 버전이 기록됩니다). - 사용자 문서에 필요한 글꼴이 오픈 라이선스가 아닌 경우 (예: Arial, Calibri): 사용자에게 글꼴 파일을 요청하십시오.