[도쿠위키] 연습용 위키생성 및 템플릿 변경

사용환경

  • 운영체제 : CentOS 5.5 Final
  • 커널버전 : Linux 2.6.18-194.26.1.el5 i686 GNU/Linux
  • 아파치버전 : httpd-2.2.3-43.el5.centos.3
  • PHP버전 : php-5.1.6-27.el5_5.3
  • 도쿠위키버전 : dokuwiki-2010-11-07 “Anteater

연관포스트

  1. [도쿠위키] 도쿠위키 설치
  2. [도쿠위키] 문서생성

01. 시작하기 전에…

지난 번에 도쿠위키에서 문서를 생성하는 법에 대한 포스팅을 하고나서… 이렇게 포스팅만 올릴 것이 아니라 실제로 다른 사용자들이 써볼 수 있는 연습용 위키를 만들어두면, 다른 사용자들이 실제로 써보고 자신의 문서시스템으로 활용할 지 말지를 보다 쉽게 결정할 수 있을 것이라고 생각을 했습니다.

그래서 넷북으로 구동 중인 개인서버 내에 연습용 위키를 생성하였습니다. 그리고 템플릿은 제가 가장 선호하는 템플릿으로 변경해뒀습니다.

연습용 위키의 주소는 http://server.simplism.kr/test/입니다.

02. ACL 정책

이 부분을 고민을 많이 했습니다. 도쿠위키의 초기 ACL 정책은 아래와 같습니다.

  • 개방형 위키 : 누구나 웹브라우저를 통해서 글작성/변경/업로드가 가능합니다. 이 ACL 정책으로 하게 되면… 아무래도 스팸으로 위키가 범벅이 될 것 같다는 생각을 했습니다.
  • 공개형 위키 : 누구나 읽을 수는 있지만 등록된 사용자만이 글작성/변경/업로드가 가능합니다. 문제는 가입을 해야되는 것이고, 가입절차를 없애기 위해서 테스트용 아이디와 비밀번호를 공개하는 방식으로 해도 문제는 없을 것 같긴합니다만… 장난스러운 사용자가 비밀번호를 변경해버리면 실제로 테스트를 해보려는 분이 테스트를 못 해볼 수도 있다는 우려가 있었습니다.
  • 폐쇄형 위키 : 공개형 위키와 마찬가지로 테스트용 계정을 생성하고 관리해야하는 문제점이 있습니다.

제가 번거롭겠지만, ACL 정책은 개방형으로 선택했습니다. 스팸으로 도배가 되면… 제가 삭제를 해주면 되므로..ㅋ 이 부분에 대해서는 테스트를 위한 사용자분들이 가장 편리하게 사용해볼 수 있는 개방형 ACL을 채택했습니다.

03. 템플릿 선정

도쿠위키에는 default라는 가장 기본적인 템플릿을 지원하고는 있습니다만… 저의 경우에는 기본 템플릿은 약간 불편한 점이 있어서… 대부분의 제 위키들(개인적인 용, 공개용 등등 다수의 도쿠위키를 설치해서 운용하고 있습니다.) 대부분이 dokubook이라는 템플릿을 사용하고 있습니다.

장점으로는 각 단계의 헤더의 처리가 가장 마음에 들고… A4용지로 출력했을 시에도 가장 마음에 드는 출력물을 보여주기 때문입니다.

사실 템플릿 변경에 대한 부분은 추후에 다룰 예정이었지만… 생각해보니 저의 경우에도 가장 맨 도쿠위키를 설치하고서 느꼈던 부분은 조악한 기본 템플릿이 너무 불편해서 템플릿부터 변경했던 경험이 있어서 템플릿 변경의 포스팅을 조금 앞으로 옮겨봤습니다.

http://www.dokuwiki.org/template로 접속을 합니다. 해당 페이지에서 마음에 드는 형태의 템플릿을 선택하시면 됩니다.

04. 템플릿 설치

