안녕하세요. 일루넥스 개발팀 박두현입니다.
이번 글의 내용은 Wiki.js에 관한 내용입니다.
일루넥스에서는 관계망에 표현되는 기업, 산업, 기술 정보등을 수집하기 위해 Wiki.js를 사용하고 있습니다.
이번에는 Wiki.js의 사용법에 대해 정리해보겠습니다.
Wiki.js ?
Wiki.js는 Node.js 기반의 오픈소스 위키 엔진이다.
설치가 쉽고 확장성이 높다는 것이 장점인 플랫폼이며 다음과 같은 특징들이 있다.
- 거의 모든 플랫폼에서 동작하며 PostgreSQL, MySQL, MariaDB, MSSQL, SQLite와 호환가능하다.
- Node.js 엔진을 사용하여 성능 최적화를 지향하며 MarkDown을 지원한다.
- 위키의 모든 컨텐츠를 관리할 수 있는 관리 페이지를 제공한다.
- 2.0 버전 이후에 여러 테마를 지원할 예정이다.
AWS EC2에서 Wiki.js 설치하기
AWS Marketplace에서 Wiki.js를 클릭 몇 번으로 설치할 수 있게 해주는 Amazon Machine Image(AMI)를 지원한다.
이 AMI 안에는 도커, PostgreSQL, Wiki.js 등 Wiki.js를 시작하기 위한 모든 것이 포함되어있다.
1. 설치 방법
AWS AMI에서 Wiki.js를 검색하여 적당한 인스턴스를 생성한다.
- 인스턴스 시작 후 퍼블릭 DNS(IP 주소)로 접속하여 관리자 계정을 생성한다. (이메일 계정)
여기까지 완료한 후 다시 URL로 접속하면 로그인 페이지가 뜨고 관리자 계정으로 로그인 후 Wiki.js를 사용할 수 있다.
위와 같이 사전에 구축된 클라우드 이미지로 정말 간단하게 설치할 수 도 있고, 위에서 설명한 것 처럼 여러 플랫폼에서 설치하는 방법이 Wiki.js 공식 위키에 자세히 정리되어 있다.
2. Wiki.js 사용하기
Wiki.js는 말 그대로 문서를 관리하기 위한 플랫폼으로 기존의 폴더 구조와 달리 모든 경로에 해당하는 페이지가 존재한다.
그래서 페이지와 URL 경로만으로 모든 문서를 관리할 수 있고 문서를 작성하면 경로에 따라 자동으로 폴더가 생성된다.
폴더와 문서 생성 방법
Wiki.js 사이트 상단의 새문서 버튼을 클릭하면 다음과 같은 창이 뜬다.
기본적으로 Wiki.js의 최상위 도메인은 ko/ 이다. (언어설정에 따라 다르다)
ko/ 라는 경로 다음에 하위 도메인을 작성할 수 있으며 가장 마지막 경로가 페이지의 이름이 되고, 나머지는 자동으로 폴더로 생성된다.
예시) 다음 문서의 경로는 ko/home/반도체/기술/기타/2 이다.
자동으로 생성된 폴더의 구조를 보면 루트/홈페이지/반도체/기술/기타 까지가 폴더이고 가장 마지막의 2가 페이지의 이름이다.
※ 여기서 왼쪽 메뉴에 나타나는 현재 디렉토리의 문서의 이름(품목분류 개요)는 2 라는 페이지의 이름과 별개로, 2라는 페이지 위에 에디터로 작성한 문서의 제목이다.
문서 관리하기
관리자 계정으로 로그인한 상태로 상단의 계정 > 관리로 들어가면 Wiki.js 관리자 페이지가 나온다.
여기에서 일반 사용자들의 권한 관리, 작성된 문서 관리(삭제 등), 여러 시스템 설정을 할 수 있다.
마치며
오늘은 Wiki.js에 대해 알아보았습니다.
오픈소스로 이 정도의 완성도와 편리함을 제공해주는 플랫폼이 있다는 것이 놀랍고,
메인 버전이 업그레이드 될 때마다 많은 기능이 추가되고 있어서 앞으로 더 기대가 되는 플랫폼이 될 것 같습니다.
