======= 도쿠위키 디렉토리 ====== {{tag>도쿠위키}} [[doku>|도쿠위키]] 디렉토리에 관한 내용이다. ===== Main Window ===== 이 페이지는 DokuWiki와 함께 제공되는 기본 템플릿을 사용하는 페이지의 레이아웃을 설명합니다. 추가 템플릿 테마 를 설치하여 페이지의 모양을 변경하고 사용자 지정할 수 있습니다 . DokuWiki 페이지는 네 부분으로 나뉩니다. 맨 위에는 페이지 머리글, 탐색 이동 경로, 페이지 콘텐츠 및 바닥 글이 있습니다. {{ :wiki:dokuwikimainwindow.png |}} ===== dokuwiki ===== 도쿠위키가 동작하는 모듈과 데이터가 존재하는 디렉토리이다. ==== bin ==== * conf : 환경설정 파일이다. * users.auth.php : 사용자 로그인 정보((패스워드는 암호화 되어 있다))가 저장되어 있다. * mime.conf : 업로드를 허용하는 파일 리스트를 지정한다. * dokuwiki.php : 도쿠위키를 처음 실행시 사용자에게 보여주는 기본 설정을 한다. * local.hp : 사용자가 설정한 위키 기본 셋팅값이다. * data : 사용자가 작성한 위키 데이터가 들어있는 저장소이다. * media : 사용자가 업로드한 외부나 첨부 파일을 저장한다. * pages : 사용자가 작성한 위키 페이지 파일을 저장한다. * inc ==== lib ==== * plugins : [[:플러그인]]이 설치되는 경로((플러그인을 수동으로 설치하려면 설명서에서 지정한 이름으로 변경하고 이 경로에다가 복사를 하고 아파치를 재실행하면 된다.)) 이다. * tpl : [[:템플릿]]이 저장되는 장소이다. ==== vendor ==== * doku.php * feed.php * index.php * install.php * .htaccess.dist * COPYING * README * VERSION ===== DokuWiki 설정 ===== 대부분의 DokuWiki 기능들은 다양한 설정 옵션을 통해 설정할 수 있습니다. 이런 설정 옵션들을 가장 쉽게 변경하는 방법은 [[plugin:config|환경 설정 관리]]를 사용하는 것 입니다. 이 방법은 위키 관리자가 온라인으로 브라우저를 사용하여 위키 설정을 바꿀 수 있게 합니다. '환경 설정 관리'를 시작하기 위해서는 관리자로 로그인 하고, '관리' 버튼을 클릭하세요. ==== 설정할 수 있는 것 ==== DokuWiki의 시스템 옵션은 ''conf/dokuwiki.php'' 파일에 있습니다. 그러나, 이 파일은 시스템의 "기본값"이 저장되어 있습니다. 설정을 변경할려면 ''conf/local.php''파일을 편집하거나 또는 이 파일이 없다면 만들어야 합니다. 이 파일에서 설정할 수 있는 옵션은 [[#available options|사용 가능한 옵션]]을 참조하세요. 사용자 이름과 (암호화된) 패스워드 그리고 접근제어규칙은 conf 디렉터리에 있는 [[acl|users.auth.php 그리고 acl.auth.php]]에 저장되어 있습니다. 미디어 관리에서 새로운 파일을 업로드할 때 ''"업로드가 거부, 이 파일의 확장자는 허용되지 않습니다!"''라는 메시지를 볼 수 있습니다. 이 동작은 ''conf/mime.conf'' 파일에서 제어합니다. 새로운 종류의 파일을 업로드할려면 [[mime|mime.conf]] 파일에서 정의하세요. 페이지를 편집할 때 내용의 일부는 자동 변환이 이루어집니다. 툴팁(tooltips), 스마일 문자 또는 특수 문자입니다. 이러한 동작은 [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] 또는 [[entities|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'' |[[config: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'' |[[devel:javascript]] | 사용자설정 JavaScript 확장 | | |''userstyle.css'' |[[devel:css]] | 사용자설정 CSS 확장 | ==== 테마 설정 파일 ==== 추가적인 설정 파일은 ''/​var/​lib/​dokuwiki/​lib/​tpl/​dokuwiki''에서 찾을 수 있습니다.​ (데비안), 예를 들어 ''​[[devel:​style.ini]]''​. Style.ini는 기본 테마파일이 읽어오는 텍스트 파일입니다. 그리고 사용자는 마음 내키는 대로 설정할 수 있습니다. (예:페이지의 배경 색상) ===== 플러그인 활성/비활성===== 설치된 플러그인은 기본으로 사용 가능하도록 활성화 된다. 이것들은 [[plugin:extension|플러그인 관리자]]를 사용하여 ''plugins.local.php''파일에 기록하여 사용할 수 없도록 비활성화 할 수 있다. ''conf/plugins.protected.php''에 기록하여 특정 플러그인을 보호하도록 할 수도 있다. 자동적으로 도쿠위키는 다음과 같은 순서로 해당 환경 설정 파일들을 로드합니다: - ''conf/plugins.php'' -- 기본 플러그인 - ''conf/plugins.local.php'' -- 플러그인 매니저에 의해 변경된 플러그인 - ''conf/plugins.required.php'' -- 플러그인 매니저로 변경할 수 없는 핵심 플러그인 - ''conf/plugins.protected.php'' -- 다른 파일에 우선 적용되는 설정 설정파일의 로딩 순서는 전역변수 ''$config_cascade''에 의해 제어됩니다. [[devel:preload|preload.php]] 파일을 사용하여 이 동작을 변경할 수 있습니다. ==== 설정 옵션 ==== [DokuWiki]]의 대부분 기능들은 다양한 설정 옵션을 통해 설정할 수 있습니다. 이러한 옵션을 변경하는 가장 쉬운 방법은 [[plugin:config|환경 설정 관리]]를 사용하는 것입니다. 사용가능한 설정은 아래에 나열되어 있습니다. 그것들의 기본 값은 ''conf/dokuwiki.php'' 파일에 저장되어 있습니다. 설정을 변경하기를 원한다면 ''conf/local.php''에서 변경해야 합니다. -- 이는 이후 업그레이드에 의해 자신만의 설정이 변경되는 막을 수 있습니다. 환경설정 관리(config manager)에서도 이 파일을 사용할 수 있습니다. ''conf/local.protected.php'' 파일은 변경할 수 없는 환경 설정을 위해서도 사용할 수 있습니다. 여기에 ''conf/local.php''의 샘플이 있습니다.: 설정 파일에 대한 몇가지 주의사항입니다. 이 파일은 PHP 코드로 취급되므로 PHP 문법이 지켜져야 합니다. 예를 들면 줄 끝에 세미콜론(;)을 붙이는 것입니다. 변수에도 여러 형식이 있습니다. * **숫자(Number)** 는 그대로 쓸수 있습니다. 예: ''9'' * **문자열(String)** 은 작은 따옴표(%%') 또는 큰 따옴표(%%")로 묶어야 합니다. 예: ''%%'foo bar'%%'' * **부울(Boolean)** 은 ''1'' 또는 ''0''입니다. * **배열(Array)** 은 위 형식 중 하나로 여러 값을 포함합니다. ==== 이용 가능한 옵션 ==== * **기본 설정 ** * [[config:title]] * [[config:startpage|start]] * [[config:lang]] * [[config:template]] * [[config:license]] * [[config:savedir]] * [[config:basedir]] * [[config:baseurl]] * [[config:dmode]] * [[config:fmode]] * [[config:allowdebug]] * **보기 설정** * [[config:recent]] * [[config:breadcrumbs]] * [[config:youarehere]] * [[config:fullpath]] * [[config:typography]] * [[config:dformat]] * [[config:signature]] * [[config:showuseras]] * [[config:toptoclevel]] * [[config:tocminheads]] * [[config:maxtoclevel]] * [[config:maxseclevel]] * [[config:camelcase]] * [[config:deaccent]] * [[config:useheading]] * [[config:refcheck]] * **인증 설정** * [[config:useacl]] * [[config:autopasswd]] * [[config:authtype]] * [[config:passcrypt]] * [[config:defaultgroup]] * [[config:superuser]] * [[config:manager]] * [[config:profileconfirm]] * [[config:rememberme]] * [[config:registernotify]] * [[config:disableactions]] * [[config:sneaky_index]] * [[config:auth_security_timeout]] * [[config:securecookie]] * ** Anti-Spam Settings ** * [[config:usewordblock]] * [[config:relnofollow]] * [[config:indexdelay]] * [[config:mailguard]] * [[config:iexssprotect]] * ** 편집 설정 ** * [[config:usedraft]] * [[config:htmlok]] * [[config:phpok]] * [[config:notify]] * [[config:subscribers]] * [[config:locktime]] * [[config:cachetime]] * ** 링크 설정 ** * [[config:target|target (wiki, interwiki, extern, media, windows)]] * ** 미디어 설정 ** * [[config:gdlib]] * [[config:im_convert]] * [[config:jpg_quality]] * [[config:fetchsize]] * ** 고급 설정 ** * [[config:updatecheck]] * [[config:userewrite]] * [[config:useslash]] * [[config:sepchar]] * [[config:canonical]] * [[config:fnencode]] * [[config:autoplural]] * [[config:mailfrom]] * [[config:compress]] * [[config:cssdatauri]] * [[config:gzip_output]] * [[config:hidepages]] * [[config:send404]] * [[config:compression]] * [[config:sitemap]] * [[config:rss_type]] * [[config:rss_linkto]] * [[config:rss_content]] * [[config:rss_update]] * [[config:recent_days]] * [[config:rss_show_summary]] * [[config:broken_iua]] * [[config:xsendfile]] * [[config:remote]] * [[config:remoteuser]] * [[config:renderer_xhtml]] * [[config:readdircache]] * ** 네트워크 설정 ** * [[config:​dnslookups]] * [[config:​jquerycdn]] * [[config:proxy|proxy (host, port, user, pass, ssl)]] * [[config:safemodehack]] * [[config:ftp|ftp (host, port, user, pass, root)]] ===== DokuWiki 템플릿 ===== 일종의 스킨과 같은 기능으로, 이곳 [[nme>]]의 디자인 스킨은 한국인이 제작한 [[https://www.dokuwiki.org/template:white]]을 토대로 만들어졌다. (토대로 만들어졌을 뿐, 하도 뜯어고쳐서 달라진 부분이 더 많다;;;) 새로운 템플릿을 만들어 [[:DokuWiki]]의 디자인을 커스트마이징할 수 있다. 템플릿은 PHP와 CSS 파일들로 ''/lib/tpl/'' 디렉토리에 저장된다.(실제로 템플릿은 HTML로 만들어지며, 그 내용 안에 PHP가 사용된다.) ==== 시작 ==== 출발점으로 새로운 템플릿을 만드는 가장 쉬운 방법은 이미 만들어진 템플릿을 가져오는 것이다. 스타트 템플릿(starter template)은 안전하고 Dokuwiki의 템플릿 표준을 따르므로 이것을 사용하는 것은 좋은 아이디어이다. - 스타트 템플릿(starter template)을 설치한다. - ''lib/tpl/starter'' 디렉토리를 ''lib/tpl/yourname'' 으로 변경한다. - 설정관리자(configuration manager)에서 새로운 템플릿을 선택한다. - 그 다음 템플릿 파일을 살펴본다. ([[#디렉토리 구조]] 참조) - 도쿠위키가 [[devel:css|CSS dispatcher]]를 이용하여 어떻게 [[CSS]]를 처리하는지 살펴본다. - 설정을 구성하는 방법은 플러그인과 유사하다. 사용자정의 템플릿의 설정을 얻을려면 tpl_getConf()을 사용한다. 템플릿이 안정화되면 도쿠위키 템플릿 페이지에 등록할 수 있다. ===템플릿 이름 규칙=== A 유효한 템플릿 이름 (디렉토리): * a-z and 0-9 문자만 사용해야 한다. * 마침표 ''.'', 줄표 ''-''와 밑줄 ''_'' 은 사용할 수 **없다** : * 도쿠위키의 인프라스트럭처는 그것을 어디에서도 지원하지 않는다. * 밑줄 ''_''의 사용은 역시 0의 인기평가를 준다. * 만약 동일한 이름이 서로 다른 두 템플릿에 의해 사용되면 * 그것들은 상호 배타적이고 호환되지 않으며 * 나아가 그들 중 하나만 dokuwiki.org의 템플릿 홈페이지를 가질 수 있다. ** [[devel:template_info|template.info.txt]]에 고유한 필드 값(즉, 템플릿 이름)이나 또는 이름을 덮어 쓸 수 있는 기존의 템플릿으로 하는 것이 중요하다.** ==== 디렉토리 구조 ==== 템플릿은 아래의 디렉토리 구조(모든 경로는 템플릿 디렉토리를 기준으로)를 따라야 한다. 모든 CSS파일은 ''[[CSS#style.ini]]''에 명시되지만 적어도 화면 프리젠테이션과 인쇄용으로 각각 하나의 CSS파일이 필요하다. * ''/lib/tpl/