문서의 이전 판입니다!

보리 OS 위키에 대해서

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

DokuWiki 설치하기

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

DokuWiki 다운로드

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

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

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

DokuWiki 압축 해제

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

tar xvfz dokuwiki-2011-05-25.tgz

DokuWiki 설정

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

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

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

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

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

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

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

설정 이름	한글 이름	설명
Superuser	슈퍼유저	관리자의 계정의 아이디를 설정해줍니다.
Real name	실제 이름	관리자의 실제 이름을 입력해줍니다. 위키 문서를 작성할 때 이 이름으로 문서가 작성됩니다.
E-mail	이메일	관리자의 이메일 주소를 설정해줍니다.
Password	패스워드	관리자 계정의 암호를 설정해줍니다.
once again	패스워드 다시 입력	관리자 계정의 암호를 한 번 더 입력해줍니다.
Initial ACL policy	초기 ACL 정책	아래 설명 참조

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

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

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

install.php 파일 삭제

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

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

위키 접속

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

처음 접속하면 기본 템플릿(스킨)에 아무런 문서도 없는 모습을 볼 수 있습니다.
이제 사용자에 맞게 DokuWiki의 환경을 설정해 주어야합니다.

DokuWiki 환경 설정

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

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

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

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

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

설정명	한글 이름	설명	권장 설정값
useheading	페이지 이름으로 첫 헤드라인 사용	페이지 이름을 파일명으로 할 것인지 위키 문서의 첫 제목으로 할 것인지 설정합니다. 기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리됩니다.	항상
sneaky_index	숨겨진 인덱스	사용자가 인덱스를 볼 때 볼 권한이 없는 문서는 인덱스에 표시되지 않도록 설정합니다.	True
fnencode	파일명의 인코딩	생성되는 파일명의 텍스트 인코딩을 설정합니다. utf-8로 하지 않을 시 한글로 된 파일명을 읽기 어려울 수 있습니다.	utf-8

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

플러그인 설치

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

플러그인명	기능
indexmenu	위키의 인덱스를 표시할 수 있도록 합니다. 여러 템플릿에서 이용 가능하기 때문에 유용합니다.

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 페이지에서 검색하실 수 있습니다.

템플릿(스킨) 변경

2013년 1월 26일 현재 DokuWiki 기본 스킨이 더욱 이쁜 관계로 기본 스킨을 사용하는 중입니다.
최신버전으로 업데이트하시거나 최근에 설치를 마치신 분들은 굳이 이 과정을 거치시지 않으셔도 됩니다.

DokuWiki의 기본 템플릿도 적응하면 쓸만하지만 아무래도 자주 사용한 사람이 아니라면 쉽게 사용하기 어려운 템플릿입니다.
따라서 새로운 템플릿을 적용해 줄 필요가 있습니다.

DokuWiki에 적용 가능한 템플릿들은 http://www.dokuwiki.org/template 이 링크에서 확인하실 수 있습니다.
적용 가능한 템플릿의 가짓수는 매우 다양하지만, 일반적으로 사용하기에는 위키피디아에서도 사용되고 보리 OS 위키에서도 사용되는 vector 템플릿이 가장 편리합니다.
이 문서에서도 vector 템플릿을 적용하는 방법을 안내할 것입니다.

먼저 http://www.dokuwiki.org/template 페이지에서 vector 스킨을 검색한 후 해당 페이지에 접속합니다.
또는 이 곳으로 접속하셔도 됩니다.

이 페이지에서는 vector 템플릿에 대한 다양한 정보를 얻을 수 있습니다.
다운로드를 받기 위해서는 [Download this Template]을 클릭하시면 됩니다.
다운로드 받은 파일을 위키 디렉터리의 lib/tpl 디렉터리에 압축을 풀어줍니다.

또한 해당 주소를 복사하여 서버에서 직접 다운로드 받아 바로 압축을 해제하는 방법도 있습니다.

cd lib/tpl
wget http://andreas-haerter.com/downloads/dokuwiki-template-vector/latest
mv latest vector.tar.gz
tar xvfz vector.tar.gz

다운로드 받은 템플릿 파일을 압축까지 해제하면 다시 관리 작업 페이지로 접속한 후 환경 설정 관리 페이지에 접속합니다.
그리고 template(한글명: 템플릿) 설정을 vector로 설정하고 [저장] 버튼을 누릅니다.
그러면 새로이 바뀐 템플릿이 적용된 환경 설정 관리 페이지가 나타납니다.

문서 및 네임스페이스 작성

DokuWiki의 문서 관리 방법

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

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

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

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

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

문서를 작성하시려면 기본적으로 검색창에 문서 제목을 입력하신 후 위의 메뉴에서 [Create] 버튼을 누르면 글 작성이 가능합니다.
그리고 특정 네임스페이스에 문서를 추가하려면, 네임스페이스:문서 제목을 검색하신 후, [Create] 버튼을 누르는 방법도 있습니다.
네임스페이스 이름을 작성하는 것이 귀찮다면 플러그인을 이용하는 방법도 있습니다.
자세한 내용은 http://www.dokuwiki.org/plugin:addnewpage 를 참조하세요.

¹⁾

물론 서버 및 PHP 설정이 완료되어 있어야 합니다. 이 부분에 대해서는 추후 자세히 설명드리겠습니다.

보리보리 쌀!

목차