install 

위킥스 설치법

  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의 문법이 적용되는 출력꼬리말 파일(선택사항)