도쿠위키

도쿠위키(DokuWiki)는 위키 엔진 중 하나다. 개발자는 독일 출신의 프로그래머 Andreas Gohr. 이름의 유래는 『Dokument(문서를 뜻하는 독일어 단어) + WikiWiki』를 합성한 것. 미디어위키와 함께 널리 사용되는 위키 엔진으로, 텍스트 파일 기반의 위키다.

설치

윈도우 설치

여기에서 내려받기를 하여 설치하면 된다. 내려받기에는 몇 가지 옵션이 있다. 단순히 개인적인 용도로 사용할 것이라면 아래 설정으로 충분하다.

• Version = Stable
• Include Web-Server = MicroApache (Windows)
• Languages =
  • en - English (always enabled)
  • ko - 한국어

이렇게 설정하고 내려받으면 압축 파일을 던져준다. *zip 등으로 적당한 곳에 풀어둔다음 «run.cmd»를 실행하면, 자동으로 아파치 서버와 웹브라우저가 작동하며 위키질을 할 수 있게 된다.

설정

최초 실행하면 설정 항목을 작성하게 되는데, 개인 사용자라면 위키 이름과 사용 언어 정도만 설정해두면 될 것이다. 필요하다면 외부 접근에 대비해 비밀번호를 설정하거나 아파치 설정을 이용하여 선별적으로 허용·차단하도록 한다.

설정이 끝났다면 «$도쿠위키/install.php»는 이름을 바꿔 접근할 수 없도록 해둔다. (윈도우라면 "DokuWikiStick" 폴더에서 찾아볼 수 있다.)

문서파일 이름의 인코딩 설정

문서파일 이름의 기본 값은 URL 인코딩이다. 이 방식은 운영체제의 언어 설정에 의존적이지 않고 어디서든 동일한 파일이름을 유지할 수 있다는 장점이 있으나, 사람이 쉽게 알아보기 힘든 단점이 있다. 따라서 이 방식을 좋아하지 않는다면, 다음처럼 «$도쿠위키/conf/local.php»에서 설정 값을 넣어주자. 인코딩 없이 파일 이름이 UTF-8로 저장된다.[※윈도우에서는 UTF-8 옵션을 쓰기 힘들다. 꼭 필요하다면 safe 옵션을 추천할 수 있겠지만 범용성면에서는 url이 낫다.]

$conf['fnencode'] = 'utf-8';

파일명 예시:

url: %EB%8F%84%EC%BF%A0%EC%9C%84%ED%82%A4.txt
safe: %zhg%151c%13ac%156s].txt
utf-8: 도쿠위키.txt

인터위키 설정

«$도쿠위키/conf/interwiki.php»를 수정하여 단축어를 만들면 위키 문서간 링크(인터위키)를 만들어 넣기 쉽다. 다음은 리브레 위키로 가는 단축어다.

lw  https://librewiki.net/wiki/{NAME}

글꼴 설정

«$도쿠위키/conf/userstyle.css»를 수정하여 다음처럼 글꼴을 선택적으로 적용할 수 있다.

body {
    font-family: "함초롬돋움";
    font-style: normal;
}

div.dokuwiki textarea.edit {
    font-family: "Noto Sans CJK KR", "Noto Sans";
    font-style: normal;
    font-weight: 300;
}

blockquote, pre {
    font-family: "Noto Sans CJK KR";
    font-style: normal;
    font-weight: 100;
}

h1, h2, h3, h4 {
    font-family: "나눔바른고딕";
    font-style: normal;
}

pre.code {
    font-family: "Consolas", "나눔고딕코딩";
    font-style: normal;
}

인쇄용은 «$도쿠위키/conf/userprint.css»를 수정한다.

플러그인 설치 및 설정

도쿠위키는 다양한 플러그인을 지원한다. 윈도우-포터블 버전이라면 «$도쿠위키/lib/plugins» 폴더에 플러그인 파일을 압축 해체하여 통째로 넣어두면 된다. 그리고 도쿠위키를 재실행하여 플러그인이 작동하는 것을 확인하면 설치는 완료.

도쿠위키 플러그인은 별도의 설정파일이 없는 경우가 많다. 별도로 수정을 원한다면 직접 소스 코드를 수정해야 한다.

템플릿 설정

템플릿은 흔히 말하는 스킨 혹은 테마를 뜻한다. «$도쿠위키/lib/tpl»에 템플릿을 내려받아 풀어둔 다음 «$도쿠위키/lib/local.php»를 수정하면 적용할 수 있다.

$conf['template'] = '템플릿이름';

도쿠위키의 기본 템플릿(dokuwiki)는 겉보기엔 세련되어 보이지 않지만 모바일을 포함한 여러 상황에 무리 없이 대응하도록 잘 짜여져 있기 때문에 그냥 쓰는 것도 나쁘지 않다.

사용

문법

기본 위키 문법이야 대동소이하니 리브레 위키를 잘 사용할 줄 안다면 쉽게 사용할 수 있다. 필요하다면 도쿠위키 문법 도움말을 살펴본다.

백업

도쿠위키 역시 백업이 중요하다. 백업 대상은 «dokuwiki/data» 폴더에 몰려있으니 주기적으로 백업하여 소중한 문서를 보호하자. 도쿠위키의 안내에 따른다면,

• data/pages
• data/meta
• data/media
• data/media_attic
• data/media_meta
• data/attic
• conf

정도를 신경 써주는 것이 좋겠다.

같이 보기

• 도쿠위키의 플러그인
• 도쿠위키 기반의 위키위키
  • 오픈위키
• 마크업 언어 문법 비교

바깥 링크

• (영어) 도쿠위키 공식 웹 사이트
• (영어) 다운로드 페이지