{{keywords>도쿠위키 제작, dokuwiki install}}
{{indexmenu_n>1}}
====== 도쿠위키 제작 일지 =======
=====도쿠위키 설치=====
++++쥔장의 경우|
**기본적으로 html을 알며, php가 어떤 것인지는 알아야 한다. [[https://www.xpressengine.com|제로보드]], [[http://sir.co.kr|그누보드]] 를 설치해 보았다는 전제하에 이 글은 시작된다.**
도쿠위키는 일단 ftp / 리눅스 / 퍼미션이니 하는 것들의 설정....
그 딴 거 없다. (하지만 ftp는 쓸 수 있어야 하고 알아야 한다. 편집자 본인은 오로지 alftp만 고집해왔던지라그거밖에 쓸 줄 몰ㄹ) 오히려 초보자들에게는 도움이 될 수 있지 않을까 싶다. 아울러 삽질 & 시간 낭비를 조금이라도 덜 하기를 바라면서)
[[http://aldn.altools.co.kr/setup/ALFTP533.exe?_ga=2.243232714.950434905.1529468924-210445421.1529468924 | alftp 다운로드]] 이제는 공식 다운로드도 막혀 버린 alftp이지만 그래도 나는 이게 젤 편하다.
[[https://www.dokuwiki.org/dokuwiki|여기서]] 최신버젼을 다운받아 압축 풀어서 걍 ftp로 업로드만 하고 경로로 접속만 하면 끝!!!
세상 간단하다. 물론 설치 전에 내가 쓰고 있는 호스팅서버(윈도우,리눅스 같은 운영체계에 설치해서 사용하는 것은 배제한다.)의 php 버젼''(PHP는 버전 5.6 이상이어야 하지만 최신 버전을 적극 권장합니다.)'' 등은 확인해야 한다. [[doku>ko:install|참조]]
모바일 홈페이지도 그냥 만들어진다. 그거 하나 만들어 보겠다고 XE에서나 요즘 유행하는 반응형 홈페이지 feat. [[go>wordpress]] / [[https://www.makenow.kr]]<- 쉽고 빠르고 간편하게 반응형 홈페이지를 만들겠다면 이거 추천 / 따위를 열심히 기웃거렸던 나는 뭐지 ;;;
하지만 문제는 그 다음에 있으니~ ;;;
++++
==== 우선 다운로드 ====
[[https://www.dokuwiki.org/dokuwiki|도쿠위키 최신 다운로드]]
++++ 도쿠위키를 다운로드 받으십시오|
{{ :wiki:install.png?nolink |}}
{{date>%y.%m.%d.}} 기준 Hogfather 버젼이 최신 (안정된 것을 위해 나는 중간 버젼을 다운 받았다.) / 언어 선택은 걍 ko(한글)을 받아도 되는데 다 체크가 되어 있는 버젼을 받는다. (괜한 욕심) / 플러그인도 걍 다 체크해서 기본 포함이 되어 있는 것으로... (껴주는 옵션이 편리한거다. 본인은 혼자 쓰는 위키로 만들 것이니 맨 위에 capcha 는 뺀다.)++++
====도쿠위키 처음 설정====
ftp의 경우 : 업로드 해주면 된다. 시간이 좀 걸리더라. (다른 일 보고 오기를 추천) / 도메인 경로로 접속하면 된다. 안 되면 install.php 붙여서 접속해보고, 폴더 권한설정 777로 해보고, 그래도 에러메시지나 페이지 없음 어쩌구 뜨면 내가 사용하고 있는 업체의 php 버젼을 확인하라~
==== 환경설정 ====
테마 등을 바꾸기 위해서는 ''./conf/dokuwiki.php'' 이 파일을 수정해야 한다.
++++한글 버젼으로 하고 테마를 변경하기 위해|
/* Basic Settings */
$conf['title'] = 'DokuWiki'; //what to show in the title
$conf['start'] = 'start'; //name of start page
$conf['lang'] = 'ko'; //your language
$conf['template'] = 'white'; //see lib/tpl directory
$conf['tagline'] = ''; //tagline in header (if template supports it)
$conf['sidebar'] = 'sidebar'; //name of sidebar in root namespace (if template supports it)
$conf['license'] = 'cc-by-nc-sa'; //see conf/license.php
$conf['savedir'] = './data'; //where to store all the files
$conf['basedir'] = ''; //absolute dir from serveroot - blank for autodetection
$conf['baseurl'] = ''; //URL to server including protocol - blank for autodetect
$conf['cookiedir'] = ''; //path to use in cookies - blank for basedir
$conf['dmode'] = 0755; //set directory creation mode
$conf['fmode'] = 0644; //set file creation mode
$conf['allowdebug'] = 0; //allow debug output, enable if needed 0|1
++++
이렇게 수정해주었다.
==== 메인페이지의 수정 ====
어찌보면 가장 중요한 껍데기(스킨)에서의 핵심 파일이 바로 :!:''main.php'' 파일이다. 스킨을 적용해주고, 그 나머지 디자인과 기능들은 이 파일의 수정을 통해 지금 보고 있는 디자인이 모두 이루어진 것이다.
경로 : ''./lib/tpl/white/main.php''
++++main.php 소스|
[]
++++
**{{date>%A:%y.%m.%d}}** 수정 백업
====도쿠위키 꾸미기====
===Plugin===
[[doku>plugin]] 은 도쿠위키라고 하는 신차에 달리는 옵션이라고 할 수 있다. 플러그인의 기능에 따라서는 스마트폰의 앱만큼이나 기능이 없는 기기에 날개를 달아준다고도 볼 수 있다. 하지만, 여기에도 무분별한 플러그인의 설치는 에러 메시지 출력을 보게 될 수 있으니 꼭 필요한 기능을 위주로, 내 도쿠위키 버젼과 호환성(되도록 너무 오래된 플러그인은 깔지 말자) 및 다른 플러그인 설치 및 충돌에 대한 설명을 잘 읽어보고 설치하자.
== 설치할 때 포함되어 있거나 함께 받을 수 있는 기본 옵션 플러그인 ==
:!: **용법에 관해서는 [[wiki:위키문법#논외의 플러그인을 통한 구문 문법]]에 정리를 해놓고 있다.**
*포함되어 있는 플러그인({{date>%y.%m.%d}} hogfather 버젼 기준
- 플러그인 확장 관리자 : [[doku>plugin:extension]] 번거롭게 ftp로 접속해서 폴더로 업로드를 안 해도 검색과 설치를 편하게 해주는 플러그인이다. 편리한만큼 플러그인이 에러 메시지를 출력하면 답이 없다. ;;;; 해결법이 있는지 모르겠지만 ftp로 접속해서 걍 설치했던 플러그인 폴더를 지워야 한다. 플러그인을 설치할 때 신중하자.
* 다운로드할 때 체크해서 받을 수 있는 플러그인 (활용도를 볼 때 필수 플러그인이다)
- 업그레이드 플러그인 : [[doku>plugin:upgrade]] 도쿠위키 엔진을 쉽게 업그레이드 시킬 수 있는 플러그인
*추가하고 있는 플러그인 (깔았다가 필요 없으면 결국 정리할 것이다.)
-플러그인 추가 : 폴더 [[doku>plugin:folder]] 이곳을 먹여 살리고 있는 플러그인이다. 사용법도 단순.
-플러그인 추가 : 키워드 [[doku>plugin:keywords]] {{keywords>키워드추가,}}
-{{date>%y.%m.%d}} 플러그인 추가: <- 글머리에 이거
-날짜형식 삽입 ''코드 : ''{{% A : % d. % m. % y}}> [[doku>plugin:date]] 날짜 삽입 플러그인
-{{date>%y.%m.%d}} 플러그인 추가 : 검색폼 넣기 ''코드 : ''{searchform}[[doku>plugin:searchform]] 내부 검색이 필요해서 깔았는데 그닥 ;;
[[https://www.dokuwiki.org/ko:plugins#%EC%83%88%EB%A1%9C%EC%9A%B4_%ED%94%8C%EB%9F%AC%EA%B7%B8%EC%9D%B8_%EC%95%84%EC%9D%B4%EB%94%94%EC%96%B4| 플러그인 리스트 목록]]으로 되어 있는 전체 플러그인 리스트이다.
===template===
현재 이곳에 적용되어 있는 템플릿은 white 템플릿이다. [[doku>template:white]]
한국사람이 제작했으며 (예제 스샷이 아이유이다~), 매우 깔끔하고 단순하며 그래서 모바일에 더더욱 이점이 있다. (하지만 데스크탑용에는 기능이 너무 없으며 단순해서 기능을 하나 추가하려면 무진장 애먹어야 한다.. ㅡㅡ;;;) 괜찮아, [[nme>]]는 모바일 최적화이니까 ;;;
=== 백업 및 복구 ===
모든 글의 데이터는 txt 파일로 저장되는 것이 도쿠위키의 특징이자, 장단점이다. (백업 복구가 간편하다)
폴더의 위치도 간단하다. ''./data/pages'' 이곳에 저장된다.
====도쿠위키 글쓰기====
===도쿠위키만의 문법===
[[nme>wiki:위키문법]] 참조
====좀 더 나만의 홈페이지를 만들고 싶어====
===대문 : start===
===좌측 메뉴 : sidebar - indexmenu : plugin ===
{{date>%y.%m.%d}} **현재 지금까지도 가장 애를 많이 먹고 있는 부분이다.**앞으로도? ㅠㅠ
:!: 플러그인 [[doku>plugin:indexmenu]] 이것을 사용해서 현재 왼쪽의 메뉴를 구성하고 있다. 도쿠위키에서 메뉴 구성은 좀 특이한데 좌측의 메뉴처럼 폴딩 - 트리 구조의 메뉴를 만드려면 플러그인을 통해서 구현할 수가 있다. (하지만 도쿠위키 처음 디자인만큼이나 기본으로 제공하는 것은 투박함 ;;;) 플러그인을 설치한 후, sidebar 라는 처음부터 만들어져 있던 페이지에 코드를 작성하면 그 페이지가 메뉴 페이지가 되는 형식이다. 메뉴 편집은 사이드바 페이지를 편집하면 된다. 어찌보면 매우 효율적인 시스템이긴 한데.. 원하는대로 구성하려면 쉽지가 않다. ㅜㅠ
===오른쪽 글쓰기 메뉴 : tools===
====목차 구성 : toc====
**아주 긴 싸움이었다. 목차....**
-일단 지금의 형태는 왼쪽 sidebar 속에 넣었다. 20.08.28
++++소스|
./lib/tpl/white/main.php 수정
++++
-그리고 페이지를 열었을 때 목록이 펼쳐져 있지 않고 접혀 있도록 옵션을 수정해서 넣었다. (대신 첨에 접속하면 심하게 떨린다 ;;;) [[http://disabu.egloos.com/3058213|참조]] 본인이 사용하는 white 템플릿에서는 scripts.js 파일에 구문이 생략되어 있다. 쩝... 그래서 2번 방법을 사용. ''lib/scripts/page.js'' 파일을 수정 ''dw_page.makeToggle('#dw__toc h3','#dw__toc > div',-1);'' -1만 끝에 붙여서 수정했다. 그리하야 덤으로 페이지 접속할 때 진동을 느낄 수 있게 되었다.
====도쿠위키 Directory 구성====
[[https://www.dokuwiki.org/development|고오급 단계 편집]]
[[wiki:도쿠위키_디렉터리_구조]]
이곳은 도쿠위키라는 위키사이트로 제작되었다. 도쿠위키는 영문이다. 젝일, 내가 영어를 더 공부하던가 해야지. 네이버에서는 검색하면 아이돌 글들만 딸려 나온다. 네이버 쓰렉~ 결국 구글링인데~ 구글 자동번역하면 코드 명령어까지 같이 번역된다. 아놔... 빵부스러기 ;;;
그리하야~ 길고 긴 오딧세이 여정을 거치게 된 결과물들이다. 한글로 된 도쿠위키 정보들이 참 귀하다. ㅡㅜ 설치는 쉽다. 참 쉽다. 하지만 플러그인이 없으면 옵션없는 깡통 차에 불과하고, 디자인은 테마를 쓰면 되는데 당최 수정이 어렵다. ㅡㅜ
====내부적인 꾸미기====
=== interwiki 항목 편집 ===
**편집에 참고한 문서들**
[[doku>interwiki]] [[doku>tips:interwiki_shortcuts]]
++++ ./conf/interwiki.conf 파일|
# Each URL may contain one of these placeholders
# {URL} is replaced by the URL encoded representation of the wikiname
# this is the right thing to do in most cases
# {NAME} this is replaced by the wikiname as given in the document
# only mandatory encoded is done, urlencoding if the link
# is an external URL, or encoding as a wikiname if it is an
# internal link (begins with a colon)
# {SCHEME}
# {HOST}
# {PORT}
# {PATH}
# {QUERY} these placeholders will be replaced with the appropriate part
# of the link when parsed as a URL
# If no placeholder is defined the urlencoded name is appended to the URL
# To prevent losing your added InterWiki shortcuts after an upgrade,
# you should add new ones to interwiki.local.conf
nme http://nme.kr/dw/doku.php?id={NAME}
doku https://www.dokuwiki.org/
namu https://namu.wiki/w/{NAME}
wpko https://ko.wikipedia.org/wiki/{NAME}
wp https://en.wikipedia.org/wiki/{NAME}
ow https://openwiki.kr/home?do=search&id={NAME}
go https://www.google.com/search?q={URL}&btnI=lucky
# To support VoIP/SIP/TEL links
callto callto://{NAME}
tel tel:{NAME}
++++
- 내게 불필요한 사이트들은 싹 지우고, [[nme>|nme.kr]] ''코드명 : nme>''내부링크용으로,[[wp>|위키피디아]] ''코드명 : wp>''영문위키,[[go>|구글]] ''코드명 : go>''구글검색 [[wpko>|위키피디아]] ''코드명 : wp>''는 한국어 사이트로, [[namu>|나무위키]] ''코드명 : namu>''링크 추가 했다. [[ow>|오픈위키]] ''코드명 : ow>'', [[n>|네이버]] ''코드명 : n>'' (아직 안된다, 안 될 듯;;), [[p>|시인과 시 검색]] ''코드명 p>'' 추가 / **계속 추가 중**
- 처음에 편집하면 새 창 옵션으로 지정이 안 되어 페이지를 나가게 된다. 불편, 따라서 열공해서 바꿨다. (이것도 시간이 ㅠㅜ) [[doku>config:target|참고]] 근데 어떤 파일을 편집해야 하는가? 이것땜시 삽질했다.
- 답은 [[doku>config|참고]]
++++./conf/local.php|
++++
파일에서 ''$conf['target']['interwiki'] = '_blank';'' 추가하면 된다.''$conf['target']['extern'] = '_blank';'' 여기에다 그냥 ['interwiki']넣었다가 홈페이지에서 아무것도 안 눌러지는 먹통현상이 발생했다. 쩝, 따로 한 줄 넣어주어야 한다.
-(아이콘은 업로드를 했는데 아직 안 뜬다.;;) 분명 namu 라는 이름으로 png 만들어서 ''./lib/images/interwiki'' 에 올렸는데 말이다. 뭐가 잘못됐지?쿠키탓이었다. 잘된다. / 관리자 로그인 - 설정 - 저장해주면 해결 된다.
===아이콘을 사용해 보자===
인터위키를 사용하는데 맛들리니 이제 아이콘을 넣어 문서를 만들고 싶어졌다. 그래서 연구했다.
결과 - [[doku>devel:smileys.conf]] 참조 / 현재 이곳에 적용된 아이콘은 아래와 같다.
:f: - 코드 %%:f:%% 폴더 아이콘 추가
이미지 업로드 경로는 :f:''./ lib/images/smileys''
++++./conf/smileys.conf |
8-) icon_cool.gif
8-O icon_eek.gif
8-o icon_eek.gif
:-( icon_sad.gif
:-) icon_smile.gif
=) icon_smile2.gif
:-/ icon_doubt.gif
:-\ icon_doubt2.gif
:-? icon_confused.gif
:-D icon_biggrin.gif
:-P icon_razz.gif
: -o icon_surprised.gif
: -O icon_surprised.gif
: -x icon_silenced.gif
: -X icon_silenced.gif
:-| icon_neutral.gif
;-) icon_wink.gif
m (facepalm.gif
^ _ ^ icon_fun.gif
:? : icon_question.gif
:! : icon_exclaim.gif
LOL icon_lol.gif
FIXME fixme.gif
DELETEME delete.gif
:f: f.png
++++
==== 자질구레한 것들 ====
주소입력창에 아이콘을 넣었다. 익스플로러의 경우,
- 1차적인 방법 : 사이에 (보통 타이틀 아래) 넣고 경로를 수정해준다. png, jpg 같은 파일이 다 적용된다. 사이즈만 16x16 이면 좋다. [[https://webdir.tistory.com/337|참조]]
- 보다 고급스런 방법이다. 위의 참조는 무시하기로 한다. 나는 도쿠위키이니까, 도쿠위키에 맞게 우선, favicon.ico 파일을 만들어 둔다. 걍 png 파일 저장이나 이름 바꾸기로 해서 .ico 로 만든다. 사이즈도 되기만 하면 되지 16x16으로 한다. 그 다음에 [[doku>tips:favicons]] 여기를 참조해서, ''./data/media'' 폴더와 ''./lib/tpl/dokuwiki/images'' 폴더에 업로드 시켜주기만 하면 끝이다.
==== 좀 더 깊이 있게 파고들고자 하면 ====
[[wiki:도쿠위키_디렉터리_구조]] => 이곳을 참고하시길
==== 도쿠위키 사이트들 ====
-[[doku>|https://www.dokuwiki.org]] 이 홈페이지 제작의 툴이 제공되고 있는 곳이다. (영문)
-https://openwiki.kr/ 오픈위키 : 보기엔 대단히 어지러워 보이지만 @.@ 그만큼 내공이 있는 국내 최대? 도쿠위키 사이트
-http://elfism.com/ 엘프화가님의 위키(개인) 많지 않으며 잘 없어지는 개인 위키 사이트들 중에 1위로 꼽을 수 있겠다. (도쿠위키 한정) 많은 부분 참고하고 도움을 받았다.
-[[http://kieuns.com/doku.php?id=wiki:template_dokuwiki_%EC%88%98%EC%A0%95|http://kieuns.com]] 긴스위키