4.2 KiB
4.2 KiB
현재 진행 상태
갱신: 2026-09-13
이번에 남아 있던 API 참고 화면 5개까지 번역과 서버 반영 및 검증을 마쳤습니다. 대상은 Trilium입니다.
| 구분 | 완료 | 진행률 |
|---|---|---|
| 도움말 본문 | 173/173 | 100% |
| 도움말 목록 제목 | 181/181 | 100% |
| 영문 감지 이미지의 한국어 설명 | 206/206 | 100% |
| API 참고 화면 | 5/5 | 100% |
기본 예제와 예제 PDF 및 UI 수정분도 운영에 반영했습니다. 이미지는 원본 유지와 한국어 설명 보완 방식입니다.
2026-09-13 API 참고 화면 5개 추가 완료
- 외부 ETAPI 명세: 경로 24개. 제목과 설명 154개 필드에 원문 중복을 제외한 번역 118개를 적용했습니다.
- 내부 API 명세: 경로 37개. 제목과 설명 198개 필드에 원문 중복을 제외한 번역 166개를 적용했습니다.
- 스크립트 참고 자료: 프런트엔드 API와 FNote 및 백엔드 API의 한국어 사본을 만들었습니다. 설명 문구와 반환값 및 매개변수 설명을 번역했습니다. 최종 변환된 텍스트 노드는 각각 170개와 179개 및 213개입니다. 식별자와 코드 형식은 유지했습니다.
- 기본 도움말 노트 3개의 webViewSrc를 한국어 사본으로 연결했습니다. 원문 링크와 연결된 다른 형식의 공식 문서 링크는 보존했습니다. 개인 노트는 수정하지 않았습니다.
- Swagger 화면의 인증 설정과 직접 실행 및 매개변수와 응답 등 조작 문구를 번역했습니다. 예제 오류 메시지 3개도 번역했습니다. ETAPI 예제 서버 주소는 브라우저에서 현재 서버를 사용할 수 있도록 /etapi로 지정했습니다.
- 실제 화면 검증 중 기존 번들에서 Swagger 정적 파일이 빠져 문서가 비어 보이는 문제를 발견했습니다. 공식 npm swagger-ui-dist 5.21.0의 배포 무결성을 검증한 뒤 필요한 파일만 추가했습니다. LICENSE와 NOTICE를 보존했습니다. 번들 내부 정적 경로도 해당 위치로 연결했습니다.
- 새 정적 파일의 읽기 권한을 컨테이너에 맞췄습니다. 초기 검증의 일반 문구 검사 조건은 문서별 실제 제목 검사로 수정했습니다. 최종 검증은 모두 통과했습니다.
- 검증: API 호출 방식과 매개변수 및 스키마의 구조를 원본과 비교했습니다. 번역 대상 설명과 예제 메시지 및 문서용 서버 주소 외에는 일치합니다. 스크립트 문서의 미번역 일반 영문 문장 검사 결과는 0개입니다. 코드와 이름 및 URL은 이 검사에서 번역 대상으로 보지 않습니다.
- 운영 검증: 정적 응답 8개 해시 일치. Swagger 경로 2개 정상. 기본 노트 연결 3개 일치. 브라우저에서 외부 API 검색 항목을 펼쳐 한국어 설명과 매개변수를 확인했습니다. 내부 API 목록과 프런트엔드 한국어 사본도 실제로 열어 확인했습니다. API 실행 요청으로 사용자 데이터를 생성하거나 삭제하지 않았습니다.
- 현재 자산 버전: v0.95.0-ko-20260913-r8
- 현재 main.cjs SHA-256: 5209c39355837fb21714c1b61d8569d3eee71f620a8e8c1a3755ccc38aa92616
- 최초 백업: /www/dk_project/dk_app/trilium/backups/before-korean-phase9-20260913-181647
- 최종 보완 전 백업: /www/dk_project/dk_app/trilium/backups/before-api-final-20260913-182417
적용 범위와 유지한 원문
앞서 남겨 둔 API 참고 화면 5개는 이번에 모두 처리했습니다. 기존 이미지를 유지하고 한국어 설명을 추가한다는 사용자 선택을 따릅니다. 코드 문법과 함수·매개변수 이름 및 제품 이름과 URL은 원문을 유지합니다. 한국어 사본에서 다시 연결되는 외부 사이트 전체를 번역하거나 수정한 것은 아닙니다. 외부 스크립트 문서는 공식 연결 주소의 사본이므로 현재 운영 버전 0.95.0과 API 지원 범위가 다를 수 있음을 화면에 명시했습니다.
현재 도움말 구성은 phase3/doc_notes/en에 phase8/doc_notes/en을 덮고 phase9/doc_notes/en을 덮은 결과입니다. 현재 앱 파일은 deployed에 있습니다. 초기 빌드 산출물과 단계별 파일을 현재 운영본으로 오인하지 마세요.