Discourse 한국어 보완

forum.itosm.co.kr에서 사용하는 Discourse 한국어 번역과 관리자 설정 이름 보완 플러그인이다. 일반 화면과 관리자 화면 및 활성 플러그인의 한국어 누락을 보완한다.

구성

• plugin.rb: 관리자 설정 이름과 플러그인 표시 문구 보완
• config/locales/client.ko.yml: 브라우저 화면 번역
• config/locales/server.ko.yml: 서버 문구와 설정 설명 번역
• config/locales/*-quality.ko.yml: 기능별 검수 원본
• patches/: 별도 플러그인에 반영한 화면 수정 원본
• docs/: 작업 기록과 Trilium 대응 문서

작성자

이창현 (Lee Chang Hyun) syskiller@naver.com

검사

저장소 루트에서 다음 명령을 실행한다.

yarn test

Ruby 문법과 모든 한국어 YAML 파일의 구조를 검사한다.

운영 배포

Ubuntu 서버에서 저장소를 최신 상태로 만든 뒤 다음 명령을 실행한다.

yarn deploy

기본 배포 대상은 app 컨테이너와 https://forum.itosm.co.kr이다. 다른 환경에서는 아래처럼 지정한다.

DISCOURSE_CONTAINER=app DISCOURSE_URL=https://forum.itosm.co.kr yarn deploy

배포 명령은 검사 통과 후 실행 파일만 itosm-admin-korean 플러그인 경로에 복사한다. 이후 대상 컨테이너만 다시 시작하고 HTTP 200 응답을 확인한다. 백업은 자동으로 만들지 않는다. 백업이 필요한 작업은 별도 승인을 받은 뒤 먼저 진행한다.

배포하지 않고 운영 상태만 확인하려면 다음 명령을 사용한다.

yarn verify:deployment

Gitea에서 새 서버로 설치

서버의 Git 인증 설정을 사용해 저장소를 받은 뒤 검사와 배포를 실행한다. 인증 정보는 저장소나 명령에 넣지 않는다.

git clone https://gitea.itosm.co.kr/syskiller/discourse-korean-localization.git
cd discourse-korean-localization
corepack yarn test
corepack yarn deploy

기록

• PROJECT_MEMORY.md: 운영 결정과 적용 범위
• 수정기록.txt: 날짜별 변경과 검사 결과
• docs/: Trilium 대응 문서와 상세 운영 기록