ubuntu

Dokuwiki 설치(우분투기준) ,문법,플러그인 쭈욱 알아보기

소화자/ editor

  • 2 comments
  • 2,991 views
  • 2017년 12월 3일

워드프레스(Wordpress) 처럼 도쿠위키(Dokuwiki)도 웹 포스팅 플랫폼으로 많이 사용되고 있습니다.
사내 문서관리 시스템으로 활용하는 회사도 있다고 들었습니다.
다양하고 유용한 플러인이 있어, 처음에 글 쓰는 문법만 조금 시간을 들여 배워 두신다면
여러 용도로 훌륭하게 활용될 수 있는 플랫폼으로 보입니다.
설치는 우분투 기준으로 하고, 기본사용법과 추천 플러그인, 문법 알아보겠습니다.

한마디

워드프레스(WordPress) 처럼 도쿠위키(Dokuwiki)도 웹 포스팅 플랫폼으로 많이 사용되고 있습니다.
사내 문서관리 시스템으로 활용하는 회사도 있다고 들었습니다.
다양하고 유용한 플러인이 있어, 처음에 글 쓰는 문법만 조금 시간을 들여 배워 두신다면
여러 용도로 훌륭하게 활용될 수 있는 플랫폼으로 보입니다.

장단점이 있겠지만 개인적으로는 워드프레스보다 도큐위키가 조금 더 맘에 와 닿습니다.
제공되는 유용한 플러그인은 워드프레스에 밀리지 않아 보입니다만,
바로 활용할 수 있게 제공되는 템플릿이 거의 없는 것이 아프고, 별도로 데이타베이스를 쓰지 않고
텍스트 자체로 저장하기 때문에 백업이나 서버 이관 등에 유리한 반면,
워드프레스에 비하면 상대적으로 조금 느린 느낌이 있습니다.
캐시 기능을 사용하기 때문에 포스팅은 괜찮지만 관리 탭 기능들이 로딩에 많이 느립니다.

그럼 도큐위키 설치(여기선 우분투 기반),기본적인 사용법, 글 쓸때의 문법,
필요한 플러인등에 대해서 쭈욱 알아 보겠습니다.

우분투(Ubuntu)기준 설치

우부투에 공식 설치가이드 에서는  사이트의 홈디렉토리로 설치 하였습니다만,
여기서는  테스트 해 보는 개념으로 서브 디렉토리로 설치해 보겠습니다.
아파치 서버와 php는 이미 설치 되어 있다고 가정하겠습니다.
만약 설치되어 있지 않으시다면 아래 한 줄로 Apache/Php/Mysql을 설치하실 수 있습니다.

sudo apt-get install lamp-server^

### 아파치 홈디렉토리로 이동합니다.  ###
cd /var/www/html

### 도쿠위키 소스압축 파일 다운로드 받습니다. ###
sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

### 압축 풀기, 풀면 dokuwiki-2016-06-26a 디렉토리가 생깁니다. ###
sudo tar xvf dokuwiki-stable.tgz

### 필요없는 압축파일은 용량만 차지하니 삭제합니다. 안하셔도 됩니다. ###
sudo rm dokuwiki-stable.tgz

### 디렉토리 명을 바꿔 줍니다. 꼭 dokuwiki로 안하셔도 상관없습니다. ###
sudo mv dokuwiki-* dokuwiki

### 디렉토리 소유자 그룹을 www-data로 바꾸어 줍니다. 
sudo chown -R www-data:www-data dokuwiki

### 아파치 rewrite 모듈 활성화
sudo a2enmod rewrite

### 아파치 서버 재시작
sudo service apache2 restart

위의 과정을 하셨다면 이제 브라우져에서 http://컴퓨터ip 또는 호스트명/dokuwiki/install.php 로 이동합니다.
디렉토리명을 dokuwiki가 아닌 다른 것으로 하신 분은 바꾸신 디렉토리명을 적어 주시면 됩니다.

