이 페이지는 설치설명서를 초보자들이 알아보기 쉽게 일부 수정하여 만든 페이지입니다. 모니위키와 관련한 상세한 내용들이나 새로 Release 되는 버전 등은 모두 개발 홈페이지에서 확인할 수 있습니다. 이 페이지는 헌터D가 PuzzletChung님과 안용열님의 도움으로 만들었습니다.

1 모니위키를 cafe24에 설치하기 #

1.1 모니위키란? #

모니위키는 PHP라는 프로그래밍 언어로 짜여진 위키엔진입니다. (위키엔진이라는 것은 위키위키를 웹에서 쓰기 위해 필요한 프로그램을 말하는 것입니다.) 기존의 다른 위키엔진에 비해서 가볍기도 할 뿐더러 블로그나 다른 용도로 확장하기 편한 장점을 가지고 있습니다. 2003년 8월 10일 공개되었으며 아직 일부분 버그가 있을 수도 있지만, 개선된 버전이 속속 나오고 있습니다. 2004년 11월 12일 현재 1.0.9.1 버전까지 공개된 상태입니다. 자유소프트웨어이며 GPL을 따르는 프로그램입니다.

더 상세한 내용은 모니위키 개발 홈페이지에서 확인할 수 있습니다.

1.2 설치전 준비물 #

먼저 설치하기 전 준비물을 알아볼게요.

1. FTP프로그램이 있어야 합니다. 파일을 업로드/다운로드 하기 쉽기 때문에 많이 쓰는 프로그램이죠. 알FTP가 많이 쓰이죠? 어떤 종류라도 상관없습니다.
2. 인터넷에 연결된 컴퓨터가 있어야 합니다. 지금 이 화면을 보고 있다면 그건 준비된 거에요.

1.3 프로그램 다운로드 #

자 이제 본격적으로 시작해 봅시다.

http://moniwiki.sourceforge.net/wiki.php/MoniWiki에서 최신 버전을 다운 받습니다.

1.4 자신의 계정으로 올리기 #

이 파일을 자신의 계정으로 FTP 프로그램을 이용해서 업로드 합니다. cafe24에서는 ftp://(자신의아이디).cafe24.com/가 자신의 계정입니다. 업로드 한 후에 telnet을 이용해 이 파일의 압축을 적절한 곳에 풉니다.

telnet을 실행하는 방법은 화면 왼쪽 하단에 보이는 시작 -> 실행을 차례로 클릭한 다음 나오는 창에 telnet:// (자신의아이디).cafe24.com를 입력하면 로그인 창이 뜹니다. 아이디와 비밀번호로 로그인 하신 후 ls 라는 명령어를 입력한 후 엔터키를 치면 자신의 계정에 무엇이 있나 확인할 수 있죠. 이전에 다른 홈페이지를 설치한 적이 없다면 www 라는 폴더와 그 아래에 폴더가 하나 정도 있을 겁니다.

1.5 리눅스 기본 명령어 #

여기서 잠깐! 다음은 설치에 필요한 리눅스 명령어 입니다. 리눅스를 몰라도 설치는 할 수 있습니다. 그러나 최소한 기본 리눅스 명령어 몇 개는 알아야 합니다.

1. ls (도스 명령어에서 dir에 해당하는 것입니다. 이 명령어로 하위폴더와 폴더 안의 파일을 확인할 수 있습니다.)
2. cd (디렉토리를 바꾸는 명령어입니다.)
3. pwd (지금 있는 디렉토리의 절대경로를 알 수 있는 명령어입니다.)
4. tar (압축을 푸는 명령어 입니다.)

혹시 더 필요한 명령어가 있다면 검색엔진을 통해 리눅스 기본명령어 라고 검색하시면 쉽게 구하실 수 있을 겁니다.

1.6 압축을 풀어 설치하기 #

아까 FTP 프로그램으로 업로드한 파일을 다음 명령어로 적절한 곳에 풉니다.

$ tar xzvf moniwiki-1.0.x.tgz (x는 해당 버전을 의미합니다.)

위 명령어로 압축을 풀면 moniwiki라는 디렉토리 밑에 화일들이 있는 것을 볼 수 있습니다. 디렉토리 이름을 원하는 것으로 바꿀 수도 있습니다. 예를 들어 /wiki라고 바꿀 수 있으며 기본 값은 /moniwiki입니다.

1.7 기본 설정하기 #

1. FTP프로그램을 이용하면 monisetup.sh 파일의 위치를 확인할 수 있습니다. 위 순서를 따라오셨다면 http://(자신의아이디).cafe24.com/moniwiki/monisetup.sh가 될 것입니다. 웹브라우저에 전체 경로를 직접 입력하여 실행시킵니다. (monisetup.sh를 실행하여 디렉토리의 쓰기권한을 조정합니다. 이렇게 하여야 MoniSetup.php를 실행시킬 수 있게 됩니다.)
   
   
   
2. 다음은 웹브라우저 주소창에 마찬가지로 전체 경로를 직접 입력하여 MoniSetup을 실행시킵니다. http://(자신의아이디).cafe24.com/moniwiki/MoniSetup.php (처음 설치할 경우 MoniSetup을 이용해서 config.php를 만들게 됩니다. 여기서 가장 중요한 것은 $url_prefix를 고치는 것입니다. 이 값은 초기에 자동으로 설정되며, 이 값을 제대로 지정하면 MoniSetup에서 로고 그림을 볼 수 있습니다.)
   
   
   
