jacepages/게시 워크플로

1. 무엇을 하는가

게시 워크플로는 새 가이드·매뉴얼·제안서·리포트를 public/<slug>/index.html로 추가하고 대문 카드에 연결하는 절차다. 저장소는 빌드 단계가 없는 정적 사이트이므로 HTML이 곧 배포 결과다.

2. 새 페이지 추가

1. URL에 사용할 소문자 하이픈 슬러그를 정한다.
2. public/<slug>/index.html을 만든다.
3. 문서 제목과 <meta name="description">을 넣는다.
4. 페이지 안에 필요한 CSS와 JavaScript를 포함해 독립 실행되게 만든다.
5. public/index.html의 카드 목록에 새 <a class="card"> 블록을 추가한다.
6. 카드에 제목, 한두 문장 설명, 발행 월을 적는다.
7. npm run dev로 로컬 대문과 /slug/를 확인한다.
8. 대문 카드, 모바일 폭, 내부 링크, 복사·검색 같은 상호작용을 검수한 뒤 배포한다.

3. 카드 작성

대문 카드의 기본 목적은 긴 페이지를 열기 전에 내용을 판단하게 하는 것이다. 기존 카드처럼 다음 세 가지를 분명히 둔다.

• <h2>: 무엇에 관한 페이지인지 드러나는 제목
• <p>: 대상, 범위, 핵심 기능을 압축한 설명
• .date: YYYY.MM 형식 발행 월

외부 프로젝트를 연결할 때는 카드의 href에 전체 https://… 주소를 넣는다. jacepages 내부 문서는 /slug/ 절대경로를 사용한다.

4. 독립 페이지의 권장 구성

• 첫 화면에서 제목·대상·기준 날짜를 이해할 수 있게 한다.
• 긴 문서는 목차나 섹션 바로가기를 둔다.
• 명령어가 많으면 복사 버튼을 제공한다.
• 체크리스트 상태를 저장한다면 저장 범위가 현재 브라우저임을 알린다.
• 가능하면 ← Jace's Pages 또는 home으로 대문 회귀 링크를 둔다.
• 좁은 화면에서 제목, 표, 코드가 잘리지 않는지 확인한다.

5. 리다이렉트

다른 프로젝트로 완전히 분리된 경로는 public/_redirects에서 301 리다이렉트를 설정할 수 있다. 현재 /crazy-dice와 하위 경로가 crazy-dice.pages.dev로 전달된다. 리다이렉트를 추가하면 정확한 경로와 :splat 보존 여부를 함께 확인한다.

6. 로컬 확인과 배포

• npm run dev는 wrangler pages dev public을 실행하며 기본 로컬 주소는 localhost:8788이다.
• 별도 빌드 명령은 없다. public/이 그대로 Cloudflare Pages 산출물이다.
• 배포는 npm run deploy이며 Cloudflare Pages 프로젝트 jacepages, 프로덕션 브랜치 main을 사용한다.

공유 저장소이므로 운영 시에는 원격 최신 상태를 먼저 반영하고, 변경을 커밋·푸시한 뒤 배포하는 순서를 지킨다.

7. 검수할 것

• 대문 카드에서 제목·설명·발행 월이 올바르게 보이는가
• 카드가 의도한 /slug/ 또는 외부 도메인으로 이동하는가
• 페이지 제목과 메타 설명이 주제와 맞는가
• 목차·복사·검색·체크리스트가 실제로 동작하는가
• 대문으로 돌아오는 경로와 모바일 레이아웃이 있는가

8. 관련 문서

• jacepages
• jacepages/페이지 카탈로그
• jacepages/개별 페이지