티스토리 뷰

개요

DokuWiki는 화려하진 않지만 가볍고 편리한 기능의 무료 위키 플랫폼이다. 최근 국내 IT 기업 대부분은 사내 협업 도구로 Confluence Wiki를 사용하지만 나는 여전히 가볍고 직관적인 DokuWiki를 선호한다. 내가 회사에 입사하여 개인 업무 PC를 할당 받으면 가장 먼저 하는 일이 DokuWiki 포터블 버전을 설치하는 것이다. 그 어떤 도구보다 강력하고 차지하는 용량도 적어 백업도 쉽다. 본 글에서는 DokuWiki 포터블 버전을 설치하는 방법을 설명하고자 한다.

설치

DokuWiki는 설치 과정을 커스터마이징할 수 있다. 포터블 버전으로 사용하려면 아래와 같이 진행한다.


  • DokuWiki 다운로드 페이지를 방문하여 설치를 진행한다. 아래와 같이 항목을 선택하고 Start Download 버튼을 클릭한다.
항목 선택값
Version Stable
Include Web-Server MicroApache (Windows) (체크한다.)
Languages ko - 한국어 (체크한다.)
Popular Plugins Upgrade Plugin, Wrap Plugin, Translation Plugin, Video Share Plugin, Gallery Plugin

  • 다운로드된 .tgz 파일을 압축 해제하고 실행한다. DokuwikiStick 디렉토리에 위치한 run.cmd를 실행하고 아래와 같이 입력 후 저장 버튼을 클릭한다.
항목 선택값
Choose your language ko
위키 이름 (위키 제목을 입력한다.)
슈퍼 사용자 (로그인할 관리자 ID를 입력한다.)
실명 (혼자 쓸거라면 앞서 입력한 슈퍼 사용자를 입력해도 무방하다.)
이메일 (알림 메일을 수신할 이메일 주소를 입력한다.)
초기 ACL 정책 닫힌 위키 (작성 글을 나만 보기 위한 설정이다.)
내용을 배포하기 위한 라이선스를 선택하세요 라이선스 정보를 보여주지 않습니다.
한 달에 한 번씩, 도쿠위키 개발자에게 익명의 사용 데이터를 보냅니다 (체크 해제한다.)

  • 이제 설치가 완료되었다. 웹 브라우저에서 http://localhost:8800/으로 접속하면 설치된 DokuWiki에 접속할 수 있다.

날짜/시간 설정

DokuWikiPHP 기반이라 PHP의 기본 설정을 따른다. 아래 설정을 추가하자.


  • /server/php/php.ini 파일의 날짜/시간 설정을 변경한다. date.timezoneEurope/Berlin에서Asia/Seoul로 수정하고 저장한다.

환경 설정

  • 앞서 등록한 슈퍼 사용자 권한으로 로그인하면 환경 설정 메뉴에 진입할 수 있다. 관리 -> 환경 설정 메뉴에 진입하여 아래 사항을 적용하자.
항목 선택값
htmlok: HTML 포함 허용 (체크한다. 글에 HTML 코드를 삽입할 수 있다.)
target>>extern: 바깥 링크에 대한 타겟 창 _blank (외부 링크를 새 창으로 연다.)

Draw.io 다이어그램 삽입하기

Draw.io는 강력한 무료 온라인 다이어그램 제작 툴이다. 개인적으로 파워포인트보다 훨씬 생산성이 좋다고 생각된다. Draw.io로 그린 다이어그램을 DokuWikiHTML 코드 삽입으로 간단히 삽입할 수 있다.


  • Draw.io로 다이어그램 생성을 완료 후 File → Embed → HTML → Create 순서로 HTML 코드를 생성한다.

  • 생성한 코드 앞뒤로 <html></html>를 감싸주어 DokuWiki 글에 추가하면 파일 업로드 등의 불편 없이 바로 DokuWiki에서 작성한 다이어그램을 확인할 수 있다.

플러그인 설치

DokuWiki의 강점은 사용자들이 만든 다양한 추가 플러그인에 있다.


  • 관리 → 확장 기능 관리자 → 검색하고 설치 → (플러그인 이름으로 검색) → 설치 순서로 플러그인을 설치할 수 있다. 아래 플러그인을 추천한다.
플러그인 설명
Color 문자열에 컬러를 입힐 수 있다.
Folded 특정 문단을 숨기거나 보여줄 수 있다
CodeMirror 문서편집기 창에 구문 강조 기능을 제공한다.
TableLayout 테이블의 헤더와 컬럼 길이를 제어할 수 있다.

테마 적용

DokuWiki의 기본 테마는 말그대로 기본에 충실하고 깔끔하다. 하지만 기호에 맞는 다양한 테마를 적용할 수 있다. 내 경우 모바일에 최적화된 Twenty Fifteen Template 테마를 선호한다. 테마 적용 전 아래와 같이 CSS 설정을 변경해주면 데스크탑에서도 무난하게 사용할 수 있다.

$ notepad ./lib/tpl/twentyfifteen/css/responsive.less
body {
    font-size: 19px; → 15px;
    font-size: 1.9rem; → 1.5rem;
    line-height: 1.6842; → 1.6;
}

업그레이드

DokuWiki의 새 버전이 나왔을 때는 어떻게 업그레이드할 수 있을까?


  • 관리 → 위키 업그레이드 메뉴에서 매우 손쉽게 새 버전으로 업그레이드할 수 있다.
  • 위키 업그레이드 메뉴가 존재하지 않는 구버전은 플러그인을 설치하면 된다.

macOS에 설치하기

  • macOSDokuWiki를 설치하는 것은 Windows보다 번거로운 편이다. 먼저 App Store에서 Xcode를 설치해야 한다. 그 후 아래 과정을 차례대로 진행한다.
### Apache 환경설정 적용
$ sudo vi /etc/apache2/httpd.conf
LoadModule php7_module libexec/apache2/libphp7.so
LoadModule userdir_module libexec/apache2/mod_userdir.so
Include /private/etc/apache2/extra/httpd-userdir.conf

$ sudo vi /etc/apache2/extra/httpd-userdir.conf
include /private/etc/apache2/users/*.conf

### ~/Sites 웹 디렉토리 생성
$ mkdir ~/Sites

### ~/Sites 웹 접근 허용
$ sudo vi /etc/apache2/users/{user_name}.conf
<Directory "/Users/{user_name}/Sites/">
    AddLanguage en .en
    Options Indexes MultiViews FollowSymLinks ExecCGI
    AllowOverride None
    Require host localhost
</Directory>

### Apache 환경설정 정상 작동 확인
$ apachectl configtest

### Apache 환경설정 적용
$ sudo launchctl load -w /System/Library/LaunchDaemons/org.apache.httpd.plist
  • DokuWiki에서 다운로드한 파일을 ~/Sites에 압축 해제한다.
  • 이제 http://localhost/~{user_name}/dokuwiki/install.php에 접속하면 DokuWiki의 설치 페이지에 접속할 수 있다.
댓글
댓글쓰기 폼