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 이라는 게시글이 추가된 것을 확인할 수 있다.
TOP