차이

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

--- wiki:htmwiki [2011/05/31 13:08] – 안기욱
+++ 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를 다운로드받습니다.\\
@@ 줄 14: / 줄 19: @@
 {{:wiki:htmwiki:스크린샷_2011-05-15_오전_5.54.23.png|다운로드 페이지에서 DokuWiki를 다운로드 받습니다.}}\\
 \\
-**:!: 2011년 5월 25일부로 DokuWiki의 최신 버전이 업데이트되었습니다.**\\
-**위키의 작성 시점이 이 이전이기 때문에 __스크린샷의 날짜와 일치하지 않습니다.__ 이 점 참고해 주시기 바랍니다.**\\
 <code bash>
 wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25.tgz
@@ 줄 21: / 줄 24: @@
 {{:wiki:htmwiki:스크린샷_2011-05-18_오후_10.03.31.png|wget 명령어로 DokuWiki를 다운로드 받는 모습}}\\
 \\
+==== DokuWiki 압축 해제 ====
 다운로드가 완료되면 압축을 풀어주어야 합니다.\\
 DokuWiki는 파일 기반 위키이기 때문에 압축만 풀어주고 약간의 권한 설정만 해 주면 바로 사용이 가능합니다.((물론 서버 및 PHP 설정이 완료되어 있어야 합니다. 이 부분에 대해서는 추후 자세히 설명드리겠습니다.))\\
@@ 줄 29: / 줄 33: @@
 {{:wiki:htmwiki:스크린샷_2011-05-18_오후_10.55.03.png|다운받은 파일의 압축을 푸는 모습}}\\
 \\
+==== DokuWiki 설정 ====
 위키 내부 파일들의 정상적인 작동을 위해 압축 푼 파일들의 권한을 모두 755로 설정해줍니다.\\
 <code bash>
@@ 줄 42: / 줄 47: @@
 </code>
 명령어를 이용하여 권한을 777로 조절해주어야합니다.\\
+\\
 {{:wiki:htmwiki:스크린샷_2011-05-28_오후_1.12.23.png|install.php에 접속한 모습}}\\
 \\
@@ 줄 68: / 줄 74: @@
 {{:wiki:htmwiki:스크린샷_2011-05-28_오후_2.43.49.png|DokuWiki 설정이 완료된 모습}}\\
 \\
+==== install.php 파일 삭제 ====
 설정이 완료되었으면 더 이상 install.php 파일이 필요하지 않습니다.\\
 DokuWiki 디렉터리에서 해당 파일을 삭제합니다.\\
@@ 줄 76: / 줄 83: @@
 {{:wiki:htmwiki:스크린샷_2011-05-31_오후_4.58.04.png|install.php를 삭제하는 모습}}\\
 \\
+==== 위키 접속 ====
 [새로운 DokuWiki.] 링크를 눌러 생성된 위키로 접속합니다.\\
 앞으로 위키에 직접 접속하시기 위해서는 DokuWiki를 설치한 경로의 doku.php로 접속하시면 됩니다.\\
@@ 줄 82: / 줄 90: @@
 \\
 처음 접속하면 기본 템플릿(스킨)에 아무런 문서도 없는 모습을 볼 수 있습니다.\\
-문서를 작성하시기 전에 DokuWiki의 위키 문서 관리 방법에 대해 간단히 알아두면 더욱 손쉽게 관리가 가능합니다.\\
+이제 사용자에 맞게 DokuWiki의 환경을 설정해 주어야합니다.\\
-\\
-DokuWiki는 위에서 언급했다시피 파일 기반으로 운영됩니다.\\
-즉, 하나의 디렉터리를 네임스페이스(분류)로 취급하고, 그 안에 있는 하나의 파일을 하나의 위키 문서로 취급합니다.\\
-구조를 간단히 표현하면 아래와 같습니다.\\
-  * **Namespace1** (Dir)
-    * start.txt
-    * document1.txt
-    * document2.txt
-    * **SubNamespace1** (Dir)
-      * start.txt
-      * document1.txt
-    * **SubNamespace2** (Dir)
-      * start.txt
-      * document1.txt
-//네임스페이스 및 위키 문서는 디스크 용량이 존재하는 한 개수에 제한 없이 얼마든지 생성할 수 있습니다.//\\
-\\
-그리고 하나의 네임스페이스 안에는 하나의 시작 문서가 존재할 수 있는데, 이 문서의 파일명은 기본적으로 //start.txt//로 지정되어 있습니다. 시작 문서는 해당 네임스페이스를 대표하는 문서가 됩니다.\\
-시작 문서가 존재하지 않을 경우 몇 가지 단점이 있기 때문에 반드시 만드시는 것을 추천합니다.\\
-\\
-기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리되지만, 설정을 통해 시작 문서의 첫 제목이 해당 네임스페이스의 파일명이 되도록, 문서의 첫 제목이 해당 문서의 제목이 되도록 바꾸어 줄 수 있습니다.\\
-이것을 포함해 먼저 DokuWiki의 설정을 바꾸어보도록 하겠습니다.\\
 \\
