차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- wiki:htmwiki [2011/05/28 09:03] – 안기욱
+++ wiki:htmwiki [2013/01/26 10:38] (현재) – [템플릿(스킨) 변경] 안기욱
@@ 줄 1: / 줄 1: @@
-====== 보리 OS 위키 ======
+====== 보리 OS 위키에 대해서 ======
 보리 OS 위키는 DokuWiki를 기반으로 운영되고 있습니다.\\
 DokuWiki는 파일 기반 위키 엔진으로 서버 이전이나 데이터 수정 및 백업이 쉬운 장점이 있으며, 다양한 플러그인과 템플릿을 제공하는 것 또한 강력한 장점입니다.\\
@@ 줄 5: / 줄 5: @@
 DokuWiki는 윈도 및 리눅스 등 다양한 OS에서 설치가 가능합니다. 우리는 우분투 리눅스에서 DokuWiki를 동작시키고 있습니다.\\
 이 문서에서도 우분투 리눅스에서 DokuWiki를 설치하는 과정을 설명할 것입니다.\\
+\\
 ===== DokuWiki 설치하기 =====
+//DokuWiki 공식 설치 매뉴얼은 http://www.dokuwiki.org/Install 에서 확인하실 수 있습니다.//\\
+\\
+==== DokuWiki 다운로드 ====
+//:!: 2011년 5월 25일부로 DokuWiki의 최신 버전이 업데이트되었습니다.//\\
+//위키의 작성 시점이 이 이전이기 때문에 __스크린샷의 날짜와 일치하지 않습니다.__ 이 점 참고해 주시기 바랍니다.//\\
+\\
 먼저 http://www.splitbrain.org/projects/dokuwiki 에서 DokuWiki를 다운로드받습니다.\\
 다운로드는 stable 버전과 non-stable 버전 두 가지를 제공하는데 안정적인 위키 운영을 위해서는 stable 버전을 이용하심을 추천합니다.\\
@@ 줄 13: / 줄 20: @@
 \\
 <code bash>
-wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2010-11-07a.tgz
+wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25.tgz
 </code>
 {{:wiki:htmwiki:스크린샷_2011-05-18_오후_10.03.31.png|wget 명령어로 DokuWiki를 다운로드 받는 모습}}\\
 \\
+==== DokuWiki 압축 해제 ====
 다운로드가 완료되면 압축을 풀어주어야 합니다.\\
 DokuWiki는 파일 기반 위키이기 때문에 압축만 풀어주고 약간의 권한 설정만 해 주면 바로 사용이 가능합니다.((물론 서버 및 PHP 설정이 완료되어 있어야 합니다. 이 부분에 대해서는 추후 자세히 설명드리겠습니다.))\\
 압축을 풀기 위해서는 //tar// 명령어를 이용합니다.\\
 <code bash>
-tar xvfz dokuwiki-2010-11-07a.tgz
+tar xvfz dokuwiki-2011-05-25.tgz
 </code>
 {{:wiki:htmwiki:스크린샷_2011-05-18_오후_10.55.03.png|다운받은 파일의 압축을 푸는 모습}}\\
 \\
+==== DokuWiki 설정 ====
 위키 내부 파일들의 정상적인 작동을 위해 압축 푼 파일들의 권한을 모두 755로 설정해줍니다.\\
 <code bash>
-chmod -R 755 dokuwiki-2010-11-07a/
+chmod -R 755 dokuwiki-2011-05-25/
 </code>
 {{:wiki:htmwiki:스크린샷_2011-05-18_오후_11.35.24.png|파일들의 권한을 모두 755로 설정한 모습}}\\
 \\
 그리고 웹 브라우저를 통해 해당 디렉터리 내에 있는 install.php로 접속합니다.\\
-만일 접속 시 권한 에러가 발생한다면
+\\
+만일 접속 시 권한 에러가 발생한다면\\
 <code bash>
-chmod -R 777 dokuwiki-2010-11-07a/
+chmod -R 777 dokuwiki-2011-05-25/
 </code>
-명령어를 이용하여 권한을 조절해주어야합니다.
+명령어를 이용하여 권한을 777로 조절해주어야합니다.\\
+\\
 {{:wiki:htmwiki:스크린샷_2011-05-28_오후_1.12.23.png|install.php에 접속한 모습}}\\
 \\
@@ 줄 63: / 줄 74: @@
 {{:wiki:htmwiki:스크린샷_2011-05-28_오후_2.43.49.png|DokuWiki 설정이 완료된 모습}}\\
 \\
