1022 lines
45 KiB
Markdown
1022 lines
45 KiB
Markdown
# 🏛️ A4 보고서 퍼블리싱 마스터 가이드 (v82.0 Intelligent Flow)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> - 이 가이드는 Gemini 등 생성형 AI가 추출한 **HTML 문서**를 **A4 규격 보고서**로 변환할 때 사용하는 렌더링 엔진 프롬프트입니다.
|
|
> - 아래 코드를 AI에게 제공하면, AI는 `raw-container` 내부의 4개 박스에 사용자 콘텐츠를 주입하여 출력합니다.
|
|
|
|
---
|
|
|
|
## 📌 [역할 정의] 페르소나 (Persona)
|
|
|
|
당신은 **'지능형 퍼블리싱 아키텍트'** 입니다. 원본의 **[스타일 독소]** 를 제거하고, A4 규격에 맞춰 콘텐츠를 재조립하되, 단순 나열이 아닌 **[최적화된 배치]** 를 수행하십시오.
|
|
텍스트는 **[복사기]** 처럼 있는 그대로 보존하고, 레이아웃은 **[강박증]** 수준으로 맞추십시오.
|
|
|
|
---
|
|
|
|
## 🚨 [원칙 0] 최우선 절대 원칙 (Data Integrity)
|
|
|
|
- **복사기 모드:** 원본 텍스트를 절대 요약, 생략(...), 수정하지 마십시오. 무조건 전부 출력하십시오.
|
|
- **데이터 무결성:** 표의 수치, 본문의 문장은 토씨 하나 바꾸지 않고 보존합니다.
|
|
|
|
---
|
|
|
|
## 🚨 [원칙 1] 핵심 렌더링 원칙 (The 6 Commandments)
|
|
|
|
| # | 원칙명 | 내용 |
|
|
|---|--------|------|
|
|
| 1 | **Deep Sanitization (심층 세탁)** | 모든 class, style을 삭제하되, 차트/그림 내부의 제목 텍스트는 캡션과 중복되므로 제거하십시오. |
|
|
| 2 | **H1 Only Break** | 오직 대목차(H1) 태그에서만 무조건 페이지를 나눕니다. |
|
|
| 3 | **Orphan Control (고아 방지)** | 중목차(H2), 소목차(H3)가 페이지 하단에 홀로 남을 경우, 통째로 다음 페이지로 넘기십시오. |
|
|
| 4 | **Smart Fit (지능형 맞춤)** | 표나 그림이 페이지를 넘어가는데 그 양이 적다면(15% 이내), 최대 85%까지 축소하여 현재 페이지에 넣으십시오. |
|
|
| 5 | **Gap Filling (공백 채우기)** | 그림이 다음 장으로 넘어가 현재 페이지 하단에 큰 공백이 생긴다면, 뒤에 있는 텍스트 문단을 당겨와 그 빈공간을 채우십시오. |
|
|
| 6 | **Visual Standard** | 여백: 상하좌우 20mm를 시각적으로 고정하십시오. / 캡션: 모든 그림/표의 제목은 하단 중앙 정렬하십시오. |
|
|
|
|
---
|
|
|
|
## 🛠️ [제작 가이드] Technical Specs
|
|
|
|
> [!NOTE]
|
|
>
|
|
> 아래 코드는 **렌더링 엔진**입니다. 이 구조를 기반으로 사용자 데이터를 `raw-container`에 주입하여 출력하십시오.
|
|
>
|
|
> 콘텐츠 주입 위치:
|
|
> - `#box-cover` → 표지 (H1: 제목, H2: 부제, P: 작성정보)
|
|
> - `#box-toc` → 목차
|
|
> - `#box-summary` → 요약 페이지
|
|
> - `#box-content` → 본문 전체
|
|
|
|
---
|
|
|
|
### 가. HTML/CSS 구조 엔진
|
|
|
|
```html
|
|
<!DOCTYPE html>
|
|
<html lang="ko">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<title>A4 Report v83.0 Template</title>
|
|
<style>
|
|
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@300;400;500;700;900&display=swap');
|
|
|
|
:root {
|
|
--primary: #006400;
|
|
--accent: #228B22;
|
|
--light-green: #E8F5E9;
|
|
--bg: #525659;
|
|
}
|
|
body { margin: 0; background: var(--bg); font-family: 'Noto Sans KR', sans-serif; }
|
|
|
|
/* [A4 용지 규격] */
|
|
.sheet {
|
|
width: 210mm; height: 297mm;
|
|
background: white; margin: 20px auto;
|
|
position: relative; overflow: hidden; box-sizing: border-box;
|
|
box-shadow: 0 0 15px rgba(0,0,0,0.1);
|
|
}
|
|
@media print {
|
|
.sheet { margin: 0; break-after: page; box-shadow: none; }
|
|
body { background: white; }
|
|
}
|
|
|
|
/* [헤더/푸터: 여백 20mm 영역 내 배치] */
|
|
.page-header {
|
|
position: absolute; top: 10mm; left: 20mm; right: 20mm;
|
|
font-size: 9pt; color: #000000; font-weight: bold;
|
|
text-align: right; border-bottom: none !important; padding-bottom: 5px;
|
|
}
|
|
.page-footer {
|
|
position: absolute; bottom: 10mm; left: 20mm; right: 20mm;
|
|
display: flex; justify-content: space-between; align-items: flex-end;
|
|
font-size: 9pt; color: #555; border-top: 1px solid #eee; padding-top: 5px;
|
|
}
|
|
|
|
/* [본문 영역: 상하좌우 20mm 고정] */
|
|
.body-content {
|
|
position: absolute;
|
|
top: 20mm; left: 20mm; right: 20mm;
|
|
bottom: auto; /* 높이는 JS가 제어 */
|
|
}
|
|
|
|
/* [타이포그래피] */
|
|
h1, h2, h3 {
|
|
white-space: nowrap; overflow: hidden; word-break: keep-all; color: var(--primary);
|
|
margin: 0; padding: 0;
|
|
}
|
|
h1 {
|
|
font-size: 20pt; /* H2와 동일하게 변경 (기존 24pt -> 18pt) */
|
|
font-weight: 900;
|
|
color: var(--primary);
|
|
border-bottom: 2px solid var(--primary);
|
|
margin-bottom: 20px;
|
|
margin-top: 0;
|
|
}
|
|
h2 {
|
|
font-size: 18pt;
|
|
border-left: 5px solid var(--accent);
|
|
padding-left: 10px;
|
|
margin-top: 30px;
|
|
margin-bottom: 10px;
|
|
color: #03581dff;
|
|
}
|
|
h3 { font-size: 14pt; margin-top: 20px; margin-bottom: 5px; color: var(--accent); font-weight: 700; }
|
|
p, li { font-size: 12pt !important; line-height: 1.6 !important; text-align: justify; word-break: keep-all; margin-bottom: 5px; }
|
|
|
|
/* [목차 스타일 수정: lvl-1 강조 및 간격 추가] */
|
|
.toc-item { line-height: 1.8; list-style: none; border-bottom: 1px dotted #eee; }
|
|
|
|
.toc-lvl-1 {
|
|
color: #006400; /* 녹색 */
|
|
font-weight: 900; /* 볼드 */
|
|
font-size: 13.5pt; /* lvl-2(10.5pt)보다 3pt 크게 */
|
|
margin-top: 15px; /* 위쪽 간격 */
|
|
margin-bottom: 5px; /* 아래쪽 3pt 정도의 간격 */
|
|
border-bottom: 2px solid #ccc;
|
|
}
|
|
.toc-lvl-2 { font-size: 10.5pt; color: #333; margin-left: 20px; font-weight: normal; }
|
|
.toc-lvl-3 { font-size: 10.5pt; color: #666; margin-left: 40px; }
|
|
|
|
|
|
/* [표/이미지 스타일] */
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin: 15px 0;
|
|
font-size: 9.5pt;
|
|
table-layout: auto;
|
|
border-top: 2px solid var(--primary);
|
|
}
|
|
|
|
th, td {
|
|
border: 1px solid #ddd;
|
|
padding: 6px 5px;
|
|
text-align: center;
|
|
vertical-align: middle;
|
|
|
|
/* ▼▼▼ [핵심 수정] 단어 단위 줄바꿈 적용 ▼▼▼ */
|
|
word-break: keep-all; /* 한글 단어 중간 끊김 방지 (필수) */
|
|
word-wrap: break-word; /* 아주 긴 영단어는 줄바꿈 허용 (안전장치) */
|
|
}
|
|
|
|
th {
|
|
background: var(--light-green);
|
|
color: var(--primary);
|
|
font-weight: 900;
|
|
white-space: nowrap; /* 제목 셀은 무조건 한 줄 유지 */
|
|
letter-spacing: -0.05em;
|
|
font-size: 9pt;
|
|
}
|
|
|
|
/* [캡션 및 그림 스타일] */
|
|
figure { display: block; margin: 20px auto; text-align: center; width: 100%; }
|
|
img, svg { max-width: 95% !important; height: auto !important; display: block; margin: 0 auto; border: 1px solid #eee; }
|
|
figcaption {
|
|
display: block; text-align: center; margin-top: 10px;
|
|
font-size: 9.5pt; color: #666; font-weight: 600;
|
|
}
|
|
|
|
.atomic-block { break-inside: avoid; page-break-inside: avoid; }
|
|
#raw-container { display: none; }
|
|
|
|
/* [하이라이트 박스 표준] */
|
|
.highlight-box {
|
|
background-color: rgb(226, 236, 226);
|
|
border: 1px solid #2a2c2aff;
|
|
padding: 5px; margin: 1.5px 1.5px 2px 0px; border-radius: 3px;
|
|
/* 여기 있는 font-size는 li 태그 때문에 무시됩니다. 아래 코드로 제어하세요. */
|
|
color: #333;
|
|
}
|
|
|
|
.highlight-box li,
|
|
.highlight-box p {
|
|
font-size: 11pt !important; /* 글자 크기 (원하는 대로 수정: 예 9pt, 10pt) */
|
|
line-height: 1.2; /* 줄 간격 (숫자가 클수록 넓어짐: 예 1.4, 1.6) */
|
|
letter-spacing: -0.6px; /* 자간 (음수면 좁아짐: 예 -0.5px) */
|
|
margin-bottom: 3px; /* 항목 간 간격 */
|
|
color: #1a1919ff; /* 글자 색상 */
|
|
}
|
|
|
|
.highlight-box h3, .highlight-box strong, .highlight-box b {
|
|
font-size: 12pt !important; color: rgba(2, 37, 2, 1) !important;
|
|
font-weight: bold; margin: 0; display: block; margin-bottom: 5px;
|
|
}
|
|
/* 수정 4 목차 스타일 : 대제목 녹색+크게, 그룹 단위 묶음 */
|
|
.toc-group {
|
|
margin-bottom: 12px; /* 기존 간격 유지 */
|
|
break-inside: avoid;
|
|
page-break-inside: avoid;
|
|
}
|
|
|
|
/* [수정] 점(Bullet) 제거를 위한 핵심 코드 */
|
|
.toc-lvl-1, .toc-lvl-2, .toc-lvl-3 {
|
|
list-style: none !important;
|
|
}
|
|
|
|
.toc-item {
|
|
line-height: 1.8;
|
|
list-style: none; /* 안전장치 */
|
|
border-bottom: 1px dotted #f3e1e1ff; /* 기존 점선 스타일 유지 */
|
|
}
|
|
|
|
.toc-lvl-1 {
|
|
color: #006400; /* 기존 녹색 유지 */
|
|
font-weight: 900;
|
|
font-size: 13.5pt; /* 기존 폰트 크기 유지 */
|
|
margin-top: 15px; /* 기존 상단 여백 유지 */
|
|
margin-bottom: 5px; /* 기존 하단 여백 유지 */
|
|
border-bottom: 2px solid #ccc;
|
|
}
|
|
.toc-lvl-2 {
|
|
font-size: 10.5pt;
|
|
color: #333;
|
|
margin-left: 20px; /* 기존 들여쓰기 유지 */
|
|
font-weight: normal;
|
|
}
|
|
.toc-lvl-3 {
|
|
font-size: 10.5pt;
|
|
color: #666;
|
|
margin-left: 40px; /* 기존 들여쓰기 유지 */
|
|
}
|
|
|
|
/* [대목차 내부 스타일 보존] */
|
|
.toc-lvl-1 .toc-number,
|
|
.toc-lvl-1 .toc-text {
|
|
font-weight: 900;
|
|
font-size: 1.2em;
|
|
color: #006400;
|
|
}
|
|
|
|
.toc-lvl-1 .toc-number {
|
|
float: left;
|
|
margin-right: 14px; /* 기존 간격 유지 */
|
|
}
|
|
.toc-lvl-1 .toc-text {
|
|
display: block;
|
|
overflow: hidden;
|
|
}
|
|
|
|
/* [소목차 내부 스타일 보존] */
|
|
.toc-lvl-2 .toc-number, .toc-lvl-3 .toc-number {
|
|
font-weight: bold;
|
|
color: #2c5282;
|
|
margin-right: 11px; /* 기존 간격 유지 */
|
|
}
|
|
.toc-lvl-2 .toc-text, .toc-lvl-3 .toc-text {
|
|
color: #4a5568;
|
|
font-size: 1em;
|
|
}
|
|
|
|
/* [요약 페이지 전용 스타일 미세 조정] */
|
|
.squeeze {
|
|
line-height: 1.35 !important;
|
|
letter-spacing: -0.5px !important;
|
|
margin-bottom: 2px !important;
|
|
}
|
|
.squeeze-title {
|
|
margin-bottom: 5px !important;
|
|
padding-bottom: 2px !important;
|
|
}
|
|
|
|
|
|
/* 요약 페이지 안의 모든 P 태그에 대해 자간/행간을 좁힘 */
|
|
#box-summary p,
|
|
#box-summary li {
|
|
font-size: 10pt !important; /* 본문보다 0.5pt~1pt 정도 작게 */
|
|
line-height: 1.45 !important; /* 줄 간격을 조금 더 촘촘하게 (기존 1.6) */
|
|
letter-spacing: -0.04em !important; /* 자간을 미세하게 좁힘 */
|
|
margin-bottom: 3px !important; /* 문단 간 격을 줄임 */
|
|
text-align: justify; /* 양쪽 정렬 유지 */
|
|
}
|
|
|
|
/* 요약 페이지 제목 아래 간격도 조금 줄임 */
|
|
#box-summary h1 {
|
|
margin-bottom: 10px !important;
|
|
padding-bottom: 5px !important;
|
|
}
|
|
|
|
.toc-squeeze .toc-group {
|
|
margin-bottom: 5px !important; /* 그룹 간격 12px -> 5px로 축소 */
|
|
}
|
|
.toc-squeeze .toc-lvl-1 {
|
|
margin-top: 8px !important; /* 대목차 상단 15px -> 8px로 축소 */
|
|
margin-bottom: 3px !important; /* 대목차 하단 5px -> 3px로 축소 */
|
|
}
|
|
.toc-squeeze .toc-item {
|
|
line-height: 1.4 !important; /* 리스트 행간 1.8 -> 1.4로 축소 */
|
|
padding: 1px 0 !important; /* 미세 패딩 축소 */
|
|
}
|
|
</style>
|
|
</head>
|
|
```
|
|
|
|
---
|
|
|
|
### 나. HTML Body 구조 (콘텐츠 주입 영역)
|
|
|
|
```html
|
|
<body>
|
|
|
|
<div id="raw-container">
|
|
<div id="box-cover"></div>
|
|
<div id="box-toc"></div>
|
|
<div id="box-summary"></div>
|
|
<div id="box-content"></div>
|
|
</div>
|
|
|
|
<template id="page-template">
|
|
<div class="sheet">
|
|
<div class="page-header"></div>
|
|
<div class="body-content"></div>
|
|
<div class="page-footer">
|
|
<span class="rpt-title"></span>
|
|
<span class="pg-num"></span>
|
|
</div>
|
|
</div>
|
|
</template>
|
|
```
|
|
|
|
> [!NOTE]
|
|
>
|
|
> 위 `raw-container` 내부 4개 `div`에 콘텐츠를 주입하면 JS 엔진이 자동으로 A4 페이지를 생성합니다.
|
|
|
|
---
|
|
|
|
### 다. JavaScript 렌더링 엔진
|
|
|
|
#### 다-1. 초기화 및 설정 (Config & Init)
|
|
|
|
```javascript
|
|
<script>
|
|
window.addEventListener("load", async () => {
|
|
await document.fonts.ready; // 웹폰트 로딩 대기 (필수)
|
|
// [Config] 297mm - 20mm(상) - 20mm(하) = 257mm ≈ 970px
|
|
const CONFIG = { maxHeight: 970 };
|
|
|
|
const rawContainer = document.getElementById('raw-container');
|
|
if (rawContainer) {
|
|
rawContainer.innerHTML = rawContainer.innerHTML.replace(
|
|
/(<rect[^>]*?)\s+y="[^"]*"\s+([^>]*?y="[^"]*")/gi,
|
|
"$1 $2"
|
|
);
|
|
}
|
|
const raw = {
|
|
cover: document.getElementById('box-cover'),
|
|
toc: document.getElementById('box-toc'),
|
|
summary: document.getElementById('box-summary'),
|
|
content: document.getElementById('box-content')
|
|
};
|
|
|
|
let globalPage = 1;
|
|
let reportTitle = raw.cover.querySelector('h1')?.innerText || "Report";
|
|
|
|
function cleanH1Text(text) {
|
|
if (!text) return "";
|
|
const parts = text.split("-");
|
|
return parts[0].trim(); // 첫 번째 부분만 남기고 나머지는 버림
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-2. Sanitizer (스타일 세탁기, `detox`)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> 원본 HTML의 Tailwind/인라인 스타일을 제거하고, 하이라이트 박스·표·그림을 표준 클래스로 변환하는 핵심 함수입니다.
|
|
|
|
```javascript
|
|
// [0] Sanitizer & Pre-processing (Integrity Preserved Version)
|
|
function detox(node) {
|
|
if (node.nodeType !== 1) return;
|
|
|
|
// [Safety Check 1] SVG 내부는 절대 건드리지 않음 (차트 깨짐 방지)
|
|
if (node.closest('svg')) return;
|
|
|
|
// [Logic A] 클래스 속성 확인 및 변수 할당
|
|
let cls = "";
|
|
if (node.hasAttribute('class')) {
|
|
cls = node.getAttribute('class');
|
|
}
|
|
|
|
// [Logic B] 하이라이트 박스 감지 및 변환 (조건 정밀화)
|
|
// 조건: 1. bg-, border-, box 중 하나라도 포함되어야 함
|
|
// 2. 단, title-box(제목박스), toc-(목차), cover-(표지)는 절대 아니어야 함
|
|
if ( (cls.includes('bg-') || cls.includes('border-') || cls.includes('box')) &&
|
|
!cls.includes('title-box') &&
|
|
!cls.includes('toc-') &&
|
|
!cls.includes('cover-') &&
|
|
!cls.includes('highlight-box') ) { // 이미 변환된 놈도 건드리지 않음
|
|
|
|
// 1. 표준 클래스로 강제 교체
|
|
node.setAttribute('class', 'highlight-box atomic-block');
|
|
|
|
// 2. 박스 내부 제목 스타일 초기화 (기존 스타일과의 충돌 방지)
|
|
const internalHeads = node.querySelectorAll('h3, h4, strong, b');
|
|
internalHeads.forEach(head => {
|
|
head.removeAttribute('style');
|
|
head.removeAttribute('class');
|
|
});
|
|
|
|
// 3. 인라인 스타일 삭제 (Tailwind inline style 등 제거)
|
|
node.removeAttribute('style');
|
|
|
|
// [중요] 여기서 return하면 안됨! 아래 공통 로직(표 테두리 등)도 타야 함.
|
|
// 대신, class는 이미 세팅했으므로 class 삭제 로직만 건너뛰게 플래그 변경
|
|
cls = 'highlight-box atomic-block';
|
|
}
|
|
|
|
// [Logic C] 일반 요소 세탁 (화이트리스트 유지)
|
|
// 목차, 표지, 제목박스, 그리고 방금 변환된 하이라이트 박스는 살려둠
|
|
if (node.hasAttribute('class')) {
|
|
// 위에서 cls 변수가 갱신되었을 수 있으므로 다시 확인하지 않고 기존 조건 활용
|
|
if (!cls.includes('toc-') &&
|
|
!cls.includes('cover-') &&
|
|
!cls.includes('highlight-') &&
|
|
!cls.includes('title-box') &&
|
|
!cls.includes('atomic-block')) {
|
|
|
|
node.removeAttribute('class');
|
|
}
|
|
}
|
|
|
|
// [Logic D] 공통 정리 (인라인 스타일 삭제)
|
|
// 단, 이미 변환된 박스는 위에서 지웠으니 중복 실행되어도 상관없음
|
|
node.removeAttribute('style');
|
|
|
|
// [Logic E] 표 테두리 강제 적용
|
|
if (node.tagName === 'TABLE') node.border = "1";
|
|
|
|
// [Logic F] 캡션 중복 텍스트 숨김 처리
|
|
if (node.tagName === 'FIGURE') {
|
|
const internalTitles = node.querySelectorAll('h3, h4, .chart-title');
|
|
internalTitles.forEach(t => t.style.display = 'none');
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-3. 목차 포매터 (`formatTOC`)
|
|
|
|
```javascript
|
|
function formatTOC(container) {
|
|
// 1. 기존 ul/li 구조가 있다면 분석
|
|
// (원본 데이터가 이미 구조화된 경우를 대비하나, 보통 raw 텍스트로 오므로 단순화)
|
|
const nodes = container.querySelectorAll("h1, h2, h3");
|
|
|
|
// 2. 헤더가 하나도 없다면 리턴 (에러 방지)
|
|
if(nodes.length === 0) return;
|
|
|
|
let tocHTML = "<ul style='padding-left:0; margin:0;'>";
|
|
nodes.forEach(node => {
|
|
let text = node.innerText.trim();
|
|
// 태그명에 따라 레벨 클래스 부여
|
|
let lvlClass = node.tagName === "H1" ? "toc-lvl-1" : (node.tagName === "H2" ? "toc-lvl-2" : "toc-lvl-3");
|
|
|
|
// 번호(1.1)와 제목 분리 로직 (선택 사항이나 퀄리티 상승)
|
|
let num = "", title = text;
|
|
const match = text.match(/^(\d+(\.\d+)*)\s+(.*)/);
|
|
if (match) {
|
|
num = match[1];
|
|
title = match[3];
|
|
}
|
|
|
|
tocHTML += `<li class='toc-item ${lvlClass}'>
|
|
<span class='toc-number'>${num}</span>
|
|
<span class='toc-text'>${title}</span>
|
|
</li>`;
|
|
});
|
|
tocHTML += "</ul>";
|
|
|
|
// 3. 컨테이너 내용 교체
|
|
container.innerHTML = tocHTML;
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-4. 노드 평탄화 처리기 (`getFlatNodes`)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> 목차(TOC)와 본문(Body)을 각각 다르게 처리합니다. 목차는 그룹화, 본문은 평탄화(Flatten)합니다.
|
|
|
|
```javascript
|
|
function getFlatNodes(element) {
|
|
// [1] 목차(TOC) 처리 로직 (제목 생성 + 완벽한 그룹화)
|
|
if(element.id === 'box-toc') {
|
|
// 1. 스타일 초기화
|
|
element.querySelectorAll('*').forEach(el => detox(el));
|
|
|
|
// 2. 레벨 분석 (위의 formatTOC 실행)
|
|
formatTOC(element);
|
|
|
|
const tocNodes = [];
|
|
|
|
// [수정] 원본에 H1이 없으면 '목차' 타이틀 강제 생성
|
|
let title = element.querySelector('h1');
|
|
if (!title) {
|
|
title = document.createElement('h1');
|
|
title.innerText = "목차";
|
|
// 디자인 통일성을 위해 스타일 적용은 CSS에 맡김
|
|
}
|
|
tocNodes.push(title.cloneNode(true));
|
|
|
|
// 3. 그룹화 로직 (Flattened List -> Grouped Divs)
|
|
// 중첩이 엉망인 원본 무시하고, 모든 li를 긁어모음
|
|
const allLis = element.querySelectorAll('li');
|
|
let currentGroup = null;
|
|
|
|
allLis.forEach(li => {
|
|
const isLevel1 = li.classList.contains('toc-lvl-1');
|
|
|
|
// 대목차(Level 1)가 나오면 새로운 그룹 시작
|
|
if (isLevel1) {
|
|
// 이전 그룹이 있으면 저장
|
|
if (currentGroup) tocNodes.push(currentGroup);
|
|
|
|
// 새 그룹 박스 생성
|
|
currentGroup = document.createElement('div');
|
|
currentGroup.className = 'toc-group atomic-block';
|
|
|
|
// 내부 UL 생성 (들여쓰기 구조용)
|
|
const ulWrapper = document.createElement('ul');
|
|
ulWrapper.style.margin = "0";
|
|
ulWrapper.style.padding = "0";
|
|
currentGroup.appendChild(ulWrapper);
|
|
}
|
|
|
|
// 안전장치: 첫 시작이 소목차라 그룹이 없으면 하나 만듦
|
|
if (!currentGroup) {
|
|
currentGroup = document.createElement('div');
|
|
currentGroup.className = 'toc-group atomic-block';
|
|
const ulWrapper = document.createElement('ul');
|
|
ulWrapper.style.margin = "0";
|
|
ulWrapper.style.padding = "0";
|
|
currentGroup.appendChild(ulWrapper);
|
|
}
|
|
|
|
// 현재 그룹의 ul에 li 추가
|
|
currentGroup.querySelector('ul').appendChild(li.cloneNode(true));
|
|
});
|
|
|
|
// 마지막 그룹 저장
|
|
if (currentGroup) tocNodes.push(currentGroup);
|
|
|
|
return tocNodes;
|
|
}
|
|
|
|
// [2] 본문(Body) 처리 로직 (기존 박스 보존 로직 유지)
|
|
let nodes = [];
|
|
Array.from(element.children).forEach(child => {
|
|
detox(child);
|
|
|
|
if (child.classList.contains('highlight-box')) {
|
|
child.querySelectorAll('h3, h4, strong, b').forEach(head => {
|
|
head.removeAttribute('style');
|
|
head.removeAttribute('class');
|
|
});
|
|
nodes.push(child.cloneNode(true));
|
|
}
|
|
else if(['DIV','SECTION','ARTICLE','MAIN'].includes(child.tagName)) {
|
|
nodes = nodes.concat(getFlatNodes(child));
|
|
}
|
|
else if (['UL','OL'].includes(child.tagName)) {
|
|
Array.from(child.children).forEach((li, idx) => {
|
|
detox(li);
|
|
const w = document.createElement(child.tagName);
|
|
w.style.margin="0"; w.style.paddingLeft="20px";
|
|
if(child.tagName==='OL') w.start=idx+1;
|
|
const cloneLi = li.cloneNode(true);
|
|
cloneLi.querySelectorAll('*').forEach(el => detox(el));
|
|
w.appendChild(cloneLi);
|
|
nodes.push(w);
|
|
});
|
|
} else {
|
|
const clone = child.cloneNode(true);
|
|
detox(clone);
|
|
clone.querySelectorAll('*').forEach(el => detox(el));
|
|
nodes.push(clone);
|
|
}
|
|
});
|
|
return nodes;
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-5. 핵심 렌더링 엔진 (`renderFlow`)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> **[Final Optimized Engine] Place → Squeeze → Check → Split**
|
|
>
|
|
> 목적: 배치 즉시 자간을 줄여 2글자 고아를 방지하고, 공간을 확보하여 페이지 밀림을 막음
|
|
|
|
```javascript
|
|
// [Final Optimized Engine] Place -> Squeeze -> Check -> Split
|
|
// 목적: 배치 즉시 자간을 줄여 2글자 고아를 방지하고, 공간을 확보하여 페이지 밀림을 막음
|
|
function renderFlow(sectionType, sourceNodes) {
|
|
if (!sourceNodes.length) return;
|
|
|
|
let currentHeaderTitle = sectionType === 'toc' ? "목차" : (sectionType === 'summary' ? "요약" : reportTitle);
|
|
|
|
let page = createPage(sectionType, currentHeaderTitle);
|
|
let body = page.querySelector('.body-content');
|
|
|
|
// 원본 노드 보존을 위해 큐에 담기
|
|
let queue = [...sourceNodes];
|
|
|
|
while (queue.length > 0) {
|
|
let node = queue.shift();
|
|
let clone = node.cloneNode(true);
|
|
|
|
// [태그 판별]
|
|
let isH1 = clone.tagName === 'H1';
|
|
let isHeading = ['H2', 'H3'].includes(clone.tagName);
|
|
// LI도 텍스트로 취급하여 분할 대상에 포함
|
|
let isText = ['P', 'LI'].includes(clone.tagName) && !clone.classList.contains('atomic-block');
|
|
let isAtomic = ['TABLE', 'FIGURE', 'IMG', 'SVG'].includes(clone.tagName) ||
|
|
clone.querySelector('table, img, svg') ||
|
|
clone.classList.contains('atomic-block');
|
|
|
|
// [전처리] H1 텍스트 정제 ("-" 뒤 제거)
|
|
if (isH1 && clone.innerText.includes('-')) {
|
|
clone.innerText = clone.innerText.split('-')[0].trim();
|
|
}
|
|
|
|
// [Rule 1] H1 처리 (무조건 새 페이지)
|
|
if (isH1 && (sectionType === 'body' || sectionType === 'summary')) {
|
|
currentHeaderTitle = clone.innerText;
|
|
if (body.children.length > 0) {
|
|
page = createPage(sectionType, currentHeaderTitle);
|
|
body = page.querySelector('.body-content');
|
|
} else {
|
|
page.querySelector('.page-header').innerText = currentHeaderTitle;
|
|
}
|
|
}
|
|
|
|
// [Rule 2] Orphan Control (제목이 페이지 끝에 걸리는 것 방지)
|
|
if (isHeading) {
|
|
const spaceLeft = CONFIG.maxHeight - body.scrollHeight;
|
|
if (spaceLeft < 160) {
|
|
page = createPage(sectionType, currentHeaderTitle);
|
|
body = page.querySelector('.body-content');
|
|
}
|
|
}
|
|
|
|
// ▼▼▼ [Step 1: 일단 배치 (Place)] ▼▼▼
|
|
body.appendChild(clone);
|
|
|
|
// ▼▼▼ [Step 2: 자간 최적화 (Squeeze Logic)] ▼▼▼
|
|
// 배치 직후, 자간을 줄여서 줄바꿈을 없앨 수 있는지 확인
|
|
// 대상: 10글자 이상인 텍스트 노드
|
|
if (isText && clone.innerText.length > 10) {
|
|
const originalHeight = clone.offsetHeight;
|
|
|
|
// 1. 강력하게 줄여봄
|
|
clone.style.letterSpacing = "-1.0px";
|
|
|
|
// 2. 높이가 줄어들었는가? (줄바꿈이 사라짐 = Orphan 해결)
|
|
if (clone.offsetHeight < originalHeight) {
|
|
// 성공! 너무 빽빽하지 않게 -0.8px로 안착
|
|
clone.style.letterSpacing = "-0.8px";
|
|
} else {
|
|
// 실패! 줄여도 줄이 안 바뀌면 가독성을 위해 원상복구
|
|
clone.style.letterSpacing = "";
|
|
}
|
|
}
|
|
|
|
// [Rule 3] 넘침 감지 (Overflow Check)
|
|
if (body.scrollHeight > CONFIG.maxHeight) {
|
|
// 조건: 목차 섹션이고 + 아직 압축하지 않았으며 + 현재 페이지에 내용이 있고 + 넘친 양이 적을 때(예: 150px 미만)
|
|
if (sectionType === 'toc' && !body.classList.contains('toc-squeeze') && body.children.length > 0) {
|
|
|
|
// 1. 압축 모드 발동!
|
|
body.classList.add('toc-squeeze');
|
|
|
|
// 2. 다시 재봤을 때 들어가는가?
|
|
if (body.scrollHeight <= CONFIG.maxHeight) {
|
|
// 성공! 루프 계속 진행 (다음 아이템 처리)
|
|
continue;
|
|
} else {
|
|
body.classList.remove('toc-squeeze');
|
|
body.removeChild(clone);
|
|
}
|
|
}
|
|
|
|
// 3-1. 텍스트 분할 (Split) - LI 태그 포함
|
|
if (isText) {
|
|
body.removeChild(clone); // 일단 제거
|
|
|
|
let textContent = node.innerText;
|
|
let tempP = node.cloneNode(false); // 태그 속성 유지 (li면 li, p면 p)
|
|
tempP.innerText = "";
|
|
|
|
// 위에서 결정된 최적 자간 스타일 유지
|
|
if (clone.style.letterSpacing) tempP.style.letterSpacing = clone.style.letterSpacing;
|
|
|
|
body.appendChild(tempP);
|
|
|
|
const words = textContent.split(' ');
|
|
let currentText = "";
|
|
|
|
for (let i = 0; i < words.length; i++) {
|
|
let word = words[i];
|
|
let prevText = currentText;
|
|
currentText += (currentText ? " " : "") + word;
|
|
tempP.innerText = currentText;
|
|
|
|
// 단어 하나 추가했더니 넘쳤는가?
|
|
if (body.scrollHeight > CONFIG.maxHeight) {
|
|
// 직전 상태(안 넘치는 상태)로 복구
|
|
tempP.innerText = prevText;
|
|
|
|
// [디자인 보정] 잘린 문단의 마지막 줄 양쪽 정렬
|
|
tempP.style.textAlign = "justify";
|
|
tempP.style.textAlignLast = "justify";
|
|
|
|
// 남은 단어들을 다시 합쳐서 대기열 맨 앞으로
|
|
let remainingText = words.slice(i).join(' ');
|
|
let remainingNode = node.cloneNode(false);
|
|
remainingNode.innerText = remainingText;
|
|
|
|
queue.unshift(remainingNode);
|
|
|
|
// 새 페이지 생성
|
|
page = createPage(sectionType, currentHeaderTitle);
|
|
body = page.querySelector('.body-content');
|
|
|
|
// [중요] 새 페이지 갔으면 압축 플래그/스타일 초기화
|
|
// 새 페이지에서는 다시 넉넉하게 시작해야 함
|
|
body.style.lineHeight = "";
|
|
body.style.letterSpacing = "";
|
|
|
|
break; // for문 탈출
|
|
}
|
|
}
|
|
}
|
|
|
|
// 3-2. 표, 그림, 박스인 경우 -> 통째로 다음 장으로 이동
|
|
else {
|
|
body.removeChild(clone); // 일단 뺌
|
|
|
|
// [Gap Filling] 빈 공간 채우기
|
|
let spaceLeft = CONFIG.maxHeight - body.scrollHeight;
|
|
|
|
// 공간이 50px 이상 있고, 앞에 글자가 이미 있을 때만 채우기 시도
|
|
if (body.children.length > 0 && spaceLeft > 50 && queue.length > 0) {
|
|
while(queue.length > 0) {
|
|
let candidate = queue[0];
|
|
if (['H1','H2','H3'].includes(candidate.tagName) ||
|
|
candidate.classList.contains('atomic-block') ||
|
|
candidate.querySelector('img, table')) break;
|
|
|
|
let filler = candidate.cloneNode(true);
|
|
|
|
// 가져올 때도 최적화(Squeeze) 시도
|
|
if(['P','LI'].includes(filler.tagName) && filler.innerText.length > 10) {
|
|
const hBefore = filler.offsetHeight; // (가상)
|
|
filler.style.letterSpacing = "-1.0px";
|
|
// 실제 DOM에 붙여봐야 높이를 알 수 있으므로 일단 적용
|
|
}
|
|
|
|
body.appendChild(filler);
|
|
|
|
if (body.scrollHeight <= CONFIG.maxHeight) {
|
|
// 들어갔으면 확정하고 대기열 제거
|
|
// 최적화 스타일 유지 (-1.0px -> -0.8px 조정 등은 생략해도 무방하나 디테일 원하면 추가 가능)
|
|
if(filler.style.letterSpacing === "-1.0px") filler.style.letterSpacing = "-0.8px";
|
|
queue.shift();
|
|
} else {
|
|
body.removeChild(filler);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// 2. 이미지 배치 (수정된 핵심 로직)
|
|
// [버그 수정] 현재 페이지가 비어있지 않을 때만 새 페이지 생성!
|
|
if (body.children.length > 0) {
|
|
page = createPage(sectionType, currentHeaderTitle);
|
|
body = page.querySelector('.body-content');
|
|
}
|
|
|
|
// 이미지를 붙임
|
|
body.appendChild(clone);
|
|
|
|
// [Smart Fit] 넘치면 축소 (기존 유지)
|
|
if (isAtomic && body.scrollHeight > CONFIG.maxHeight) {
|
|
const currentH = clone.offsetHeight;
|
|
const overflow = body.scrollHeight - CONFIG.maxHeight;
|
|
body.removeChild(clone);
|
|
|
|
if (overflow > 0 && overflow < (currentH * 0.15)) {
|
|
clone.style.transform = "scale(0.85)";
|
|
clone.style.transformOrigin = "top center";
|
|
clone.style.marginBottom = `-${currentH * 0.15}px`;
|
|
body.appendChild(clone);
|
|
} else {
|
|
body.appendChild(clone); // 너무 크면 그냥 둠
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-6. 페이지 생성기 (`createPage`)
|
|
|
|
```javascript
|
|
function createPage(type, headerTitle) {
|
|
const tpl = document.getElementById('page-template');
|
|
const clone = tpl.content.cloneNode(true);
|
|
const sheet = clone.querySelector('.sheet');
|
|
|
|
if (type === 'cover') {
|
|
sheet.innerHTML = "";
|
|
const title = raw.cover.querySelector('h1')?.innerText || "Report";
|
|
const sub = raw.cover.querySelector('h2')?.innerText || "";
|
|
const pTags = raw.cover.querySelectorAll('p');
|
|
const infos = pTags.length > 0 ? Array.from(pTags).map(p => p.innerText).join(" / ") : "";
|
|
|
|
// [표지 스타일] 테두리 제거 및 중앙 정렬
|
|
sheet.innerHTML = `
|
|
<div style="position:absolute; top:20mm; right:20mm; text-align:right; font-size:11pt; color:#666;">${infos}</div>
|
|
<div style="display:flex; flex-direction:column; justify-content:center; align-items:center; height:100%; text-align:center; width:100%;">
|
|
<div style="width:85%;">
|
|
<div style="font-size:32pt; font-weight:900; color:var(--primary); line-height:1.2; margin-bottom:30px; word-break:keep-all;">${title}</div>
|
|
<div style="font-size:20pt; font-weight:300; color:#444; word-break:keep-all;">${sub}</div>
|
|
</div>
|
|
</div>`;
|
|
} else {
|
|
// ... (나머지 페이지 생성 로직 기존 유지) ...
|
|
clone.querySelector('.page-header').innerText = headerTitle;
|
|
clone.querySelector('.rpt-title').innerText = reportTitle;
|
|
if (type !== 'toc') clone.querySelector('.pg-num').innerText = `- ${globalPage++} -`;
|
|
else clone.querySelector('.pg-num').innerText = "";
|
|
}
|
|
document.body.appendChild(sheet);
|
|
return sheet;
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
#### 다-7. 실행 순서 (Execution Order)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> 아래 순서대로 실행됩니다: **표지 → 목차 → 요약(Smart Squeeze) → 본문 → 후처리**
|
|
|
|
```javascript
|
|
createPage('cover');
|
|
if(raw.toc) renderFlow('toc', getFlatNodes(raw.toc));
|
|
|
|
// [요약 페이지 지능형 맞춤 로직 (Smart Squeeze)]
|
|
const summaryNodes = getFlatNodes(raw.summary);
|
|
|
|
// 1. 가상 공간에 미리 렌더링하여 높이 측정
|
|
const tempBox = document.createElement('div');
|
|
tempBox.style.width = "210mm";
|
|
tempBox.style.position = "absolute";
|
|
tempBox.style.visibility = "hidden";
|
|
tempBox.id = 'box-summary'; // CSS 적용
|
|
document.body.appendChild(tempBox);
|
|
|
|
// 노드 복제하여 주입
|
|
summaryNodes.forEach(node => tempBox.appendChild(node.cloneNode(true)));
|
|
|
|
// 2. 높이 분석 (Smart Runt Control)
|
|
const totalHeight = tempBox.scrollHeight;
|
|
const pageHeight = CONFIG.maxHeight; // 1페이지 가용 높이 (약 970px)
|
|
const lastPart = totalHeight % pageHeight;
|
|
|
|
// [조건] 넘친 양이 100px 미만일 때 압축
|
|
if (totalHeight > pageHeight && lastPart > 0 && lastPart < 180) {
|
|
summaryNodes.forEach(node => {
|
|
if(node.nodeType === 1) {
|
|
node.classList.add('squeeze');
|
|
if(node.tagName === 'H1') node.classList.add('squeeze-title');
|
|
|
|
// [추가] P, LI 태그에 더 강력한 인라인 스타일 강제 주입 (폰트 축소 포함)
|
|
if(node.tagName === 'P' || node.tagName === 'LI') {
|
|
node.style.fontSize = "9.5pt";
|
|
node.style.lineHeight = "1.4";
|
|
node.style.letterSpacing = "-0.8px";
|
|
}
|
|
}
|
|
});
|
|
}
|
|
// 뒷정리
|
|
document.body.removeChild(tempBox);
|
|
// 3. 렌더링 실행
|
|
renderFlow('summary', summaryNodes);
|
|
|
|
// ▼▼▼ [기존 유지] 본문 렌더링 및 마무리 작업 ▼▼▼
|
|
renderFlow('body', getFlatNodes(raw.content));
|
|
|
|
// 긴 제목 자동 축소 (기존 기능 유지)
|
|
document.querySelectorAll('.sheet h1, .sheet h2').forEach(el => {
|
|
let fs = 100;
|
|
while(el.scrollWidth > el.clientWidth && fs > 50) { el.style.fontSize = (--fs)+"%"; }
|
|
});
|
|
|
|
// ▼▼▼▼▼ [수정된 핵심 로직: 통합 자간 조정] ▼▼▼▼▼
|
|
// 변경점 1: 'li' 태그 포함
|
|
// 변경점 2: 표, 그림 내부 텍스트 제외
|
|
// 변경점 3: 글자수 제한 완화 (10자 이상이면 검사)
|
|
const allTextNodes = document.querySelectorAll('.sheet .body-content p, .sheet .body-content li');
|
|
|
|
allTextNodes.forEach(el => {
|
|
// 1. [제외 대상] 표(table), 그림(figure), 차트 내부는 건드리지 않음
|
|
if (el.closest('table') || el.closest('figure') || el.closest('.chart')) return;
|
|
|
|
// 2. [최소 길이] 10자 미만은 무시
|
|
if (el.innerText.trim().length < 10) return;
|
|
|
|
// 3. [테스트]
|
|
const originH = el.offsetHeight;
|
|
const originSpacing = el.style.letterSpacing;
|
|
el.style.fontSize = "12pt";
|
|
|
|
// 강력하게 당겨봄
|
|
el.style.letterSpacing = "-1.4px";
|
|
|
|
const newH = el.offsetHeight;
|
|
|
|
// 성공(높이 줄어듦) 시
|
|
if (newH < originH) {
|
|
el.style.letterSpacing = "-1.0px"; // 적당히 안착
|
|
}
|
|
else {
|
|
el.style.letterSpacing = originSpacing; // 원상복구
|
|
}
|
|
});
|
|
// ▲▲▲▲▲ [수정 끝] ▲▲▲▲▲
|
|
|
|
// 제목 자동 축소 (중복 실행 방지를 위해 제거해도 되지만, 안전하게 둠)
|
|
document.querySelectorAll('.sheet h1, .sheet h2').forEach(el => {
|
|
let fs = 100;
|
|
while(el.scrollWidth > el.clientWidth && fs > 50) { el.style.fontSize = (--fs)+"%"; }
|
|
});
|
|
|
|
const pages = document.querySelectorAll('.sheet'); // .page 대신 .sheet로 수정하여 정확도 높임
|
|
if (pages.length >= 2) {
|
|
const lastSheet = pages[pages.length - 1];
|
|
const prevSheet = pages[pages.length - 2];
|
|
// 커버나 목차가 아닐때만 진행
|
|
if(lastSheet.querySelector('.rpt-title')) {
|
|
const lastBody = lastSheet.querySelector('.body-content');
|
|
const prevBody = prevSheet.querySelector('.body-content');
|
|
|
|
// 마지막 페이지 내용이 3줄(약 150px) 이하인가?
|
|
if (lastBody.scrollHeight < 150 && lastBody.innerText.trim().length > 0) {
|
|
prevBody.style.lineHeight = "1.3"; // 앞 페이지 압축
|
|
prevBody.style.paddingBottom = "0px";
|
|
|
|
const contentToMove = Array.from(lastBody.children);
|
|
contentToMove.forEach(child => prevBody.appendChild(child.cloneNode(true)));
|
|
|
|
if (prevBody.scrollHeight <= CONFIG.maxHeight + 5) {
|
|
lastSheet.remove(); // 성공 시 마지막 장 삭제
|
|
} else {
|
|
// 실패 시 원상 복구
|
|
for(let i=0; i<contentToMove.length; i++) prevBody.lastElementChild.remove();
|
|
prevBody.style.lineHeight = "";
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// 원본 데이터 삭제
|
|
const rawToRemove = document.getElementById('raw-container');
|
|
if(rawToRemove) rawToRemove.remove();
|
|
});
|
|
</script>
|
|
</body>
|
|
</html>
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 [요약] 렌더링 엔진 구조 흐름
|
|
|
|
```
|
|
원본 HTML 입력 (raw-container 주입)
|
|
↓
|
|
[0] detox() → 스타일 세탁 (class/style 제거, 하이라이트 박스 표준화)
|
|
↓
|
|
[1] getFlatNodes() → 목차 그룹화 / 본문 평탄화
|
|
↓
|
|
[2] renderFlow() → Place → Squeeze → Overflow Check → Split/Move
|
|
↓
|
|
[3] createPage() → 표지 / 목차 / 요약 / 본문 페이지 생성
|
|
↓
|
|
[4] 후처리 → 긴 제목 자동 축소 / 자간 통합 조정 / 마지막 페이지 병합
|
|
↓
|
|
최종 A4 보고서 출력
|
|
```
|