이제는 선택한 템플릿을 다운로드합니다. 제가 선택한 템플릿은 dokubook입니다. http://www.dokuwiki.org/template:dokubook를 클릭하면 바로 이동하실 수 있습니다.

이제 해당 페이지에서 템플릿 파일을 다운로드 받도록 하겠습니다. current stable version이라고 표시된 template-dokubook.tgz를 다운로드받습니다.(하단에 wget을 이용하는 방법이 있는데… 안되서;;; 어쩔 수 없이 다운로드 한 다음에 업로드해야 하는 군요;;)

FTP를 이용해서 다운받을 파일을 서버로 업로드합니다. root가 아닌 일반사용자로 로그인했으므로… 일단 제 홈디렉토리 내에 파일을 업로드 해뒀습니다. 이제 나머지는 ssh를 이용해서 작업을 하도록 하겠습니다.

<strong># cd /var/www/html/<span style="color: #ff0000;">[도쿠위키 설치한 디렉토리]</span>/lib/tpl</strong>

일단, 템플릿을 위치할 디렉토리로 이동합니다. lib/tpl 내에 템플릿 파일을 넣어두면 템플릿 사용이 가능합니다. 이제는 제 홈디렉토리 내에 있는 template-dokubook.tgz 파일을 복사해와서 압축만 풀어주면 끝입니다.

<strong># cp /home/</strong><span style="color: #ff0000;"><strong>[계정명]</strong></span><strong>/template-dokubook.tgz .</strong>

이제는 복사해온 template-dokubook.tgz 파일의 압축을 해제합니다.

<strong># ls</strong>
default  index.php  template-dokubook.tgz
<strong># tar zxf template-dokubook.tgz</strong>
<strong># ls dokubook/</strong>
COPYING                conf                           images                     rtl.css
README                design.css                   lang                         script.js
VERSION               detail.php                    layout.css                 style.ini
_admin.css            dokubook_design.css    main.php                  style.ini.dist
_linkwiz.css            dokubook_layout.css    media.css                  tpl_functions.php
_mediaoptions.css  dokubook_print.css      mediamanager.php
_subscription.css    footer.html                  print.css

정상적으로 압축을 해제하였습니다. 이제는 웹브라우저 상에서 템플릿을 변경해주시면 됩니다.

05. 템플릿 적용

이제는 설치한 템플릿을 도쿠위키에 적용하도록 하겠습니다. 하단의 버튼 중에서 관리라고 써있는 버튼을 클릭합니다.

이제 환경 설정을 선택합니다.

환경 설정 내의 기본설정을 보면… 템플릿을 선택할 수 있는 콤보 박스가 있습니다. 해당 박스를 dokubook으로 변경해줍니다.

이제는 설정을 적용합니다. 저장을 위해서 해당 설정 페이지의 가장 하단으로 내려갑니다.

가장 하단의 저장을 선택하면 설정이 적용됩니다.

설정이 적용되었습니다. 이전의 템플릿에 비해서 많이 이뻐진(?) 것을 확인할 수 있습니다.

06. 마치면서…

이제부터는 이 템플릿 상태로 도쿠위키에 대한 포스팅을 하려고 합니다. 앞으로도 도쿠위키에 대한 포스팅을 기대해주시고… http://server.simplism.kr/test/를 접속하시면, 앞으로 포스팅할 내용이지만 위키 문법을 연습하고 실제로 사용해볼 수 있습니다. ACL 정책은 개방형으로 선택해뒀으니… 인증과정 필요없이 누구나 문서작성, 문서변경, 업로드가 가능합니다.

실제로 사용해보시면서 자신의 문서시스템으로 적용을 고려해보시면 될 것 같습니다.

일반적으로 이곳저곳 옮겨다니면서 문서를 작성하시는 분이나 저 처럼 여러가지 운영체제를 사용하는 분들에게는 도쿠위키가 나쁘지 않은 선택입니다.(물론 숙달될 때까지… 조금 시간이 걸립니다.)

07. 참고문서

  1. http://www.dokuwiki.org/template:dokubook