보리 OS 위키는 DokuWiki를 기반으로 운영되고 있습니다.
DokuWiki는 파일 기반 위키 엔진으로 서버 이전이나 데이터 수정 및 백업이 쉬운 장점이 있으며, 다양한 플러그인과 템플릿을 제공하는 것 또한 강력한 장점입니다.
기타 상세한 정보는 DokuWiki 공식 홈페이지를 참고하시기 바랍니다.
DokuWiki는 윈도 및 리눅스 등 다양한 OS에서 설치가 가능합니다. 우리는 우분투 리눅스에서 DokuWiki를 동작시키고 있습니다.
이 문서에서도 우분투 리눅스에서 DokuWiki를 설치하는 과정을 설명할 것입니다.

DokuWiki 공식 설치 매뉴얼은 http://www.dokuwiki.org/Install 에서 확인하실 수 있습니다.

먼저 http://www.splitbrain.org/projects/dokuwiki 에서 DokuWiki를 다운로드받습니다.
다운로드는 stable 버전과 non-stable 버전 두 가지를 제공하는데 안정적인 위키 운영을 위해서는 stable 버전을 이용하심을 추천합니다.
리눅스에서는 wget 명령어를 이용하여 터미널 상에서 직접 설치 파일의 다운로드가 가능합니다.



2011년 5월 25일부로 DokuWiki의 최신 버전이 업데이트되었습니다.
위키의 작성 시점이 이 이전이기 때문에 스크린샷의 날짜와 일치하지 않습니다. 이 점 참고해 주시기 바랍니다.

wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25.tgz

다운로드가 완료되면 압축을 풀어주어야 합니다.
DokuWiki는 파일 기반 위키이기 때문에 압축만 풀어주고 약간의 권한 설정만 해 주면 바로 사용이 가능합니다.¹⁾
압축을 풀기 위해서는 tar 명령어를 이용합니다.

tar xvfz dokuwiki-2011-05-25.tgz

위키 내부 파일들의 정상적인 작동을 위해 압축 푼 파일들의 권한을 모두 755로 설정해줍니다.

chmod -R 755 dokuwiki-2011-05-25/

그리고 웹 브라우저를 통해 해당 디렉터리 내에 있는 install.php로 접속합니다.

만일 접속 시 권한 에러가 발생한다면

chmod -R 777 dokuwiki-2011-05-25/

명령어를 이용하여 권한을 777로 조절해주어야합니다.


오른쪽 위의 [Choose your language:] 목록에서 설정을 ko로 설정해주시면 한글로 페이지를 보실 수 있습니다.

• ACL - Access Control List
  • 위키 문서의 접근 및 권한 정책을 설정합니다.
  • Initial ACL policy 설정으로 초기의 위키의 정책을 설정할 수 있습니다.
    • 개방형 위키 : 아무나 위키 문서를 읽고 쓰고 생성할 수 있도록 합니다.
    • 공개형 위키 : 아무나 위키를 읽을 수 있지만 등록된 사용자만 위키 문서를 쓰거나 생성할 수 있도록 합니다.
    • 폐쇄형 위키 : 등록된 사용자만 접근이 가능하도록 합니다.
  • 이 설정은 추후 각 문서 및 분류별로 개별 변경이 가능합니다.

하단의 [Please choose the license you want to put your content under:] 설정에서는 작성되는 위키 문서들의 라이센스를 지정해 줄 수 있습니다.
각 라이센스 뒤에 [?] 링크를 따라가시면 해당 라이센스가 어떠한 것을 의미하는지 보실 수 있습니다. 참고하시고 위키의 목적에 맞게 지정해주시면 됩니다.

모든 설정이 완료되었으면 [저장] 버튼을 누릅니다.
잘못된 설정이 없다면 아래와 같은 완료 화면이 나타납니다.

설정이 완료되었으면 더 이상 install.php 파일이 필요하지 않습니다.
DokuWiki 디렉터리에서 해당 파일을 삭제합니다.

cd dokuwiki_dokuwiki-2011-05-25
rm -f install.php

[새로운 DokuWiki.] 링크를 눌러 생성된 위키로 접속합니다.
앞으로 위키에 직접 접속하시기 위해서는 DokuWiki를 설치한 경로의 doku.php로 접속하시면 됩니다.



