위키위키위키 위키

위키위키위키

“좋은 것은 적어도 세 번 이상 반복할 필요가 있습니다.”

위키위키위키는 텍스트 파일 기반 PHP 위키 엔진입니다. 데이터베이스 없이, 복잡한 설정 없이, 그냥 쓸 수 있는.

주요 기능

  • 간편 설치
  • 마크다운 지원
  • 문서 연결([[문서 제목]]), 문서 연동(![[문서 제목]]), 해시태그(#태그), 리다이렉트
  • 문서 둘러보기 및 검색
  • 편집 이력 관리
  • 동시 편집 충돌 방지
  • 문서 내보내기
  • RSS, 사이트맵, llms.txt, llms-full.txt, 읽기 전용 API
  • 사용자 관리
  • 편집 권한(공개, 비공개) 설정
  • 테마 추가
  • 다국어(한국어, 영어)
  • 다크 모드
  • …

요구 사항

  • PHP 8.2+
  • 필수 확장: json, mbstring, session, hash, pcre
  • 권장 확장: zip(내보내기), intl(문자열 정규화)

설치

로컬 (프로젝트 루트에서)

git clone https://github.com/minguhong/WikiWikiWiki
cd WikiWikiWiki
php -S localhost:3333
  1. http://localhost:3333 접속
  2. 언어 선택
  3. 기본 정보 입력 및 관리자 계정 생성

웹 서버 (아파치)

필요 모듈: mod_rewrite(필수), mod_headers(선택), mod_expires(선택)

  1. 최신 릴리즈 파일 다운로드
  2. 서버에 업로드 (.htaccess 포함)
  3. 언어 선택
  4. 기본 정보 입력 및 관리자 계정 생성

Nginx를 사용하는 경우 nginx.example.conf 참고

사용법

마크다운을 제외한 위키 문법

문법 설명
[[문서 제목]] 다른 문서로 연결
[[문서 제목|표시할 텍스트]] 문서 별칭으로 연결
[[상위/하위]] /로 계층 문서 구분
![[문서 제목]] 다른 문서의 내용을 문서에 포함 (트랜스클루전)
#태그 모아 보기용 태그 지정
(redirect: 문서 제목) 다른 문서로 리다이렉트 (문서 첫 줄에 작성)

임베드

문법 설명 옵션 예시
(image: URL) 이미지 width, height, caption (image: URL width: 300px caption: 체리)
(video: URL) 동영상 (YouTube, Vimeo 등) width, height (video: URL width: 80%)
(iframe: URL) iframe (https://만) width, height (iframe: URL height: 400px)
(map: 주소) 구글 지도 width, height (map: 서울 강남구)
(codepen: URL) CodePen width, height (codepen: URL)
(arena: 경로 또는 URL) Are.na 채널 width, height (arena: username/channel-name)
(wikipedia: 검색어) 위키백과 링크 (기본: 위키 언어) lang (wikipedia: Markdown lang: en)
(recent: 숫자) 최근 편집 문서 목록 (recent: 5)
(wanted: 숫자) 링크는 있지만 아직 없는 문서 목록 (wanted: 10)
(random: 숫자) 무작위 문서 목록 (random: 10)

width, height 값에는 px, %, rem, em 등을 사용할 수 있습니다.

피드 및 API

경로 설명
/rss.xml RSS 피드
/sitemap.xml 사이트맵
/llms.txt LLM용 문서 목록 요약
/llms-full.txt LLM용 문서 전체 내용
/api/all 전체 문서 목록 JSON (?limit=20&offset=0, limit 최대 100), 최상위: pages, count, total, offset, limit; 문서 항목: title, modified_at, url, redirect_target, redirect_url
/api/wiki/{제목} 문서 내용 JSON, title, content, modified_at, url, redirect_target

단축키

단축키 설명
/ 검색
e 편집 (문서 보기)
n 새 문서
Cmd/Ctrl + B 굵게 (새 문서/편집)
Cmd/Ctrl + I 기울임 (새 문서/편집)
Cmd/Ctrl + K 위키 링크 (새 문서/편집)
Cmd/Ctrl + S 또는 Cmd/Ctrl + Enter 저장 (새 문서/편집)
Esc 편집 취소 (새 문서/편집)

라이선스

MIT