🍄Wikijs

Wiki.js

공식사이트: https://wiki.js.org
공식문서: https://docs.requarks.io
Github: https://github.com/Requarks/wiki

장점

  • MarkDown 문서로 편집이 가능하다. docuwiki랑 저울질하다가 이것 때문에 Wiki.js를 선택했다.

  • AWS/DigitalOcean 같은 클라우드 위에 쉽게 올릴 수 있도록 market image를 제공한다.

  • Let's Encrypt 등록기능을 자체 제공해주어서 https 쓰기가 편하다.

  • Git/AWS S3 등 데이터백업 및 동기화기능을 제공한다. Github에 연동하면 md파일들을 쉽게 볼수 있다. 이것 또한 md를 고집한 이유이기도 하다. 나중에 Wiki.js 버리게 되더라도 부담이 덜하겠지.

단점

  • 프론트가 vue로 작성되어 있는데 현재 Wiki.js 2.x 버전에서는 SPA가 아니라 링크 누를 때마다 전체페이지를 다시 불러온다. 다소 느린 감이 있다. 어드민만 SPA로 되어 있다. 3.0부터는 모두 SPA로 전환될 예정이다.

  • 아직 RSS/Atom feed 기능이 없다. 쪼르고 있는데, 개발자의 우선순위에서는 아직 밀리고 있다. [여기](https://wiki.js.org/feedback/p/rss-atom-feed) 투표 해서 우선순위 좀 올려봅시다.

AWS에서 간편설치하기

초기 설치 후 설정 변경하기

  • wiki 컨테이너 멈추고 삭제하기 

sudo docker stop wiki
sudo docker rm wiki

  • docker create 명령 (Let's Encrypt 적용, git 백업디렉토리 설정) 

sudo mkdir -p /wiki/git
sudo chown -R ubuntu:ubuntu /wiki
sudo docker create --name=wiki -e LETSENCRYPT_DOMAIN=inbon.net -e LETSENCRYPT_EMAIL=이메일 -e SSL_ACTIVE=1 -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -v /wiki/git:/wiki/git -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 requarks/wiki:2

  • docker create 명령 (Let's Encrypt 미적용, git 백업디렉토리 설정) 

sudo mkdir -p /wiki/git
sudo chown -R ubuntu:ubuntu /wiki
sudo docker create --name=wiki -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -v /wiki/git:/wiki/git -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 requarks/wiki:2

  • wiki 컨테이너 재시작 

sudo docker start wiki

번역 기여하기

나도 2% 기여함 :), 기여하기 어렵지 않음