올포랜드 위키는 Wiki.js의 Git Storage 기능을 기준으로 운영한다. 별도 raw 주입 스크립트나 top-down 동기화는 사용하지 않는다.
| 구성 요소 | 역할 |
|---|---|
ai-wiki Git 저장소 |
Wiki.js 페이지와 Wiki.js가 관리하는 파일의 기준 저장소다. |
| Wiki.js Git Storage | 브라우저에서 수정된 문서를 Git에 commit/push 하고, 원격 변경을 pull/import 한다. |
플랫폼 shares 서비스 |
Git에 넣기 무거운 레거시 HTML, PDF, ZIP, 샘플 파일을 /shares/... 경로로 제공한다. |
all4land-files |
로컬 compose에서 ALL4LAND_SHARES_ROOT=../../all4land-files로 마운트하는 정적 파일 루트다. |
Wiki.js와 로컬 Git 체크아웃은 둘 다 쓰기 주체다.
git fetch origin 또는 git pull --ff-only origin main으로 Wiki.js가 올린 변경을 받는다.금지하는 작업은 다음과 같다.
git push --forcereset --hard, 강제 checkout_media, _files, resource-center 파일의 광범위 삭제Wiki.js에서 직접 업로드하고 관리하는 이미지는 Wiki.js 기본 파일 경로를 사용한다.
레거시 자료실, API 문서, 설치 파일, 샘플 HTML처럼 Wiki.js 문서와 분리해 제공할 자료는 플랫폼 공유 경로를 사용한다.
[OpenLayers 예제](/shares/resource-center/ex-openlayers.html)
[설치 파일](/shares/resource-center/resources/download/desktop/MapPrimeDeskTop_x64_Setup_2.0.zip)
shares 아래에 wiki 네임스페이스를 끼워 넣던 경로는 예전 knowledge-hub/files 서비스 기준이므로 새 문서에서는 사용하지 않는다.
대표 확인 주소는 다음과 같다.
| URL | 확인 내용 |
|---|---|
http://localhost:3200 |
Wiki.js 직접 접속 |
http://localhost:3230/shares/resource-center/webgis-ex-url.html |
shares 컨테이너 직접 접속 |
http://localhost:3100/shares/resource-center/webgis-ex-url.html |
edge gateway 경유 공유 파일 접속 |
운영자가 로컬 체크아웃에서 작업할 때 사용하는 AGENTS.md 같은 에이전트 지침 파일은 .gitignore에 포함되어야 한다. 해당 파일은 Wiki.js 페이지로 올라가면 안 된다.