위와 같은 화면이 보이면, 모두 나중에 수정가능하니 부담없이 아래처럼 진행합니다.

  1. 화면 오른쪽 상단에서 언어를 ko로 설정하여 한글로 바꾸어 줍니다.
  2. 위키이름은 전체 주체를 나타내는 것으로 우선 생각나는대로 적어줍니다.
  3. 슈퍼 사용자는 관리자 아이디로 원하시는 아이디로 기억하기 좋은 것으로  적어줍니다.
  4. ACL(Access Control List) 활성화(권장)는 혼자 사용하실거 아니면 체크합니다.
  5. 실명은 닉네임 쓰셔도 누구도 체크 하지 않습니다.
  6. 이메일도 부담없이 사용하시는 이메일 적어줍니다.
  7. 비밀번호/다시확인  원하시는 암호로 채워줍니다.
  8. 초기 ACL 정책 원하시는 것으로 골라 줍니다.
  9. 사용자 자신이 등록할 수 있도록 하기는 회원가입 의미입니다.
  10. 라이센스는 ?  참고 하셔서 원하시는 것 선택합니다.
  11. 도쿠위키 경험개선에 기여하실 것인지 선택합니다.
  12. 마지막으로 저장 버튼 누르시면 설치가 완료됩니다.^-^

 

만약 공개용으로 사용하실 거면 보안을 위해 도쿠위키 설치 디렉토리에 가셔서 install.php 파일을 지우시거나,
다른 곳으로 옯겨버립니다.암호를 잊어버리신 경우에 처음 설치 때 처럼 사용하시면 유용합니다.

저장버튼을 누르고 나면, “도쿠위키 설치 관리자”란 화면이 뜨고
“새 도쿠위키로 들어가세요” 란 글에 링크가 걸려 파랗게 보입니다. 클릭하십시오

위 화면에서 오른쪽 상단 로그인을 클릭하고, 이전에 정해준 슈퍼 사용자 아이디와 암호로 로그인 합니다.

이제 오른쪽 위 메뉴에 “관리” 링크가 추가되어 있을 겁니다.
클릭하시면 사용자 관리자 부터 인기도 조사까지 메뉴가 보이는데,
한번씩 클릭해서 둘러보시면 음~~ 하고 느낌이 오실 겁니다.

새 글 쓰고 지우기

처음 사용하시분들이 가장 당황하시는 부분이 그럼 대체 새 글은 어떻게 쓰란 말인가? ~~ ㅠㅠ 질문입니다.
예를 들어 2017년의 새로운 목표와 다짐을 2017년이란 제목으로 쓰시고 싶다 가정하면,
화면 오른쪽 상단 돋보기 검색창에 2017년이라 쓰고 엔터를 치시면, 검색 결과가 나오고
오른쪽에 세로줄로 나오는 아이콘 4개 중에 제일 위에 연필+ 가 보입니다. 눌러 봅니다.
에디터 창이 보이고 글을 쓸 수 있습니다.
아무거나 글을 쓰고, 저장 누르신 후에, 오른쪽 상단 사이트맵 눌러 보시면,
2017년 이란 글이 들어간 걸 보실 수 있습니다.

앗! 그러면 2017년 글 밑에 1월이란 글을 쓰고 싶다면 어떻게 할까요?
이런 때는 역시 돋보기 검색창에 2017년:1월 이라고 적고 엔터를 치시고, 연필+ 아이콘을 클릭하시고
아무거나 글을 쓰시고, 저장 누르시고,사이트맵을 눌러봅니다.