3. 처음 실행하면 monisetup.php가 자동으로 뜨며 자신의 환경에 맞는 config.php를 가 만들어집니다. 다시 monisetup.php를 열면 필요한 몇몇 디렉토리가 만들어집니다.
   
   
   
4. MoniWiki를 처음 설치할 경우는 WikiSeed를 심을 것인지를 선택합니다. (WikiSeed는 모니위키를 운영할 때 도움이 될만한 페이지들의 묶음을 의미합니다.) 씨앗을 심는 경우는 불필요한 페이지가 들어갈 수 있는데, 어느 정도 익숙해졌다고 생각되면 지워도 무방한 페이지입니다.
   
   
   
5. 처음 설치할 때 관리 비밀번호 $admin_passwd를 반드시 설정해 주세요
   
   
   
6. secure.sh를 실행합니다. monisetup.sh와 monisetup.php와 동일한 방법입니다.(secure.sh를 실행해서 다른 사람들이 자신의 Wiki 설정을 볼 수 없게,고칠 수 없게 하는 것입니다.)
   
   

1.8 RCS 설치하기 #

MoniWikiRcs 페이지를 참고하십시요.

아래 내용은 중급자 이상에 해당하는 내용이므로 초급자라면 설치 이후에 천천히 손봐도 됩니다.

1.9 고급 설정하기 #

1.9.1 자동개행 #

config.php에서

$auto_linebreak=1;

으로 해 주시면 자동개행이 켜집니다.

1.9.2 관리자외의 사용자가 페이지 지우기 #

초기 설정으로 DeletePage등 몇몇 기능이 잠겨 있습니다. 이를 풀기 위해서 wiki.php 파일을 수정해야 합니다.

   $protected_actions=array(

      "deletepage","deletefile","rename","rcspurge","rcs","chmod","backup","restore");

위 부분에서 "deletepage", 부분을 삭제하면 관리자를 제외한 다른 사용자도 페이지를 지울 수 있습니다.

주의할 점은 이 기능이 참여의 폭을 넓힌다는 점에서 긍정적인 면이 있지만 테러의 대상이 될 수도 있다는 것입니다. 그러므로 페이지를 삭제할 때 백업본을 감추는 것이 좋습니다. wikilib.php 파일을 열어서 function do_post_DeletePage에서 아래 부분을 삭제하거나 앞에 #을 달아서 주석처리해 주시면 삭제는 가능하되 백업본은 남아있게 됩니다.

print _("with revision history")." 

";

고급 설정하기 아래 부분은 안용열씨의 홈페이지에서 뜯어왔습니다.

1.9.3 OeKaki 설치 #

모니위키 1.0.5 이상 버전에서는 /applets/OekakiPlugin 에서 make install 하면 그냥 깔린다는 정보가 있습니다. 만약 이 방법이 안되면 http://hp.vector.co.jp/authors/VA016309/paintbbs 로 가서 file 디렉토리에 pbbs222_5.zip를 다운 받아서 받아서 해당 폴더에 풀면 됩니다.

1.9.4 트레일(히스토리) on #

config.php에 $trail=1;를 추가하면 사용가능합니다.

1.9.5 테마 #

config.php에

$theme='테마이름';

$theme_css=1;

을 추가하면 원하는 테마를 기본으로 지정하여 사용할 수 있습니다.

1.9.6 검색엔진 #

모니위키의 기본 설정은 로봇이 긁지 못하게 하는 메타 태그를 쓰도록 되어 있습니다. (NOINDEX,NOFOLLOW) wiki.php에서 NOINDEX로 검색하여 그 줄을 주석처리 하면 검색엔진이 위키 페이지도 검색합니다.

See also : MoniWikiAdjustments MoniWikiTips

설치가 끝났습니다. 이제 위키위키를 즐기세요.

1.10 기타 주의사항 #

1. MoniSetup을 실행시킬 때, $admin_passwd를 설정하면 자신만 DeletePage할 수 있습니다. 이 값을 설정하면, 차후에 MoniSetup을 할 때 이 값을 알아야 고칠 수 있으며, config.php에 이 값이 들어가므로 수동으로 고칠 수 있습니다.
   
   
2. $rcs_user의 기본 값은 "root"이나, 위키를 처음 설치할 경우는 이 값을 조절할 수 있습니다. 한번 결정한 후에는 이 값을 계속해서 써야합니다.
   
   
3. /etc/php.ini에서 register_globals = On이라고 되어있어야 OeKaki가 정상 작동합니다.
   
   

1.11 관리 #

업그레이드를 편리하게 하려면, 플러그인을 새로 추가할 경우는 원 파일을 고치는 것보다는 새롭게 플러그인을 만들어 주는 것이 낫습니다. 이렇게 하면 tar파일을 덮어쓰는 것만으로 간단히 업그레이드 할 수 있습니다.

1.12 업그레이드 #

특별한 경우가 아니라면, 덮어쓰는 것만으로 업그레이드 할 수 있습니다. 원 파일을 수정하였을 경우라면 덮어쓰는 것을 선택적으로 해주어야 합니다.
기존의 data디렉토리는 전혀 덮어씌여지지 않습니다. 하지만 업그레이드 하기 전에는 data/text 디렉토리의 내용을 백업해 두는 것이 좋을 것입니다.

1.13 백업 #

root사용자라면 tar를 이용해서 간단히 백업할 수 있겠고, 호스팅을 하는 일반 사용자의 경우라면 backup restore를 액션을 이용할 수 있습니다.