DokuWiki 설정
대부분의 DokuWiki 기능들은 다양한 설정 옵션을 통해 설정할 수 있습니다. 이런 설정 옵션들을 가장 쉽게 변경하는 방법은 환경 설정 관리를 사용하는 것 입니다. 이 방법은 위키 관리자가 온라인으로 브라우저를 사용하여 위키 설정을 바꿀 수 있게 합니다.
'환경 설정 관리'를 시작하기 위해서는 관리자로 로그인 하고, '관리' 버튼을 클릭하세요.
설정할 수 있는 것
DokuWiki의 시스템 옵션은 conf/dokuwiki.php
파일에 있습니다. 그러나, 이 파일은 시스템의 “기본값”이 저장되어 있습니다. 설정을 변경할려면 conf/local.php
파일을 편집하거나 또는 이 파일이 없다면 만들어야 합니다. 이 파일에서 설정할 수 있는 옵션은 사용 가능한 옵션을 참조하세요.
사용자 이름과 (암호화된) 패스워드 그리고 접근제어규칙은 conf 디렉터리에 있는 users.auth.php 그리고 acl.auth.php에 저장되어 있습니다.
미디어 관리에서 새로운 파일을 업로드할 때 “업로드가 거부, 이 파일의 확장자는 허용되지 않습니다!”
라는 메시지를 볼 수 있습니다. 이 동작은 conf/mime.conf
파일에서 제어합니다. 새로운 종류의 파일을 업로드할려면 mime.conf 파일에서 정의하세요.
페이지를 편집할 때 내용의 일부는 자동 변환이 이루어집니다. 툴팁(tooltips), 스마일 문자 또는 특수 문자입니다. 이러한 동작은 acronyms.conf, smileys.conf 또는 entities.conf 파일에서 제어됩니다.
설정 파일들
Debian 패키지로 설치했을 경우 모든 설정 파일들은 ./conf
폴더 또는 /etc/dokuwiki
폴더에 있습니다.
“기본 파일”은 DokuWiki에 포함되어 잇지만, “로컬 파일” 들은 위키 관리자가 작성해야 합니다.
로컬 파일이 지원되면, 기본 파일 대신 로컬 파일을 편집해야 업그레이드 문제를 피할 수 있습니다.
기본 파일 | 로컬 파일 | 설정 종류 | 기본 내용 |
---|---|---|---|
dokuwiki.php | local.php local.protected.php | 아래 참조 | 일반적인 wiki 설정 |
acronyms.conf | acronyms.local.conf | abbreviations | 자동 약어 힌트 |
entities.conf | entities.local.conf | entities | 자동 변환 문자열 |
interwiki.conf | interwiki.local.conf | interwiki | interwiki 링크s |
mime.conf | mime.local.conf | mime | 업로드 MIME 타입설정 |
smileys.conf | smileys.local.conf | smileys | 텍스트 → 이미지 변환 |
acl.auth.php | acl 참조 | 접근 제어 설정 | |
users.auth.php | acl 참조 | 사용자와 암호 | |
license.php | license.local.php | license | 사용가능한 라이센스 목록 |
scheme.conf | scheme.local.conf | urlschemes | 링크로 인식되는 URL 구성표 |
mediameta.php | exif | 편집가능한 이미지 Metadata | |
wordblock.conf | wordblock.local.conf | blacklist | 스팸 블랙리스트 |
plugins.required.php | plugins.local.php plugins.protected.php | 아래 참조 | 플러그인 활성/비활성 |
userscript.js | javascript | 사용자설정 JavaScript 확장 | |
userstyle.css | css | 사용자설정 CSS 확장 |
테마 설정 파일
추가적인 설정 파일은 /var/lib/dokuwiki/lib/tpl/dokuwiki
에서 찾을 수 있습니다. (데비안), 예를 들어 style.ini
. Style.ini는 기본 테마파일이 읽어오는 텍스트 파일입니다. 그리고 사용자는 마음 내키는 대로 설정할 수 있습니다. (예:페이지의 배경 색상)
플러그인 활성/비활성
설치된 플러그인은 기본으로 사용 가능하도록 활성화 된다. 이것들은 플러그인 관리자를 사용하여 plugins.local.php
파일에 기록하여 사용할 수 없도록 비활성화 할 수 있다. conf/plugins.protected.php
에 기록하여 특정 플러그인을 보호하도록 할 수도 있다.
자동적으로 도쿠위키는 다음과 같은 순서로 해당 환경 설정 파일들을 로드합니다:
conf/plugins.php
– 기본 플러그인conf/plugins.local.php
– 플러그인 매니저에 의해 변경된 플러그인conf/plugins.required.php
– 플러그인 매니저로 변경할 수 없는 핵심 플러그인conf/plugins.protected.php
– 다른 파일에 우선 적용되는 설정
설정파일의 로딩 순서는 전역변수 $config_cascade
에 의해 제어됩니다. preload.php 파일을 사용하여 이 동작을 변경할 수 있습니다.
설정 옵션
[DokuWiki]]의 대부분 기능들은 다양한 설정 옵션을 통해 설정할 수 있습니다. 이러한 옵션을 변경하는 가장 쉬운 방법은 환경 설정 관리를 사용하는 것입니다.
사용가능한 설정은 아래에 나열되어 있습니다. 그것들의 기본 값은 conf/dokuwiki.php
파일에 저장되어 있습니다. 설정을 변경하기를 원한다면 conf/local.php
에서 변경해야 합니다. – 이는 이후 업그레이드에 의해 자신만의 설정이 변경되는 막을 수 있습니다. 환경설정 관리(config manager)에서도 이 파일을 사용할 수 있습니다. conf/local.protected.php
파일은 변경할 수 없는 환경 설정을 위해서도 사용할 수 있습니다.
여기에 conf/local.php
의 샘플이 있습니다.:
<?php $conf['title'] = "Admin's Wiki. "; $conf['useacl'] = 1; $conf['superuser'] = 'admin';
설정 파일에 대한 몇가지 주의사항입니다. 이 파일은 PHP 코드로 취급되므로 PHP 문법이 지켜져야 합니다. 예를 들면 줄 끝에 세미콜론(;)을 붙이는 것입니다. 변수에도 여러 형식이 있습니다.
- 숫자(Number) 는 그대로 쓸수 있습니다. 예:
9
- 문자열(String) 은 작은 따옴표(') 또는 큰 따옴표(“)로 묶어야 합니다. 예:
'foo bar'
- 부울(Boolean) 은
1
또는0
입니다. - 배열(Array) 은 위 형식 중 하나로 여러 값을 포함합니다.
이용 가능한 옵션
- 기본 설정
- 보기 설정
- 인증 설정
- Anti-Spam Settings
- 편집 설정
- 링크 설정
- 미디어 설정
- 고급 설정
- 네트워크 설정
번역
- english version: dokuwiki-2006-11-06.
jk Lee - real mail domain is gmail, not zoo.com for spam filtering 2007-2-4 created - english version: dokuwiki-2012-09-23. Nakky.H, 2012-10-5 created