+==== install.php 파일 삭제 ====
+설정이 완료되었으면 더 이상 install.php 파일이 필요하지 않습니다.\\
+DokuWiki 디렉터리에서 해당 파일을 삭제합니다.\\
+<code bash>
+cd dokuwiki_dokuwiki-2011-05-25
+rm -f install.php
+</code>
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_4.58.04.png|install.php를 삭제하는 모습}}\\
+\\
+==== 위키 접속 ====
 [새로운 DokuWiki.] 링크를 눌러 생성된 위키로 접속합니다.\\
 앞으로 위키에 직접 접속하시기 위해서는 DokuWiki를 설치한 경로의 doku.php로 접속하시면 됩니다.\\
@@ 줄 69: / 줄 90: @@
 \\
 처음 접속하면 기본 템플릿(스킨)에 아무런 문서도 없는 모습을 볼 수 있습니다.\\
+이제 사용자에 맞게 DokuWiki의 환경을 설정해 주어야합니다.\\
+\\
+==== DokuWiki 환경 설정 ====
+설정을 위해 관리자 계정으로 로그인하여야 합니다. 접속된 페이지에서 [로그인] 버튼을 누릅니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-28_오후_4.41.00.png|로그인 페이지에 접속한 모습}}\\
+\\
+처음에 설정했던 관리자 계정과 암호를 입력하여 로그인합니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_5.01.16.png|로그인에 성공한 모습}}\\
+\\
+로그인에 성공하면 이전에는 없던 [관리] 버튼을 보실 수 있습니다. [관리] 버튼을 클릭해 관리 작업 페이지로 접속합니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_9.02.54.png|관리 작업 페이지}}\\
+\\
+먼저 DokuWiki의 시스템을 설정해주어야 합니다. [환경 설정]에 들어갑니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_9.04.47.png|환경 설정 페이지}}\\
+\\
+환경 설정 페이지에서는 다양한 설정값들을 변경해 줄 수 있습니다. 이 중에서 미리 변경해주어야 하는 것들은 아래와 같습니다.\\
+^ 설정명 ^ 한글 이름 ^ 설명 ^ 권장 설정값 ^
+^ useheading | 페이지 이름으로 첫 헤드라인 사용 | 페이지 이름을 파일명으로 할 것인지 위키 문서의 첫 제목으로 할 것인지 설정합니다. 기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리됩니다. | 항상 |
+^ sneaky_index | 숨겨진 인덱스 | 사용자가 인덱스를 볼 때 볼 권한이 없는 문서는 인덱스에 표시되지 않도록 설정합니다. | True |
+^ fnencode | 파일명의 인코딩 | 생성되는 파일명의 텍스트 인코딩을 설정합니다. utf-8로 하지 않을 시 한글로 된 파일명을 읽기 어려울 수 있습니다. | utf-8 |
+\\
+위 3개 정도의 설정만 바꾸어주어도 DokuWiki를 사용하는 데 큰 지장은 없습니다.\\
+추후에 다른 설정을 바꾸실 때 이 곳을 이용하시면 됩니다. 각각의 설정에 대한 자세한 설명은 각 설정의 영문명을 클릭하시면 보실 수 있습니다.\\
+맨 아래 [저장] 버튼을 누르면 설정이 저장됩니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-06-03_오후_10.13.35.png|설정이 완료된 모습}}
+==== 플러그인 설치 ====
+이제 다시 관리 작업 페이지로 되돌아간 후 필요한 플러그인들을 설치해줍니다. 기본적으로 설치해주어야 할 플러그인은 아래와 같습니다.\\
+^ 플러그인명 ^ 기능 ^
+| indexmenu | 위키의 인덱스를 표시할 수 있도록 합니다. 여러 템플릿에서 이용 가능하기 때문에 유용합니다. |
+\\
+indexmenu 플러그인을 설치하는 과정을 소개하겠습니다. 다른 플러그인 설치 또한 이와 같이 작업해주시면 됩니다.\\
+http://www.dokuwiki.org/plugin:indexmenu 페이지에 접속해 [Download the Plugin] 링크에 연결되어있는 파일 주소를 복사합니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_9.55.29.png|indexmenu 플러그인 페이지}}\\
+\\
+그리고 관리 작업 페이지로 이동한 후 플러그인 관리자 페이지로 이동합니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_9.58.31.png|플러그인 관리자 페이지}}\\
+\\
+[URL]에 복사한 주소를 복사한 뒤 [다운로드] 버튼을 누르면 자동으로 설치가 진행됩니다.\\
+년 5월 31일 현재 최신 버전의 다운로드 링크는 http://samuele.netsons.org/dokuwiki/media/indexmenu.zip 입니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-05-31_오후_10.04.01.png|다운로드 완료된 모습}}\\
+\\
+이제 플러그인의 설치가 완료되었습니다. 다른 플러그인 또한 비슷한 방법으로 설치해 주시면 됩니다.\\
+필요한 기능이 있으면 http://www.dokuwiki.org/plugins 페이지에서 검색하실 수 있습니다.\\
+\\
+==== 템플릿(스킨) 변경 ====
+:!: //2013년 1월 26일 현재 DokuWiki 기본 스킨이 더욱 이쁜 관계로 기본 스킨을 사용하는 중입니다.//\\
+//최신버전으로 업데이트하시거나 최근에 설치를 마치신 분들은 굳이 이 과정을 거치시지 않으셔도 됩니다.//\\
+\\
+\\
+DokuWiki의 기본 템플릿도 적응하면 쓸만하지만 아무래도 자주 사용한 사람이 아니라면 쉽게 사용하기 어려운 템플릿입니다.\\
+따라서 새로운 템플릿을 적용해 줄 필요가 있습니다.\\
+\\
+DokuWiki에 적용 가능한 템플릿들은 http://www.dokuwiki.org/template 이 링크에서 확인하실 수 있습니다.\\
+적용 가능한 템플릿의 가짓수는 매우 다양하지만, 일반적으로 사용하기에는 위키피디아에서도 사용되고 보리 OS 위키에서도 사용되는 vector 템플릿이 가장 편리합니다.\\
+이 문서에서도 vector 템플릿을 적용하는 방법을 안내할 것입니다.\\
+\\
+먼저 http://www.dokuwiki.org/template 페이지에서 vector 스킨을 검색한 후 해당 페이지에 접속합니다.\\
+또는 [[http://www.dokuwiki.org/template:vector|이 곳]]으로 접속하셔도 됩니다.
+\\
+{{:wiki:htmwiki:스크린샷_2011-06-03_오후_10.28.29.png?|vector 템플릿 소개 페이지}}\\
+\\
+이 페이지에서는 vector 템플릿에 대한 다양한 정보를 얻을 수 있습니다.\\
+다운로드를 받기 위해서는 [Download this Template]을 클릭하시면 됩니다.\\
+다운로드 받은 파일을 위키 디렉터리의 lib/tpl 디렉터리에 압축을 풀어줍니다.\\
+\\
+또한 해당 주소를 복사하여 서버에서 직접 다운로드 받아 바로 압축을 해제하는 방법도 있습니다.\\
+<code bash>
+cd lib/tpl
+wget http://andreas-haerter.com/downloads/dokuwiki-template-vector/latest
+mv latest vector.tar.gz
+tar xvfz vector.tar.gz
+</code>
+다운로드 받은 템플릿 파일을 압축까지 해제하면 다시 관리 작업 페이지로 접속한 후 환경 설정 관리 페이지에 접속합니다.\\
+그리고 template(한글명: 템플릿) 설정을 vector로 설정하고 [저장] 버튼을 누릅니다.\\
+그러면 새로이 바뀐 템플릿이 적용된 환경 설정 관리 페이지가 나타납니다.\\
+\\
+{{:wiki:htmwiki:스크린샷_2011-06-03_오후_11.04.59.png?|템플릿이 적용된 모습}}\\
+==== 문서 및 네임스페이스 작성 ====
+=== DokuWiki의 문서 관리 방법 ===
 문서를 작성하시기 전에 DokuWiki의 위키 문서 관리 방법에 대해 간단히 알아두면 더욱 손쉽게 관리가 가능합니다.\\
 \\
@@ 줄 89: / 줄 197: @@
 시작 문서가 존재하지 않을 경우 몇 가지 단점이 있기 때문에 반드시 만드시는 것을 추천합니다.\\
 \\
-기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리되지만, 설정을 통해 시작 문서의 첫 제목이 해당 네임스페이스의 파일명이 되도록, 문서의 첫 제목이 해당 문서의 제목이 되도록 바꾸어 줄 수 있습니다.\\
+문서를 작성하시려면 기본적으로 검색창에 //문서 제목//을 입력하신 후 위의 메뉴에서 [Create] 버튼을 누르면 글 작성이 가능합니다.\\
-이것을 포함해 먼저 DokuWiki의 설정을 바꾸어보도록 하겠습니다.\\
+그리고 특정 네임스페이스에 문서를 추가하려면, //네임스페이스:문서 제목//을 검색하신 후, [Create] 버튼을 누르는 방법도 있습니다.\\
-\\
+네임스페이스 이름을 작성하는 것이 귀찮다면 플러그인을 이용하는 방법도 있습니다.\\
-설정을 위해 관리자 계정으로 로그인하여야 합니다. 접속된 페이지에서 [로그인] 버튼을 누릅니다.\\
+자세한 내용은 http://www.dokuwiki.org/plugin:addnewpage 를 참조하세요.
-\\
-{{:wiki:htmwiki:스크린샷_2011-05-28_오후_4.41.00.png|로그인 페이지에 접속한 모습}}
-\\
-처음에 설정했던 관리자 계정과 암호를 입력하여 로그인합니다.\\