도쿠위키

도쿠위키란?

도쿠위키는 독일에서 만들어진 설치형 위키이다. php로 되어있으며 DB가 아닌 파일기반이라 꽤 가볍고, 백업도 편리한 편. 현재 이곳(Elf'sNote)이 도쿠위키로 운영되고 있다.

도쿠위키의 장점

  • 정렬순서가 정해져 있는 게시판/블로그에 비해 리스트 순서를 내 마음대로 정할수 있다.1)
  • 링크로 확장되어 얼마든지 문서내용을 늘려나갈수 있다.2)
  • 손쉬운 마크업 언어로 키보드만으로 대부분의 작업이 가능하다다.3)
  • 좀더 페이지를 다양하게 꾸밀수 있다.
  • 테마가 꽤 많은 편이고, CSS로 변경도 편한 편.
  • 제로보드Xe에 비해 빠르다. 확실히!
  • 외쿡프로그램&웹서비스답게 플러그인이 많아서 기능확장이 편리하다.
  • 틀이 정해지지 않은 자유로운 글쓰기가 가능.
  • 가볍게 적고 얼마든지 확장해서 쓰는 게 가능하다.

도쿠위키의 단점

  • 마크업 언어에 대한 추가학습이 필요하다.(익히면 편하다. 익히면…)
  • 플러그인에 대한 추가학습 역시 필요하다. 귀찮지만 어쨌든 위지웍인 제로보드 애드온과는 차이가 있는 편.
  • 문서리스트를 정리해주지 않는다. 자유롭지만,그만큼 작업비용은 늘어난다.
  • 섬 문서도 생길가능성이 높다.

도쿠위키는 누가 좋아하는가?

아무래도 일반인보다는 텍스트편집 / 하드코딩을 좋아하는 사람들에게 맞는듯. 작업 난이도를 보자면…

위지웍<위키편집<하드코딩 정도인지라…

아무래도 위지웍에 익숙한 (글쓰기 일반인들이 쓰기 꽤 힘든 면이 있다. 그래서인지 도쿠위키 등을 사용하는 층을 보면, 대부분 프로그래머나 개발자가 많은 편이다.4) 꽤나 아쉬운 부분. 숲을 위키랑 연동시킬까 싶긴 한데.. 시린이라던가.. 받아들일지는 의문이다.

CMS로서의 도쿠위키

좋은 점은 편집을 통해 다양한 레이아웃을 자유롭게 만들수 있다는 점. 제로보드의 경우 레이아웃을 먼저 만들고, 거기에 컨텐츠를 채워넣는 감각에 가깝다면, 도쿠위키는 그자리에서 레이아웃과 컨텐츠를 같이 짜는 형태에 가깝다. 사실 그냥 html로 홈페이지 만들때랑 초큼 비슷한 느낌도 있다. Heading과 hr, 적절한 이미지를 사용하면 꽤 페이지가 예뻐져서 애용중.

왜 이곳은 도쿠위키를 사용하고 있는가?

엘프화가의 개인공간을 만들기위해 꽤 많은 시스템을 고려했었다. 해외사이트도 많이 뒤졌고. 그중 최후까지 고려되었던 것이 바로 도쿠위키와 제로보드. 그러나 점점 마음은 도쿠위키로 기울고 있다. 이미 모든 자료를 도쿠위키로 작업/정리 중. 그 이유중 하나는 파일기반이라는 점. 워낙 자주 서버를 폭파시키고 또 붙여넣고 하는 편이라… 쉽게 이전이 가능한 편이 좋다.(라기보단 X같은 제로보드이전에 지쳤다. 썅) 그래서 결국 파일기반의 도쿠위키를 시작.. 특히 컴퓨터내에서 사용할수 있는 Dokuwiki on Usb 로 기본데이터를 정리하면서 좀더 손쉽게 관리가 가능해졌다. 완전편해!!

참고링크

원래는 설치방법에 대한 글을 진행해볼까 했었는데… 찾아보니 도쿠위키에 관한 글이 꽤 많았다.. +ㅅ+ 내가 어설프게 잘난척 하면서 적는 것보다 좀더 잘 아시는 분들의 글들을 링크하는 게 나을 것 같아 정리해보았다.

