[도쿠위키] 문서생성

사용환경

  • 운영체제 : 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. [도쿠위키] 도쿠위키 설치

01. 시작하기 전에…

이제 본격적으로 도쿠위키라는 훌륭하지만 쪼~~금 쓰기 어려운 놈을 어떻게 사용하는지 적어볼까 합니다. 솔직히 거의 대부분은 도쿠위키의 공식위키에서 배울 수 있는 것이지만, 공식위키는 조~~금 불친절합니다. 그래서 저는 조금 친절하게 위키를 사용하는 방법에 대해서 설명하고자 합니다. 이 괜찮은 것을 다른 많은 사람들이 사용할 수 있었으면 해서요…

솔직히 도쿠위키 공식위키보다는 체계적으로 작성될 것 같지는 않지만… 최대한 노력해보려고 합니다.

02. 시작페이지

도쿠위키에서는 처음으로 열리는 시작페이지가 start 문서입니다. 개인의 취향이나 필요에 따라서 이 부분은 관리 – 환경설정 – 시작 페이지 이름에서 변경이 가능합니다. 저의 경우에는 대부분 그냥 두고 쓰는 편입니다.

03. 문서생성법

도쿠위키에서 새로운 문서를 생성하는 방법에는 두 가지가 있습니다.

  1. 검색으로 생성
  2. 기존문서에서 내부링크로 문서생성

일단은 검색창에 원하는 문자열을 입력한 다음에 해당 검색결과로 문서를 만드는 방법이 1번 검색으로 생성하는 방법입니다. 그리고 기존 문서의 내용에 새로운 문서에 대한 링크를 만든 후에 해당 링크를 클릭하여 해당 경로로 문서를 만드는 방법이 2번입니다.

이제 예를 들어가면서 차근차근 하나씩 설명하도록 하겠습니다.

04. 검색으로 문서생성하기

도쿠위키를 설치한 직후의 기본 템플릿(일종의 스킨같은..)은 검색창이 우측 상단에 위치하고 있습니다. 해당 검색 창에 원하는 문서의 이름을 입력합니다.(한글도 무관합니다.) 저의 경우에는 “심플리즘“을 입력했습니다.

좌측 상단에 [[심플리즘]]이라고 써있는 부분이 이제 만들 문서의 이름입니다. 만약에 기존에 심플리즘이라는 이름으로 만들어졌던 문서가 있다면, 결과에 일치하는 페이지 이름에 검색결과로 나올 것 입니다. 하단의 페이지 만들기를 누르면, 이제 페이지를 편집할 수 있는 화면으로 넘어갑니다.

기존의 다른 블로그나 게시판과 유사한 형태의 입력폼이 출력이 됩니다.(각 메뉴에 대한 설명은 추후에 하도록 하겠습니다. 문법과 관련된 부분에서…) 여기에 “안녕하세요“를 입력하고 저장하겠습니다.

입력한 “안녕하세요“가 저장이 되었습니다. 이렇게, 원하는 문서이름으로 내용이 저장되었습니다.

05. 내부링크를 통한 문서생성

위키 우측상단에 위키의 이름으로 정한 심플리즘의 위키를 클릭해서 start 페이지로 이동합니다. 이제 start 페이지를 편집해서 비어있는 내부링크를 만든 뒤에 해당 링크를 이용해서 새로운 문서를 만들어보도록 하겠습니다.

아직 start 페이지는 생성하지 않았기 때문에… 이 토픽은 아직 없습니다라고 나옵니다. 하단의 페이지 만들기를 클릭해서 페이지 생성을 합니다.

위 처럼 입력을 해봅니다. 도쿠위키에서 [[….]]으로 싸여진 것은 링크로 변환이 됩니다.(위키문법입니다. 앞으로 이러한 문법들을 많이 보실 수 있을 것입니다. 처음에는 어려워도… 익숙해지면, 위키가 아니면 사용하기 싫어지게 됩니다;;;)

참고) 비교를 위해서 위에서 검색을 통해서 만들어진 문서의 링크([[심플리즘]])와 새로 만들 문서의 링크([[심플리즘2]])를 같이 만들어봤습니다. 이미 만들어져있는 문서의 링크의 경우는 녹색으로, 아직 없는 문서의 링크는 붉은 색으로 표시가 됩니다.

심플리즘이라고 표시된 링크는 이미 위에서 검색창을 통해서 만든 문서의 링크이므로 녹색으로 표시가 되었습니다. 해당 링크를 클릭하면 아까 만들어진 문서로 이동하게 됩니다. 그렇지만 심플리즘2는 아직 문서가 없기에 붉은 색으로 표시가 되어 있습니다.

이제 심플리즘2라고 되어있는 링크를 클릭합니다.

아까와 같이 아직 문서를 만들기 전이라서… 이 토픽은 아직 없습니다라고 출력이 됩니다. 하단의 페이지 만들기를 누르면 아까 만들었던 심플리즘이라는 문서와 마찬가지로 페이지를 편집할 수 있는 화면으로 이동합니다. 그 화면에서 원하는 내용을 입력하고 저장하면 심플리즘2라는 문서가 생성이 되는 것입니다.

06. 마무리

이 처럼 도쿠위키에서 문서를 만드는 방법은 이 두 가지 방법이 있습니다. 문서를 작성하다보니… 위키문법을 먼저 포스팅할 껄… 이라는 생각과 혹시라도 이 포스팅을 보실 분들이 자신의 웹계정이나 개인서버에 설치하시기 전에 연습할 공간을 만드는 것이 어떨까… 라는 생각입니다.

그래서 아예 제 개인서버 내에 공개용 위키를 만들려고 생각하고 있습니다. 단, ACL 정책을 어떻게 할 지는 약간 고민입니다. 아예 공개용으로 만들었을 경우에.. 혹시라도 광고용 글들로 도배가 되버릴까봐…;;

어찌되었든 이제 슬슬 도쿠위키를 주제로하는 포스팅을 계속 해보도록 하겠습니다.

07. 참고문서

http://www.dokuwiki.org/ko:dokuwiki