문서: Discourse 기록을 독립 저장소로 통합

게임 저장소에 섞여 있던 한국어 화면 보완 기록과 운영 검사 및 공식 기여 기준을 전용 프로젝트 기록으로 옮긴다.

Trilium 위치는 Ubuntu 서버 운영 아래의 Discourse 한국어 배포 분류로 바로잡았다.

이동 전 백업은 /home/syskiller/backups/discourse/20260920-114500-record-reclassification에 있다.
This commit is contained in:
이창현
2026-09-20 11:31:12 +00:00
parent cc13baa20b
commit 9d4483ff85
5 changed files with 109 additions and 10 deletions
+40 -8
View File
@@ -1,19 +1,51 @@
# 한국어 번역 기반 작업 · 2026-09-20
- Trilium 노트 ID: `dZobqUI4a5ZH`
- Trilium 노트 ID: `dZobqUl4a5ZH`
- 상위 폴더: `Discourse 한국어 배포` · `1wcGHtWA2OEz`
- 운영 분류: `Ubuntu 서버 운영` · `rwBRtSdCR34B`
## 작업 개요
`forum.itosm.co.kr`의 사용자 화면과 관리자 화면에서 영어로 남은 항목을 점검했다. Discourse 코어와 Chat 플러그인과 Voice 플러그인의 번역 누락을 나눠 확인한 뒤 공식 한국어 계정의 기본 번역을 보완했다.
2026년 9월 20일 `forum.itosm.co.kr`의 사용자 화면과 관리자 화면에서 영어로 남은 항목을 점검했다. Discourse 코어와 Chat 플러그인과 Voice 플러그인의 번역 누락을 나눠 확인한 뒤 공식 한국어 재정의 기능으로 보완했다.
## 적용 내용
- 한국어 계정의 번역 182개를 저장했다.
- 최신 글과 관리자 대시보드와 채팅 및 음성 메뉴와 로그인 화면의 주요 영문 문구를 보완했다.
- 기본 음성 대화 서비스 이름을 자연스러운 한국어로 바꿨다.
- 운영 화면에서 주요 사용자 흐름과 관리자 메뉴 표시를 확인했다.
- 한국어 재정의 182개 저장
- 기본 음성 대화방 이름을 `자유 대화방`으로 변경
- 기본 음성 대화방 설명과 관리자 그룹 소개를 한국어로 정리
- 최신 글과 관리자 대시보드와 채팅 및 음성 메뉴와 로그인 화면의 주요 영어 문구 보완
## 기록 구조 변경
## 백업과 보존
처음에는 `버전 기록` 아래에 문서가 잘못 만들어졌다. 내용을 보존한 채 `블리어스 (ITOSMGames)` 아래의 새 전용 폴더로 옮겨 다시 구성했다. 잘못 배치된 원본 노트는 새 문서의 저장과 내용을 확인한 뒤 정리했다.
작업 전 업로드 파일을 포함한 Discourse 전체 백업 `itosm-2026-09-20-093718-v20260915204557.tar.gz`을 만들었다. 크기는 7.0 MB다. 공식 실행 구성인 `/var/discourse/launcher`와 `/var/discourse/containers/app.yml`은 수정하지 않았다. SMTP와 로그인 설정도 변경하지 않았다.
## 검사 결과
데스크톱과 390×844 모바일 화면에서 최신 글과 관리자 대시보드를 확인했다. 비로그인 로그인 화면과 비밀번호 재설정 창도 확인했다. 실제 비밀번호 변경과 재설정 메일 발송은 하지 않았다. aaPanel의 Docker 컨테이너와 8880 포트 연결과 역방향 프록시와 SSL 연결은 기존 상태를 유지했다. 컨테이너 재시작은 하지 않았다.
## 남은 범위
기본 안내 글 제목과 Discourse 제품 표기는 번역 대상이 아닌 콘텐츠와 제품 고유 표기로 남겨 두었다.
## 관리자 화면 추가 보완과 개발 명령 정비
| 항목 | 결과 |
| --- | --- |
| 개발 명령 환경 | Node.js 22.23.2와 Corepack 0.34.6을 사용자 전용 경로에 설치하고 Yarn 4.0.0-rc.40을 활성화했다. |
| 무결성 확인 | Node.js 공식 체크섬 검사를 통과했다. |
| 명령 검사 | `yarn lint-staged`가 정상 실행됐다. |
| 관리자 번역 | 대시보드와 탐색 메뉴와 플러그인 상단 안내를 보완했다. 한국어 번역 덮어쓰기는 234개다. |
| 실제 화면 확인 | 새 소식과 고급 메뉴와 신뢰 레벨 변화와 검색 요약과 릴리스 변경 수를 확인했다. |
| 데이터 변경 | 데이터베이스 구조와 일반 콘텐츠는 바꾸지 않았다. 한국어 번역 덮어쓰기 레코드만 추가했다. |
| 서비스 영향 | 컨테이너와 서비스는 재시작하지 않았다. |
| 복구 기준 | `itosm-2026-09-20-093718-v20260915204557.tar.gz` |
### 정식 배포판 반영 기준
Discourse의 일반 번역과 번역 키를 제공하는 공식 플러그인 번역은 `translate.discourse.org`의 Crowdin 작업으로 제출한다. 사이트 이름과 운영 정책처럼 ITOSM에만 해당하는 표현은 공식 번역에서 제외한다. 플러그인 이름과 설명처럼 코드 메타데이터에 직접 적힌 영문은 번역 파일과 분리해 해당 플러그인 저장소의 코드 변경으로 준비한다. 큰 문구 변경은 Discourse Meta의 번역 분류에서 먼저 검토받는다.
### 공식 기여자 표기
Discourse 공식 번역과 관련 코드 변경의 제출자는 **이창현 (Lee Chang Hyun)**으로 사용한다. 제출 및 커밋 이메일은 **syskiller@naver.com**으로 사용한다.