Search
📚

Wiki.js를 사용하여 WIKI 구축 방법 정리

목차

구축 환경

구축 환경은 아래와 같다. 여러 OS에서 설치가 가능하며 공식 홈페이지로 이동하면 확인 가능하다.
Server : AWS (프리티어 t2.micro) OS : Ubuntu 20.04.2 LTS INSTALL : Docker
Plain Text

설치

원하는 DB를 선택할 수 있으며 docker-compose 를 사용하여 컨테이너를 구성하였다. 본인은 MYSQL 를 사용하였다.
docker-compose.yml 파일 내용 (MYSQL 환경 설정)
Wiki.js 공식 홈페이지에서도 postgres 를 사용한 예시 파일이 존재한다.

환경 설정

관리자 계정 생성 후 초기 페이지 작성

최초 접속 시 아래와 같이 관리자 계정을 생성하는 화면을 확인할 수 있다.
이 화면에서 관리자로 사용할 이메일과 패스워드를 설정한다.
관리자 계정 설정 후 WIKI 접속 시 확인 가능한 첫 페이지를 최초 생성한다.
마크다운 문법을 사용 / 에디터 사용 / HTML 소스코드 작성 등 여러 방법으로 게시글을 작성할 수 있다.
개인적으로 최초 홈페이지를 작성하기 전 기본적인 환경설정을 모두 마치고 작성하는 것을 추천한다.

기본적인 환경 설정

오른쪽 위의 톱니바퀴를 클릭하면 환경 설정이 가능하다.

메일 전송 설정(Gmail 기준)

회사 메일이 Gmail을 사용하여 만든 기업메일이기 때문에 Gmail 기준으로 작성하였다.
Gmail 계정을 사용하여 안내 메일 전송 기능을 사용하기 위해서는 아래 설정을 해야한다.
1.
전송에 사용할 Gmail 계정에 로그인 후 아래 URL에 접속한다.
2.
보안 수준이 낮은 앱 허용 옵션을 아래와 같이 사용 으로 만들어준다.
3. 새로운 사용자에게 계정 활성화 메일 등을 전송하기 위해 wiki.js 설정에서 SMTP 설정을 진행해주어야 한다.
Gmail을 사용하기 때문에 SMTP 호스트 이름을 smtp.gmail.com 을 사용하였다.
아래 유저 이름은 실제 Gmail의 ID와 PW를 입력한다. (회사메일이라 가렸습니당)
4. SMTP 설정 후 테스트 메일 전송을 통해 잘 설정된것을 확인할 수 있다.

계정 인증 설정

사용자가 WIKI에 가입 시 자동으로 가입이 허용되도록 만들어주는 설정이다. GITHUB, SLACK 등 여러 플랫폼을 사용하여 인증을 설정할 수 있다.
이 글에서는 기본 옵션인 Local 기능을 사용하여 설정하였다. 이 기능을 사용하면 메일 옵션에 설정된 메일을 이용하여 회원가입한 계정의 활성화를 위해 확인 메일을 전송하는 방식이다.
자동 가입이 가능한 domain Whitelist 와 자동 가입된 유저가 소속되는 그룹을 아래와 같이 설정한다.

언어 패치

초기 설치 상태일때는 기본적으로 영어로 언어가 설정되어 있다.
언어 메뉴에서 한국어 언어팩을 다운 받은 후 기본 언어를 변경할 수 있다.
1.
한국어 설치
2.
Site Locale 옵션 한국어 로 변경 후 적용
3.
언어가 한국어로 변경된 것을 확인

추가 설정

게시글 트리 부분 없애기

게시글 작성 후 내용 확인 시, 아래 사진과 같이 사이트 중간에 게시글에 대한 정보를 확인할 수 있는 부분이 있다.
해당 부분이 거슬리면 설정의 테마소스코드 삽입해당 부분이 보이지 않도록 소스코드를 삽입해준다.
소스코드 내용
코드 적용 후 다시 게시글을 확인하면 아래와 같이 해당 부분이 보이지 않은 것을 확인할 수 있다.(깨끗 )

사용법

게시글

글 작성

상단의 아이콘을 클릭하면 게시글을 작성할 수 있다.
최초로 만든 페이지(테스트 페이지)는 /home 경로이다. Wiki.js의 게시글 작성 시 경로를 직접 설정하여 진행하는 방식이다.
예시로 테스트 게시글 아래에 새로운 게시글을(/home/TEST1)을 작성한다. 이렇게 진행하게 되면 아래와 같은 구조가 된다.
테스트 는 폴더로 변하며, 아래에 새로운 게시글이 저장되는 형태이다. (폴더로 변해도 게시글은 그대로)
└── 테스트(/home) └── TEST1(/home/TEST1)
Plain Text
이후 페이지 정보를 입력할 때 경로를 다시 설정 가능하다.
마크다운 문법을 사용하여 게시글 작성이 가능하며, 파일 업로드 기능 등 여러 기능을 지원한다.
/home 폴더 아래 TEST1 이라는 게시글이 추가된 것을 확인할 수 있다.