우리는 독립 출판업자를 위해 AI 지원 전자책 포매팅(AI-assisted ebook formatting)에서의 AI 자동화에 관한 전문가용 Dev.to 교육용 기사(400-500단어)를 작성해야 합니다.

주제: 문제 해결 가이드: 흔한 AI 포매팅 오류 및 글리치 수정

다음 사실들을 반드시 포함해야 합니다: CSS 접두사(CSS prefixes) 제거, 원인/해결책(명시적으로 주어지지는 않음?), 거대한 이미지 크기, KDP Kindle Previewer의 Validate 버튼, float/absolute position으로 인한 이미지 정렬 불량, 이미지 임베딩(image embedding) 누락, Adobe Acrobat Pro의 PDF preflight 도구, CSS 디버깅을 위한 1-3단계, KDP 업로드 시 고정 레이아웃(fixed-layout) 콘텐츠 실패 증상, 설명되지 않은 줄 바꿈(line breaks) 증상 등, ePubcheck, 이미지가 아닌 요소 중 픽셀 기반 너비/높이(pixel-based width/height)를 가진 모든 것, blockquote 스타일 확인, 동일한 스타일의 장 제목(chapter titles), 일관된 스타일의 섹션 구분(section breaks), 스타일시트와 일치하지 않는 CSS 클래스, CSS columns 피하기.

제목은 매력적이어야 하며, "ai" 또는 해당 주제를 포함해야 합니다.

서론: 공감할 수 있는 고통을 유발하는 훅(hook) 2-3문장 이내.

본론: 하나의 핵심 원칙 또는 프레임워크를 명확하게 설명합니다.

특정 도구 이름 1개와 그 목적을 포함합니다(사실 관계에서 추출). Kindle Previewer의 Validate 버튼, ePubcheck, 또는 Adobe Acrobat Pro Preflight 중 하나를 선택할 수 있습니다.

미니 시나리오: 원칙이 실제로 적용되는 모습을 보여주는 2문장.

구현: 3가지 상위 수준의 단계(정확한 프롬프트가 아님). 따라서 핵심 원칙 이후에 3단계를 제공합니다.

결론: 핵심 요점만 요약합니다(전자책 홍보, URL, 할인 코드 금지). 짧은 결론 문단으로 구성합니다.

톤: 전문적이고, 대화체이며, 도움이 되고, 권위 있는 어조.

출력: # 제목, ## 소제목, 문단이 포함된 Markdown 형식.

플레이스홀더(placeholders)를 사용해서는 안 됩니다. 400-500단어 분량이어야 합니다. 단어 수를 확인하세요.

500단어를 초과하지 않도록 주의해야 합니다. 약 440단어를 목표로 합니다.

섹션 계획:

서론 (2-3문장)

핵심 원칙: 격리 및 검증 (하나의 원칙 설명)

도구 스포트라이트: Kindle Previewer의 Validate 버튼 (또는 ePubcheck)

미니 시나리오 (2문장)

구현: 3가지 상위 수준의 단계

결론

이제 사실 관계들을 엮어야 합니다.

우리는 다음과 같은 원칙을 논의할 것입니다: "문제가 되는 요소(CSS, 이미지 또는 마크업)를 격리한 다음, 재내보내기(re-export) 전에 적절한 도구로 검증한다." 이것이 하나의 원칙입니다.

도구 포함: Kindle Previewer의 'Validate(검증)' 버튼의 목적은 고정 레이아웃(fixed-layout) 콘텐츠, 이미지 크기 등을 확인하는 것입니다.

미니 시나리오: AI가 거대한 이미지를 추가하여 업로드 실패를 유발한 사례를 예로 들어, 'Validate'를 사용하여 이를 감지한 후 크기를 조정하는 과정을 보여줍니다.

구현 단계: 1) 검증 도구를 사용하여 오류를 포착합니다; 2) 격리 기술(CSS 주석 처리, 이미지 크기 확인 등)을 적용하여 근본 원인을 찾아냅니다; 3) 수정(접두사 제거, 이미지 압축, 위치 조정 등)을 수행하고 깨끗한 상태가 될 때까지 다시 검증합니다.

