ParaWiki 웹페이지 게시 (Publish wiki as static site) #2

New Issue

kimminsung · 2026-04-14T11:12:36+09:00

kimminsung commented

2026-04-14 11:12:36 +09:00

목적 (Goal)

ParaWiki를 온라인에서 열람 가능한 웹페이지로 게시. 다른 사람들이 브라우저로 접근할 수 있게 한다.

요구사항 (Requirements)

wiki/ 폴더를 루트로 하는 정적 사이트 게시
wikilink [[...]], YAML frontmatter, 백링크 렌더링
한국어 전문 검색
raw/, Output/, Backup/, .obsidian/ 등은 빌드에서 제외
wiki/index.md를 홈페이지로

후보 (Candidates)

Quartz 4 + Gitea Actions — 사내망 또는 외부 배포, Obsidian 금고 전용, 무료
Obsidian Publish — 유료($10/월), 설정 최소
MkDocs Material — wikilink 변환 필요, ParaWiki 관례와 충돌

1순위: Quartz 4.

결정 필요 사항 (Decisions)

열람 대상: 사내 내부망 / 외부 공개 / 혼합?
Gitea Actions Runner 활성화 여부 확인
Gitea Pages 모듈 지원 여부 확인
배포 대상: 사내 웹서버 / Gitea Pages / GitHub 미러 → GitHub Pages / Cloudflare Pages
도메인: 기본 / 커스텀

작업 항목 (Tasks)

Quartz 4 스캐폴딩 (quartz/ 하위 또는 별도 브랜치)
wiki/ → Quartz content 경로 매핑
빌드 제외 규칙(raw/, Output/, Backup/) 설정
CI 파이프라인 (Gitea Actions workflow) 작성
배포 타깃 구성
홈(wiki/index.md) 링크 확인
한국어 검색 확인

## 목적 (Goal) ParaWiki를 온라인에서 열람 가능한 웹페이지로 게시. 다른 사람들이 브라우저로 접근할 수 있게 한다. ## 요구사항 (Requirements) - `wiki/` 폴더를 루트로 하는 정적 사이트 게시 - wikilink `[[...]]`, YAML frontmatter, 백링크 렌더링 - 한국어 전문 검색 - `raw/`, `Output/`, `Backup/`, `.obsidian/` 등은 빌드에서 제외 - `wiki/index.md`를 홈페이지로 ## 후보 (Candidates) 1. **Quartz 4 + Gitea Actions** — 사내망 또는 외부 배포, Obsidian 금고 전용, 무료 2. **Obsidian Publish** — 유료($10/월), 설정 최소 3. **MkDocs Material** — wikilink 변환 필요, ParaWiki 관례와 충돌 1순위: Quartz 4. ## 결정 필요 사항 (Decisions) - [ ] 열람 대상: 사내 내부망 / 외부 공개 / 혼합? - [ ] Gitea Actions Runner 활성화 여부 확인 - [ ] Gitea Pages 모듈 지원 여부 확인 - [ ] 배포 대상: 사내 웹서버 / Gitea Pages / GitHub 미러 → GitHub Pages / Cloudflare Pages - [ ] 도메인: 기본 / 커스텀 ## 작업 항목 (Tasks) - [ ] Quartz 4 스캐폴딩 (`quartz/` 하위 또는 별도 브랜치) - [ ] `wiki/` → Quartz content 경로 매핑 - [ ] 빌드 제외 규칙(`raw/`, `Output/`, `Backup/`) 설정 - [ ] CI 파이프라인 (Gitea Actions workflow) 작성 - [ ] 배포 타깃 구성 - [ ] 홈(`wiki/index.md`) 링크 확인 - [ ] 한국어 검색 확인

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kimminsung/ParaWiki#2