install 

위킥스 설치법

• 필요한 프로그램
  • PHP 4.0.7 이상?: 4.0.6 이하 버전에서는 PCRE 관련함수에 버그가 있어서 몇군데 문제가 발생한다. http://bugs.php.net/bug.php?id=13635
  • PHP가 실행되는 웹서버: 보통 Apache
  • MySQL/PostgreSQL: PostgreSQL은 7.1 이상 버전을 권한다. 이전 버전에서는 한 페이지에 들어가는 글자의 양에 제한이 있었다.

1. MySQL/PostgreSQL에 자신의 계정과 DB를 만들고, 각각 $dbUser, $dbName이라 한다. 비밀번호는 $dbPass라고 하자.

2. 이제 DB에 테이블을 생성해야 한다. schema/mysql.sql, schema/psql.sql 파일이 각각 MySQL, PostgreSQL DB를 위한 스키마이다.
   See also CreatingDatabaseInMySQL

3. ./install.sh를 실행한다. 윈도환경일 경우는 다음 작업을 직접 해야 한다.
   1. mywikix 디렉토리를 생성하고 _mywikix 디렉토리의 모든 파일을 mywikix로 복사한다.
   2. mytheme 디렉토리를 생성하고 기본테마인 themes/wikix 디렉토리의 모든 파일을 mytheme으로 복사한다.
   3. file 디렉토리를 생성하고 chmod 1777 file을 실행한다(웹사용자가 파일을 생성할 수 있게).
   4. file0 디렉토리를 생성하고 chmod 1777 file0을 실행한다(웹사용자가 파일을 생성할 수 있게).
   5. tmpfile 디렉토리를 생성하고 chmod 1777 tmpfile을 실행한다(웹사용자가 파일을 생성할 수 있게).

4. mywikix/config.php 파일을 열어서 주요 변수들을 설정한다.
   1. $dbBack 값을 설정한다. PostgreSQL을 사용할 경우 pg, MySQL을 사용할 경우 mysql로 설정한다.
   2. $dbName, $dbUser, $dbPass 값을 설정한다. MySQL/PostgreSQL 서버가 별도로 있을 경우 그 서버의 이름을 $dbHost에 기입한다.
   3. $initIP 변수는 최초 wikiX를 초기화할 곳의 IP로 설정한다. 이 부분에서 실수가 많은데 wikiX가 설치된 서버의 IP가 아니라 최초 wikiX에 접속할 클라이언트쪽의 IP이다.
   4. $wikiXdir 변수에는 wikix 디렉토리가 위치한 절대경로를 지정한다. 링크된 디렉토리의 경우 링크되지 않은 실제 디렉토리를 설정한다.
   5. $adminAuthor, $adminPassword는 각각 관리자 ID, 비밀번호이다. 이 값을 원하는 값으로 설정한다. $adminPassword는 DB에 저장되는 값과 다르게 할 것을 권장하므로 임시 비밀번호라고 생각하자.
   6. 기타 변수는 선택사항이다.

5. 이제 IP가 $initIP인 곳에서 웹브라우저로 wikiX를 실행한다. 기본 페이지들이 추가된 후 mywikix/config.php 파일의 $initIP 변수를 다시 비운다. 이는 실수로 wikiX DB를 초기화하는 것을 방지하기 위해서이다.

6. 관리자 계정(mywikix/config.php 파일에서 $adminAuthor가 ID, $adminPassword가 비밀번호)으로 로그인한 후 바꿀 관리자 비밀번호를 아래 Logout 란에 입력하고 Logout을 한다. 반드시 비밀번호를 바꾸길 권장한다.
   • 관리자 로그인은 사용자 로그인과는 전혀 다른 곳을 클릭해야 나타난다. 좌측하단 조회수의 hit 또는 hits의 마지막 알파벳을 눌러야 된다. 사용자 로그인에 관리자 ID, 비밀번호를 입력해도 로그인되지 않는다.

7. \Calendar@ plugin을 통해 음력달력을 출력하고 싶으면 cd transdate; make를 실행한다.

이제 기본적인 설치는 끝났다. 확장하고 싶은 기능이 있을 경우 mywikix/config.php의 변수들을 수정하면 된다. 주요 파일들을 설명하면

1. mywikix/config.php: 말하면 입 아프다. ^^;
2. mywikix/package.php: wikiXextension 설치를 위한 파일
3. mywikix/header.php: wikiX의 문법이 적용되지 않는 출력머리말 파일
4. mywikix/footer.php: wikiX의 문법이 적용되지 않는 출력꼬리말 파일
5. mywikix/wikix.header: wikiX의 문법이 적용되는 출력머리말 파일(선택사항)
6. mywikix/wikix.footer: wikiX의 문법이 적용되는 출력꼬리말 파일(선택사항)

• mywikix/header.php, mywikix/footer.php 파일은 테마와는 별도로 개인적인 출력사항을 가진다.
• mywikix/wikix.header, mywikix/wikix.footer 파일은 모든 페이지에 적용될 wikiX 문법을 가진다. 개발자는 사용자 명령들을 여기에 모아둔다.
• mywikix/*er.php와 mywikix/wikix.*er 두 곳에서 모두 표현 가능한 부분일 경우 wikiX 파서에 부담을 주지 않는 mywikix/*er.php 파일에 둘 것을 권장한다. 개발자는 mywikix/wikix.*er 파일에는 사용자매크로만 두고 있다.

  ---

  주요 파일