DokuWiki, 로컬 PC에 포터블 설치하기

티스토리 뷰

SW 개발/Tools > Windows

DokuWiki, 로컬 PC에 포터블 설치하기

지단로보트 2017. 4. 14. 01:40

개요

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에 접속할 수 있다.

날짜/시간 설정

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

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

환경 설정

앞서 등록한 슈퍼 사용자 권한으로 로그인하면 환경 설정 메뉴에 진입할 수 있다. 관리 -> 환경 설정 메뉴에 진입하여 아래 사항을 적용하자.

항목	선택값
htmlok: HTML 포함 허용	(체크한다. 글에 HTML 코드를 삽입할 수 있다.)
target>>extern: 바깥 링크에 대한 타겟 창	_blank (외부 링크를 새 창으로 연다.)

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

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

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

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

플러그인 설치

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

관리 → 확장 기능 관리자 → 검색하고 설치 → (플러그인 이름으로 검색) → 설치 순서로 플러그인을 설치할 수 있다. 아래 플러그인을 추천한다.

플러그인	설명
Color	문자열에 컬러를 입힐 수 있다.
Folded	특정 문단을 숨기거나 보여줄 수 있다
CodeMirror	문서편집기 창에 구문 강조 기능을 제공한다.
TableLayout	테이블의 헤더와 컬럼 길이를 제어할 수 있다.

DokuWiki는 학습곡선이 적은 최소한의 문법을 제공하는데, 문자열에 색상을 입히는 기능이 없어 아쉬울 때가 있다. Color 플러그인을 사용하면 쉽게 색상을 입힐 수 있다. 문법은 아래와 같다.

// OLIVE 색상을 입힌다.
<color /olive>색상을 입힐 문자열</color>

// LIME 색상을 입힌다.
<color /lime>색상을 입힐 문자열</color>

DokuWiki에서 가장 큰 애로사항이 테이블의 컬럼 폭을 사용자가 결정할 수 없다는 것이다. 그래서 컬럼의 값이 길어지면 워드랩이 작동하면서 가독성이 떨어지게 된다. TableLayout 플러그인은 컬럼 폭 설정을 가능하게 하여 이런 현상을 예방할 수 있다. 문법은 아래와 같다.

{{tablelayout?colwidth="30px,50px,70px}}
^헤더1^헤더2^헤더3^

테마 적용

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;
}

개인적인 취향으로 데스크탑에서는 별도의 테마 플러그인을 적용하는 것 보다는, 구글 크롬의 확장 프로그램인 Dark Reader(밝기 +10, 대비 -10, 세피아 필터 +60 글꼴 Cascadia Code)를 적용하는 것을 선호한다. 다크 테마가 주는 피로도 감소와 가독성이 뛰어나다.

업그레이드

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

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

macOS에 설치하기

macOS에 DokuWiki를 설치하는 것은 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의 설치 페이지에 접속할 수 있다.

CentOS 7에 설치하기

사실 CentOS 7에 설치하는 것을 포터블이라고 볼 수는 없지만 아래와 같이 설치할 수 있다.

$ sudo yum -y update
$ sudo yum -y install httpd wget nano
$ sudo firewall-cmd --permanent --zone=public --add-service={http,https}
$ sudo firewall-cmd --reload
$ sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
$ sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
$ sudo yum clean all
$ sudo yum makecache fast
$ sudo yum install -y install mod_php71w php71w-cli php71w-common php71w-gd php71w-mbstring ph p71w-mcrypt php71w-mysqlnd php71w-xml
$ php -v
PHP 7.1.30 (cli) (built: Jun  2 2019 08:03:12) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies

$ wget https://download.dokuwiki.org/out/dokuwiki-19a53ac32cb4430da817cbcaa41ebe0f.tgz -O dokuwiki.tgz
$ sudo tar zxvf dokuwiki.tgz -C /var/www/html/ --strip-components=1
$ cd /var/www/html
$ sudo cp .htaccess.dist .htaccess
$ sudo nano /etc/httpd/conf/httpd.conf
<Directory />
    AllowOverride none
    Require all denied
</Directory>

DocumentRoot "/var/www/html"

<Directory "/var/www">
    AllowOverride None
    Require all granted
</Directory>

<Directory "/var/www/html">
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all
</Directory>

$ sudo chown -R apache:apache /var/www/html
$ sudo yum -y install policycoreutils-python
$ sudo chcon -Rv --type=httpd_sys_rw_content_t /var/www/html/conf/
$ sudo chcon -Rv --type=httpd_sys_rw_content_t /var/www/html/data/
$ sudo semanage fcontext -a -t httpd_sys_rw_content_t /var/www/html/data/
$ sudo semanage fcontext -a -t httpd_sys_rw_content_t /var/www/html/conf/
$ sudo restorecon -v /var/www/html/conf/
$ sudo restorecon -v /var/www/html/data/
$ sudo setsebool -P httpd_can_network_connect on
$ sudo systemctl start httpd && systemctl enable httpd

저작자표시 비영리 동일조건

공지사항

처음 오신 분들을 위한 바로 가기 모음

최근에 올라온 글

최근에 달린 댓글

Total

Today

Yesterday

링크

TAG more

« 2024/04 »
일	월	화	수	목	금	토
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30

글 보관함

Software Engineer, Java, Spring Boot, JAX-RS REST API, OAuth 2.0, Microservice, DevOps

티스토리 뷰