도쿠위키

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

1 설치[편집]

1.1 윈도우 설치[편집]

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

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

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

2 설정[편집]

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

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

2.1 문서파일 이름의 인코딩 설정[편집]

문서파일 이름의 기본 값은 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

2.2 인터위키 설정[편집]

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

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

2.3 글꼴 설정[편집]

«$도쿠위키/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»를 수정한다.

2.4 플러그인 설치 및 설정[편집]

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

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

2.5 템플릿 설정[편집]

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

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

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

3 사용[편집]

3.1 문법[편집]

사실 도쿠위키미디어위키와 비교했을 때 문법 기호가 상당히 다르다. 다만 적용되는 원리는 유사하다. 더 자세한 내용은 도쿠위키 문법 도움말을 살펴본다. 어차피 기본 도쿠위키의 문서 편집기에도 문법을 쉽게 표시하는 위키 편집기가 내장되어 있으니 어렵지 않게 작성할 수 있을 것이다.

도쿠위키와 미디어위키의 중요한 문법의 차이는 다음과 같다. 전반적으로 미디어위키보다는 모니위키와 문법적 형태가 더 유사한 점이 많이 보인다.

  1. 우선 문단 기호의 단계가 미디어위키와는 반대로 '=' 기호가 많은 것이 큰 문단이고, '='기호가 적은 것이 작은 문단을 나타낸다.
  2. 굵은 글씨는 **글씨**, 기울인 글씨는 //글씨//, 밑줄은 __글씨__ 이런 식으로 표현된다. 그밖에도 상이한 내용이 여러 개 존재한다.
  3. 미디어위키와는 달리 외부 링크든 위키 내부 문서 링크든 대괄호 2개를 이용해서 표시한다.
  4. 목록 기호는 미디어위키와는 달리 앞에 공백을 띄워야 한다.
  5. 표 문법의 경우 미디어위키의 그것보다는 더 직관적이다. |(표내용1)|(표내용2)| 이런 식으로 줄 하나를 완성시킬 수 있다. 다만 표 기호 | 앞에 공백이 와서는 안 된다.
  6. 각주의 경우 소괄호 2개를 붙여서 사용한다. 즉 ((각주의 내용)) 이런 식으로 사용한다.
  7. <html> </html>, <php> </php> 기호를 사용해서 HTML이나 PHP 문법을 거의 무제한으로 사용할 수 있다. 미디어위키가 별도의 기호 없이 html을 사용하며, html을 제한적으로만 지원하는 것과는 차이가 있다.
  8. 외부 이미지의 삽입이 자유롭다. 또한 이미지는 중괄호 2개를 이용해서 삽입한다. {{이름공간:파일명}} 이런 식으로 삽입이 가능하다. 또한 미디어위키와는 달리[1] 기본적으로 ogg 파일 등의 사운드 파일을 삽입할 수 있는 등 미디어위키에 비해 블로그 형식의 글을 작성하는 것이 유리하다.

3.2 백업[편집]

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

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

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

4 같이 보기[편집]

5 바깥 링크[편집]

6 각주

  1. Localsettings.php에 별도의 셋팅을 해야 한다.