kimminsung/ParaWiki
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases Wiki Activity

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

New Issue
Open
opened 2026-04-14 11:12:36 +09:00 by kimminsung · 0 comments
kimminsung commented 2026-04-14 11:12:36 +09:00
Owner
Copy Link
Copy Source

목적 (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) 링크 확인
  • 한국어 검색 확인
## 목적 (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.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
kimminsung (김민성)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kimminsung/ParaWiki#2