고정 페이지 HTML 문서 모드 추가 v1.5.1

2026-05-26 11:03:33 +09:00
parent 0ad2ab3f9d
commit a25306389b
15 changed files with 169 additions and 14 deletions
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -91,6 +91,8 @@
 - About, Projects, Links, Contact, 서비스 소개 페이지 등 고정 콘텐츠에 사용
 - 기본 게시물 목록에는 노출하지 않음
 - 헤더와 사이드바를 사용하지 않고 본문 중심 전체 화면으로 표시
+- 페이지는 `renderMode`로 렌더링 방식을 구분한다. 기본값은 `markdown`이며 기존 Markdown 콘텐츠 렌더러를 사용한다. `html_document`는 관리자에서 붙여넣은 전체 HTML 문서를 공개 `/pages/:slug` 요청에서 `text/html` 원문으로 응답한다.
+- HTML 문서 모드는 관리자만 저장하는 신뢰 콘텐츠를 전제로 하며, `<head>`, `<style>`, `<body>`를 포함한 단일 랜딩 페이지 용도로 사용한다.
 - 진입 경로는 추후 메뉴/링크 설정을 통해 연결

 ### 공개 URL 구조
@@ -251,7 +253,8 @@ components/content/
 | id | UUID | Primary Key |
 | title | String | 제목 |
 | slug | String | URL 슬러그 |
-| content | Text | 마크다운 콘텐츠 |
+| content | Text | Markdown 콘텐츠 또는 HTML 문서 원문 |
+| render_mode | String | 렌더링 방식(`markdown`, `html_document`) |
 | excerpt | String | 요약 |
 | featured_image | String nullable | 대표 이미지 |
 | is_featured | Boolean | 홈 Featured 및 목록 번개 표시용 추천 글 여부 |
@@ -633,8 +636,9 @@ components/content/

 ### 관리자 페이지 편집

- 고정 페이지 작성/수정 화면은 게시물과 같은 블록형 에디터를 사용한다.
- 고정 페이지는 제목, 슬러그, 본문, 대표 이미지만 저장한다.
+- 고정 페이지 작성/수정 화면은 기본 모드에서 게시물과 같은 블록형 에디터를 사용한다.
+- 고정 페이지 HTML 문서 모드는 전체 HTML 붙여넣기용 textarea를 사용하고, 공개 URL에서 Nuxt 레이아웃 없이 원문 HTML로 응답한다.
+- 고정 페이지는 제목, 슬러그, 렌더링 방식, 본문, 대표 이미지를 저장한다.
 - 고정 페이지는 게시물 목록과 태그 목록에 노출하지 않는다.
 - 고정 페이지 공개 보기 경로는 `/pages/:slug`를 사용한다.