docs: 한글화 운영 적용본과 도움말 100개 작업 기록 보관

updates/2026-09-05/work/trilium/docs-ko-002.mjs

@@ -0,0 +1,28 @@
+const p=s=>'<p>'+s+'</p>';
+export default {
+ 30:({a,pre})=>p('동기화 중에 갱신할 항목을 계산하는 데 시간이 오래 걸릴 수 있습니다. 역방향 프록시를 사용하는 환경에서는 이때 요청 시간이 초과될 수 있습니다.')+p('프록시의 시간 제한을 늘리면 해결할 수 있습니다.')+'<h2>Nginx</h2>'+p('설정 파일에 다음 내용을 추가하세요.')+pre(0)+p('설정을 저장한 뒤 서버를 다시 시작하세요.')+p('Nginx 설정에 관한 자세한 내용은 '+a(0,'Nginx 프록시 설정')+'을 참고하세요.')+p('문제가 계속되면 시간 제한을 더 늘려 보세요.'),
+ 31:({a})=>p('MindElixir는 '+a(0,'마인드맵 노트')+'에 사용하는 라이브러리입니다.')+p('핵심 라이브러리는 '+a(1,'GitHub의 mind-elixir-core')+'에서 확인할 수 있습니다.')+p('기본 배포판에서는 라이브러리를 추가 수정 없이 포함합니다.')+p('라이브러리 자체의 기능에 문제가 있다면 일반적으로 '+a(2,'원본 프로젝트')+'에 보고하는 것이 좋습니다.')+'<h2>플러그인</h2>'+p('MindElixir는 플러그인을 지원합니다. Trilium에서는 '+a(3,'node-menu 플러그인')+'을 이용해 항목의 글꼴과 색상 및 링크를 편집할 수 있게 합니다.'),
+ 32:({a,img})=>p(img(0,'유사한 노트 목록'))+p('유사한 노트 기능은 본문 내용과 노트 사이의 관계 및 생성 날짜를 살펴 현재 노트와 관련된 노트를 찾습니다.')+p(a(0,'리본 메뉴')+'에서 유사한 노트 탭을 누르면 목록을 볼 수 있습니다.')+'<h2>사용 방법</h2><ul><li>노트 위에 마우스를 올리면 내용을 간단히 미리 볼 수 있습니다.</li><li>노트를 클릭하면 현재 화면에서 열립니다.</li><li><kbd>Ctrl</kbd>을 누른 채 클릭하면 별도 탭에서 열립니다.</li></ul>',
+ 33:({img})=>p(img(0,'본문 언어 설정'))+p('텍스트 노트에 작성 언어를 지정할 수 있습니다. 브라우저나 데스크톱 앱이 본문의 언어를 알 수 있어 맞춤법 검사 등에 도움이 됩니다. 아랍어나 히브리어처럼 오른쪽에서 왼쪽으로 쓰는 언어의 표시 방향도 이 설정에 따라 결정됩니다.')+'<h2>언어 지정</h2>'+p('기본 속성에서 언어 항목을 찾으세요.')+'<h2>언어 목록 구성</h2>'+p('처음에는 언어가 설정되어 있지 않습니다. 전체 설정에서 언어를 추가하거나 노트의 언어 선택 목록에서 언어 구성을 선택하세요.'),
+ 34:({a,img,pre})=>p('Mermaid는 복잡한 다이어그램을 배치하는 데 사용할 수 있는 '+a(0,'Eclipse Layout Kernel(ELK)')+' 엔진을 지원합니다. Trilium에서도 사용할 수 있지만 기본적으로 켜져 있지는 않습니다.')+p('다이어그램 맨 앞에 다음 YAML 머리말을 넣으면 ELK를 사용합니다.')+pre(0)+'<table><thead><tr><th>ELK를 사용하지 않은 배치</th><th>ELK를 사용한 배치</th></tr></thead><tbody><tr><td>'+img(0,'ELK를 사용하지 않은 다이어그램')+'</td><td>'+img(1,'ELK를 사용한 다이어그램')+'</td></tr></tbody></table>',
+ 35:({a})=>p('Trilium에서는 '+a(0,'스크립트')+'와 '+a(1,'주요 속성')+'을 활용해 고급 기능을 만들 수 있습니다. 사용 방법을 보여 주기 위해 '+a(2,'기본 예제 노트')+'에 다음 사례를 준비했습니다.')+'<ul>'+['관계 지도','일일 노트','체중 기록','할 일 관리'].map((s,i)=>'<li>'+a(i+3,s)+'</li>').join('')+'</ul>'+p('이 예제들은 Trilium에서 구성할 수 있는 기능을 보여 주기 위한 것입니다. 모든 기능이 완성된 기본 기능으로 제공되는 것은 아닙니다.'),
+ 36:({a,img})=>p('Trilium은 노트 사이를 빠르고 편하게 이동할 수 있도록 설계되었습니다.')+'<h2>뒤로 가기와 앞으로 가기</h2>'+p('<kbd>Alt</kbd>+<kbd>←</kbd>와 <kbd>Alt</kbd>+<kbd>→</kbd>를 누르면 이전에 본 노트 사이를 이동할 수 있습니다.')+p('웹브라우저의 방문 기록 기능을 이용하므로 브라우저의 뒤로 가기와 앞으로 가기와 같은 방식으로 작동합니다.')+p(img(0,'노트 이동 버튼'))+'<h2>노트로 이동</h2>'+p('상단의 노트로 이동 버튼을 누르거나 <kbd>Ctrl</kbd>+<kbd>J</kbd>를 누르세요. 제목 일부를 입력하면 자동 완성 목록에서 원하는 노트를 골라 바로 열 수 있습니다.')+p('자세한 내용은 '+a(0,'노트로 이동')+'을 참고하세요.'),
+ 37:({a,img})=>p('자주 사용하는 검색을 노트 트리에 저장할 수 있습니다. 검색 결과는 저장된 검색 노트 아래에 하위 노트처럼 표시됩니다.')+p(img(0,'검색 저장 예시'))+'<h2>저장 위치</h2>'+p('기본 저장 위치는 일일 노트입니다. 다른 곳에 저장하려면 원하는 노트에 <code>#searchHome</code> 라벨을 추가하세요. '+a(0,'작업 공간')+' 안에서는 <code>#workspaceSearchHome</code> 라벨로 해당 작업 공간의 검색 저장 위치를 지정할 수 있습니다.'),
+ 38:({a,img})=>p('이 버전에서 지원하는 제공자는 다음과 같습니다.')+'<ul><li>'+a(0,'Ollama')+'</li><li>'+a(1,'OpenAI')+'</li><li>'+a(2,'Anthropic')+'</li><li>Voyage AI</li></ul>'+p('사용할 대화 모델의 제공자 이름을 다음 위치에 입력하세요.')+p(img(0,'대화 모델 제공자 설정'))+p('임베딩 제공자는 다음 위치에서 지정합니다.')+p(img(1,'임베딩 제공자 설정')),
+ 39:({img})=>p(img(0,'선택한 내용을 하위 노트로 옮기기'))+p('문서가 너무 길어지면 내용을 하위 노트로 나눌 수 있습니다.')+'<ol><li>옮길 내용을 선택해 잘라냅니다.</li><li>새 하위 노트를 만들고 제목을 입력합니다.</li><li>잘라낸 내용을 하위 노트에 붙여 넣습니다.</li></ol>'+p('Trilium은 이 과정을 한 번에 처리할 수 있습니다. 본문에서 내용을 선택한 뒤 선택 영역 도구 모음의 가위 아이콘을 눌러 하위 노트로 옮기기를 실행하세요. 선택한 내용의 제목을 감지해 새 노트 이름으로 사용합니다. 이 작업에 단축키를 지정할 수도 있습니다. 블록 도구 모음에서도 사용할 수 있습니다.'),
+ 40:({a,pre})=>p('NixOS에 포함된 Trilium 모듈을 설정하는 방법입니다.')+'<h2>준비 사항</h2>'+p(a(0,'NixOS')+'가 설치되어 있어야 합니다.')+'<h2>설정</h2>'+p('<code>configuration.nix</code>에 다음 내용을 추가하세요.')+pre(0).replace('default data directory:','기본 데이터 폴더:').replace('default bind address: 127.0.0.1, port 8080','기본 수신 주소: 127.0.0.1 / 포트: 8080')+p('바꾸려는 옵션은 앞의 주석 표시를 제거하세요.')+p('Nginx 역방향 프록시 설정을 비롯한 다른 항목은 '+a(1,'NixOS 옵션 목록')+'에서 확인할 수 있습니다.'),
+ 41:({pre})=>p('주요 속성에서 사용할 위젯 노트를 지정하세요. 해당 위젯으로 실행 도구 모음의 아이콘을 표시합니다.')+'<h4>실행 도구 모음 위젯 예제</h4>'+pre(0),
+ 42:({a,pre})=>p('Trilium은 '+a(0,'스크립트 코드 노트')+'에서 애플리케이션의 여러 기능을 사용할 수 있도록 API를 제공합니다.')+p('API는 두 종류입니다.')+'<ul><li>화면에서 실행하는 스크립트용 '+a(1,'프런트엔드 API')+'</li><li>서버에서 실행하는 스크립트용 '+a(2,'백엔드 API')+'</li></ul>'+p('두 API 모두 전역 변수 <code>api</code>를 통해 사용합니다. 스크립트 어디에서나 접근할 수 있습니다.')+p('예를 들어 화면에 메시지를 표시하려면 다음 프런트엔드 스크립트를 사용합니다.')+pre(0).replace('Hello world.','안녕하세요.')+'<aside class="admonition note">'+p('<strong>참고</strong><br>스크립트 API는 실험 단계입니다. 이후 버전에서 변경될 수 있습니다.')+'</aside>',
+ 43:({a})=>p('Trilium은 Evernote의 백업·내보내기 형식인 ENEX 파일을 가져올 수 있습니다. ENEX 파일 하나에는 노트북 하나의 노트와 관련 자료가 담깁니다.')+'<h2>Evernote에서 ENEX 내보내기</h2>'+p('원문에서 안내하는 방식은 구형 Evernote 데스크톱 앱을 사용합니다. 웹이나 모바일 버전이 아닙니다. 노트북에서 마우스 오른쪽 버튼을 누르고 내보내기를 선택한 뒤 안내를 따르세요.')+'<h2>Trilium으로 ENEX 가져오기</h2>'+p('가져올 위치의 노트에서 마우스 오른쪽 버튼을 누르세요. 가져오기를 선택한 뒤 ENEX 파일을 지정합니다.')+p('완료되면 노트와 자료를 살펴 누락된 내용이 없는지 확인하세요.')+'<h2>제한 사항</h2>'+p('이미지를 제외한 자료는 노트의 첨부 파일로 만들어집니다.')+p('ENEX 내부의 HTML은 표준과 완전히 일치하지 않아 일부 서식이 달라지거나 사라질 수 있습니다. 큰 문제가 있으면 '+a(0,'Trilium 문제 보고 페이지')+'에 알려 주세요.'),
+ 44:({img,pre})=>p('사용자 지정 테마는 기본적으로 기존 밝은 테마를 바탕으로 합니다. TriliumNext 테마를 바탕으로 쓰려면 기존 테마 노트에 <code>#appThemeBase=next</code> 속성을 추가하세요. <code>appTheme</code> 속성도 있어야 합니다.')+p(img(0,'테마 기반 설정'))+p('<code>appThemeBase</code>에 사용할 수 있는 값은 다음과 같습니다.')+'<ul><li><code>next</code> — 밝은 화면과 어두운 화면을 자동으로 전환합니다.</li><li><code>next-light</code> — 항상 밝은 테마를 사용합니다.</li><li><code>next-dark</code> — 항상 어두운 테마를 사용합니다.</li><li>그 밖의 값은 무시하며 기존 밝은 테마를 사용합니다.</li></ul><h2>스타일 덮어쓰기</h2>'+p('TriliumNext 테마에는 기존 테마보다 우선순위가 높은 스타일 규칙이 더 있습니다. 변경한 스타일이 적용되지 않으면 값 뒤에 <code>!important</code>를 붙여 보세요.')+pre(0),
+ 45:({img})=>p(img(0,'각주 예시'))+p('각주는 문단의 참고 자료나 보충 설명을 노트 아래쪽에 정리할 때 유용합니다.')+'<h2>사용 방법</h2><ul><li>새 각주를 넣으려면 '+img(1,'각주 삽입 버튼')+' 버튼을 누르세요. 옆의 화살표를 눌러 새 각주를 선택해도 됩니다.</li><li>기존 각주를 다시 참조하려면 화살표를 누르고 각주 삽입을 선택한 뒤 번호를 고르세요.</li><li><code>[1]</code> 같은 참조 표시 위에 마우스를 올리면 각주 내용을 미리 볼 수 있습니다.</li><li>본문의 참조 표시를 누르면 해당 각주로 이동합니다.</li><li>각주의 <code>^</code> 버튼을 누르면 본문의 참조 위치로 돌아갑니다.</li></ul>',
+ 46:({a,img})=>p('<strong>책 노트</strong>는 하위 노트의 내용을 차례로 보여 주는 특별한 '+a(0,'노트')+' 유형입니다. 여러 짧은 노트를 하나의 책처럼 이어서 읽을 때 유용합니다.')+p(img(0,'책 노트 예시'))+p('위 예시에서 왼쪽의 Node.js 노트에는 여러 하위 노트가 있습니다. 오른쪽에서는 그 내용을 하나의 연속된 문서로 보여 줍니다.')+'<h2>기능</h2>'+p('여러 하위 노트의 내용을 한 화면에서 이어 볼 수 있습니다. 긴 내용을 관리하기 쉬운 단위로 나누어 작성한 뒤 읽을 때 편리합니다.')+p(a(1,'노트 목록')+' 기능을 사용하므로 격자와 목록 및 달력 보기 중에서 선택할 수 있습니다.')+p('보기 방식은 '+a(2,'리본 메뉴')+'의 책 속성 탭에서 바꾸세요.'),
+ 47:({a,pre})=>p('Trilium 인스턴스는 실행 중인 서버 하나를 뜻합니다. '+a(0,'동기화')+'를 구성하면 데스크톱 앱 내부의 서버와 동기화 대상 서버 등 여러 인스턴스를 사용하게 됩니다. 이때 현재 어느 인스턴스에서 실행 중인지 구분하면 편리합니다.')+'<h2>인스턴스 이름 지정</h2>'+p('<code>config.ini</code>에 다음과 같이 이름을 설정하세요.')+pre(0).replace('instanceName=Hello','instanceName=내서버')+'<h2>서버에서 인스턴스 구분</h2>'+p('<code>api.getInstanceName()</code>을 호출하면 설정 파일이나 환경 변수에 지정한 현재 서버의 인스턴스 이름을 얻을 수 있습니다.')+'<h2>특정 인스턴스에서만 스크립트 실행</h2>'+p('정기적으로 실행하거나 특정 이벤트에 반응하는 스크립트를 일부 인스턴스에서만 실행할 수 있습니다. 코드를 바꿀 필요 없이 <code>runOnInstance</code> 라벨의 값에 실행할 인스턴스 이름을 넣으세요. 여러 인스턴스에서 실행하려면 라벨을 여러 개 추가하세요.'),
+ 48:({a,img})=>p(img(0,'노트별 추가 작업 버튼'))+p('현재 노트의 종류에 따라 '+a(0,'리본 메뉴')+' 바로 아래 오른쪽에 추가 작업 버튼이 나타납니다. 해당 노트에 필요한 기능을 제공합니다.')+p('예를 들면 다음과 같습니다.')+'<ul><li>'+a(1,'Mermaid 다이어그램')+'과 '+a(2,'캔버스')+'에서는 SVG로 내려받거나 참조를 복사해 '+a(3,'텍스트 노트')+'에 붙여 넣을 수 있습니다.</li><li>'+a(4,'읽기 전용 노트')+'에서는 잠시 편집을 허용해 빠르게 수정할 수 있습니다.</li></ul><h2>사용 방법</h2>'+p('오른쪽 끝의 화살표 두 개를 누르면 버튼 영역을 접을 수 있습니다.'),
+ 49:({a,img})=>p(img(0,'오른쪽 사이드바'))+p('오른쪽 사이드바는 현재 노트와 관련된 다음 내용을 보여 줍니다.')+'<ul><li>'+a(0,'목차')+'</li><li>'+a(1,'강조 표시 목록')+'</li></ul>'+p('표시할 내용이 없으면 사이드바가 나타나지 않습니다. 예를 들어 제목이 적고 강조 표시도 없으면 숨겨집니다.')+'<h2>사이드바 표시와 숨기기</h2>'+p('<code>toggleRightPane</code> 단축키를 지정해 사이드바를 표시하거나 숨길 수 있습니다. 기본 키는 지정되어 있지 않습니다.')+'<h2>분할 화면에서 사용</h2>'+p(a(2,'화면 분할')+'을 사용해도 현재 '+a(3,'탭')+'에는 사이드바가 하나만 표시됩니다.')+p('분할된 화면에서 노트를 클릭하면 해당 노트의 내용으로 사이드바가 바뀝니다. 표시할 내용이 없으면 닫힌 상태를 유지합니다.'),
+ 50:({img})=>p('공유 노트를 열면 기본적으로 웹페이지 형태로 표시됩니다. 스크립트에서 이용하거나 파일로 내려받을 때는 원본 내용을 그대로 제공하는 편이 나을 수 있습니다.')+'<table><thead><tr><th>웹페이지로 표시한 노트</th><th>원본 형식으로 표시한 노트</th></tr></thead><tbody><tr><td>'+img(0,'웹페이지 형태의 공유 노트')+'</td><td>'+img(1,'원본 형식의 공유 노트')+'</td></tr></tbody></table><h2>노트 속성으로 지정</h2>'+p('<code>#shareRaw</code> 속성을 추가하면 공유 주소로 접근할 때 항상 원본 형식으로 제공합니다.')+'<h2>주소에 옵션 추가</h2>'+p('주소 끝에 <code>?raw</code>를 붙이면 <code>#shareRaw</code> 속성이 없어도 원본 형식으로 볼 수 있습니다.')+p(img(2,'주소로 원본 형식 요청')),
+ 51:({a,img})=>p('노트 지도는 노트 사이의 연결을 시각적으로 보여 줍니다. 노트들이 어떤 구조로 묶여 있는지 파악할 수 있습니다.')+p('다음 두 가지 보기가 있습니다.')+'<ul><li>링크 지도 — 노트 사이의 관계를 표시합니다.</li><li>트리 지도 — 노트의 계층 구조를 표시합니다.</li></ul><h2>링크 지도</h2>'+p('노트 사이의 '+a(0,'관계')+'를 보여 줍니다.')+p(img(0,'링크 지도'))+'<h2>트리 지도</h2>'+p('노트의 상위·하위 구조를 보여 줍니다.')+p(img(1,'트리 지도'))+'<h2>독립된 노트 유형</h2>'+p('모든 노트에서 열 수 있는 지도 기능 외에 관계를 전체 화면에 표시하는 전용 노트를 만들 수도 있습니다. '+a(1,'노트 지도 유형')+'을 참고하세요.')+'<h2>관련 기능</h2>'+p(a(2,'관계 지도')+'는 비슷한 기능이지만 다음과 같은 차이가 있습니다.')+'<ul><li>노트 지도는 자동으로 만들어집니다. 관계 지도는 직접 구성합니다.</li><li>관계 지도는 하나의 노트 유형입니다. 링크 지도는 연결을 화면에 보여 주는 보기 기능입니다.</li></ul>',
+ 52:({a,img})=>p('책갈피를 사용하면 특정 제목처럼 노트 안의 원하는 위치를 가리키는 '+a(0,'링크')+'를 만들 수 있습니다.')+p('내부적으로는 HTML 앵커를 사용합니다. 이 기능은 TriliumNext 0.94.0에서 추가되었습니다.')+'<h2>사용 방법</h2>'+p('<strong>책갈피 만들기</strong>')+'<ol><li>책갈피를 둘 위치에 커서를 놓으세요.</li><li>'+a(1,'서식 도구 모음')+'에서 '+img(0,'책갈피 메뉴 버튼')+' 버튼을 누른 뒤 '+img(1,'새 책갈피 버튼')+' 버튼을 선택하세요.</li></ol>'+p('<strong>책갈피로 연결하기</strong>')+'<ol><li>링크를 넣을 위치에 커서를 놓으세요.</li><li>'+a(2,'링크')+' 창에서 책갈피 항목을 열고 원하는 책갈피를 선택하세요.</li></ol><h2>제한 사항</h2>'+p('이 버전에서는 다른 노트의 책갈피로 연결할 수 없습니다. 내부 링크가 책갈피를 지원하도록 개선된 뒤 추가될 예정입니다.'),
+ 53:({a,img})=>p('Trilium은 일정한 간격으로 노트의 상태를 저장해 이전 버전을 보관합니다.')+'<h2>이전 버전 저장 간격</h2>'+p('설정 → 기타에서 저장 간격을 바꿀 수 있습니다. 간격이 짧을수록 더 많은 버전을 남기지만 저장 공간도 더 필요합니다.')+p('특정 노트나 하위 트리의 버전 기록을 끄려면 <code>disableVersioning</code> '+a(0,'라벨')+'을 추가하세요.')+'<h2>보관 개수 제한</h2>'+p('설정 → 기타에서 노트마다 보관할 이전 버전의 최대 개수를 지정할 수 있습니다. -1은 제한 없음이며 0은 모든 이전 버전을 삭제한다는 뜻입니다. 개별 노트에는 <code>versioningLimit=X</code> 라벨로 따로 지정할 수 있습니다.')+p('변경한 제한은 해당 노트를 수정할 때 적용됩니다.')+p('초과한 이전 버전 지금 삭제 버튼을 누르면 즉시 적용할 수 있습니다.')+p('이전 버전은 리본 메뉴 오른쪽의 버튼으로 확인할 수 있습니다.')+p(img(0,'이전 버전 보기')),
+ 54:({a,img})=>p(img(0,'빠른 검색'))+p('빠른 검색은 노트 제목뿐 아니라 본문까지 검색하고 결과를 바로 선택할 수 있게 보여 줍니다.')+p('별도 탭에서 고급 조건으로 검색하려면 '+a(0,'검색')+' 기능을 사용하세요.')+p('본문 대신 제목만 검색해 빠르게 이동하려면 '+a(1,'노트로 이동')+' 기능을 사용하세요.')+'<h2>화면 배치</h2>'+p(a(2,'세로 배치와 가로 배치')+'에 따라 빠른 검색창의 위치가 달라집니다.')+'<ul><li>세로 배치에서는 '+a(3,'노트 트리')+' 바로 위에 표시됩니다.</li><li>가로 배치에서는 '+a(4,'실행 도구 모음')+'에 표시됩니다. 다른 아이콘처럼 위치를 옮길 수 있습니다.</li></ul>'
+};