openNAMU를 사용하여 위키를 만들자!

안녕하세요, 광토리입니다.

이번에는 오픈나무라는 위키 엔진으로 나만의 위키를 만드는 방법을 알아보겠습니다!

---

위키 엔진이 뭘까?

위키 엔진은 위키를 돌리기 위한 프로그램을 뜻합니다.

 

'나무위키'는 the seed라는 엔진을 사용합니다. 하지만 the seed는 오픈 소스가 아니기 때문에 저희가 사용할 수 없습니다. 구글에 검색하면 웬만하면 나오는 '위키백과'는 오픈 소스인 미디어위키 엔진을 사용하긴 합니다만, 문법이 다소 어렵기 때문에 입문이 어려운 편입니다.

 

그래서 제가 추천드리는 위키 엔진은 '오픈나무 openNAMU'라는 위키 엔진입니다. 오픈나무는 나무위키에서 사용하는 문법인 나무마크가 거의 호환되며, 설치와 설정이 간단한 편입니다.

---

오픈나무를 설치하기 전 준비물

위키는 엄연히 웹 사이트입니다. 웹 사이트를 만들기 위해서는 도메인과 위키를 호스팅할 서버가 필요한데, 오픈나무는 Python3 기반으로 만들어져 있기 때문에 Python3을 실행할 수 있는 서버가 필요합니다.

 

서버는 여러가지 있습니다. 집에 있는 PC에서 오픈나무를 계속 켜두면 이것도 서버가 되는 것이죠. 하지만, 전기세 등 여러가지 문제가 있으니 저는 가상서버 호스팅을 추천드립니다.

 

Vultr

• 벌처는 프로모션 링크를 생각보다 자주 뿌리기 때문에 가입하기 전에 그런 링크가 있나 잘 찾아보시기 바랍니다.
• 저는 개인적으로 벌처를 가장 추천드립니다.
• 카드에서 돈이 나가는 방식이 아니라, 충전식이기 때문에 매번 돈이 떨어지면 충전해야 한다는 단점이 있습니다.
• 한글을 지원하지 않습니다.

 

Oracle Cloud

• 돈을 내지 않는 프리 티어도 생각보다 좋은 성능을 가지고 있습니다.
• 메뉴들이 꽤 복잡한 편입니다... 몇 번 계속 쓰면서 익혀야 합니다.
• 선점형으로 운영되고 있기 때문에 서울이나 도쿄 리전에서는 자리가 잘 나지 않습니다. 한국 춘천이나 오사카를 추천드립니다.
• 가끔 무고밴으로 인스턴스가 삭제되는 일이 있다는 말이 있습니다. 사용하실 때 조심하시기 바랍니다.
• 싱가포르 달러로 결제되기 때문에 여러 나라에서 결제할 수 있는 비자 카드, 마스터 카드가 있어야 합니다.

https://it.gwangtori.com/40

무료 VPS!? 오라클 클라우드를 사용해 보자! [1]

 

Google Cloud

• 믿을 수 있는 대기업의 클라우드이기 때문에 믿고 쓸 수 있습니다.
• 이쪽도 무료 등급 인스턴스가 존재합니다.
• 하지만 미국 지역에서만 무료이기 때문에 핑이 높습니다.
• 또, 오라클 클라우드에 비해 스토리지 크기가 작으며 트래픽 제한이 1기가로 빡셉니다.

https://cloud.google.com/

클라우드 컴퓨팅 서비스  |  Google Cloud

 

Cafe24

• 해외 서비스를 이용할 수 없다면 그나마 가장 유명한 카페24를 추천드립니다.
• 성능이 해외에 비해 부족하긴 하지만 파이썬 프로그램을 계속 켜둬야 하는 위키 엔진 특성상 가상서버 호스팅을 사용해야 하는데 가상서버 호스팅을 서비스하는 회사는 적더라구요...
• 벌처보다 CPU의 성능이 좋지 않은 듯합니다. 생각보다 느려요.
• 개인적으로 달러 결제되는 카드를 발급받고 해외 서비스 이용하는 것을 강력히 권해드립니다.

https://hosting.cafe24.com/

카페24 호스팅 | 온라인 비즈니스의 시작

 

PythonAnywhere

• 무료입니다. 개인용으로 위키를 운영하실 분에게는 추천드립니다.
• 느립니다. 서버가 미국에 있어 핑도 높고 무료의 한계로 속도가 느린 편입니다.
• 한글을 지원하지 않습니다.

구축이 살짝 까다로운 편입니다. 자세한 내용은 아래 글을 참고해 주세요.

 

 

자신이 사용하고 있는 PC

• 유지보수 걱정이 없습니다.
• PC를 켜고 있을 때만 사용 가능합니다.
• 포트포워딩을 하지 않으면 공유기가 연결된 기기에서만 접속할 수 있습니다.

자세한 내용은 아래에 '오픈나무 설치하기'의 'Windows' 문단을 참고해 주세요.

---

오픈나무 설치하기

Linux Ubuntu

sudo apt update
sudo apt upgrade

1. 업데이트를 먼저 합니다.

sudo apt install python3
sudo apt install python3-pip

2. Python3와 pip까지 설치합니다. [Y/n]으로 선택지가 나오면 Y를 쳐서 계속 진행합니다.

python3

