문서: 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
+32
View File
@@ -0,0 +1,32 @@
# Discourse 한국어 보완 프로젝트 기록
이 문서는 포럼과 관리자 화면의 한국어 보완과 공식 기여 준비 기록을 관리한다. 게임과 게임 제작 도구의 기록과 분리한다.
## 2026-09-20 Discourse 한국어 화면 보완과 운영 확인
- `forum.itosm.co.kr`의 최신 글과 관리자 대시보드와 채팅과 음성 대화방과 로그인 화면에서 영어로 남은 사용자 문구를 한국어 재정의로 보완했다.
- Discourse 코어와 Chat 플러그인과 Voice 플러그인의 번역 누락을 구분해 총 182개의 한국어 재정의를 저장했다. 기본 음성 대화방 이름은 `자유 대화방`으로 바꾸고 설명도 한국어로 정리했다.
- 변경 전 업로드 파일을 포함한 Discourse 전체 백업 `itosm-2026-09-20-093718-v20260915204557.tar.gz`을 만들었다. 백업 크기는 7.0 MB다.
- 공식 실행 구성인 `/var/discourse/launcher`와 `/var/discourse/containers/app.yml`은 수정하지 않았다. 컨테이너 재시작도 하지 않았다. aaPanel에서 기존 Docker 컨테이너와 8880 포트 연결과 `forum.itosm.co.kr` 역방향 프록시와 SSL 연결을 유지했다.
- 데스크톱과 390×844 모바일 화면에서 최신 글과 관리자 대시보드가 정상 표시되는지 확인했다. 비로그인 로그인 화면과 비밀번호 재설정 창도 실제 메일 발송이나 비밀번호 변경 없이 확인했다.
- 로그인과 SMTP 설정은 이미 정상인 상태를 보존했다. 계정과 비밀번호와 메일 서버 설정은 변경하지 않았다.
- 일부 기본 안내 글 제목과 Discourse 제품 표기는 번역 대상이 아닌 콘텐츠와 제품 고유 표기로 남아 있다.
## 2026-09-20 Discourse 관리자 한글화 확대와 Yarn 실행 환경 정비
- 사용자 전용 경로에 Node.js 22.23.2와 Corepack 0.34.6을 설치하고 저장소가 지정한 Yarn 4.0.0-rc.40을 활성화했다. 공식 체크섬 검사를 통과했다.
- `/home/syskiller/.local/bin`에서 `node`, `npm`, `npx`, `corepack`, `yarn` 명령을 사용할 수 있다.
- `yarn lint-staged`를 실행해 명령이 정상 동작함을 확인했다.
- 관리자 대시보드와 탐색 메뉴와 플러그인 상단 안내의 누락 번역을 보완했다. 한국어 번역 덮어쓰기는 182개에서 234개로 늘었다.
- 신뢰 레벨 변화와 검색 요약과 릴리스 변경 수와 새 소식 및 고급 메뉴를 실제 관리자 화면에서 확인했다.
- 플러그인 표의 제품명과 설명 중 일부는 번역 키가 아니라 플러그인 코드 메타데이터에 직접 적혀 있어 일반 번역 덮어쓰기로 바뀌지 않는다. 정식 배포판 반영 작업에서 플러그인별 변경으로 분리한다.
- 데이터베이스 구조와 일반 콘텐츠 데이터는 변경하지 않았다. Discourse 한국어 번역 덮어쓰기 레코드만 추가했다.
- 컨테이너와 서비스는 재시작하지 않았다. 기존 전체 백업 `itosm-2026-09-20-093718-v20260915204557.tar.gz`를 복구 기준으로 유지한다.
- Discourse 공식 번역은 Crowdin 기반이며 `translate.discourse.org`에서 기여한 번역이 정기적으로 저장소에 반영된다. 누락 번역을 검증한 뒤 공통 번역과 플러그인 코드 변경을 나눠 공식 기여용으로 정리한다.
## 2026-09-20 공식 기여자 표기 확정
- Discourse 한국어 번역과 관련 코드의 공식 제출자 이름은 `이창현 (Lee Chang Hyun)`으로 사용한다.
- 공식 제출 및 커밋 이메일은 `syskiller@naver.com`으로 사용한다.
- 저장소 로컬 Git 작성자 설정도 같은 정보로 맞췄다.
+6
View File
@@ -10,3 +10,9 @@ Discourse 관리자 설정 화면에서 내부 설정 키를 영어 문장으로
## 작성자 ## 작성자
이창현 (Lee Chang Hyun) <syskiller@naver.com> 이창현 (Lee Chang Hyun) <syskiller@naver.com>
## 프로젝트 기록
- `PROJECT_MEMORY.md`: 운영 결정과 적용 범위
- `수정기록.txt`: 날짜별 변경과 검사 및 복구 기준
- `docs/`: Trilium 대응 문서와 상세 운영 기록
+40 -8
View File
@@ -1,19 +1,51 @@
# 한국어 번역 기반 작업 · 2026-09-20 # 한국어 번역 기반 작업 · 2026-09-20
- Trilium 노트 ID: `dZobqUI4a5ZH` - Trilium 노트 ID: `dZobqUl4a5ZH`
- 상위 폴더: `Discourse 한국어 배포` · `1wcGHtWA2OEz` - 상위 폴더: `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**으로 사용한다.
+2 -2
View File
@@ -1,9 +1,9 @@
# Discourse 한국어 배포 # Discourse 한국어 배포
Trilium의 `블리어스 (ITOSMGames)` 바로 아래에 만든 전용 분류다. 포럼과 관리자 패널의 한국어 번역 적용 기록과 공식 배포판 기여 준비를 이곳에서 관리한다. Trilium의 `Ubuntu 서버 운영` 바로 아래에 만든 전용 분류다. 포럼과 관리자 패널의 한국어 번역 적용 기록과 공식 배포판 기여 준비를 이곳에서 관리한다.
- Trilium 폴더 노트: `1wcGHtWA2OEz` - Trilium 폴더 노트: `1wcGHtWA2OEz`
- 상위 노트: `블리어스 (ITOSMGames)` · `LrrNdhdqVAes` - 상위 노트: `Ubuntu 서버 운영` · `rwBRtSdCR34B`
- 데이터베이스 변경: 없음 - 데이터베이스 변경: 없음
## 문서 목록 ## 문서 목록
+29
View File
@@ -0,0 +1,29 @@
Discourse 한국어 보완 수정 기록
[2026-09-20] Discourse 한국어 화면 보완과 회귀 검사
- 작업 대상: https://forum.itosm.co.kr
- 변경 이유: 최신 Discourse 코어와 Chat 및 Voice 플러그인에서 한국어가 누락된 사용자 화면과 관리자 화면 문구를 정리했다.
- 변경 내용: 한국어 재정의 182개를 저장했다. 기본 음성 대화방 이름과 설명을 한국어로 바꿨다. 관리자 그룹 소개 문구도 한국어로 저장했다.
- DB 변경: `translation_overrides`와 음성 대화방 및 관리자 그룹 소개 데이터만 변경했다. DB 구조와 데이터 이전은 없다.
- 백업: `itosm-2026-09-20-093718-v20260915204557.tar.gz` 7.0 MB. 업로드 파일을 포함한 Discourse 전체 백업이다.
- 검사: 데스크톱 최신 글과 관리자 대시보드와 채팅 및 음성 메뉴를 확인했다. 390×844 모바일 최신 글과 관리자 대시보드를 확인했다. 비로그인 로그인 화면과 비밀번호 재설정 창을 확인했다.
- 운영 반영: 운영 DB의 공식 번역 재정의 기능으로 즉시 반영했다. 컨테이너 재시작은 하지 않았다. aaPanel의 Docker 컨테이너와 역방향 프록시와 SSL 연결은 유지했다.
- 보존 사항: `/var/discourse/launcher`와 `/var/discourse/containers/app.yml`과 SMTP와 로그인 설정은 수정하지 않았다. 비밀번호 재설정 메일은 보내지 않았다.
- 남은 제한: 기본 안내 글 제목과 제품 고유 표기 일부는 콘텐츠와 고유 이름으로 남아 있다.
## 2026-09-20 Discourse 관리자 한글화 확대와 Yarn 실행 환경 정비
- Node.js 22.23.2와 Corepack 0.34.6을 사용자 전용 경로에 설치했다. 공식 체크섬 확인 후 저장소 지정 버전인 Yarn 4.0.0-rc.40을 활성화했다.
- `node`, `npm`, `npx`, `corepack`, `yarn` 명령 경로와 버전을 확인했다. `yarn lint-staged`도 정상 실행됐다.
- 관리자 대시보드와 탐색 메뉴와 플러그인 안내의 누락 번역을 보완했다. 한국어 번역 덮어쓰기는 182개에서 234개로 늘었다.
- 실제 관리자 화면에서 새 소식과 고급 메뉴와 신뢰 레벨 변화와 검색 요약과 릴리스 변경 수를 확인했다.
- 플러그인 이름과 설명 일부는 플러그인 코드 메타데이터에 영문으로 고정돼 있어 번역 덮어쓰기 대상이 아니다. 정식 배포판 반영 때 플러그인별 변경으로 분리한다.
- 데이터베이스 구조와 일반 콘텐츠 데이터는 변경하지 않았다. 컨테이너와 서비스는 재시작하지 않았다.
- 복구 기준: `itosm-2026-09-20-093718-v20260915204557.tar.gz`
- Discourse 공식 번역 경로인 `translate.discourse.org`와 Crowdin 반영 절차를 확인했다. 공통 누락 번역과 플러그인 코드 변경을 나눠 공식 기여용으로 정리한다.
## 2026-09-20 공식 기여자 표기 확정
- Discourse 공식 번역과 코드 기여의 제출자를 `이창현 (Lee Chang Hyun)`으로 정했다.
- 제출 및 커밋 이메일은 `syskiller@naver.com`으로 정했다.
- 저장소 로컬 Git 작성자 설정에 반영하고 값을 다시 확인했다.