아까 쓰셨던 2017년이란 글이 보임과 동시에 2017년이란 분류밑에 1월이란 글이 보입니다.
여기서 도쿠위키 관점에서 정리해보면 검색창에 2017년 이라 치고 글을 쓰면
도쿠위키 홈디렉토리 아래 data/pages 디렉토리에 2017년 이란 파일명으로 파일을 만들고
2017년:1월 이라 치고 글을쓰면 도쿠위키 홈디렉토리 아래 data/pages 디렉토리 아래에
2017년이란 디렉토리를 만들고 그 안에 1월 이란 파일명으로 파일을 만들게 됩니다.
2017년:1월:1주 이렇게 하면 실제 만들어지는 파일은 2017년 디렉토리 아래 1월 이란 디렉토리를 만들고
그 안에 1주 라는 파일명으로 파일을 만들게 되는 것입니다. 이해 되셨죠~~

여기서 글을 쓰고 지우는 방법을 정리해보면

  • 글을 쓰고 지우려면 먼저 로그인이 되어 있어야 합니다.
  • 쓰고 싶은 글의 제목을 검색창에 입력하고 엔터를 칩니다.
  • 연필 아이콘을 눌러 글을 작성합니다.
  • 글의 분류(디렉토리)를 만들고 싶을 땐  콜론(:) 기호를 이용합니다.
  • 글을 지울때 쓴 글의 내용을 다 지우고 저장을 누르면 글이 사라집니다.
  • 글 제목에 공백이 들어가면 자동으로 언더바(__) 로 바뀝니다.
  • 헤드라인(h1~h6 태그)을 잘 이용하시면 목차가 자동으로 만들어집니다.
  • 자동 시작페이지 글은 start 라는 이름으로 만드셔야 합니다.

추천 플러그인

플러그인 설치 및 관리는 관리 메뉴에서 확장기능관리자를 누르시면 됩니다.
로딩이 오래 걸리거나 새로고침을 해줘야 할 때도 있습니다.
개인적으로 꼭 추천 드리는 플러그인은 아래와 같습니다.

  • Wrap 플러그인     –  색깔 텍스트 박스를 만들어 줘서 단락의 의미를 줄 수 있습니다.
  • edittable               –  테이블 태그 플러그인으로 사용이 아주 편합니다.
  • Smtp                      –  메일 전송 플러그인, 메일 전송을 자동화 할 수 있습니다.
  • Tag                         –  포스팅에  태그를 부여하여 효율적인 검색을 도와줍니다.
  • Disscussion          –  포스팅 아래 댓글을 달 수 있게 해 줍니다.
  • Captcha                 –  로봇이 와서 광고성 글 쓰는 걸 막아 줍니다.
  • Iframe                   –  유투브등의 동영상 링크를 삽입할 수 있게 해 줍니다.
  • Bookcreater         –  포스팅 내용을 pdf 책으로 바꿔줍니다.(완벽하진 않음)
    사용을 위해선 dwpdf와 text 플러그인도 같이 필요합니다.
  • 소프트웨어와 관련이 있다면 Syntaxhighlighter4, Codemirror 등도 추천드립니다.
  • 그외 포스팅 글 성격에 맞게 도쿠위키 플러그인 에서 검색하여 설치합니다.

도쿠위키 플러그인 사이트 접속하시면 페이지 아래쪽에 인기도, 최근 업데이트 기준으로 정렬해서
플러그인을 보실 수 있으니, 플러그인 이름 확인 후에 확장기능 관리자에서 이름으로 검색하여
설치하시면 편합니다.
물론 다운로드 받아서 도쿠위키 홈 디렉토리 아래 lib/plugins 디렉토리에 넣으셔도 됩니다.

도쿠위키 글 작성 포맷팅문법