+==== DokuWiki 환경 설정 ====
 설정을 위해 관리자 계정으로 로그인하여야 합니다. 접속된 페이지에서 [로그인] 버튼을 누릅니다.\\
 \\
@@ 줄 123: / 줄 111: @@
 환경 설정 페이지에서는 다양한 설정값들을 변경해 줄 수 있습니다. 이 중에서 미리 변경해주어야 하는 것들은 아래와 같습니다.\\
 ^ 설정명 ^ 한글 이름 ^ 설명 ^ 권장 설정값 ^
-^ useheading | 페이지 이름으로 첫 헤드라인 사용 | 페이지 이름을 파일명으로 할 것인지 위키 문서의 첫 제목으로 할 것인지 설정합니다. | True |
+^ useheading | 페이지 이름으로 첫 헤드라인 사용 | 페이지 이름을 파일명으로 할 것인지 위키 문서의 첫 제목으로 할 것인지 설정합니다. 기본적으로 네임스페이스 및 문서의 제목은 디렉터리명 또는 파일명으로 처리됩니다. | 항상 |
 ^ sneaky_index | 숨겨진 인덱스 | 사용자가 인덱스를 볼 때 볼 권한이 없는 문서는 인덱스에 표시되지 않도록 설정합니다. | True |
 ^ fnencode | 파일명의 인코딩 | 생성되는 파일명의 텍스트 인코딩을 설정합니다. utf-8로 하지 않을 시 한글로 된 파일명을 읽기 어려울 수 있습니다. | utf-8 |
@@ 줄 131: / 줄 119: @@
 맨 아래 [저장] 버튼을 누르면 설정이 저장됩니다.\\
 \\
+{{:wiki:htmwiki:스크린샷_2011-06-03_오후_10.13.35.png|설정이 완료된 모습}}
+==== 플러그인 설치 ====
 이제 다시 관리 작업 페이지로 되돌아간 후 필요한 플러그인들을 설치해줍니다. 기본적으로 설치해주어야 할 플러그인은 아래와 같습니다.\\
 ^ 플러그인명 ^ 기능 ^
@@ 줄 150: / 줄 140: @@
 \\
 이제 플러그인의 설치가 완료되었습니다. 다른 플러그인 또한 비슷한 방법으로 설치해 주시면 됩니다.\\
-필요한 기능이 있으면 http://www.dokuwiki.org/plugins 페이지에서 검색하실 수 있습니다.
+필요한 기능이 있으면 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의 위키 문서 관리 방법에 대해 간단히 알아두면 더욱 손쉽게 관리가 가능합니다.\\
+\\
+DokuWiki는 위에서 언급했다시피 파일 기반으로 운영됩니다.\\
+즉, 하나의 디렉터리를 네임스페이스(분류)로 취급하고, 그 안에 있는 하나의 파일을 하나의 위키 문서로 취급합니다.\\
+구조를 간단히 표현하면 아래와 같습니다.\\
+  * **Namespace1** (Dir)
+    * start.txt
+    * document1.txt
+    * document2.txt
+    * **SubNamespace1** (Dir)
+      * start.txt
+      * document1.txt
+    * **SubNamespace2** (Dir)
+      * start.txt
+      * document1.txt
+//네임스페이스 및 위키 문서는 디스크 용량이 존재하는 한 개수에 제한 없이 얼마든지 생성할 수 있습니다.//\\
+\\
+그리고 하나의 네임스페이스 안에는 하나의 시작 문서가 존재할 수 있는데, 이 문서의 파일명은 기본적으로 //start.txt//로 지정되어 있습니다. 시작 문서는 해당 네임스페이스를 대표하는 문서가 됩니다.\\
+시작 문서가 존재하지 않을 경우 몇 가지 단점이 있기 때문에 반드시 만드시는 것을 추천합니다.\\
+\\
+문서를 작성하시려면 기본적으로 검색창에 //문서 제목//을 입력하신 후 위의 메뉴에서 [Create] 버튼을 누르면 글 작성이 가능합니다.\\
+그리고 특정 네임스페이스에 문서를 추가하려면, //네임스페이스:문서 제목//을 검색하신 후, [Create] 버튼을 누르는 방법도 있습니다.\\
+네임스페이스 이름을 작성하는 것이 귀찮다면 플러그인을 이용하는 방법도 있습니다.\\
+자세한 내용은 http://www.dokuwiki.org/plugin:addnewpage 를 참조하세요.