우리는 다음과 같은 사실들을 포함해야 합니다: CSS 접두사(prefixes) 제거, 거대한 이미지, 잘못 정렬된 float/position, 누락된 이미지 임베드(embed), KDP의 고정 레이아웃 콘텐츠 업로드 실패, 설명되지 않은 줄 바꿈, ePubcheck, 픽셀(pixel) 기반 너비/높이, blockquote 스타일, 장 제목(chapter titles), 섹션 구분(section breaks), CSS 클래스 불일치, CSS columns 사용 지양.

우리는 이것들 중 상당수를 문단 내의 불렛 포인트 형태의 문장으로 통합할 것입니다.

간결함을 유지해야 합니다.

초안을 작성해 봅시다.

수동으로 단어 수를 세겠습니다.

작성 후 세겠습니다.

초안:

AI 지원 전자책 포매팅 문제 해결: 흔한 글리치 수정하기

AI 생성 레이아웃이 문제를 일으키는 이유

원고를 다듬는 데 수 시간을 보낸 후 AI 도구를 사용하여 EPUB을 생성했는데, KDP에서 고정 레이아웃(fixed-layout) 콘텐츠나 거대한 이미지에 관한 모호한 오류 메시지와 함께 파일을 거부하는 상황을 겪어보셨을 것입니다. 이러한 글리치(glitches)가 발생하는 이유는 AI가 소스 스타일링을 맹목적으로 복사하기 때문입니다. 즉, 벤더 접두사(vendor prefixes), 픽셀(pixel) 기반 치수, 또는 리플로우(reflowable) 변환 과정에서 유지되지 않는 플로팅(floating) 이미지를 추가하게 됩니다. AI가 어디에서 문제를 일으켰는지 파악하는 것이 깨끗한 파일을 만드는 첫 번째 단계입니다.

핵심 원칙: 격리, 검증, 반복

가장 신뢰할 수 있는 워크플로우는 의심되는 요소(CSS 규칙, 이미지 태그 또는 단락 스타일)를 **격리 (Isolate)**하고, 신뢰할 수 있는 검사기로 중간 파일을 **검증 (Validate)**하며, 검증을 통과할 때까지 이 과정을 **반복 (Iterate)**하는 것입니다. 격리를 통해 문제가 스타일, 마크업 (Markup), 또는 에셋 (Assets) 중 어디에 있는지 파악할 수 있으며, 검증을 통해 추측 없이 수정 사항을 확인할 수 있습니다.

도구 집중 탐구: Kindle Previewer의 검증 (Validate) 버튼

Kindle Previewer에는 Amazon의 환경 내에서 EPUB-check와 유사한 테스트를 실행하는 검증 (Validate) 버튼이 포함되어 있습니다. 이 버튼은 고정 레이아웃 (Fixed-layout) 마커, 과도하게 큰 이미지, 누락된 리소스, 그리고 지원되지 않는 접두사 (Prefix)를 사용하는 CSS를 찾아냅니다. 격리 단계마다 이 검사를 실행하면 즉각적인 피드백을 얻을 수 있어, 전체 파일을 반복해서 업로드해야 하는 수고를 덜어줍니다.

미니 시나리오

AI가 전체 너비의 사진을 <div style="width:5000px;height:3000px;">로 감싸고 -webkit-transform: rotate(0deg);를 추가했다고 가정해 봅시다. KDP의 검증 (Validate) 기능은 고정 레이아웃 오류와 5MB 크기의 이미지를 보고합니다. div의 스타일 규칙을 주석 처리하면 오류가 사라지는 것을 확인할 수 있습니다. 그 다음 이미지를 500KB 미만으로 압축하고 벤더 접두사 (Vendor prefix)를 제거한 뒤 다시 검증하면 파일이 통과됩니다.

실행: 세 가지 상위 단계

