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

This commit is contained in:
Codex
2026-09-06 05:06:00 +09:00
parent 1752fed118
commit 0814e9f44c
632 changed files with 117034 additions and 0 deletions
@@ -0,0 +1,8 @@
const p=s=>'<p>'+s+'</p>';const ul=xs=>'<ul>'+xs.map(s=>'<li>'+s+'</li>').join('')+'</ul>';
export default {
95:({a,img})=>p(img(0,'노트 속성'))+p('속성은 노트에 지정하는 이름과 값의 쌍입니다. 추가 정보를 저장하거나 기능을 설정하며 크게 두 종류로 나뉩니다.')+ul([a(0,'라벨')+' — 메타데이터를 저장하거나 노트의 동작을 설정합니다. 검색에도 사용할 수 있습니다. 미리 정의된 항목은 '+a(1,'라벨 안내')+'를 참고하세요.',a(2,'관계')+' — 링크처럼 노트 사이의 연결을 정의합니다. 메타데이터와 스크립트에 활용할 수 있습니다. 미리 정의된 항목은 '+a(3,'관계 안내')+'를 참고하세요.'])+'<h2>속성 목록 확인하기</h2>'+p('현재 노트에 직접 지정한 라벨과 관계는 '+a(4,'상단 리본')+'의 소유한 속성에서 확인하고 수정할 수 있습니다. 상위 노트에서 물려받은 항목은 상속된 속성에서 확인할 수 있으며 그곳에서는 수정할 수 없습니다.')+p('목록에서 라벨 앞에는 <code>#</code>이 붙고 관계 앞에는 <code>~</code>가 붙습니다.')+'<h2>같은 이름의 여러 값</h2>'+p('같은 이름의 속성을 여러 개 지정할 수 있습니다. 이를 통해 한 항목에 여러 값을 저장할 수 있습니다.')+'<h2>속성 정의와 주요 속성</h2>'+p('특별한 라벨로 속성의 형식과 표시 방법을 정의할 수 있습니다. '+a(5,'주요 속성')+'을 참고하세요.')+'<h2>속성 상속</h2>'+p('하위 노트가 상위 노트의 속성을 물려받을 수 있습니다. 자세한 내용은 '+a(6,'속성 상속')+'을 참고하세요.'),
96:({a,img,pre})=>p(img(0,'HTML 표시 노트'))+p('HTML 표시 노트는 '+a(0,'스크립트')+'에서 활용하는 유형입니다. 관계 속성으로 연결된 '+a(1,'코드 노트')+'의 HTML을 화면에 표시합니다.')+'<h2>HTML 표시 노트 만들기</h2>'+ul(['HTML 언어의 '+a(2,'코드 노트')+'를 만들고 표시할 내용을 작성합니다. 예: <code>&lt;p&gt;안녕하세요.&lt;/p&gt;</code>',a(3,'HTML 표시 노트')+'를 만듭니다.','<code>renderNote</code> '+a(4,'관계')+'가 앞서 만든 HTML 코드 노트를 가리키도록 지정합니다.'])+'<h2>동적 내용 표시하기</h2>'+p(a(5,'스크립트')+'로 HTML의 일부를 바꾸면 동적 화면을 만들 수 있습니다. 현재 날짜와 시각을 표시하는 예제를 만들어 보겠습니다.')+p('먼저 다음 내용의 HTML 코드 노트를 만드세요.')+pre(0).replace('Current date &amp; time','현재 날짜와 시각').replace('The current date &amp; time is','현재 날짜와 시각:')+p('그 바로 아래에 프런트엔드 JavaScript '+a(6,'코드 노트')+'를 만들고 다음 코드를 작성합니다.')+pre(1).replace('$dateEl.text(new Date());','$dateEl.text(new Date().toLocaleString("ko-KR"));')+p('원하는 위치에 HTML 표시 노트를 만들고 <code>~renderNote</code> 관계로 HTML 노트를 연결하세요. 열면 현재 날짜와 시각이 한국어 형식으로 표시됩니다. 예: <strong>현재 날짜와 시각</strong> — 현재 날짜와 시각: 2025. 4. 6. 오후 3:26:29')+'<h2>관련 예제</h2>'+p(a(7,'체중 기록')+'은 기본 '+a(8,'사용 예제')+'에 포함되어 있습니다.'),
97:({a,img})=>p('Trilium은 호환성을 최대한 유지하면서 Markdown 가져오기와 내보내기를 지원합니다.')+'<h2>가져오기</h2><h3>클립보드에서 가져오기</h3>'+p('일부 Markdown 내용을 복사했다면 편집기의 블록 메뉴에서 가져올 수 있습니다.')+p(img(0,'클립보드의 Markdown 가져오기'))+'<h3>파일에서 가져오기</h3>'+p('확장자가 <code>.md</code>인 파일 하나를 가져오거나 여러 파일의 폴더 구조를 '+a(0,'압축 파일')+'로 묶어 가져올 수 있습니다. 이 기능에서는 ZIP 형식을 사용하세요. 브라우저가 폴더를 직접 읽지 못하므로 '+a(1,'7-Zip')+' 같은 도구로 폴더를 ZIP으로 압축해야 합니다.')+p(img(1,'Markdown 파일 가져오기'))+'<h2>내보내기</h2><h3>하위 트리 내보내기</h3>'+p('하위 트리 전체를 ZIP으로 내보내면 노트 구조에 맞춰 폴더가 만들어집니다.')+p(img(2,'하위 트리의 Markdown 내보내기'))+'<h3>노트 하나만 내보내기</h3>'+p('하위 노트를 제외하고 현재 노트만 내보내려면 노트 작업 메뉴를 사용하세요.')+p(img(3,'현재 노트의 Markdown 내보내기'))+'<h3>보호된 노트 내보내기</h3>'+p('먼저 보호 세션을 시작해야 합니다. 내보낸 파일은 암호화되지 않습니다. 다시 가져온 노트도 필요하면 보호 설정을 다시 적용하세요.')+'<h2>지원 문법</h2>'+ul([a(2,'GitHub 확장 Markdown')+'을 주된 기준으로 사용합니다.','이미지를 지원합니다. 사용자 지정 너비가 있으면 HTML로 내보내며 그림 요소도 HTML로 포함합니다.','표를 지원합니다. 구조가 복잡하거나 HTML이 필요한 요소를 포함한 표는 HTML로 내보냅니다.',a(3,'안내 상자')+'는 GitHub 형식을 사용합니다.','링크를 지원합니다. 노트의 제목과 아이콘을 반영하는 참조 링크는 정보를 보존하기 위해 HTML로 포함합니다.','수식은 <code>$</code>와 <code>$$</code> 구분 기호를 지원합니다.']),
98:({img})=>p(img(0,'집중 모드 화면'))+p('Windows 11에서 운영체제 제목 표시줄을 끄고 배경 효과를 켠 예시입니다. 집중 모드는 대부분의 메뉴를 숨겨 읽기와 쓰기에 집중할 수 있도록 합니다.')+p(img(1,'전체 메뉴의 집중 모드'))+'<h2>켜고 끄기</h2>'+p('전체 메뉴에서 집중 모드를 선택하세요. 0.92.5부터는 <kbd>F9</kbd>로 전환할 수 있습니다. 이전 버전의 기본 단축키는 <kbd>Alt</kbd>+<kbd>Z</kbd>입니다. 단축키 설정에서는 <code>toggleZenMode</code> 항목을 찾으세요.')+p('집중 모드에서는 전체 메뉴도 숨겨집니다. 오른쪽 위의 '+img(2,'집중 모드 종료 버튼')+'을 누르거나 단축키를 다시 누르면 해제됩니다. 현재 창에만 적용되며 앱을 다시 시작하면 해제됩니다.')+'<h2>창 이동하기</h2>'+p('운영체제 제목 표시줄을 사용한다면 해당 부분을 끌어 창을 옮기세요. 제목 표시줄을 껐다면 노트 제목이 있는 창 위쪽을 끌어 이동할 수 있습니다.')+p(img(3,'집중 모드의 분할 보기'))+p('Windows 11에서 배경 효과를 끄고 두 노트를 나란히 표시한 예시입니다.')+'<h2>탭과 분할 보기</h2>'+p('탭은 숨겨지지만 단축키는 사용할 수 있습니다. <code>firstTab</code>의 기본 키는 <kbd>Ctrl</kbd>+<kbd>1</kbd>이며 <code>secondTab</code>은 <kbd>Ctrl</kbd>+<kbd>2</kbd>입니다. 다음 탭으로 이동하는 <code>activateNextTab</code>은 <kbd>Ctrl</kbd>+<kbd>Tab</kbd>을 사용하며 이전 탭으로 이동하는 <code>activatePreviousTab</code>은 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd>을 사용합니다. 실제 지정된 키는 설정에서 확인하세요.')+p('이 문서의 버전에서는 분할 보기 단축키가 없습니다. 집중 모드를 끈 상태에서 분할 구성을 만든 뒤 다시 집중 모드를 켜면 사용할 수 있습니다.'),
99:({a,pre})=>p('ETAPI는 외부 프로그램에서 Trilium을 사용하는 REST API입니다. 0.50부터 제공됩니다. 명세는 '+a(0,'OpenAPI 문서')+'에서 확인할 수 있습니다.')+'<h2>클라이언트 라이브러리</h2>'+p(a(1,'trilium-py')+'를 사용하면 Python에서 Trilium에 접근하는 코드를 더 쉽게 작성할 수 있습니다.')+'<h2>토큰 발급</h2>'+p('모든 API 작업은 토큰으로 인증해야 합니다. 설정 → ETAPI에서 발급하거나 <code>/auth/login</code> 요청으로 받을 수 있습니다. 자세한 요청 형식은 '+a(2,'API 명세')+'를 참고하세요.')+'<h2>인증</h2><h3>Authorization 헤더</h3>'+pre(0)+p('<code>ETAPITOKEN</code>을 발급받은 토큰으로 바꾸세요. 0.93.0부터는 다른 도구와의 호환성을 위해 <code>Bearer ETAPITOKEN</code> 형식도 지원합니다.')+'<h3>기본 인증</h3>'+p('0.56부터 다음 형식도 지원합니다.')+pre(1)+ul(['<code>BATOKEN = BASE64(username + \':\' + password)</code> 형식으로 만듭니다.','사용자 이름은 <code>etapi</code>입니다.','비밀번호 자리에 발급받은 ETAPI 토큰을 넣습니다.'])+p('기본 인증만 지원하는 도구에서 사용할 수 있는 방식입니다.')+'<h2>Bash 스크립트 예제</h2>'+p('다음 예제는 노트의 HTML 본문을 내려받습니다.')+pre(2).replace('# Configuration','# 연결 설정').replace('# Download a note by ID','# 노트 ID로 본문 내려받기').replace('TOKEN=z1vA4fkGxjOR_ZXLrZeqHEFOv65yV3882iFCRtNIK9k9iWrHliITNSLQ=','TOKEN=YOUR_ETAPI_TOKEN')+p('실행 전에 다음 값을 바꾸세요.')+ul(['<code>TOKEN</code> — 직접 발급받은 ETAPI 토큰','<code>SERVER</code> — 사용 중인 Trilium의 프로토콜과 호스트 및 포트','<code>NOTE_ID</code> — 내려받을 노트의 ID'])
};