[DokuWiki] 문서관리 특화 무료 위키백과 DokuWiki 사용법 정리

* 부서내 임시로 구성된 TFT의 파트장을 맡으면서 팀원 간의 문서관리방법을 고민하다가 문서관리에 특화된 무료 위키백과인 DokuWiki를 도입하기로 결정하고 사용자 메뉴얼을 속독하고 사용법을 정리했다. 사용법을 정리하면서 개인 블로그 엔진으로 활용해도 매우 뛰어난 엔진임을 느꼈다. DocuWiki 설치 방법은 추후 포스팅할 예정이다.

<신규 페이지 생성하기>

* DokuWiki에서 신규 페이지 작성은 이미 존재하는 문서에서 링크를 생성하면서 시작한다. 문서 편집 화면에서 새로 작성할 페이지 제목을 선택하고 내부 링크를 작성한다. 링크 마법사 화면에서 페이지명(영문소문자와 밑줄로 구성)을 입력하여 링크를 생성 후 문서를 저장한다. 문서 보기 화면에서 해당 페이지 제목을 클릭하면 신규 페이지를 작성할 수 있다. 이러한 페이지 작성 방법은 위키에서 페이지가 고립되는 것을 방지한다.

* 보다 빠른 방법은 검색창에서 새로 작성할 페이지의 단어를 입력하는 것이다. 가장 간편한 방법이지만 위키에서 페이지가 고립될 수 있다.

<페이지 수정하기>

* DokuWiki에서 페이지를 수정하려면 메뉴에서 문서 편집을 클릭한다. 현재 다른 사용자가 편집 중일 경우 페이지가 잠기었다는 메시지가 뜬다.

<페이지 삭제하기>

* DokuWiki에서 페이지를 삭제하려면 문서 편집을 클릭하고 내용을 모두 지우고 저장을 클릭한다.

<이전 판 확인하기>

* DokuWiki에서 현재 페이지의 수정되기 전의 이력인 이전 판(Old Revisions)을 확인하려면 메뉴에서 이전 판을 클릭한다.

<페이지 텍스트 파일로 받기>

* DokuWiki에서 현재 페이지를 서버 상의 텍스트 파일 그대로 받으려면 주소 뒤에 ?do=export_raw를 붙인다.

<페이지 꾸미기>

* DokuWiki는 페이지 작성시 고유의 문법을 지원한다.

* 문서 작성시 큰 제목은 '=' 문자 6개를 앞뒤로 입력한다.

====== 큰 제목 ======

* 큰 제목 밑의 중간 제목은 '=' 문자 5개를 앞뒤로 입력한다.

===== 중간 제목 =====

* 중간 제목 밑의 작은 제목은 '=' 문자 4개를 앞뒤로 입력한다.

==== 작은 제목 ====

* 소스 코드, 명령어 강조는 <code> 태그를 앞뒤로 입력한다.

<code>man</code>

* 소스 코드, 명령어 하이라이트닝은 <code java> 태그와 같이 언어 제목을 명시하여 앞뒤로 입력한다.

<code bash>yum -y install httpd</code>

<code java>System.out.println("Hello World!");</code>

<code csharp>MessageBox.Show("Hello World!");</code>

* 주석은 괄호를 앞뒤로 입력한다.

단어((단어에 대한 설명))

* 가로줄로 영역을 나눌 때는 '-' 문자를 4개 입력한다.

----

* 리스트를 열거할 때는 공백 문자 2개와 '*' 문자를 앞에 입력한다.

  * 항목1

  * 항목2

  * 항목3

* 표는 각 헤더 앞뒤로 '^' 문자를, 각 컬럼 앞뒤로 '|'를 입력한다.

^컬럼명1^컬럼명2^컬럼명3^

|컬럼값1|컬럼값2|컬럼값3|

* 문법을 무시하고 화면에 그대로 출력하려면 <nowiki> 태그를 앞뒤로 입력한다.

<nowiki>==== 문법 무시 ====</nowiki>

<이미지 업로드하기>

* DokuWiki에서 페이지에 출력할 이미지를 업로드하려면 툴바에서 그림과 기타 파일 추가 메뉴 실행 후 업로드할 파일을 선택한 후 파일명 앞에 ':' 문자로 식별자 역할의 네임스페이스를 입력하고 올리기 및 완료를 차례대로 클릭한다. 업로드되는 모든 이미지는 페이지와 같은 식별자를 가지므로 식별자를 신중하게 지정해야 한다. 업로드가 허용되는 최대 크기는 2MB이다. 이미지 외에 다른 확장자를 가진 파일도 업로드가 가능하지만 관리 특성상 파일관리는 SVN을 이용하는 것이 현명하다고 판단된다.

* ':namespace:filename.png' 식별자로 업로드된 이미지를 문서에 출력하려면 문서 편집 화면에서 아래와 같이 입력한다.

{{:namespace:filename.png}} // 기본 출력

{{ :namespace:filename.png }} // 가운데 정렬

{{ :namespace:filename.png?20x20 }} // 20x20 크기로 출력하고 가운데 정렬