# 2026-09-05 한글화 작업 기록

TriliumNext 0.95.0 운영 환경에 적용한 수정본과 진행 중인 번역 자료를 함께 보관합니다. 전체 한글화는 아직 완료되지 않았습니다. 이 폴더를 추가해도 저장소 루트의 기존 설치 프로그램이나 v1.0.0 배포 파일은 바뀌지 않습니다.

## 진행 상태

| 구분 | 이번 작업의 결과 | 운영 서버 적용 |
|---|---|---|
| 기본 예제 | 148개 노트의 제목 또는 본문 수정 | 완료 |
| 편집기 | 한국어 사전 719개 문구와 추가 메뉴 수정 | 완료 |
| 일반 화면 | 한국어 문장과 안내문 90개 항목 조정 | 완료 |
| 캔버스 | 한국어 언어 설정 추가 | 완료. 개별 기능의 화면 점검 남음 |
| 마인드맵 | 한국어 언어 설정과 메뉴 및 안내문 수정 | 완료. 개별 기능의 화면 점검 남음 |
| 이모지 | Unicode CLDR 한국어 이름과 검색어 반영 | 완료 |
| 기본 도움말 | 173개 파일 중 100개 처리. 57.8% | 미적용 |
| 최상위 노트와 일지 | 기존 운영 화면에서 제목 변경 | 완료. 별도 수동 변경 |

도움말 수에는 원래 본문이 비어 있는 3개 파일이 포함됩니다. 전체 한글화 진행률과 도움말 파일 처리율은 다른 지표입니다. PDF와 이미지 안의 영문 및 추가 입력란을 점검해야 하므로 전체 완료율은 확정하지 않았습니다.

## 폴더 구성

- `deployed/`: 운영 서버의 실제 적용 파일과 동일성을 검사한 자산입니다. `main.cjs`의 자산 주소 접미사는 `-ko-20260905-r2`입니다.
- `work/trilium/`: 번역 원본과 빌더 및 검증 도구입니다. 기존 빌더의 상대 경로를 유지했습니다.
- `work/trilium/release/`: 생성된 파일입니다. 도움말은 미완성 준비본입니다. 이곳의 `main.cjs`는 첫 배포 단계의 생성본이며 최신 운영본은 `deployed/main.cjs`입니다.
- `work/trilium/scoped/`: 기본 예제 하위 트리만 추출한 자료와 배포 이미지에 포함된 정적 도움말 및 코드 원본입니다.
- `CHANGELOG.ko.md`: 변경 이유와 구현 방식 및 검증 결과와 남은 작업입니다.
- `SHA256SUMS.json`: 이 작업 폴더의 파일 크기와 SHA-256 목록입니다. 목록 파일 자체는 제외합니다.

데이터베이스와 인증 키 및 세션 데이터는 포함하지 않습니다. 배포 스크립트에는 해당 운영 환경의 경로가 들어 있으므로 다른 서버에서 그대로 실행하는 범용 설치 도구가 아닙니다.

## 번역본 재생성

Node.js 24.19.0에서 실행했습니다. 이 날짜 폴더에서 다음 명령을 실행합니다. 추가 패키지 설치는 필요하지 않습니다.

```sh
node work/trilium/build-ui.mjs
node work/trilium/build-demo.mjs
node work/trilium/validate-demo.mjs
node work/trilium/build-docs.mjs
```

`build-server.mjs`는 초기 서버 패치와 예제 이전 훅을 생성하는 기록용 빌더입니다. 현재 운영본과 초기 생성본의 차이는 자산 URL 접미사입니다. 새 Trilium 버전에 번들을 그대로 덮어쓰면 안 됩니다. 해당 버전의 원본과 패치 위치를 먼저 대조해야 합니다.

## 도움말 작업 계속하기

`docs-order.json`이 문서 순서를 고정합니다. 0~99번까지 번역했으며 다음 작업은 100번부터입니다. `docs-ko-001.mjs`부터 `docs-ko-008.mjs`까지 번역을 담고 있습니다.

```sh
node work/trilium/docs-batch.mjs 100 5
node work/trilium/build-docs.mjs
```

새 번역 모듈을 작성하면 `build-docs.mjs`에 등록하세요. 검증 도구는 원본과 번역본의 링크 및 이미지 경로 목록을 비교합니다. 본문 의미와 그림 속 글자 및 실행 결과까지 보증하는 검사는 아닙니다.

## 운영 적용 및 복구

최신 배포는 `deploy-ui-phase2.py`로 수행했습니다. 적용 직전 파일을 백업하고 Compose 구문 검사 후 Trilium 컨테이너만 재생성합니다. 상태 검사와 실제 자산 해시 확인이 실패하면 기존 파일과 Compose 설정을 복구합니다.

최신 백업 위치:

```text
/www/dk_project/dk_app/trilium/backups/before-korean-ui-phase2-20260905-154240
```

기존 DB 백업과 예제 적용 전 백업 위치는 변경 기록을 참고하세요. 이 저장소에 백업 DB는 올리지 않습니다. 서버 접근 권한이나 포트 공개 범위 및 인증 설정을 바꾸는 작업은 수행하지 않았습니다.

## 출처와 라이선스

TriliumNext 배포 이미지에 포함된 소스와 도움말 및 기본 예제의 권리는 원저작자에게 있습니다. 기존 소스의 라이선스 표시를 유지합니다. CKEditor 45.2.0 공식 한국어 번역은 CKSource의 배포 자료를 사용했습니다. 이모지 한국어 이름은 Unicode CLDR 자료를 사용했습니다. 이 기록은 원본 구성 요소에 새로운 라이선스를 부여하지 않습니다.

- [TriliumNext](https://github.com/TriliumNext/Notes)
- [CKEditor 한국어 번역 원본](https://cdn.ckeditor.com/ckeditor5/45.2.0/translations/ko.js)
- [CKEditor 라이선스 안내](https://ckeditor.com/legal/ckeditor-licensing-options)
- [Unicode CLDR JSON](https://github.com/unicode-org/cldr-json)