설치형 위키위키로 설치와 설정, 기본 사용법이 간단하고 백업, 복구 등도 용이한데다가 사용자관리 및 문서 보호 기능을 기본적으로 탑재하고 있어 회원제나 완전 비공개 위키를 간단하게 만들 수 있다. 자료의 저장에 데이터베이스를 사용하지 않고 텍스트 파일을 사용한다. 데이터베이스를 사용하지 않기에 백업과 복원이 간편해서(파일만 보관하면 되기에…) 복잡한 MySQL 에 대한 지식이 없어도 관리할 수 있다.
도쿠위키는 원본문서의 기본 레이아웃이 보기도 편할 뿐더러 위키문법도 쉽고, 입력하기도 편하다. 1)
다운로드 페이지에서 다운로드 가능하다.1 .
구글링을 해보면 도쿠위키의 성능에 대한 비판적인 글들이 있다. 위키 비교사이트인 위키매트릭스에 보면 도쿠위키는 소형 위키에 적당하다는 문구가 떡하니 자리잡고 있다.
문서저장은 TXT문서로 한다. 보여줄 때에는 문법에 맞게 변환을 해서 HTML로 보여줘야 하는데 이 때 내부적으로 강력한 2단계 캐쉬기능을 쓴다. 즉, 미리 만들어 놓은 HTML을 보여준다. 문서 표시의 반응 속도는 매우 빠르다.
이 때문에 사용할 수록 캐쉬파일이 늘어난다. 2) 거대규모의 사이트 에서는 캐쉬파일을 가끔 정리해 주는 것이 좋다.
사실 느리다는 인식은 플러그인 중 특히 페이지의 목록을 만들거나 내용을 검색하여 결과를 만드는 플러그인들에 의해 생겼을 가능성이 많다. 성능이 중요한 대형 사이트들은 이러한 플러그인 들을 적절히 사용하는 것이 중요하다. 구글 맞춤 검색 (Cse)을 활용하는 것도 좋은 방법이 된다.
* 도쿠위키 초기설정 – 페이지, 템플릿, 플러그인, 내비게이션 * 예쁜 URL 사용하기 * 로고 바꾸는 법
http://openwiki.kr/wiki/tag/windows 와 같은 깔끔한 Url을 만들어 준다.
RewriteRule ^tag/(.*)$ doku.php?id=$1&do=showtag [QSA,L]
유지보수
문법 설명를 비롯한 모든 문서와 추가적인 정보들은 www.dokuwiki.org의 DokuWiki에서 유지관리된다.
도쿠위키에는 많은 플러그인이 있다. 플러그인을 설치, 제거하기가 매우 쉽다는 장점도 있다. 참조
다만, 다른 위키엔진들에서는 기본기능인데 도쿠위키에서는 플러긴을 설치해야 되는 것들이 있다.
웬만한 규모의 위키에서 꼭 필요하다고 생각되는 플러긴들.
해당 문서로의 링크를 가지고 있는 문서의 목록을 보여준다. 필수!
백링크(역링크) 표시 %%{{backlinks>}}%%
페이지 혹은 틀 가져오기. 유용하다. 필수!
{{page>[id]&[flags]}} {{section>[id]#[section]&[flags]}} {{namespace>[namespace]&[flags]}} {{tagtopic>[tag]&[flags]}}
페이지의 이름을 변경하고, 페이지의 위치(이름공간)을 변경할 수 있다. 이 때 문서의 속성이나 과거 수정이력등이 보존된다. 필수!
솔직히 이거 정말 기본적인 기능 아니냐? 그런데 최근까지도 제대로 작동하는 플러긴이 없었어. 없었다구.
페이지의 목록을 표시하는 기능의 플러긴이다. 다른 플러긴에서 많이 사용하므로 필수!
이미지를 앨범형식으로 표시할 수 있다.
문서에 꼬리표를 먹이고, 이에 따라 분류하거나 표시할 수 있다.
~~TAGCLOUD~~
표시할 때 느려진다
{{topic>이름공간?태그1}}명령어를 이용해서 해당 이름공간 안에 있는 태그만 불러오는 것도 가능하다.
옵션 값에는 nodate(날짜를 표시하지 않음), desc(본문 내용을 추가), nouser(글쓴 사람을 표시하지 않음) 등 pagelist 플러그인에 있는 flags를 이용해서 옵션을 추가할 수 있다.
정보 상자info
팁 상자tip
중요 상자important
경고 상자alert
도움말 상자help
다운로드 상자download
할 일 상자todo
{{changes>표시될 숫자}}로 사용 가능하다.
~~REDIRECT>namespace:page~~
특정 페이지를 다른 한 페이지로 옮기는 것은 같다.
차이점은 넘겨주기는 설정을 어드민 페이지(관리-문서넘겨주기)에서 한꺼번에 관리한다는 것이고 (관리자권한 필요), 문서 넘겨주기는 가짜 페이지를 만들고, 그 원본 페이지로 가는 넘겨주기 명령을 넣어줘야 하는 것이 다르다.
사용법은 관리자 페이지에 추가적인 플러그인-문서 넘겨주기 설정 페이지의 폼 안에 '옮길 문서 (스페이스바) 옮겨질 곳 문서'를 적어주면 된다.
각기 장단점이 있다. 둘다 설치하고 때에 맞춰 쓰면 된다.
넘겨주기에서 전체 이름공간을 넘겨주려면
action.php
에
$redirects = confToHash(dirname(__FILE__).'/redirect.conf');
와
if($redirects[$ID]){
사이에
$newID = ""; foreach ( $redirects as $mask=>$target ) { $regex_mask = '/^'.preg_replace( '/\*/', '(.*)', $mask ).'$/'; if ( preg_match( $regex_mask, $ID ) ) { $newID = preg_replace( $regex_mask, $target, $ID ); break; } } $redirects[$ID] = $newID;
를 추가해주면 될 것 같다..
글씨 크기를 적용할 수 있다. wrap으로도 글씨 크기와 색상을 적용할 수도 있지만 사용법을 몰라서 알고있는 사람이 있다면
사용법은 <fs 사이즈>글자</fs> 사이즈 부분에는 em, ex, %, px 단위로 사용가능하다. 그 이외에도 xx-small, x-small, small, medium, large, x-large, xx-large와 같은 키워드로도 가능하다.
예) <fs 2em>글자</fs> <fs large>글자</fs>
도쿠위키는 원래 한사람이 편집 중이면 다른 사람은 건드리지 못하게 하는 기능이 있어 충돌을 막는다. 접속자가 많은 대규모 위키의 경우 한 문서를 여럿이 동시에 편집하려는 경우가 생길 수 있다.
이 플러긴을 사용해서, 한꺼번에 여러 사람이 편집하고, 수정된 부분을 지능적으로 골라 합치도록 할 수 있다.
미디어 위키는 이러한 충돌을 자동으로 해결할 수 있는 기능이 일찍부터 있었고, 모니위키도 해당 기능이 추가되어 있다.
https://www.dokuwiki.org/plugin:imgpaste
안드레아 성님의 플러긴. 구글 크롬에서 ctrl-c
& ctrl-v
로 그림을 올릴 수 있게 된다.
생성될 파일이름을 설정할 수 있다.
@ID@:@USER@_%Y%m%d-%H%M%S
추천
글씨에 색상을 적용할 수 있게 만들어준다.(다른 위키는 기본 기능이지만)
사용법은 <color blue 또는 red 등>글씨</color>혹은 <color 색상코드>글씨</color>도 가능하다.
statdisplay에서 쓸 수 있도록 위키 접속에 대한 로그파일을 만들어 준다. 약간의 전체적인 성능저하 및 저장소 접속(HDD traffic)이 발생할 수 있다.
구글, 페이스북, 야후꾸러기 등의 계정으로 로그인 할 수 있다. 각 사이트에서 앱을 만들고 키를 발급받아야 한다.
도쿠위키 내부 정보를 표시해준다.
편집시에 도쿠위키 문법을 자동으로 검색하여 색깔을 입혀준다.
도쿠위키 기본설치로는 WysiWyg이 되지 않는다. 여러 위지윅플러긴이 있으나, 그냥 편하게 쓰기에는 위지윅보다는 구문강조정도가 좋다. 기본 편집기와 크게 다르지 않으면서 편리한 기능을 추가해준다. 다른 위지윅 플러긴 보다 완성도가 높다.
CodeMirror는 각종 컴퓨터 프로그램 코드를 웹상에서 쾌적한 환경으로 편집할 수 있도록 구축하는데 도움주는 자바스크립트 라이브러리이다. 전문 코드 편집기에 상응하는 문법 강조 및 코드 편집기능들을 제공함. 특히 다중 편집 모드를 지원하여 HTML + CSS + JavaScript 또는 HTML + PHP처럼 여러 언어를 복합적으로 편집할 때에도 문법을 강조할 수 있다. 사용할 수 있는 언어로는 JavaScript, XML/HTML, CSS, SPARQL, PHP, Python, Lua, Ruby, SQL 이 있으며, 크로스-브라우저를 지원함. 구글의 API 놀이터와 어스 KML 셈플러, 파이어버그 플러그인인 FireRainbow 등에서 CodeMirror를 이용한 편집기를 제공하거나 문법 강조기능을 활용하고 있다. 보다 자세한 사용법은 API 문서를 참조하라.
<표전체너비 첫번째열너비 두번째열너비...>
식이 된다.
보통 WRAP으로 감싸기 마련이니 전체 너비는 100%로 지정하고 고정해야할 너비만 지정해주면 나머지는 공간을 나눠서 배정한다.(브라우저가)9)
관리자 화면에서 도쿠위키를 새버전으로 업그레이드 할 수 있도록 해준다. 몇번의 클릭만으로 가능하다.
폰터스티본스 버전부터는 기본플러긴으로 포함되었다.
유튜브 동영상 삽입하기
list($vid,$param) = explode('?',$vid,2); if(preg_match('/(\d+)x(\d+)/i',$param,$m)){ // custom $width = $m[1]; $height = $m[2]; }elseif(strpos($param,'small') !== false){ // small $width = 300; $height = 168; }elseif(strpos($param,'large') !== false){ // large $width = 640; $height = 360; }else{ // medium 560x315 $width = 560; $height = 315; }
예를들어 게임이라는 이름공간에 i_template를 작성하면 게임/마인크래프트라는 이름공간에도 게임/마인크래프트/조합법 이라는 이름공간 그 하위까지 모두 i_template의 영향을 받는다. 하지만 게임이라는 이름공간에 c_template를 만들면 단지 게임 이름공간 안에 문서들에서만 적용된다.
요즘 위키는 그냥 엔터프라이즈 급은 미디어위키가 대세 이고, 개인위키들은 도쿠위키 (Dokuwiki), 기타 등등.. 이라.. 서로 간 문법에서의 타협이 이루어질 가능성은 없어 보이고, 공통분모가 생긴다면, 마크다운 (Markdown)정도로 되지 않을까 한다…그러니까.. 크레올레 자체가 망했다.
Anteater..