Python 3.10.6 (main, Nov 14 2022, 16:10:14) [GCC 11.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

3. Python3가 잘 설치되었나 확인합니다. 저는 3.10.6 버전으로 잘 설치되었네요. Ctrl + D로 나와줍니다.

git clone -b beta https://github.com/openNAMU/openNAMU.git
#해당 명령어를 치면 현재 있는 디렉토리에 추가됩니다. 디렉토리를 잘 확인하세요.
#beta 부분에 다른 브랜치를 넣으셔도 됩니다만, dev는 개발 버전이기 때문에 불안정하며 추천하지 않습니다. stable은 안정된 버전입니다. 하지만 업데이트 주기가 늦기 때문에 버그 패치가 오래 걸립니다.
#전 중간 브랜치인 beta를 추천드립니다.

cd openNAMU
#위키 엔진 폴더, openNAMU로 이동합니다.
#cd .. 명령어로 상위 폴더로 이동할 수 있습니다.

python3 app.py
#위키 엔진 실행

4. openNAMU를 설치하고 실행합니다.

5. 오픈나무 초기 설정하기 문단에서 계속됩니다.

---

Windows

윈도우도 간단합니다.

1. Python 홈페이지로 이동합니다. https://www.python.org/downloads/

Download Python

 

2. 원하는 버전을 선택한 후, 자신의 Windows에 맞게 다운로드합니다.

 

3. Add python.exe to PATH를 체크하고 Install Now를 눌러 설치합니다.

 

4. 오픈나무 리포지토리에 들어갑니다. https://github.com/openNAMU/openNAMU

GitHub - openNAMU/openNAMU: 파이썬 기반 위키 엔진 (Python-based wiki engine.)

 

5. Code를 누르고 Download ZIP을 눌러 오픈나무를 다운로드합니다.

 

6. 적당한 곳에 압축을 풀고 app를 실행합니다.

(저는 확장자 표시를 활성화했기 때문에 app.py입니다.)

7. 오픈나무 초기 설정하기 문단에서 계속됩니다.

---

 

위키 시작

엔진이 안 켜져요...

오픈나무를 처음 실행했는데,

/usr/bin/python3: No module named pip
----
Version : v3.4.6-RC2-dev116
DB set version : 3500355
Skin set version : 3500111
----
PIP check pass
----
Traceback (most recent call last):
  File "/home/username/openNAMU/app.py", line 5, in <module>
    from route.tool.func import *
  File "/home/username/openNAMU/route/tool/func.py", line 70, in <module>
    from .func_render import *
  File "/home/username/openNAMU/route/tool/func_render.py", line 1, in <module>
    from .func_render_namumark import *
  File "/home/username/openNAMU/route/tool/func_render_namumark.py", line 1, in <module>
    from .func_tool import *
  File "/home/username/openNAMU/route/tool/func_tool.py", line 4, in <module>
    import flask
ModuleNotFoundError: No module named 'flask'

이와 같이 표시되면서 오픈나무가 꺼지면 다음 명령어로 모듈을 설치해 주세요.
'pip3 install -r requirements.txt'

윈도우에서는 디렉토리 입력 칸에 cmd를 치면 명령 창이 켜집니다.

---

초기 설정

DB type (sqlite) [sqlite, mysql] :

DB를 선택합니다. 소괄호에 써 있는 것이 기본값입니다. 기본값으로 진행하고 싶다면 엔터를 누르시면 넘어갑니다.

가볍게 쓰신다면 sqlite, 몇 천 개 이상의 문서를 만들 예정이라면 mysql를 추천드립니다. mysql은 기본 지식이 있으신 분이 아니라면 권장하지는 않습니다. [MariaDB 설치하기]

 

DB name (data) [] :

DB 이름을 선택합니다. 아무렇게 해도 상관 없습니다.

 

----
Host (0.0.0.0) :

특별한 이유가 없다면 엔터를 눌러 기본값으로 설정합니다.

 

Port (3000) :

포트를 설정합니다. 80으로 설정하시면 IP 뒤에 따로 붙이지 않아도 됩니다. (ex. loaclhost, 12.34.56.78)

기본값으로 설정했다면 localhost:3000, 127.0.0.1:3000이나 VPS IP주소:3000으로 접속할 수 있습니다.

 

Language (ko-KR) [ko-KR, en-US] :

오픈나무는 한국어와 영어 다국어가 지원됩니다. 한국어로 설정할 지, 영어로 설정할 지 고를 수 있습니다.

 

Markup (namumark) [namumark, markdown, custom, raw] :

어떤 문법으로 사용할 지 고를 수 있습니다. 보통은 나무위키에서 편집을 많이하시니 나무마크를 고르게 되죠.

• 나무마크: the seed(나무위키)에서 사용하는 문법입니다.
• 마크다운: 깃허브나 블로그 등에서 잘 쓰이는 마크다운입니다.
• 커스텀: 직접 렌더러를 만들 수 있습니다. 자세한 내용은 다음을 참고하세요. [공식 위키]

 

Encryption method (sha3) [sha3, sha3-salt, sha3-512, sha3-512-salt] :

특별한 이유가 없다면 엔터를 눌러 기본값으로 설정합니다.

 

모두 설정하게 되면 'Now running...'이 표시되고, 위키가 열리게 됩니다.

 

호스팅을 사용하는데 접속이 되지 않는다면 방화벽을 확인하시기 바랍니다.

---

감사합니다!

제가 준비한 것은 여기까지입니다. 봐주셔서 감사합니다.