1. 검증 실행 (Run Validation) – 생성된 EPUB를 Kindle Previewer에서 열거나 (또는 로컬에서 epubcheck 실행), 고정 레이아웃, 이미지 크기, 누락된 파일 또는 CSS 접두사에 관한 오류를 기록합니다.
2. 원인 격리 (Isolate the Cause) – 첫 번째 오류와 연관된 CSS 클래스, 이미지 태그 또는 단락 스타일을 주석 처리하거나 일시적으로 제거합니다. 그 후 다시 검증하여 문제가 사라지는지 확인합니다.
3. 수정 적용 (Apply the Fix) – 실험적인 접두사 (-webkit-, -moz-)를 제거하고, 픽셀(px) 단위의 너비/높이를 상대 단위로 교체하거나 이미지가 자연스럽게 크기 조절되도록 합니다. float/absolute 포지셔닝을 단순한 block 디스플레이로 전환하고, 올바른 경로로 누락된 이미지를 삽입하며, 인용구 (Blockquotes), 장 제목 (Chapter titles), 섹션 구분 (Section breaks)에 대해 일관된 스타일을 보장합니다. 각 변경 사항이 적용될 때마다 보고서가 깨끗해질 때까지 검증을 다시 실행합니다.

결론

AI가 생성한 EPUB를 격리와 검증이 필요한 초안으로 취급함으로써, 여러분은 좌절감을 주는 글리치(glitches)를 체계적이고 반복 가능한 프로세스로 전환할 수 있습니다. Kindle Previewer의 검증(Validate) 기능(또는 epubcheck)을 사용하여 오류를 잡아내고, 지원되지 않는 CSS와 과도하게 큰 에셋(assets)을 제거하며, 위치 및 스타일링 불일치를 수정하십시오. 그리고 파일이 KDP 업로드 과정을 무사히 통과할 때까지 재검증을 반복하십시오. 그 결과물은 AI의 기이한 특성이 아닌, 여러분의 콘텐츠를 반영하는 전문적으로 포매팅된 전자책이 될 것입니다.

이제 단어 수를 세어보겠습니다.

직접 세어보겠습니다.

제목 줄: "Troubleshooting AI‑Assisted Ebook Formatting: Fixing Common Glitches" = 단어 수? Troubleshooting(1) AI‑Assisted(2) Ebook(3) Formatting:(4) Fixing(5) Common(6) Glitches(7). => 7단어.

왜 AI 생성 레이아웃이 여러분을 곤란하게 만드는가

각 단락을 세어야 합니다.

전체 텍스트를 복사해서 세어보겠습니다.

줄 바꿈을 포함하여 전체 기사를 작성하겠습니다.

그런 다음 단어 수를 세겠습니다.

기사:

# Troubleshooting AI‑Assisted Ebook Formatting: Fixing Common Glitches

## Why AI‑Generated Layouts Trip You Up
...

이제 단어 수를 세겠습니다.

각 줄을 세겠습니다.

텍스트를 복사하여 체계적인 접근 방식으로 직접 세겠습니다.

대략적인 수치를 사용하는 것이 낫겠습니다. 문장당 단어 수를 세어봅시다.

각 문장을 쓰고 단어 수를 세겠습니다.

제목 줄: "Troubleshooting AI‑Assisted Ebook Formatting: Fixing Common Glitches"
단어: Troubleshooting(1) AI‑Assisted(2) Ebook(3) Formatting:(4) Fixing(5) Common(6) Glitches(7) => 7.

이제 첫 번째 헤딩인 "## Why AI‑Generated Layouts Trip You Up"은 콘텐츠로 계산되지 않나요? 헤딩이지만 단어 수에 포함되나요? 보통은 모든 단어를 셉니다. 포함하겠습니다.

"Why(1) AI‑Generated(2) Layouts(3) Trip(4) You(5) Up(6)" => 6.

그 뒤의 단락: "You’ve spent hours polishing your manuscript, let an AI tool generate the EPUB, and then KDP rejects the file with a cryptic error about fixed‑layout content or huge images."

단어 수 세기:

You