처음 접속하면 기본 템플릿(스킨)에 아무런 문서도 없는 모습을 볼 수 있습니다.

문서를 작성하시기 전에 DokuWiki의 위키 문서 관리 방법에 대해 간단히 알아두면 더욱 손쉽게 관리가 가능합니다.

DokuWiki는 위에서 언급했다시피 파일 기반으로 운영됩니다.
즉, 하나의 디렉터리를 네임스페이스(분류)로 취급하고, 그 안에 있는 하나의 파일을 하나의 위키 문서로 취급합니다.
구조를 간단히 표현하면 아래와 같습니다.

• Namespace1 (Dir)
  • start.txt
  • document1.txt
  • document2.txt
  • SubNamespace1 (Dir)
    • start.txt
    • document1.txt
  • SubNamespace2 (Dir)
    • start.txt
    • document1.txt

네임스페이스 및 위키 문서는 디스크 용량이 존재하는 한 개수에 제한 없이 얼마든지 생성할 수 있습니다.

그리고 하나의 네임스페이스 안에는 하나의 시작 문서가 존재할 수 있는데, 이 문서의 파일명은 기본적으로 start.txt로 지정되어 있습니다. 시작 문서는 해당 네임스페이스를 대표하는 문서가 됩니다.
시작 문서가 존재하지 않을 경우 몇 가지 단점이 있기 때문에 반드시 만드시는 것을 추천합니다.

기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리되지만, 설정을 통해 시작 문서의 첫 제목이 해당 네임스페이스의 파일명이 되도록, 문서의 첫 제목이 해당 문서의 제목이 되도록 바꾸어 줄 수 있습니다.
이것을 포함해 먼저 DokuWiki의 설정을 바꾸어보도록 하겠습니다.

설정을 위해 관리자 계정으로 로그인하여야 합니다. 접속된 페이지에서 [로그인] 버튼을 누릅니다.



처음에 설정했던 관리자 계정과 암호를 입력하여 로그인합니다.



로그인에 성공하면 이전에는 없던 [관리] 버튼을 보실 수 있습니다. [관리] 버튼을 클릭해 관리 작업 페이지로 접속합니다.



먼저 DokuWiki의 시스템을 설정해주어야 합니다. [환경 설정]에 들어갑니다.



환경 설정 페이지에서는 다양한 설정값들을 변경해 줄 수 있습니다. 이 중에서 미리 변경해주어야 하는 것들은 아래와 같습니다.

위 3개 정도의 설정만 바꾸어주어도 DokuWiki를 사용하는 데 큰 지장은 없습니다.
추후에 다른 설정을 바꾸실 때 이 곳을 이용하시면 됩니다. 각각의 설정에 대한 자세한 설명은 각 설정의 영문명을 클릭하시면 보실 수 있습니다.
맨 아래 [저장] 버튼을 누르면 설정이 저장됩니다.

이제 다시 관리 작업 페이지로 되돌아간 후 필요한 플러그인들을 설치해줍니다. 기본적으로 설치해주어야 할 플러그인은 아래와 같습니다.

indexmenu 플러그인을 설치하는 과정을 소개하겠습니다. 다른 플러그인 설치 또한 이와 같이 작업해주시면 됩니다.
http://www.dokuwiki.org/plugin:indexmenu 페이지에 접속해 [Download the Plugin] 링크에 연결되어있는 파일 주소를 복사합니다.



그리고 관리 작업 페이지로 이동한 후 플러그인 관리자 페이지로 이동합니다.



[URL]에 복사한 주소를 복사한 뒤 [다운로드] 버튼을 누르면 자동으로 설치가 진행됩니다.
2011년 5월 31일 현재 최신 버전의 다운로드 링크는 http://samuele.netsons.org/dokuwiki/media/indexmenu.zip 입니다.



이제 플러그인의 설치가 완료되었습니다. 다른 플러그인 또한 비슷한 방법으로 설치해 주시면 됩니다.
필요한 기능이 있으면 http://www.dokuwiki.org/plugins 페이지에서 검색하실 수 있습니다.

작업중입니다……