쓸만한 플러그인

이곳에서 사용하는 플러그인들 정리. 끝에 적힌 작동방식은 내가 안까먹을라공.

  • Gallery: 폴더내에 이미지를 갤러리화해준다. 완전좋은게..걍 이미지만 media폴더에 던져넣으면 걍 뽑아준다.6)간략한 작동방식은 {{gallery>namespace}}
  • tag: 태그링크를 만들어줍니다. 원하는 곳에 삽입가능해서 꽤 편하다. {{tag>tag1 tag2}}
  • Disqus: 댓글서비스인 디스커스 플러그인을 달아준다. 사용방식은 ~~DISQUS~~
  • nspages: 현재 네임스페이스 하위글들을 출력해준다.게시판 형태로 만들기 좋다. 다만 설정방식이 좀 귀찮으니 요 세팅을 참고하자7) <nspages -title -simpleList -exclude -textpages="">
  • include: 다른 페이지 내용을 불러들이는 플러그인. 특정페이지일 경우 {{page>ns}} 특정태그 페이지의 경우 {{tagtopic>junk}}
  • pagemove: 페이지 위치를 바꿔줄뿐만 아니라, 관련 링크도 모조리 수정해준다. 완전좋다. 단 namespace변경시 묘한 버그가 있다;
  • wrap: 현재 Elfism.com 의 디자인을 책임지는 훌륭한 플러그인. 다양한 클래스의 div를 사용할수 있게 해준다. 사용방법도 무척 편리!wrap에 사용예제가 있으니 참고하자.
  • Indexmenu: 좌측의 트리메뉴를 만들어주는 플러그인. 예전에 한번 업데이트하다가 꼬이면서8) 잘 안나오다가 다시 잘나와서 사용중이다. 폴더는 title별 소팅이 안되는게 조금 아쉬운 점.
  • Task: 문서를 기반으로 할일리스트를 생성해주며 진행사항을 트래킹할 수 있는 플러그인. 이슈트래커로 쓸수 있다.
  • Todo : 문서 안에 체크리스트를 넣을 수 있는 플러그인. Task 와 혼용해서 쓰면 유용하다.
  • imgpaste : 클립보드의 이미지를 붙여넣기 하면, 업로드해주는 편리한 플러그인. 크롬에서만 되는 게 흠.
  • markdowku : 도쿠위키에서 아무런 제한없이 마크다운 언어를 혼용할 수 있다.마크다운 언어를 사랑하는 사람이라면 필수.

테마제작시 참고

템플릿 수정을 검토하면서 어떤식으로 적용가능한지 파악중이다. 기본적으로 php 문구를 간단히 삽입해서 사용가능 할듯.9)

몇가지 팁&트러블슈팅

  • 이미지섬네일이 엑박이 뜰 경우: 큰 이미지를 렌더링 못해서 생기는 문제. php.ini 에서 메모리리미트를 64→128로 수정하면 잘 뜬다.
  • FTP 등으로 이미지를 바로 올려서 관리가 가능하다. 다만, 소문자+영어정도로만 적어야 한다. 안그러면 인식못하는 듯.
  • \conf\acronyms.conf 파일을 수정하면 일종의 약어사전처럼 사용가능하다.
  • 페이지위치를 자주변경한다면 media폴더는 완전히 별개로 관리하는게 편하다.10) 또한 이미지를 넣을때는 절대주소로 넣는게 좋다.
  • 도쿠위키 새 템플릿에 대한 뒷이야기 :클릭
1)
라기보다 정확히는 리스트순서가 없다.ㄷㄷㄷ
2)
게시판 분류를 고민해야 하는 제로보드와는 다르죠.
3)
물론 마크업언어를 알아야 한다는 전제가 필요하지만, 그거 없어도 일반 글쓰기는 가능.
4)
나같은 디자이너는 없겠지..아마;;
5)
같은 의미에서 start.txt를 검색하셔도 꽤 나온다.
6)
제로보드 뻐큐머겅
7)
h1을 참고해 이름 출력. 심플리스트 형태로 출력 현재페이지 제외.큰타이틀제거
8)
제이쿼리문제였던듯
9)
잘 잊어먹으니 적어두자
10)
실제로도 별개다