도쿠위키 글 작성 문법은 HTML 문법을 따르지 않는 자체 문법이 있어 조금 연습이 필요합니다.
연습장(Playground)에서 편집기 창 위에 보이는 아이콘을  이용하시면 금방 익숙해지실 겁니다.
간략히 짚어 보도록 하겠습니다. 억지로 외울 필요는 없습니다.
설치를 완료하신 분은  도쿠위키 공식문법 에 꼭 방문하시어 따라해보시길 추천드립니다.

  • 글자 굵게          ** 굵게 하고픈 부분 **
  • 글자 이탤릭       // 이탤릭 하고픈 부분 //
  • 글자 밑줄          __밑줄 하고픈 부분__
  • 글자 지움표시  <del>지움표시 하고픈 부분</del>
  • 글자 첨자          <sup>첨자로 하고픈 부분</sup>
  • 엔터키(Enter) 곧 줄바꿈은    \\
  • 빈칸 스페이스는  도쿠위키 홈 아래   conf/entities 파일에  \_ &nbsp; 라인 추가하고 \_를 이용합니다.
  • 프로그램 코드 삽입은 <file 언어명 다운파일명>프로그램 코드 </file> 식으로
    예를 들면 <file javascript sample.js>자바스크립트 코드</file>
    file 대신 code를 사용하셔도 됩니다.
  • 외부링크    [[링크 URL | 보이는 텍스트 ]] 식으로  예를 들면   [[http://html5around.com/|html5around]]
  • 내부링크    [[페이지명 | 링크텍스트]]식으로  예를 들면 [[:ubuntu:nodejs_nvm|NodeJs_NVM]
  • 섹션링크     [[:네임스페이스:페이지명:#섹션명|원하시는링크명]] 식으로 예를 들면  [[:ubuntu:docker#설치|도커설치]]
  • 이미지링크 [링크 URL|{{네임스페이스:이미지파일명}}]] 식으로
    예를 들면 [[http://html5around.com/|{{dokuwiki:logo_h5ar.png?150×80|서버}}]]
  • 동영상 삽입 Iframe 플러그인 설치 필요
    {{url>유투브-embed-URL width,height noborder | 원하는 텍스트 }} 식으로
    예를 들면
    {{url>https://www.youtube.com/embed/nP1e5fa8dDw?list=PL5FF4088B77B6B3EB 450px,300px noborder | 도큐위키}}
  • Wrap 플러그인과 edittable , tag 플러그인은 설치하면 편집창에 아이콘이 생기니
    연습이 가능하실 겁니다.

플러그인 별로 URL 링크가 있어 각각 사용 설명을 제공하고 있으니,
필요한 플러그인은 해당 링크를 방문하셔서 ,추가적인 기능이나
업데이트 된 내용을 확인하시면 확실하게 도움이 되실 겁니다.

마치며

만약 php5를 사용하시고 계시다면 도쿠위키 최신 버젼은 php7을 지원하고 있으므로 성능향상을 위해서
우분투에서 php5를 php7으로 업그레이드하기   를 참조하셔서 업그레이드 추천 드립니다.
설치한 플러그인 커스터마이징은 도쿠위키 홈 디렉토리아래 lib/plugins 디렉토리에서
수정하고픈 플러그인 디렉토리로 들어가 소스를 수정하시면 됩니다.

제공되는 유용한 템플릿이 거의 없으니, 원하시는 사용용도에 맞게 디자인 템플릿만
잘 만들어 쓰신다면 훌륭한 플랫폼임에 틀림없다고 생각됩니다.

질문이나 댓글 달아주시면 아는 범위에서 성실히 답변 드리겠습니다.
[회원가입도 마찬가지지만 이메일 주소만 제대로 입력하시고 나머지는 편하게 쓰시면 됩니다.^-^]

이 글이 누군가에겐 조금이나마 도움이 되었으면 하는 작은 바램입니다.

소화자

존재를 드러내지 않고 무림의 배후를 조정하는 전설로만 전해지는 무엇이든 소화하는... 갑 오징어~^-^

2
Leave a Reply

avatar
1 Comment threads
1 Thread replies
0 Followers
 
Most reacted comment
Hottest comment thread
2 Comment authors
소화자채동국 Recent comment authors
newest oldest most voted
채동국
Guest
채동국

쉬운 설명 감사합니다.