5.1 KiB
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에서 실행했습니다. 이 날짜 폴더에서 다음 명령을 실행합니다. 추가 패키지 설치는 필요하지 않습니다.
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까지 번역을 담고 있습니다.
node work/trilium/docs-batch.mjs 100 5
node work/trilium/build-docs.mjs
새 번역 모듈을 작성하면 build-docs.mjs에 등록하세요. 검증 도구는 원본과 번역본의 링크 및 이미지 경로 목록을 비교합니다. 본문 의미와 그림 속 글자 및 실행 결과까지 보증하는 검사는 아닙니다.
운영 적용 및 복구
최신 배포는 deploy-ui-phase2.py로 수행했습니다. 적용 직전 파일을 백업하고 Compose 구문 검사 후 Trilium 컨테이너만 재생성합니다. 상태 검사와 실제 자산 해시 확인이 실패하면 기존 파일과 Compose 설정을 복구합니다.
최신 백업 위치:
/www/dk_project/dk_app/trilium/backups/before-korean-ui-phase2-20260905-154240
기존 DB 백업과 예제 적용 전 백업 위치는 변경 기록을 참고하세요. 이 저장소에 백업 DB는 올리지 않습니다. 서버 접근 권한이나 포트 공개 범위 및 인증 설정을 바꾸는 작업은 수행하지 않았습니다.
출처와 라이선스
TriliumNext 배포 이미지에 포함된 소스와 도움말 및 기본 예제의 권리는 원저작자에게 있습니다. 기존 소스의 라이선스 표시를 유지합니다. CKEditor 45.2.0 공식 한국어 번역은 CKSource의 배포 자료를 사용했습니다. 이모지 한국어 이름은 Unicode CLDR 자료를 사용했습니다. 이 기록은 원본 구성 요소에 새로운 라이선스를 부여하지 않습니다.