Cool URIs don't change
퍼머넌트한 permalink만들기
http://c2.com/cgi/wiki?TopTenWikiEngines (여기서 TwikiClone 이 TWiki이다.)
http://no-smok.net/nsmk/_c0_a7_c5_b0_bf_a3_c1_f8 (한글로 된 위키엔진 비교)

Cool URI로 주소를 표현할수 있도록, 소스 핵을 통해서든 플럭인을 통해서든 그 적용이 가능하고 쉬운것을 원했는데, 이 중에 KWiki는 플럭인을 통해서 Cool URL 행태로 주소적용이 가능했지만, 웹호스팅 서버의 설치에서 문제가 있어서 TWiki를 선택하게 됬다.

노모스크의 경우 한글 위키네임을 갖는 페이지의 주소를 http://no-smok.net/nsmk/_c0_a7_c5_b0_bf_a3_c1_f8 와 같은 식으로 풀어서 사용하는데, 이런 방식은 각 페이지마다 유추가능한 개별 주소를 갖는 원 위키체계에 비해, 결과적으로 그 의미를 살리지 못하는 주소체계로 보인다.

이에 반해 TWiki는 www.w3c.org 에서 말하는 Cool URI에서 가장 바람직(?)한 예로 들고 있는 주소표현 양식처럼, 파일 확장자나 ? 와 같은 표현을 완전히 감추고, 약간의 Tip만 이용하면, 위키엔진에 독립적인 주소형태로 표현이 가능하다는 점이 큰 장점이다.

개인위키로 사용하기에 무겁다거나 기능이 과다(?)하다는 의견이 있어서 처음엔 다른 엔진을 주목했었는데, 한글주소를 무리없이 해결해준다는(거기다 Cool URL구현이 약간의 꽁수로 무척 쉽게 된다는 점) 점에서 100점 만점을 주고 싶은 심정이다.

물론 무버블타입의 경우에 TWiki엔진의 포맷팅 Rule을 이용한 플러그인이 있다는 점도 큰 메릿이 아닐 수 없다.

위키를 설치 상태 그대로 두고만 있다. 시간날 때마다 조금씩 그 기능을 알아보고 새롭게 디자인을 바꿔서 적용해 봐야겠다. ( 현재론 TWiki이 제공하는 사용자인증(?) 기능을 이용해 아무나 Edit할 수없도록 설정된 상태라 직접 위키를 사용해 보실순 없습니다. )

http://alogblog.com/wiki/wiki/Main/환영합니다

Installation

• http://twiki.org/getpackage.html 에서 압축파일을 다운받는다.
• 서버의 웹루트( 예: www/ ) 아래에 twiki/ 등의 적당한 이름으로 폴더를 만들고 여기에 푼다.
• $ cd www/    # 이 부분의 작업은 Cool URL 적용을 위한 꽁수적용부분.
  $ ln -s twiki/bin wiki
  $ cd www/twiki/bin
  $ ln -s view wiki

Configuration

twiki/lib/TWiki.cfg 를 열고 몇가지 사항을 환경에 맞게 수정해준다.

• $defaultUrlHost   = "http://alogblog.com";
• $scriptUrlPath  = "/wiki";
• $dispViewPath  = "/wiki";
• $pubUrlPath  = "/twiki/pub";
• $pubDir  = "/home/.../www/twiki/pub";
• $templateDir  = "/home/.../www/twiki/templates";
• $dataDir  = "/home/.../www/twiki/data";
• $safeEnvPath = "/home/bin:/bin:/usr/bin"; # /home/bin 아래에 diff 가 있어서...
• $mailProgram = "/home/bin/sendmail -t -oi -oeq";
• $useLocale = 1;
• $siteLocale = "ko_KR.euckr";
• $siteCharsetOverride = "euc-kr";

twiki/lib/TWiki.pm 을 열고, 한글 위키URL에 문제가 있는 경우에 수정

•  $fullTopicName = Encode::encode( $charEncoding, $fullTopicName, &FB_PERLQQ ); 을, $fullTopicName = Encode::encode( $charEncoding, $fullTopicName ); 로 바꿔준다.

twiki/bin/setlib.cfg 를 열고, 펄모듈 경로를 설정해준다.

• $twikiLibPath = '/home/.../www/twiki/lib';
• $localPerlLibPath = '/home/.../www/perl-lib'; # 당장엔 값을 정하지 않아도 문제없는 듯. 다만 향후 플럭인을 설치하고 펄모듈을 사용자 계정아래에 둘 경우에 이 경로를 설정해줘야 문제가 없다. 이 경로는 자신의 계정밑에 개인적으로 설치한 펄모듈 라이브러리 폴더를 적어주면 된다. perl-lib이라는 값은 하나의 예일 뿐이다.

twiki/bin/.htaccess.txt 를 twiki/bin/.htaccess 로 이름을 바꿔준 후, 몇가지를 수정한다.

• SetHandler cgi-script
• AuthUserFile /home/.../www/twiki/data/.htpasswd
  AuthName 'Enter your WikiName: ...'
  AuthType Basic

twiki/data/.htpasswd 파일을 만들어 준다.

• $ htpasswd -c /home/...www/twiki/data/.htpasswd userid 하면, password를 묻는데 입력.
  htpasswd는 Apache 웹서버의 사용자인증을 이용하기 위해 비밀번호를 사용자별로 만들어 줄 때 사용하는 명령. 위키 페이지에서 Edit을 클릭하면 물어온다.

twiki/subdir-htaccess.txt 파일을 twiki/data, twiki/lib, twiki/templates 폴더 아래에 .htaccess 로 이름을 바꿔준 후, 복사해 넣는다.

브라우져의 주소창에, http: //mydomain/wiki/wiki/ 혹은 http: //mydomain/wiki/wiki/Main/WebHome을 입력해, 초기 화면이 뜨면 성공이다.

 IE에선 "URL을 강제로 UTF-8로 보내기"를 켜든, 끄든 상관없이 한글 위키페이지가 작동할 것이다. 그런데 Firefox에서도 작동은 잘 하지만, 한글URL이 URL Escaped된 형태(%AB%CD...)로 나타날 경우가 있다. URL이 UTF-8이 아닌 경우에 일어나는데(IE에선 상관없이 한글로 나타난다.) 이런 주소형태가 깔끔하지 못하다면, 아래처럼 브라우져 설정값을 바꿔주면 한글주소가 잘 나타난다.

주소창에 about:config를 치면 설정 항목이 쭉 나타난다. 여기서 network.standard-url.encode-utf8 을 true로(값 부분을 더블 클릭하면 됨), network.standard-url.escape-utf8을 false로 해주면, 한글 위키네임으로 된 페이지 주소가 한글로 깔끔하게 나타난다. ( 이 설정을 해주지 않아도 한글주소가 잘 적용된다. 다만 브라우져상에서 %AB%CD형태로 더티(?)하게 표현되는 것을 피할 표현상의 목적일 뿐이다.)

 TWiki를 Cool URL이 가능하고 브라우져상의 설정에 상관없이 작동되도록 설치하는 부분까지만 TWiki에 대해 조금 알 뿐, 그 실제 운용상의 제반 기능에 대해선 현재론 지식이 전무합니다.