도움말 173개와 제목 181개 한글화 및 운영 반영 기록

This commit is contained in:
Codex
2026-09-13 17:01:02 +09:00
parent 618e6ab213
commit 77c2892aba
578 changed files with 15816 additions and 30 deletions
File diff suppressed because one or more lines are too long
Binary file not shown.

After

Width:  |  Height:  |  Size: 186 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 172 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 167 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 237 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 202 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 191 KiB

@@ -0,0 +1,3 @@
<p>이 버전에서 지원하는 제공자는 다음과 같습니다.</p><ul><li><a class="reference-link" href="#root/_help_7EdTxPADv95W">Ollama</a></li><li><a class="reference-link" href="#root/_help_ZavFigBX9AwP">OpenAI</a></li><li><a class="reference-link" href="#root/_help_e0lkirXEiSNc">Anthropic</a></li><li>Voyage AI</li></ul><p>사용할 대화 모델의 제공자 이름을 다음 위치에 입력하세요.</p><p><img style="aspect-ratio:1884/1267;" src="AI Provider Information_im.png"
width="1884" height="1267" alt="대화 모델 제공자 설정"></p><p>임베딩 제공자는 다음 위치에서 지정합니다.</p><p><img style="aspect-ratio:1907/1002;" src="1_AI Provider Information_im.png"
width="1907" height="1002" alt="임베딩 제공자 설정"></p>
@@ -0,0 +1,8 @@
<p><a href="https://ollama.com/">Ollama</a>는 여러 방식으로 설치할 수 있으며 <a href="https://hub.docker.com/r/ollama/ollama">Docker 컨테이너</a>에서도 실행할 수 있습니다. 지원되는 GPU를 사용하면 일반적으로 더 빠릅니다. CPU와 메모리만으로도 실행할 수 있습니다. 직접 설치하려면 공식 <a href="https://ollama.com/download">설치 프로그램</a>을 이용하세요.</p><p><img style="aspect-ratio:785/498;" src="3_Installing Ollama_image.png"
width="785" height="498" alt="Ollama 내려받기 화면"></p><p><img style="aspect-ratio:467/100;" src="Installing Ollama_image.png" width="467"
height="100" alt="설치 파일"></p><p><img style="aspect-ratio:1296/1011;" src="1_Installing Ollama_image.png"
width="1296" height="1011" alt="설치 진행 화면"></p><p>Windows에서는 설치 후 시작 메뉴에서 실행할 수 있습니다.</p><p><img style="aspect-ratio:1161/480;" src="2_Installing Ollama_image.png"
width="1161" height="480" alt="시작 메뉴의 Ollama"></p><p>PowerShell이나 명령 프롬프트에서 <code>ollama</code> 명령도 사용할 수 있습니다.</p><p><img style="aspect-ratio:1730/924;" src="5_Installing Ollama_image.png"
width="1730" height="924" alt="Ollama 명령줄 실행"></p><p>설치 후 <code>pull</code> 명령으로 사용할 모델을 내려받습니다. 다음은 원문 작성 시점인 2025년 4월에 소개한 도구 호출용 모델과 임베딩 모델의 예시입니다.</p><pre><code class="language-text-x-trilium-auto">ollama pull llama3.1:8b
ollama pull mxbai-embed-large</code></pre><p>기본 포트는 11434입니다. <a href="http://localhost:11434">로컬 Ollama 상태 페이지</a>를 열면 실행 여부를 확인할 수 있습니다.</p><p><img style="aspect-ratio:585/202;" src="4_Installing Ollama_image.png"
width="585" height="202" alt="Ollama 정상 실행 응답"></p><p>서비스를 실행하고 모델을 내려받았다면 Trilium에서 채팅 제공자와 임베딩 제공자로 설정할 준비가 된 것입니다.</p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 198 KiB

@@ -0,0 +1,13 @@
<p><img style="aspect-ratio:1363/1364;" src="Introduction_image.png" width="1363"
height="1364" alt="노트에 관해 AI와 대화하는 예제"></p><p>Trilium의 AI 기능은 노트를 바탕으로 대화하고 정보를 찾도록 도와줍니다. 이 버전은 OpenAI와 Anthropic 및 Ollama 같은 제공자와의 대화뿐 아니라 도구 호출과 임베딩을 지원합니다.</p><p>설정의 AI/LLM 항목을 열고 기능을 켭니다.</p><p><img style="aspect-ratio:1916/1906;" src="5_Introduction_image.png" width="1916"
height="1906" alt="AI 설정 위치"></p><p><img style="aspect-ratio:1911/997;" src="1_Introduction_image.png" width="1911"
height="997" alt="AI 기능 켜기"></p><h2>임베딩</h2><p>임베딩은 노트의 의미를 수치로 표현한 자료입니다. 사람이 읽는 요약문과는 다릅니다. 코사인 유사도 같은 계산으로 대화에 관련된 노트를 찾아 AI에 전달하는 데 활용합니다. 이 버전에서는 OpenAI와 Voyage AI 및 Ollama로 임베딩을 만들 수 있습니다.</p><p>다음 예제는 직접 운영하는 Ollama를 사용합니다. 설치 방법은 <a class="reference-link"
href="#root/_help_vvUCN7FDkq7G">Ollama 설치</a>를 참고하세요. <a
href="https://ollama.com/search?c=embedding">Ollama 임베딩 모델 목록</a>에서 모델을 찾아 <code>pull</code> 명령으로 가져옵니다. 원문의 2025년 4월 예제는 <code>mxbai-embed-large</code>를 사용합니다.</p><p>제공자 탭에서 Ollama를 선택하고 기본 URL을 입력합니다. 같은 컴퓨터에서 실행하는 예제 주소는 <code>http://localhost:11434</code>입니다. 새로고침 버튼으로 모델 목록을 불러옵니다.</p><p><img style="aspect-ratio:1912/1075;" src="4_Introduction_image.png" width="1912"
height="1075" alt="Ollama 주소와 모델 목록 설정"></p><p>임베딩 모델 목록에서는 임베딩용 모델이 위쪽에 표시되고 일반 대화 모델과 구분선으로 나뉩니다.</p><p><img style="aspect-ratio:1232/959;" src="8_Introduction_image.png" width="1232"
height="959" alt="임베딩 모델 선택"></p><p>모델을 선택하면 임베딩 생성이 시작됩니다. 설정 위쪽의 통계에서 진행 상황을 확인합니다.</p><p><img style="aspect-ratio:1333/499;" src="7_Introduction_image.png" width="1333"
height="499" alt="임베딩 생성 통계"></p><p>생성이 시작되지 않으면 설정 아래쪽에서 모든 임베딩 다시 만들기를 누릅니다.</p><p><img style="aspect-ratio:1337/1490;" src="3_Introduction_image.png" width="1337"
height="1490" alt="모든 임베딩 다시 만들기"></p><p>생성에는 시간이 걸립니다. 노트를 만들거나 수정하거나 삭제하면 관련 임베딩도 갱신됩니다. 제공자나 모델을 바꾸면 전체 임베딩을 다시 만들어야 합니다.</p><h2>도구</h2><p>AI가 사용할 수 있도록 제공하는 함수입니다. 모델이 도구 이름과 인수를 요청하면 Trilium이 실행하고 결과를 대화에 전달합니다. 이 버전에는 다음 도구가 포함되어 있습니다.</p><ul><li><code>search_notes</code> — 의미 기반 검색</li><li><code>keyword_search</code> — 검색어 기반 검색</li><li><code>attribute_search</code> — 속성 검색</li><li><code>search_suggestion</code> — 검색 문법 지원</li><li><code>read_note</code> — 노트 본문 읽기</li><li><code>create_note</code> — 노트 만들기</li><li><code>update_note</code> — 노트 수정</li><li><code>manage_attributes</code> — 노트 속성 관리</li><li><code>manage_relationships</code> — 노트 사이의 관계 관리</li><li><code>extract_content</code> — 노트에서 내용 추출</li><li><code>calendar_integration</code> — 날짜 노트 검색과 생성 및 오늘의 노트 조회</li></ul><p>대화 중 도구가 실행되면 다음처럼 결과가 표시됩니다. 특정 도구를 직접 지시하지 않아도 모델이 필요에 따라 선택할 수 있습니다.</p><p><img style="aspect-ratio:1372/1591;" src="6_Introduction_image.png" width="1372"
height="1591" alt="대화 중 도구 실행 결과"></p><h2>대화 시작</h2><p>노트와 대화 버튼으로 시작합니다.</p><p><img style="aspect-ratio:1378/539;" src="2_Introduction_image.png" width="1378"
height="539" alt="노트와 대화 버튼"></p><p>버튼이 보이지 않으면 실행 도구 모음 설정에서 사용 가능한 실행 도구를 표시할 실행 도구 영역으로 옮기세요.</p><p><img style="aspect-ratio:1765/1287;" src="9_Introduction_image.png" width="1765"
height="1287" alt="대화 실행 도구 표시"></p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 175 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 548 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

@@ -0,0 +1,2 @@
<p>Trilium에서는 <a href="#root/_help_CdNpE2pqjmI6">스크립트</a>와 <a
href="#root/_help_OFXdgB2nNk1F">주요 속성</a>을 활용해 고급 기능을 만들 수 있습니다. 사용 방법을 보여 주기 위해 <a href="#root/_help_wX4HbRucYSDD">기본 예제 노트</a>에 다음 사례를 준비했습니다.</p><ul><li><a href="#root/_help_iRwzGnHPzonm">관계 지도</a></li><li><a href="#root/_help_l0tKav7yLHGF">일일 노트</a></li><li><a href="#root/_help_R7abl2fc6Mxi">체중 기록</a></li><li><a href="#root/_help_xYjQUYhpbUEW">할 일 관리</a></li></ul><p>이 예제들은 Trilium에서 구성할 수 있는 기능을 보여 주기 위한 것입니다. 모든 기능이 완성된 기본 기능으로 제공되는 것은 아닙니다.</p>
@@ -0,0 +1,26 @@
<p>할 일 관리는 <a href="#root/_help_OFXdgB2nNk1F">주요 속성</a>과 <a
href="#root/_help_CdNpE2pqjmI6">스크립트</a>를 활용하는 <a href="#root/_help_wX4HbRucYSDD">기본 예제</a>입니다.</p><h2>동작 예시</h2><p><img src="Task Manager_task-manager.png" alt="할 일 관리 예제"></p><p>할 일과 완료된 일을 구분합니다. <code>doneDate</code>에 값이 있으면 완료된 일로 처리합니다. 아직 하지 않은 일은 장소와 태그로 분류하며 속성을 바꾸면 알맞은 위치로 자동 이동합니다.</p><p><a href="#root/_help_l0tKav7yLHGF">날짜별 노트</a>와도 연동합니다. 예정일인 <code>todoDate</code>와 완료일인 <code>doneDate</code>에 해당하는 날짜 노트 아래에 같은 작업을 <a href="#root/_help_IakOLONlIfGI">복제</a>하고 원본 예제에서는 TODO와 DONE <a href="#root/_help_kBrnXNG3Hplm">접두사</a>로 구분합니다.</p><h2>구현</h2><p>새 작업을 넣는 노트의 <code>~child:template</code> <a
href="#root/_help_zEY4DaJG4YT5">관계</a>가 작업 템플릿을 가리킵니다. <a href="#root/_help_bwZpz2ajCEwO">속성 상속</a>을 참고하세요.</p><h3>속성</h3><p>템플릿에서 예정일과 완료일 및 태그와 장소를 <a href="#root/_help_OFXdgB2nNk1F">주요 속성</a>으로 표시합니다. <code>~runOnAttributeChange</code>는 속성이 바뀔 때 실행할 <a href="#root/_help_GPERMystNGTB">이벤트</a> 처리기를 연결합니다. 이 <a href="#root/_help_CdNpE2pqjmI6">스크립트</a>는 완료일을 입력하면 완료 목록으로 옮기고 할 일과 장소 및 태그 목록에서 제거합니다.</p><h3>새 할 일 버튼</h3><pre><code class="language-text-x-trilium-auto">api.addButtonToToolbar({
title: '새 할 일',
icon: 'check',
shortcut: 'alt+n',
action: async () =&gt; {
// 노트 생성은 백엔드에서 처리합니다.
const taskNoteId = await api.runOnBackend(async () =&gt; {
const todoRootNote = await api.getNoteWithLabel('taskTodoRoot');
const {note} = await api.createNote(todoRootNote.noteId, '새 할 일', '');
return note.noteId;
});
// 생성한 노트를 바로 엽니다.
await api.activateNewNote(taskNoteId);
}
});</code></pre><h3>색상</h3><p>다음 CSS <a href="#root/_help_6f9hih2hXXZk">코드 노트</a>는 할 일을 빨간색으로 표시하고 완료한 일을 초록색으로 표시합니다.</p><pre><code class="language-text-x-trilium-auto">span.fancytree-node.todo .fancytree-title {
color: red !important;
}
span.fancytree-node.done .fancytree-title {
color: green !important;
}</code></pre><p>이 <a href="#root/_help_6f9hih2hXXZk">코드 노트</a>에 <code>#appCss</code> <a
href="#root/_help_zEY4DaJG4YT5">라벨</a>을 지정하면 시작할 때 적용됩니다. 이벤트 처리기는 상태에 따라 <code>#cssClass</code> 값으로 <code>todo</code>나 <code>done</code>을 지정합니다.</p>
@@ -0,0 +1,46 @@
<p><img src="Weight Tracker_image.png" alt="체중 기록 예제"></p><p>체중 기록은 <a href="#root/_help_GLks18SNjxmC">스크립트 API</a>를 활용하는 <a href="#root/_help_wX4HbRucYSDD">기본 예제</a>입니다. <code>weight</code>를 <a href="#root/_help_OFXdgB2nNk1F">주요 속성</a>으로 지정한 <a href="#root/_help_KC1HB96bqqHX">템플릿</a>에서 <a href="#root/_help_l0tKav7yLHGF">날짜별 노트</a>를 만들면 체중을 입력하고 시간에 따른 변화를 차트로 볼 수 있습니다.</p><h2>구현 방식</h2><p>체중 기록 화면은 HTML 표시 노트입니다. 자체 본문 대신 <a href="#root/_help_CdNpE2pqjmI6">스크립트</a>의 결과를 표시하는 영역을 제공합니다. <code>~renderNote</code> <a href="#root/_help_zEY4DaJG4YT5">관계</a>로 구현용 노트와 연결합니다.</p><p>구현에는 HTML과 JavaScript <a href="#root/_help_6f9hih2hXXZk">코드 노트</a>가 사용됩니다. <code>weight</code> 속성이 있는 노트를 모아 차트로 표시합니다. 차트 라이브러리 <a
href="https://www.chartjs.org/">Chart.js</a>는 Trilium에 내장되어 있지 않으므로 첨부 파일로 가져옵니다.</p><h3>코드</h3><p>다음 코드를 프런트엔드 JavaScript <a href="#root/_help_6f9hih2hXXZk">코드 노트</a>에 작성합니다.</p><pre><code class="language-text-x-trilium-auto">async function getChartData() {
const days = await api.runOnBackend(async () =&gt; {
const notes = api.getNotesWithLabel('weight');
const days = [];
for (const note of notes) {
const date = note.getLabelValue('dateNote');
const weight = parseFloat(note.getLabelValue('weight'));
if (date &amp;&amp; weight) {
days.push({ date, weight });
}
}
days.sort((a, b) =&gt; a.date &gt; b.date ? 1 : -1);
return days;
});
const datasets = [
{
label: "체중 (kg)",
backgroundColor: 'red',
borderColor: 'red',
data: days.map(day =&gt; day.weight),
fill: false,
spanGaps: true,
datalabels: {
display: false
}
}
];
return {
datasets: datasets,
labels: days.map(day =&gt; day.date)
};
}
const ctx = $("#canvas")[0].getContext("2d");
new chartjs.Chart(ctx, {
type: 'line',
data: await getChartData()
});</code></pre><h2>상단 버튼 숨기기</h2><p>체중 기록의 연결된 노트 중 버튼 구현 노트를 찾아 본문을 지우거나 주석으로 처리하세요. Trilium을 다시 시작하면 체중 기록 버튼이 표시되지 않습니다.</p>
@@ -0,0 +1,6 @@
<p><img style="aspect-ratio:1071/146;" src="Attributes_image.png" width="1071"
height="146" alt="노트 속성"></p><p>속성은 노트에 지정하는 이름과 값의 쌍입니다. 추가 정보를 저장하거나 기능을 설정하며 크게 두 종류로 나뉩니다.</p><ul><li><a class="reference-link" href="#root/_help_HI6GBBIduIgv">라벨</a> — 메타데이터를 저장하거나 노트의 동작을 설정합니다. 검색에도 사용할 수 있습니다. 미리 정의된 항목은 <a class="reference-link"
href="#root/_help_HI6GBBIduIgv">라벨 안내</a>를 참고하세요.</li><li><a class="reference-link" href="#root/_help_Cq5X6iKQop6R">관계</a> — 링크처럼 노트 사이의 연결을 정의합니다. 메타데이터와 스크립트에 활용할 수 있습니다. 미리 정의된 항목은 <a
class="reference-link" href="#root/_help_Cq5X6iKQop6R">관계 안내</a>를 참고하세요.</li></ul><h2>속성 목록 확인하기</h2><p>현재 노트에 직접 지정한 라벨과 관계는 <a class="reference-link" href="#root/_help_BlN9DFI679QC">상단 리본</a>의 소유한 속성에서 확인하고 수정할 수 있습니다. 상위 노트에서 물려받은 항목은 상속된 속성에서 확인할 수 있으며 그곳에서는 수정할 수 없습니다.</p><p>목록에서 라벨 앞에는 <code>#</code>이 붙고 관계 앞에는 <code>~</code>가 붙습니다.</p><h2>같은 이름의 여러 값</h2><p>같은 이름의 속성을 여러 개 지정할 수 있습니다. 이를 통해 한 항목에 여러 값을 저장할 수 있습니다.</p><h2>속성 정의와 주요 속성</h2><p>특별한 라벨로 속성의 형식과 표시 방법을 정의할 수 있습니다. <a class="reference-link"
href="#root/_help_OFXdgB2nNk1F">주요 속성</a>을 참고하세요.</p><h2>속성 상속</h2><p>하위 노트가 상위 노트의 속성을 물려받을 수 있습니다. 자세한 내용은 <a class="reference-link"
href="#root/_help_bwZpz2ajCEwO">속성 상속</a>을 참고하세요.</p>
@@ -0,0 +1,2 @@
<p>상속은 <a href="#root/_help_HI6GBBIduIgv">라벨</a>이나 <a href="#root/_help_Cq5X6iKQop6R">관계</a>를 여러 노트에 공통으로 적용하는 기능입니다. 주로 상위·하위 노트 사이에 적용하며 템플릿으로도 사용할 수 있습니다.</p><h2>일반 상속</h2><p><code>isInheritable</code>을 <code>true</code>로 지정하면 해당 속성을 현재 노트와 모든 하위 노트에 적용합니다. <a
class="reference-link" href="#root/_help_HI6GBBIduIgv">라벨</a>과 <a class="reference-link" href="#root/_help_Cq5X6iKQop6R">관계</a> 편집 화면에서 설정하거나 <code>#myLabel(inheritable)=value</code>처럼 작성할 수 있습니다.</p><p>예를 들어 <code>archived</code> 라벨의 상속을 켜면 하위 트리 전체를 검색 등의 목록에서 숨길 수 있습니다. 일반 상속은 모든 하위 노트에 적용됩니다. 일부 노트에서 개별적으로 바꿔야 한다면 복사 상속이나 템플릿 방식을 사용하세요.</p><h2>복사 상속</h2><p>속성 이름 앞에 <code>child:</code>를 붙이면 새 하위 노트에 해당 속성을 복사합니다. 복사된 속성은 독립적이며 노트를 다른 위치로 옮겨도 유지됩니다.</p><p><code>#child:exampleAttribute</code>를 상위 노트에 지정하면 새로 만드는 바로 아래 노트에 <code>#exampleAttribute</code>가 생깁니다. 관계는 <code>~child:myRelation</code>처럼 지정합니다. 기존 노트에는 소급 적용되지 않습니다. 무한한 하위 단계에 적용하려면 일반 상속이나 템플릿을 사용하세요.</p><h3>여러 단계로 복사하기</h3><p><code>#child:child:child:foo</code>를 지정하면 첫 단계에는 <code>#child:child:foo</code>가 생기고 다음 단계에는 <code>#child:foo</code>가 생기며 세 번째 단계에는 <code>#foo</code>가 생깁니다. 관계도 <code>~child:child:child:foo</code>로 같은 방식을 사용할 수 있습니다. 새로 만드는 노트에만 적용됩니다.</p><h2>템플릿 상속</h2><p><a class="reference-link" href="#root/_help_KC1HB96bqqHX">템플릿</a>의 속성도 물려받을 수 있습니다. 비슷한 구조와 역할을 가진 노트에 공통 설정을 유지할 때 유용합니다.</p>
@@ -0,0 +1,12 @@
<p>라벨은 이름과 선택적인 값을 가진 노트의 <a href="#root/_help_zEY4DaJG4YT5">속성</a>입니다.</p><h2>활용 방법</h2><p><code>#year=1999</code>와 <code>#genre="공상 과학"</code> 및 <code>#author="닐 스티븐슨"</code>처럼 분류 정보를 붙입니다. <a
class="reference-link" href="#root/_help_OFXdgB2nNk1F">주요 속성</a>으로 표시하면 편리합니다. 앱의 고급 기능을 설정하거나 <a class="reference-link" href="#root/_help_R7abl2fc6Mxi">체중 기록</a>의 <code>weight</code>처럼 스크립트에 필요한 정보를 담기도 합니다.</p><h2>편집 화면에서 추가</h2><p><a class="reference-link"
href="#root/_help_BlN9DFI679QC">상단 리본</a>의 소유한 속성에서 더하기 → 새 라벨 추가를 선택합니다. 노트나 소유한 속성에 초점이 있을 때 Alt+L로도 엽니다. 이름을 입력하고 필요하면 값을 지정합니다. 하위 노트에도 적용하려면 상속 가능을 선택하세요. <a class="reference-link" href="#root/_help_bwZpz2ajCEwO">속성 상속</a>을 참고하세요.</p><h2>직접 입력</h2><p><a class="reference-link"
href="#root/_help_BlN9DFI679QC">상단 리본</a>의 소유한 속성에 입력합니다.</p><ul><li><code>#myLabel</code> — 값 없는 라벨</li><li><code>#myLabel=value</code> — 값을 가진 라벨</li><li><code>#myLabel="안녕하세요 여러분"</code> — 공백이 있는 값은 따옴표로 감쌉니다.</li><li><code>#myLabel='"안녕하세요"라고 말하기'</code> — 큰따옴표가 들어 있으면 작은따옴표로 감쌉니다.</li><li><code>#myLabel(inheritable)</code> 또는 <code>#myLabel(inheritable)=value</code> — 상속 가능한 라벨</li></ul><h2>미리 정의된 라벨</h2><p>다음 라벨은 Trilium에서 특별한 기능을 수행합니다. 별표는 같은 접두사로 시작하는 여러 라벨을 뜻합니다.</p><ul><li><code>disableVersioning</code> — 자동 <a class="reference-link" href="#root/_help_vZWERwf8U3nx">수정 이력</a> 생성을 끕니다. 다시 받을 수 있는 대형 라이브러리 등에 유용합니다.</li><li><code>versioningLimit</code> — 전체 설정 대신 해당 노트의 최대 <a class="reference-link" href="#root/_help_vZWERwf8U3nx">수정 이력</a> 수를 지정합니다.</li><li><code>calendarRoot</code> — <a class="reference-link"
href="#root/_help_l0tKav7yLHGF">일일 노트</a>의 루트입니다. 하나만 지정합니다.</li><li><code>archived</code> — 기본 검색과 선택 창에서 제외합니다. <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>에서도 숨기도록 설정할 수 있습니다.</li><li><code>excludeFromExport</code> — 내보낼 때 해당 노트와 하위 항목을 제외합니다.</li><li><code>run</code>과 <code>runOnInstance</code> 및 <code>runAtHour</code> — <a class="reference-link" href="#root/_help_GPERMystNGTB">이벤트</a> 실행 설정입니다.</li><li><code>disableInclusion</code> — 상위 스크립트 실행에 포함하지 않습니다.</li><li><code>sorted</code> — 하위 노트를 제목순으로 유지합니다. 값에 다른 라벨 이름을 지정하면 그 값으로 정렬합니다. 해당 라벨이 없는 노트는 제목을 사용합니다.</li><li><code>sortDirection</code> — 자동 정렬 방향입니다. <code>ASC</code>는 기본 오름차순이고 <code>DESC</code>는 내림차순입니다.</li><li><code>sortFoldersFirst</code> — 자동 정렬할 때 하위 노트가 있는 항목을 먼저 모읍니다.</li><li><code>top</code> — 상위 노트에 자동 정렬이 설정되어 있어도 해당 노트를 맨 위에 둡니다.</li><li><code>hidePromotedAttributes</code> — 현재 노트의 <a class="reference-link" href="#root/_help_OFXdgB2nNk1F">주요 속성</a>을 숨깁니다. 상속용 속성을 정의한 상위 노트 등에 유용합니다.</li><li><code>readOnly</code> — 텍스트와 코드 및 Mermaid 등 지원하는 노트를 항상 <a href="#root/_help_CoFPLs3dRlXc">읽기 전용</a>으로 엽니다.</li><li><code>autoReadOnlyDisabled</code> — 자동 <a href="#root/_help_CoFPLs3dRlXc">읽기 전용</a> 전환을 끕니다.</li><li><code>appCss</code> — 앱에 불러올 CSS 노트입니다. <a class="reference-link"
href="#root/_help_AlhDUqhENtH7">앱 전체 사용자 CSS</a>를 참고하세요.</li><li><code>appTheme</code> — 설정에서 선택할 수 있는 전체 테마 CSS입니다. <a class="reference-link" href="#root/_help_pKK96zzmvBGf">테마 개발</a>을 참고하세요.</li><li><code>appThemeBase</code> — <code>next</code>와 <code>next-light</code> 및 <code>next-dark</code>로 자동·밝은·어두운 Next 테마를 기반으로 사용합니다. <a class="reference-link"
href="#root/_help_WFGzWeUK6arS">Next 테마 수정</a>을 참고하세요.</li><li><code>cssClass</code> — <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a> 항목에 추가할 CSS 클래스입니다. 템플릿에서도 사용할 수 있습니다.</li><li><code>iconClass</code> — 아이콘에 추가할 CSS 클래스입니다. 예: <code>bx bx-home</code>. Boxicons를 사용하며 템플릿에서도 지정할 수 있습니다.</li><li><code>pageSize</code> — <a class="reference-link"
href="#root/_help_0ESUbbAxVnoK">노트 목록</a>의 페이지당 항목 수입니다.</li><li><code>customRequestHandler</code> — <a class="reference-link" href="#root/_help_J5Ex1ZrMbyJ6">사용자 요청 처리기</a>입니다.</li><li><code>customResourceProvider</code> — <a class="reference-link" href="#root/_help_d3fAXQ2diepH">사용자 리소스 제공자</a>입니다.</li><li><code>widget</code> — 앱 구성 요소 트리에 넣을 <a class="reference-link" href="#root/_help_MgibgPcfeuGz">사용자 위젯</a>입니다.</li><li><code>searchHome</code> — 새 <a
class="reference-link" href="#root/_help_m523cpzocqaD">저장된 검색</a> 노트를 만들 위치입니다.</li><li><code>workspace</code> 및 관련 라벨 — <a class="reference-link" href="#root/_help_9sRHySam5fXb">작업 공간</a>을 설정합니다.</li><li><code>inbox</code> — 사이드바의 새 노트 버튼으로 만든 노트를 보관할 기본 위치입니다.</li><li><code>sqlConsoleHome</code> — <a class="reference-link" href="#root/_hidden/_help/_help_tC7s2alapj8V/_help_wX4HbRucYSDD/_help_oyIAJ9PvvwHX/_help__help_YKWqdJhzi2VY">SQL 콘솔</a> 노트의 기본 위치입니다.</li><li><code>bookmarked</code> — <a href="#root/_help_u3YFHC9tQlpm">북마크</a>로 지정합니다.</li><li><code>bookmarkFolder</code> — 하위 항목을 열 수 있는 <a class="reference-link" href="#root/_help_u3YFHC9tQlpm">북마크 폴더</a>로 표시합니다.</li><li><code>share*</code> — <a class="reference-link" href="#root/_help_R9pX4DGra2Vt">공개 공유</a> 설정입니다.</li><li><code>displayRelations</code>와 <code>hideRelations</code> — <a class="reference-link" href="#root/_help_iRwzGnHPzonm">관계도</a>와 <a class="reference-link" href="#root/_help_BCkXAVs63Ttv">노트 지도</a>에서 표시하거나 숨길 관계 이름을 쉼표로 구분해 지정합니다.</li><li><code>titleTemplate</code> — 새 하위 노트의 기본 제목입니다. JavaScript 템플릿 문자열로 계산하며 <code>now</code>와 <code>parentNote</code>를 사용할 수 있습니다. 예: <code>${parentNote.getLabel('authorName')}의 작품</code> 또는 <code>${now.format('YYYY-MM-DD HH:mm:ss')} 기록</code>. <a class="reference-link" href="#root/_help_47ZrP6FNuoG8">기본 노트 제목</a>을 참고하세요.</li><li><code>template</code> — 새 노트의 <a class="reference-link" href="#root/_help_KC1HB96bqqHX">템플릿</a> 선택 목록에 표시합니다.</li><li><code>toc</code> — <a class="reference-link" href="#root/_help_BFvAtE74rbP6">목차</a> 표시를 제어합니다. <code>#toc</code> 또는 <code>#toc=show</code>는 항상 표시하고 <code>#toc=false</code>는 숨깁니다.</li><li><code>color</code> — 트리와 링크 등의 노트 색입니다. <code>red</code>나 <code>#a13d5f</code> 같은 CSS 색상값을 사용합니다.</li><li><code>keyboardShortcut</code> — 해당 노트로 이동할 단축키입니다. 예: <code>ctrl+alt+e</code>. 변경 후 화면을 새로고침해야 합니다.</li><li><code>keepCurrentHoisting</code> — 현재 확대 범위 밖의 노트를 열어도 트리의 확대 범위를 유지합니다.</li><li><code>executeButton</code> — 현재 코드 노트 실행 버튼의 이름입니다.</li><li><code>executeDescription</code> — 실행 버튼과 함께 보여 줄 자세한 설명입니다.</li><li><code>excludeFromNoteMap</code> — <a class="reference-link"
href="#root/_help_bdUJEHsAPYQR">노트 지도</a>에서 제외합니다.</li><li><code>newNotesOnTop</code> — 새 하위 노트를 맨 위에 만듭니다.</li><li><code>hideHighlightWidget</code> — <a class="reference-link" href="#root/_help_AxshuNRegLAv">강조 표시 목록</a> 위젯을 숨깁니다.</li><li><code>hideChildrenOverview</code> — 해당 노트의 <a class="reference-link" href="#root/_help_0ESUbbAxVnoK">하위 노트 목록</a>을 숨깁니다.</li><li><code>printLandscape</code> — PDF를 가로 방향으로 내보냅니다.</li><li><code>printPageSize</code> — PDF 용지 크기입니다. <code>A0 A1 A2 A3 A4 A5 A6 Legal Letter Tabloid Ledger</code>를 지원합니다.</li><li><code>geolocation</code> — <a
class="reference-link" href="#root/_help_81SGnPGMk7Xc">지리 지도</a>에 표시할 위도와 경도입니다.</li><li><code>calendar:*</code> — <a class="reference-link" href="#root/_help_xWbu3jpNWapp">달력 보기</a> 설정입니다.</li><li><code>viewType</code> — 격자나 목록 등 <a class="reference-link"
href="#root/_help_0ESUbbAxVnoK">하위 노트 보기</a> 형식을 지정합니다.</li></ul>
@@ -0,0 +1 @@
<p>주요 속성은 자주 사용하는 <a href="#root/_help_zEY4DaJG4YT5">속성</a>을 노트의 주 화면에 입력란으로 표시하는 기능입니다.</p><p><img src="Promoted Attributes_promot.png" alt="주요 속성 입력란"></p><p>각 입력란은 일반 속성과 같은 값을 저장합니다. 검색이나 스크립트에서 사용할 속성을 매번 메뉴에서 찾지 않고 바로 확인하고 수정할 수 있습니다.</p><h2>속성 정의</h2><p>속성의 이름과 값은 문자열입니다. 속성 정의는 값을 글자나 날짜 등 어떤 형식으로 해석할지와 여러 값을 허용할지 및 주요 속성으로 표시할지를 지정합니다.</p><p><img src="Promoted Attributes_image.png" alt="속성 정의 예시"></p><p>실제 값을 저장하는 속성과 그 형식을 지정하는 속성은 별개입니다. 형식 정의에 <a href="#root/_help_bwZpz2ajCEwO">상속</a>을 설정하면 하위 트리 전체에 공통으로 적용하고 값은 각 노트에 따로 지정할 수 있습니다.</p><h3>역방향 관계</h3><p>배우자 관계처럼 양쪽에 같은 이름의 관계가 필요한 경우가 있습니다. 한 노트에서 다른 노트로 <code>isPartnerOf</code>를 연결했다면 반대 방향에도 같은 관계가 있어야 합니다.</p><p>부모와 자녀는 방향에 따라 이름이 다릅니다. 부모에서 자녀로는 <code>isParentOf</code>를 사용하고 반대쪽에는 <code>isChildOf</code>를 사용할 수 있습니다.</p><p>관계 정의에서 서로의 역방향 관계 이름을 지정하면 자동으로 관리할 수 있습니다. 부모·자녀 예제에서는 각 관계의 정의에 상대 관계 이름을 지정해야 합니다. 관계를 저장하면 대상 노트의 역방향 관계도 확인하고 생성합니다. 관계를 삭제하면 대응하는 역방향 관계도 삭제합니다.</p>
@@ -0,0 +1,5 @@
<p>관계는 <a href="#root/_help_HI6GBBIduIgv">라벨</a>과 비슷하지만 텍스트 값 대신 다른 노트를 가리킵니다.</p><h2>활용 방법</h2><ul><li>책 노트와 저자 노트를 연결하는 등 자료의 관계를 나타냅니다. <a class="reference-link" href="#root/_help_OFXdgB2nNk1F">주요 속성</a>으로 표시하면 더 편하게 사용할 수 있습니다.</li><li><a
class="reference-link" href="#root/_help_HcABDtFCkbFN">렌더링 노트</a>와 <a class="reference-link" href="#root/_help_R9pX4DGra2Vt">공개 공유</a> 및 <a
class="reference-link" href="#root/_help_KC1HB96bqqHX">템플릿</a>을 설정합니다.</li><li>노트의 이벤트나 조건에 맞춰 실행할 스크립트를 연결합니다.</li></ul><h2>편집 화면에서 만들기</h2><p><a class="reference-link"
href="#root/_help_BlN9DFI679QC">상단 리본</a>의 소유한 속성에서 더하기 버튼을 누르고 새 관계 추가를 선택합니다. 노트나 소유한 속성에 초점이 있을 때 Alt+L을 눌러도 편집 화면이 열립니다.</p><p>관계 이름과 대상 노트를 지정합니다. 관계에는 대상 노트가 반드시 있어야 합니다. 하위 노트에도 적용하려면 상속 가능을 선택하세요. <a class="reference-link" href="#root/_help_bwZpz2ajCEwO">속성 상속</a>을 참고하세요.</p><h2>직접 입력하기</h2><p><a class="reference-link"
href="#root/_help_BlN9DFI679QC">상단 리본</a>의 소유한 속성에서 <code>~myRelation=@</code>를 입력합니다. 자동 완성 목록에 대상 제목을 입력한 다음 Enter를 누르거나 원하는 노트를 선택합니다. <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>에서 노트를 복사했다면 <code>@</code> 없이 <code>=</code> 뒤에 붙여 넣을 수도 있습니다.</p><p>상속 가능한 관계는 <code>~myRelation</code> 대신 <code>~myRelation(inheritable)</code>로 입력합니다.</p><h2>미리 정의된 관계</h2><p>다음 관계는 Trilium에서 특별한 기능을 수행합니다. 이름 끝의 별표는 같은 접두사로 시작하는 여러 관계를 뜻합니다.</p><ul><li><code>runOn*</code> — <a class="reference-link" href="#root/_help_GPERMystNGTB">이벤트</a>에 따라 스크립트를 실행합니다.</li><li><code>template</code> — 상하위 관계가 없어도 속성을 상속합니다. 템플릿 규칙에 따라 비어 있는 인스턴스에 본문과 하위 트리를 추가합니다.</li><li><code>inherit</code> — 상하위 관계가 없어도 속성을 상속합니다. 비슷한 개념인 <a class="reference-link" href="#root/_help_KC1HB96bqqHX">템플릿</a>과 <a class="reference-link" href="#root/_help_bwZpz2ajCEwO">속성 상속</a>을 참고하세요.</li><li><code>renderNote</code> — <a class="reference-link" href="#root/_help_HcABDtFCkbFN">렌더링 노트</a>에서 표시할 HTML 또는 스크립트 코드 노트를 가리킵니다.</li><li><code>widget_relation</code> — 대상 노트를 실행하고 사이드바 위젯으로 표시합니다.</li><li><code>shareCss</code> — 공유 페이지에 넣을 CSS 노트입니다. 해당 노트도 공유 하위 트리에 있어야 합니다. 필요에 따라 <code>share_hidden_from_tree</code>와 <code>share_omit_default_css</code>를 함께 사용합니다.</li><li><code>shareJs</code> — 공유 페이지에 넣을 JavaScript 노트입니다. 해당 노트도 공유 하위 트리에 있어야 합니다. 필요하면 <code>share_hidden_from_tree</code>로 트리에서 숨깁니다.</li><li><code>shareTemplate</code> — 공유 노트 표시용 템플릿으로 사용할 임베디드 JavaScript 노트입니다. 지정하지 않으면 기본 템플릿을 사용합니다. 필요하면 <code>share_hidden_from_tree</code>로 숨깁니다.</li><li><code>shareFavicon</code> — 공유 페이지의 아이콘 노트입니다. 보통 공유 루트에 지정하고 상속 가능으로 설정합니다. 아이콘도 공유 하위 트리에 있어야 합니다. 필요하면 <code>share_hidden_from_tree</code>로 숨깁니다.</li></ul>
Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

@@ -0,0 +1,4 @@
<p><img style="aspect-ratio:1425/654;" src="Bulk Actions_image.png" width="1425"
height="654" alt="일괄 작업 설정"></p><p>일괄 작업으로 여러 노트에 라벨을 추가하거나 지우고 스크립트를 실행할 수 있습니다.</p><h2>사용 방법</h2><p><a class="reference-link"
href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>에서 노트 하나를 선택하거나 <a class="reference-link" href="#root/_help_yTjUdsOi4CIE">여러 노트 선택</a> 방법으로 대상을 지정합니다. <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>의 마우스 오른쪽 메뉴에서 고급 → 일괄 작업 적용을 선택합니다.</p><p>기본 대상은 선택한 노트뿐입니다. 하위 노트도 처리하려면 선택한 노트의 하위 항목 포함을 선택하세요. 위쪽의 대상 노트 수가 갱신됩니다. 사용 가능한 작업에서 항목을 선택하고 선택한 작업 영역에서 세부 값을 지정합니다. 같은 유형의 작업을 여러 번 추가할 수 있으며 오른쪽 X로 제거합니다. 설정을 마친 뒤 일괄 작업 실행을 누릅니다. 마지막 설정은 다음에 창을 열 때 복원됩니다.</p><h2>라벨 작업</h2><p><a class="reference-link" href="#root/_help_HI6GBBIduIgv">라벨</a>을 다음과 같이 관리합니다.</p><ul><li>라벨 추가 — 같은 이름의 <a href="#root/_help_HI6GBBIduIgv">라벨</a>이 없으면 만들고 있으면 값을 바꿉니다. 새 값을 비우면 값 없는 라벨이 됩니다.</li><li>라벨 값 변경 — 해당 <a href="#root/_help_HI6GBBIduIgv">라벨</a>이 있는 노트만 처리합니다. 값을 비우면 기존 값이 지워집니다.</li><li>라벨 이름 변경 — 해당 <a href="#root/_help_HI6GBBIduIgv">라벨</a>의 이름만 바꾸고 값은 유지합니다.</li><li>라벨 삭제 — 같은 이름의 라벨을 값 유무와 관계없이 삭제합니다.</li></ul><h2>관계 작업</h2><p><a class="reference-link" href="#root/_help_Cq5X6iKQop6R">관계</a>의 추가와 대상 변경 및 이름 변경과 삭제를 지원합니다. 추가는 지정한 노트를 가리키는 관계를 만듭니다. 나머지 작업은 해당 관계가 있는 노트만 처리합니다. 이름을 바꿔도 대상 노트는 유지됩니다.</p><h2>노트 작업</h2><p>노트 이름 변경은 모든 대상의 제목을 지정한 값으로 바꿉니다. <a
class="reference-link" href="#root/_help_habiZ3HU8Kw8">FNote</a> 정보에 접근하는 템플릿 문자열도 사용할 수 있습니다. <code>새 항목: ${note.title}</code>은 제목 앞에 문구를 붙입니다. <code>${note.dateCreatedObj.format('MM-DD')}: ${note.title}</code>은 만든 날짜를 월·일 형식으로 붙입니다.</p><p>노트 이동은 지정한 상위 노트 아래로 옮깁니다. 간단한 이동은 <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>에서 잘라내기와 붙여넣기 또는 메뉴로 처리해도 됩니다. 노트 삭제는 대상을 삭제합니다. <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">노트 트리</a>에서 선택하고 Delete를 누르는 방법도 있습니다. 노트 수정 이력 삭제는 대상의 모든 <a class="reference-link" href="#root/_help_vZWERwf8U3nx">수정 이력</a>을 지웁니다.</p><h2>스크립트 실행</h2><p>복잡한 작업은 JavaScript로 작성할 수 있습니다. 다음 예제는 제목 뒤에 문구를 붙입니다.</p><pre><code class="language-application-javascript-env-backend">note.title = note.title + " - 추가 문구";</code></pre><p>다음 예제는 <code>#shareAlias</code> 라벨을 노트 제목으로 설정합니다.</p><pre><code class="language-application-javascript-env-backend">note.setLabel("shareAlias", note.title)</code></pre>
Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

@@ -0,0 +1,4 @@
<p>Trilium은 <code>config.ini</code> 파일과 환경 변수로 설정할 수 있습니다. 지원하는 항목은 <a href="https://github.com/TriliumNext/Notes/blob/develop/apps/server/src/assets/config-sample.ini">config-sample.ini 예제</a>와 <a href="https://github.com/TriliumNext/Notes">Notes 저장소</a>를 참고하세요.</p><p>환경 변수는 다음 규칙을 따릅니다.</p><ul><li>이름 앞에 <code>TRILIUM_</code>을 붙이고 INI의 구역과 키를 밑줄로 구분합니다.</li><li>형식은 <code>TRILIUM_&lt;SECTION&gt;_&lt;KEY&gt;=&lt;VALUE&gt;</code>입니다.</li><li>같은 항목이 파일에도 있으면 환경 변수의 값이 우선합니다.</li></ul><p>예를 들어 설정 파일에 다음 내용이 있다고 가정합니다.</p><pre><code class="language-text-x-trilium-auto">[Network]
host=localhost
port=8080</code></pre><p>다음 환경 변수로 값을 바꿀 수 있습니다.</p><pre><code class="language-text-x-trilium-auto">TRILIUM_NETWORK_HOST=0.0.0.0
TRILIUM_NETWORK_PORT=9000</code></pre><p>설정은 다음 순서로 읽습니다.</p><ul><li><code>config.ini</code> 파일을 불러옵니다.</li><li><code>TRILIUM_</code>으로 시작하는 환경 변수를 찾습니다.</li><li>환경 변수 이름에서 구역과 키를 구분합니다.</li><li>환경 변수의 값을 우선해 파일의 설정과 합칩니다.</li></ul>
@@ -0,0 +1 @@
<p>기본 설정에서는 다른 도메인이나 출처의 웹페이지가 브라우저를 통해 Trilium에 요청하는 것을 허용하지 않습니다.</p><p>Trilium 0.93.0부터 환경 변수나 <code>config.ini</code>를 사용해 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS">교차 출처 리소스 공유(CORS)</a>를 설정할 수 있습니다.</p><table><thead><tr><th>CORS 헤더</th><th>환경 변수</th><th>config.ini의 Network 구역 설정</th></tr></thead><tbody><tr><td><code>Access-Control-Allow-Origin</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_ORIGIN</code></td><td><code>corsAllowOrigin</code></td></tr><tr><td><code>Access-Control-Allow-Methods</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_METHODS</code></td><td><code>corsAllowMethods</code></td></tr><tr><td><code>Access-Control-Allow-Headers</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_HEADERS</code></td><td><code>corsAllowHeaders</code></td></tr></tbody></table>
@@ -0,0 +1,3 @@
<p>Trilium 인스턴스는 실행 중인 서버 하나를 뜻합니다. <a class="reference-link"
href="#root/_help_cbkrhQjrkKrh">동기화</a>를 구성하면 데스크톱 앱 내부의 서버와 동기화 대상 서버 등 여러 인스턴스를 사용하게 됩니다. 이때 현재 어느 인스턴스에서 실행 중인지 구분하면 편리합니다.</p><h2>인스턴스 이름 지정</h2><p><code>config.ini</code>에 다음과 같이 이름을 설정하세요.</p><pre><code class="language-text-x-trilium-auto">[General]
instanceName=내서버</code></pre><h2>서버에서 인스턴스 구분</h2><p><code>api.getInstanceName()</code>을 호출하면 설정 파일이나 환경 변수에 지정한 현재 서버의 인스턴스 이름을 얻을 수 있습니다.</p><h2>특정 인스턴스에서만 스크립트 실행</h2><p>정기적으로 실행하거나 특정 이벤트에 반응하는 스크립트를 일부 인스턴스에서만 실행할 수 있습니다. 코드를 바꿀 필요 없이 <code>runOnInstance</code> 라벨의 값에 실행할 인스턴스 이름을 넣으세요. 여러 인스턴스에서 실행하려면 라벨을 여러 개 추가하세요.</p>
@@ -0,0 +1,26 @@
<p><a href="#root/_help_CdNpE2pqjmI6">스크립트</a>로 공개 REST 요청을 처리할 수 있습니다. 외부 서비스에서 제목과 본문을 보내 노트를 만드는 등의 연동에 사용합니다.</p><h2>외부 요청으로 노트 만들기</h2><p>다음은 백엔드 JavaScript <a href="#root/_help_6f9hih2hXXZk">코드 노트</a>예제입니다. 예시 비밀값을 그대로 공개 서비스에 사용하면 안 됩니다.</p><pre><code class="language-text-x-trilium-auto">const {req, res} = api;
const {secret, title, content} = req.body;
if (req.method == 'POST' &amp;&amp; secret === 'secret-password') {
// 노트를 저장할 상위 노트를 지정합니다.
// 이 코드 노트의 관계로 대상 상위 노트를 연결합니다.
// 간단한 예제에서는 노트 정보에서 확인한 고정 ID를 사용할 수도 있습니다.
const targetParentNoteId = api.currentNote.getRelationValue('targetNote');
const {note} = api.createTextNote(targetParentNoteId, title, content);
const notePojo = note.getPojo();
res.status(201).json(notePojo);
}
else {
res.send(400);
}</code></pre><p><code>#customRequestHandler=create-note</code> 라벨과 저장할 위치를 가리키는 <code>~targetNote</code> 관계를 지정합니다.</p><h3>요청 예시</h3><pre><code class="language-text-x-trilium-auto">POST http://my.trilium.org/custom/create-note
Content-Type: application/json
{
"secret": "secret-password",
"title": "인사",
"content": "안녕하세요."
}</code></pre><p><code>/custom</code> 아래 요청은 <code>customRequestHandler</code> <a href="#root/_help_zEY4DaJG4YT5">라벨</a>이 있는 노트에서 처리기를 찾습니다. 라벨 값은 경로에 대응하는 정규식입니다. 찾은 스크립트에는 Express의 <a href="https://expressjs.com/en/api.html#req">요청 객체</a>와 <a
href="https://expressjs.com/en/api.html#res">응답 객체</a>가 <code>api.req</code>와 <code>api.res</code>로 제공됩니다.</p><p>이 경로는 기본 인증을 자동으로 요구하지 않습니다. 처리기에서 인증을 구현해야 합니다. 예제는 POST 방식과 비밀값을 확인한 뒤 <a
href="#root/_help_GLks18SNjxmC">스크립트 API</a>로 노트를 만듭니다.</p><h2>파일 제공</h2><p>파일만 제공하려면 <code>customResourceProvider</code> 라벨에 경로 정규식을 지정할 수 있습니다. <a href="#root/_help_d3fAXQ2diepH">사용자 지정 리소스 제공</a>을 참고하세요.</p><h2>고급 사용</h2><p>요청과 응답 객체의 기능은 <a href="https://expressjs.com/en/api.html">Express 공식 문서</a>에서 확인할 수 있습니다.</p><h3>경로 매개변수</h3><pre><code class="language-text-x-trilium-auto">http://my.trilium.org/custom/notes/123</code></pre><p>마지막 숫자처럼 바뀌는 부분을 정규식으로 받을 수 있습니다.</p><pre><code class="language-text-x-trilium-auto">notes/([0-9]+)</code></pre><p>괄호로 묶은 일치 결과는 <code>api.pathParams</code>에 들어갑니다.</p><pre><code class="language-text-x-trilium-auto">const noteId = api.pathParams[0];</code></pre><p><code>?noteId=123</code> 같은 쿼리 매개변수는 <code>req.query.noteId</code>로 읽습니다.</p>
@@ -0,0 +1,8 @@
<p>사용자 지정 리소스 제공 기능은 Trilium에 가져온 이미지와 글꼴 및 스타일시트 등의 파일을 공개 주소로 제공합니다. 테마와 함께 사용자 글꼴을 제공할 때 활용할 수 있습니다.</p><h2>설정 순서</h2><ul><li>이미지나 글꼴 파일을 Trilium으로 끌어서 가져옵니다.</li><li>파일 노트를 선택하고 소유한 속성을 엽니다.</li><li><code>#customResourceProvider=hello</code> 라벨을 추가합니다.</li><li>브라우저에서 <code>&lt;protocol&gt;://&lt;host&gt;/custom/hello</code>를 엽니다. protocol에는 환경에 맞는 <code>http</code>나 <code>https</code>를 사용합니다. host는 Trilium 서버의 주소입니다. 별도 서버 없이 데스크톱 앱만 사용한다면 기본 주소는 <code>http://localhost:37840</code>입니다.</li><li>정상적으로 설정되었다면 가져온 파일이 내려받아집니다.</li></ul><p><code>hello</code> 대신 다음과 같은 이름도 사용할 수 있습니다.</p><ul><li>경로 — <code>fonts/Roboto.ttf</code>로 지정하면 <code>&lt;host&gt;/custom/fonts/Roboto.ttf</code>로 접근합니다.</li><li>정규식 — <code>hello/.*</code>로 지정하면 <code>/custom/hello/1</code>과 <code>/custom/hello/2</code> 또는 <code>/custom/hello/world</code>처럼 여러 경로에 대응합니다.</li></ul><h2>테마에서 사용하기</h2><p>글꼴 파일을 가져온 뒤 <code>#customResourceProvider=fonts/myfont.ttf</code> 속성을 지정하세요. 테마 CSS에서는 다음처럼 불러올 수 있습니다.</p><pre><code class="language-text-css">@font-face {
font-family: customFont;
src: url("/custom/fonts/myfont.ttf");
}
div {
font-family: customFont;
}</code></pre>
@@ -0,0 +1 @@
<p>Trilium은 노트와 트리 구조 및 메타데이터와 대부분의 설정을 <a href="https://www.sqlite.org">SQLite</a> 데이터베이스에 저장합니다. 파일 이름은 <code>document.db</code>이며 기본 <a href="#root/_help_tAassRL4RSQL">데이터 폴더</a>에 있습니다.</p><h2>사용 예제</h2><p>처음 실행하면 주요 기능을 소개하는 예제 노트를 제공합니다. <a class="reference-link" href="#root/_help_6tZeKvSHEUiB">사용 예제</a>를 참고하세요.</p><h2>데이터베이스 직접 수정하기</h2><p>고급 사용자는 <a href="https://sqlitebrowser.org/">DB Browser for SQLite</a> 같은 도구로 데이터베이스를 살펴보거나 수정할 수 있습니다. 자세한 내용은 <a href="#root/_help_oyIAJ9PvvwHX">데이터베이스 직접 수정하기</a>를 참고하세요.</p><h2>데이터베이스 초기화하기</h2><p>시험 중인 환경을 초기 상태로 되돌리려면 기존 데이터베이스를 제거할 수 있습니다. 다음 실행 시 원본 예제 노트가 포함된 새 데이터베이스를 만듭니다. 기존 노트가 사라지므로 필요한 데이터를 먼저 백업하고 애플리케이션을 종료하세요.</p><p><a href="#root/_help_tAassRL4RSQL">데이터 폴더</a>에서 <code>document.db</code>와 이름이 <code>document.db</code>로 시작하는 관련 파일을 제거합니다.</p><p><code>config.ini</code>의 설정도 보존할 필요가 없다면 <a href="#root/_help_tAassRL4RSQL">데이터 폴더</a>의 내용을 모두 제거해 초기화할 수 있습니다. 파일 대신 환경 변수로 설정하는 방법은 <a href="#root/_help_Gzjqa934BdH4">설정 안내</a>를 참고하세요.</p>
@@ -0,0 +1 @@
<p>Trilium을 처음 실행하면 사용 예제가 포함된 데이터베이스를 만듭니다. 예제에서는 다음 기능을 살펴볼 수 있습니다.</p><ul><li><a class="reference-link" href="#root/_help_iRwzGnHPzonm">관계 지도</a></li><li><a class="reference-link" href="#root/_help_l0tKav7yLHGF">날짜별 노트</a></li><li><a class="reference-link" href="#root/_help_R7abl2fc6Mxi">체중 기록</a></li><li><a class="reference-link" href="#root/_help_xYjQUYhpbUEW">할 일 관리</a></li><li><a class="reference-link" href="#root/_help_Wy267RK4M69c">테마</a></li></ul><h3>사용 예제 복원하기</h3><p>고급 기능을 시험한 뒤 원래 예제를 다시 확인하고 싶거나 새 기능이 추가된 최신 예제를 살펴보고 싶을 때 원본 예제를 가져올 수 있습니다.</p><p>Trilium의 가져오기 기능을 사용하세요.</p><ul><li><a href="https://github.com/TriliumNext/Notes/raw/develop/db/demo.zip">최신 예제 ZIP 파일</a>을 내려받습니다.</li><li>예제를 넣을 상위 노트를 트리에서 마우스 오른쪽 버튼으로 클릭합니다.</li><li>노트로 가져오기를 선택합니다.</li><li>내려받은 ZIP 파일을 선택합니다.</li></ul>
@@ -0,0 +1 @@
<p>고급 개발이나 문제 해결 과정에서 Trilium의 SQLite 데이터베이스를 직접 수정해야 할 때가 있습니다. 수정하기 전에 <code>document.db</code>를 백업하세요.</p><h2>내장 SQL 콘솔 사용하기</h2><p>Trilium에는 데이터베이스 편집기가 내장되어 있습니다. <a class="reference-link" href="#root/_help_YKWqdJhzi2VY">SQL 콘솔</a>을 참고하세요.</p><h2>외부 도구로 수정하기</h2><p>애플리케이션이 실행되지 않는 경우처럼 SQL 콘솔을 사용할 수 없을 때는 외부 도구를 이용할 수 있습니다. 데스크톱 앱을 종료하거나 서버 서비스와 Docker 컨테이너를 중지한 뒤 작업하세요.</p><h3>DB Browser for SQLite 사용하기</h3><p>여러 운영체제에서 사용할 수 있는 그래픽 데이터베이스 편집기입니다.</p><ul><li>파일 메뉴에서 데이터베이스 열기를 선택하고 <a href="#root/_help_tAassRL4RSQL">데이터 폴더</a>의 데이터베이스를 엽니다.</li><li>SQL 실행 탭을 선택합니다.</li><li>원하는 SQL 문을 입력합니다.</li><li>탭 아래 도구 모음의 실행 버튼을 누르거나 <kbd>F5</kbd>를 누릅니다.</li><li>주 도구 모음에서 변경 사항 쓰기를 누릅니다.</li><li>데이터베이스나 프로그램을 닫습니다.</li></ul><p><img src="Manually altering the data.png" alt="외부 데이터베이스 편집기 사용 예시"></p><h3>SQLite 명령줄 도구 사용하기</h3><p>데이터베이스 경로를 지정해 실행하세요.</p><pre><code class="language-text-x-trilium-auto">sqlite3 ~/.local/share/trilium-data/document.db</code></pre><ul><li>SQL 문 끝에 <code>;</code>을 붙여 입력합니다.</li><li>종료하려면 <code>.quit</code>을 입력하고 <kbd>Enter</kbd>를 누릅니다.</li></ul>
@@ -0,0 +1 @@
<p>SQL 콘솔은 Trilium에 내장된 데이터베이스 편집기입니다.</p><p><a href="#root/_help_Vc8PjrjAGuOp">전체 메뉴</a> → 고급 → SQL 콘솔 열기에서 실행할 수 있습니다.</p><p><img src="SQL Console_image.png" alt="SQL 콘솔 화면"></p><h3>사용 방법</h3><ul><li>화면 위쪽의 테이블 이름에 마우스를 올리면 열 이름과 자료형을 확인할 수 있습니다.</li><li>SQL 문은 한 번에 하나씩 실행할 수 있습니다.</li><li><img src="3_SQL Console_image.png" alt="실행 버튼">을 누르면 작성한 SQL 문을 실행합니다.</li><li>조회 결과는 표로 표시됩니다.<p><img src="1_SQL Console_image.png" alt="SQL 조회 결과"></p></li></ul><h3>SQL 콘솔 저장하기</h3><p>SQL 조회문이나 명령을 전용 노트로 저장할 수 있습니다. SQL 문을 작성한 뒤 <img src="2_SQL Console_image.png" alt="저장 버튼">을 누르세요. 저장한 노트는 <a href="#root/_help_l0tKav7yLHGF">날짜별 노트</a>에 나타납니다.</p><ul><li>SQL 문은 기본 화면에 표시되지 않습니다. 노트의 오른쪽 클릭 메뉴에서 노트 소스 보기를 선택하면 확인할 수 있습니다.</li><li>저장된 SQL 문은 직접 수정할 수 없습니다. 변경하려면 SQL 콘솔에 복사해 수정한 뒤 다시 저장하세요.</li></ul>
@@ -0,0 +1,2 @@
<p>새 노트의 기본 제목은 새 노트입니다. 다른 제목이나 생성 시점에 따라 달라지는 제목을 사용하려면 <code>#titleTemplate</code> <a
href="#root/_help_zEY4DaJG4YT5">라벨</a>을 지정하세요. 이 기능은 0.52부터 지원합니다.</p><p>상위 노트에 라벨과 값을 지정하면 하위 노트를 만들 때 그 값을 제목으로 사용합니다. 상속을 켜면 더 아래 단계에도 적용됩니다. 최상위 노트에 지정하면 전체 노트에 적용할 수 있습니다.</p><p>예를 들어 2022년에 읽은 책 아래에 닐 스티븐슨의 아나뎀과 프란츠 카프카의 변신을 기록한다고 가정해 보겠습니다. 상위 노트에 <code>#titleTemplate="[저자]의 [책 제목] ([출간 연도])"</code>를 지정하면 새 하위 노트의 제목이 이 형식으로 만들어집니다.</p><p>정보를 자동으로 추론하는 기능은 아닙니다. 대괄호 부분은 사용자가 직접 채워 넣는 자리입니다.</p><h2>동적으로 제목 만들기</h2><p>제목 템플릿은 노트를 만드는 순간 JavaScript 문자열로 평가됩니다. 문자열 보간을 사용하면 날짜나 상위 노트의 값을 넣을 수 있습니다. <code>parentNote</code> 변수는 상위 노트의 <a href="#root/_help_habiZ3HU8Kw8">FNote 객체</a>를 제공합니다.</p><p>본문까지 기본 내용을 지정하려면 <a class="reference-link" href="#root/_help_KC1HB96bqqHX">템플릿</a>도 참고하세요.</p><h3>예제</h3><p>서버 장애 기록을 날짜별로 남긴다면 상위 노트에 <code>#titleTemplate="${now.format('YYYY-MM-DD')}: "</code>를 지정하세요. 새 노트를 만들 때 <a href="https://day.js.org/docs/en/display/format">now 날짜 객체</a>를 사용해 날짜가 입력됩니다. 이후 시스템 중단이나 백업 지연처럼 사건 이름을 덧붙이면 됩니다.</p><p>상위 노트의 저자 속성을 사용하려면 <code>#titleTemplate="${parentNote.getLabelValue('authorName')}의 작품"</code>을 사용하세요. 상위 노트의 제목을 그대로 사용하려면 <code>${parentNote.title}</code>을 지정합니다.</p>
@@ -0,0 +1,11 @@
<p>ETAPI는 외부 프로그램에서 Trilium을 사용하는 REST API입니다. 0.50부터 제공됩니다. 명세는 <a href="https://github.com/TriliumNext/Notes/blob/master/src/etapi/etapi.openapi.yaml">OpenAPI 문서</a>에서 확인할 수 있습니다.</p><h2>클라이언트 라이브러리</h2><p><a href="https://github.com/Nriver/trilium-py">trilium-py</a>를 사용하면 Python에서 Trilium에 접근하는 코드를 더 쉽게 작성할 수 있습니다.</p><h2>토큰 발급</h2><p>모든 API 작업은 토큰으로 인증해야 합니다. 설정 → ETAPI에서 발급하거나 <code>/auth/login</code> 요청으로 받을 수 있습니다. 자세한 요청 형식은 <a href="https://github.com/TriliumNext/Notes/blob/master/src/etapi/etapi.openapi.yaml">API 명세</a>를 참고하세요.</p><h2>인증</h2><h3>Authorization 헤더</h3><pre><code class="language-text-x-trilium-auto">GET https://myserver.com/etapi/app-info
Authorization: ETAPITOKEN</code></pre><p><code>ETAPITOKEN</code>을 발급받은 토큰으로 바꾸세요. 0.93.0부터는 다른 도구와의 호환성을 위해 <code>Bearer ETAPITOKEN</code> 형식도 지원합니다.</p><h3>기본 인증</h3><p>0.56부터 다음 형식도 지원합니다.</p><pre><code class="language-text-x-trilium-auto">GET https://myserver.com/etapi/app-info
Authorization: Basic BATOKEN</code></pre><ul><li><code>BATOKEN = BASE64(username + ':' + password)</code> 형식으로 만듭니다.</li><li>사용자 이름은 <code>etapi</code>입니다.</li><li>비밀번호 자리에 발급받은 ETAPI 토큰을 넣습니다.</li></ul><p>기본 인증만 지원하는 도구에서 사용할 수 있는 방식입니다.</p><h2>Bash 스크립트 예제</h2><p>다음 예제는 노트의 HTML 본문을 내려받습니다.</p><pre><code class="language-text-x-trilium-auto">#!/usr/bin/env bash
# 연결 설정
TOKEN=YOUR_ETAPI_TOKEN
SERVER=http://localhost:8080
# 노트 ID로 본문 내려받기
NOTE_ID="i6ra4ZshJhgN"
curl "$SERVER/etapi/notes/$NOTE_ID/content" -H "Authorization: $TOKEN" </code></pre><p>실행 전에 다음 값을 바꾸세요.</p><ul><li><code>TOKEN</code> — 직접 발급받은 ETAPI 토큰</li><li><code>SERVER</code> — 사용 중인 Trilium의 프로토콜과 호스트 및 포트</li><li><code>NOTE_ID</code> — 내려받을 노트의 ID</li></ul>
@@ -0,0 +1,13 @@
<p><img style="aspect-ratio:263/445;" src="Hidden Notes_image.png" width="263"
height="445" alt="숨겨진 노트 트리"></p><p>Trilium은 여러 기능의 정보를 실제 노트로 저장합니다. 덕분에 <a class="reference-link"
href="#root/_help_zEY4DaJG4YT5">속성</a>과 <a class="reference-link"
href="#root/_help_Cq5X6iKQop6R">관계</a> 및 <a class="reference-link"
href="#root/_help_eIg8jdvaoNNd">검색</a>과 <a class="reference-link"
href="#root/_help_QEAPj01N5f7w">링크</a>를 활용할 수 있습니다. 트리가 복잡해지거나 실수로 지우는 일을 줄이기 위해 기본적으로 숨겨 둡니다. 일반 노트처럼 <a class="reference-link"
href="#root/_help_wX4HbRucYSDD">데이터베이스</a>에 저장되지만 특별한 <a class="reference-link" href="#root/_help_m1lbrzyKDaRB">노트 ID</a>로 구분합니다.</p><h2>숨겨진 트리 열기</h2><p><a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a>에서 고급 → 숨겨진 하위 트리 표시를 선택합니다.</p><h2>구성</h2><ul><li><a class="reference-link" href="#root/_hidden/_help__globalNoteMap">노트 지도</a> — <a class="reference-link" href="#root/_help_bdUJEHsAPYQR">노트 지도</a> 기능을 <a class="reference-link" href="#root/_help_xYmIYSP6wE3F">실행 도구 모음</a>에서 열 때 사용하는 노트입니다. 하위 노트를 만들어 지도 모음을 보관하고 다른 곳에서 연결하거나 <a href="#root/_help_u3YFHC9tQlpm">북마크</a>로 지정할 수 있습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__sqlConsole">SQL 콘솔 기록</a> — <a class="reference-link"
href="#root/_help_YKWqdJhzi2VY">SQL 콘솔</a>에서 실행한 쿼리를 월별로 보관합니다. 결과는 저장하지 않습니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a> → 고급 → SQL 콘솔 기록 열기로도 접근합니다. 기록 처리에 영향을 주지 않도록 임의의 하위 노트는 만들지 않는 편이 좋습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__search">검색 기록</a> — 전체 <a class="reference-link"
href="#root/_help_eIg8jdvaoNNd">검색</a>의 조건을 월별로 보관합니다. 결과 자체는 저장하지 않습니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a> → 고급 → 검색 기록 열기로 접근합니다. 임의의 하위 노트는 권장하지 않습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__bulkAction">일괄 작업</a> — 마지막 <a class="reference-link" href="#root/_help_ivYnonVFBxbQ">일괄 작업</a> 설정을 각 <code>action</code> 라벨에 보관합니다. 하위 노트를 만들어도 특별한 기능은 없습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__backendLog">백엔드 로그</a> — 서버의 <a class="reference-link"
href="#root/_help_qzNzp9LYQyPT">오류 로그</a>를 표시합니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a> → 고급 → 백엔드 로그 표시로도 엽니다.</li><li><a class="reference-link" href="#root/_hidden/_help__userHidden">사용자 숨김 영역</a> — <a href="#root/_help_CdNpE2pqjmI6">스크립트</a>가 화면에 직접 표시하지 않을 노트를 보관하는 공간입니다. ID는 <code>_userHidden</code>입니다.</li><li><a class="reference-link" href="#root/_hidden/_help__lbTplRoot">실행 도구 템플릿</a> — <a
class="reference-link" href="#root/_help_xYmIYSP6wE3F">실행 도구 모음</a>의 새 항목을 만드는 템플릿입니다. 하위 노트를 만들 수 없습니다. 일부 내용을 바꿀 수는 있지만 보통 필요하지 않습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__share">공유 노트</a> — 위치와 관계없이 <a href="#root/_help_R9pX4DGra2Vt">공개 공유</a> 중인 노트를 모아 보여 줍니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a>의 공유 노트 하위 트리 표시로도 엽니다. 하위 노트는 만들 수 없습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__lbRoot">실행 도구 모음</a> — 사용 가능하거나 화면에 표시 중인 <a class="reference-link"
href="#root/_help_xYmIYSP6wE3F">실행 도구</a>를 담습니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a>에서 실행 도구 모음 설정을 선택하거나 <a class="reference-link" href="#root/_help_xYmIYSP6wE3F">실행 도구 모음</a>의 빈 곳을 마우스 오른쪽 버튼으로 눌러 설정합니다. 하위 노트는 만들 수 없습니다.</li><li><a class="reference-link" href="#root/_hidden/_help__options">설정</a> — <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">설정 항목</a>을 저장합니다. <a class="reference-link" href="#root/_help_x3i7MxGccDuM">전체 메뉴</a>의 설정 또는 <a class="reference-link"
href="#root/_help_xYmIYSP6wE3F">실행 도구 모음</a>의 설정 아이콘으로 엽니다.</li><li><a class="reference-link" href="#root/_hidden/_help__lbMobileRoot">모바일 실행 도구 모음</a> — 모바일 화면에서 사용하는 별도 도구 모음입니다. 모바일 화면에서 같은 방법으로 설정합니다.</li><li><a class="reference-link" href="#root/_hidden/_help__help">사용자 안내서</a> — 도움말 노트의 구조와 메타데이터를 담습니다. 본문은 앱 디렉터리의 파일에서 읽습니다.</li></ul>
Binary file not shown.

After

Width:  |  Height:  |  Size: 8.6 KiB

@@ -0,0 +1,26 @@
<p>측정 지표 API는 Prometheus 같은 외부 모니터링 시스템에 Trilium 상태를 제공합니다.</p><h2>접속</h2><p><code>GET /etapi/metrics</code>로 요청합니다. ETAPI 토큰이 필요하며 기본 응답은 Prometheus 텍스트 형식입니다.</p><pre><code class="language-text-x-trilium-auto"># ETAPI 토큰 발급 예시
curl -X POST http://localhost:8080/etapi/auth/login \
-H "Content-Type: application/json" \
-d '{"password": "your_password"}'
</code></pre><h2>사용 예시</h2><pre><code class="language-text-x-trilium-auto">curl -H "Authorization: YOUR_ETAPI_TOKEN" \
http://localhost:8080/etapi/metrics
</code></pre><p>다음과 같은 형식으로 응답합니다. 지표 이름과 형식은 연동을 위해 유지합니다.</p><pre><code class="language-text-x-trilium-auto"># HELP trilium_info Trilium 인스턴스 정보
# TYPE trilium_info gauge
trilium_info{version="0.91.6",db_version="231",node_version="v18.17.0"} 1 1701432000
# HELP trilium_notes_total 삭제된 노트를 포함한 전체 노트 수
# TYPE trilium_notes_total gauge
trilium_notes_total 1234 1701432000
</code></pre><p>JSON으로 받으려면 다음처럼 요청합니다.</p><pre><code class="language-text-x-trilium-auto">curl -H "Authorization: YOUR_ETAPI_TOKEN" \
"http://localhost:8080/etapi/metrics?format=json"
</code></pre><h2>제공 지표</h2><ul><li><code>trilium_info</code> — 버전과 빌드 정보</li><li><code>trilium_notes_total</code> — 삭제된 노트를 포함한 전체 노트 수</li><li><code>trilium_notes_deleted</code> — 삭제된 노트 수</li><li><code>trilium_notes_active</code> — 활성 노트 수</li><li><code>trilium_notes_protected</code> — 보호 노트 수</li><li><code>trilium_attachments_total</code> — 전체 첨부 파일 수</li><li><code>trilium_attachments_active</code> — 활성 첨부 파일 수</li><li><code>trilium_revisions_total</code> — 수정 이력 수</li><li><code>trilium_branches_total</code> — 활성 가지 수</li><li><code>trilium_attributes_total</code> — 활성 속성 수</li><li><code>trilium_blobs_total</code> — 본문 데이터 레코드 수</li><li><code>trilium_etapi_tokens_total</code> — 활성 ETAPI 토큰 수</li><li><code>trilium_embeddings_total</code> — 노트 임베딩 수</li><li><code>trilium_notes_by_type</code> — 유형별 노트 수. type 라벨로 구분합니다.</li><li><code>trilium_attachments_by_type</code> — MIME 유형별 첨부 파일 수. mime_type 라벨로 구분합니다.</li><li><code>trilium_database_size_bytes</code> — 데이터베이스 크기. 바이트 단위입니다.</li><li><code>trilium_oldest_note_timestamp</code> — 가장 오래된 노트의 시각</li><li><code>trilium_newest_note_timestamp</code> — 가장 최근 노트의 시각</li><li><code>trilium_last_modified_timestamp</code> — 마지막 수정 시각</li></ul><h2>Prometheus 설정</h2><p><code>prometheus.yml</code>에 추가할 예시입니다.</p><pre><code class="language-text-x-trilium-auto">scrape_configs:
- job_name: 'trilium'
static_configs:
- targets: ['localhost:8080']
metrics_path: '/etapi/metrics'
bearer_token: 'YOUR_ETAPI_TOKEN'
scrape_interval: 30s
</code></pre><h2>오류 응답</h2><p>400은 지원하지 않는 format 값입니다. 401은 토큰이 없거나 유효하지 않다는 뜻이며 500은 서버 내부 오류입니다.</p><h2>Grafana 대시보드</h2><p><img style="aspect-ratio:2594/1568;" src="1_Metrics_image.png" width="2594"
height="1568" alt="Trilium 모니터링 대시보드"></p><p><a class="reference-link" href="#root/_help_bOP3TB56fL1V">Grafana 대시보드 JSON</a>을 가져오기 화면에 입력하세요.</p><p><img style="aspect-ratio:1881/282;" src="2_Metrics_image.png" width="1881"
height="282" alt="대시보드 가져오기 메뉴"></p><p>JSON을 붙여넣고 불러오기를 누릅니다.</p><p><img style="aspect-ratio:1055/830;" src="Metrics_image.png" width="1055"
height="830" alt="대시보드 JSON 입력"></p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

@@ -0,0 +1,2 @@
<p>Trilium은 파일 이름 대신 노트 ID로 각 노트를 구분합니다. 일반적으로 새 노트를 만들 때 영문 대소문자와 숫자로 이루어진 12자리 ID를 무작위로 생성합니다.</p><h2>가져오기와 내보내기의 영향</h2><p>노트를 내보내면 ID도 메타데이터에 기록됩니다. 하지만 다시 가져올 때는 모든 노트에 새 ID를 부여합니다. <a class="reference-link" href="#root/_help_0vhv7lsOLy82">첨부 파일</a>처럼 함께 가져오는 다른 항목도 새 ID를 받습니다.</p><h2>ID 충돌</h2><p>ID는 길이가 정해져 있고 무작위로 만들어지므로 <a
href="https://en.wikipedia.org/wiki/Pigeonhole_principle">비둘기집 원리</a>에 따라 기존 노트와 같은 ID가 생성될 가능성이 있습니다.</p><p>사용할 수 있는 문자가 62개이고 길이가 12자리이므로 가능한 ID 수는 <span class="math-tex">\(62^{12}\)</span>개입니다. 원문은 <a href="https://alex7kom.github.io/nano-nanoid-cc/?alphabet=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz&amp;size=12&amp;speed=1000&amp;speedUnit=hour">Nano ID 충돌 계산기</a>를 이용해 매시간 1000개의 노트를 약 900년 동안 만들어야 충돌 확률이 1% 정도가 된다고 설명합니다.</p><p>이처럼 가능성이 매우 작아 Trilium은 별도의 충돌 방지 절차를 두지 않습니다. 고유 해시를 사용하는 <a href="https://stackoverflow.com/questions/10434326/hash-collision-in-git">Git</a>에도 비슷한 문제가 있습니다. 이론적으로 충돌이 발생하면 기존 노트를 새 노트가 덮어쓸 가능성이 있습니다.</p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

@@ -0,0 +1 @@
<p>노트 지도는 노트 사이의 연결을 시각적으로 보여 줍니다. 노트들이 어떤 구조로 묶여 있는지 파악할 수 있습니다.</p><p>다음 두 가지 보기가 있습니다.</p><ul><li>링크 지도 — 노트 사이의 관계를 표시합니다.</li><li>트리 지도 — 노트의 계층 구조를 표시합니다.</li></ul><h2>링크 지도</h2><p>노트 사이의 <a href="#root/_help_zEY4DaJG4YT5">관계</a>를 보여 줍니다.</p><p><img src="1_Note Map (Link map, Tree m.png" alt="링크 지도"></p><h2>트리 지도</h2><p>노트의 상위·하위 구조를 보여 줍니다.</p><p><img src="Note Map (Link map, Tree m.png" alt="트리 지도"></p><h2>독립된 노트 유형</h2><p>모든 노트에서 열 수 있는 지도 기능 외에 관계를 전체 화면에 표시하는 전용 노트를 만들 수도 있습니다. <a href="#root/_help_bdUJEHsAPYQR">노트 지도 유형</a>을 참고하세요.</p><h2>관련 기능</h2><p><a href="#root/_help_iRwzGnHPzonm">관계 지도</a>는 비슷한 기능이지만 다음과 같은 차이가 있습니다.</p><ul><li>노트 지도는 자동으로 만들어집니다. 관계 지도는 직접 구성합니다.</li><li>관계 지도는 하나의 노트 유형입니다. 링크 지도는 연결을 화면에 보여 주는 보기 기능입니다.</li></ul>
@@ -0,0 +1,16 @@
<h2>노트의 내부 형식</h2><p>본문을 저장하는 방식은 <a class="reference-link" href="#root/_help_KSZ04uQ2D1St">노트 유형</a>마다 다릅니다.</p><ul><li><a class="reference-link" href="#root/_help_iPIMuisry3hd">텍스트 노트</a>는 <a class="reference-link"
href="#root/_help_MI26XDLSAlCD">CKEditor</a>가 사용하는 HTML로 저장합니다. 안내 상자처럼 Trilium 전용 요소도 있습니다.</li><li><a class="reference-link" href="#root/_help_6f9hih2hXXZk">코드 노트</a>는 입력한 텍스트를 그대로 저장합니다.</li><li><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">지리 지도</a>는 위치와 확대 비율 등의 JSON을 저장합니다.</li><li><a class="reference-link" href="#root/_help_grjYqerjn243">캔버스</a>는 <a
class="reference-link" href="#root/_help_H0mM1lTxF9JI">Excalidraw</a>의 JSON과 Trilium용 정보를 함께 저장합니다.</li><li><a class="reference-link" href="#root/_help_gBbsAeiuUxI5">마인드맵</a>은 <a class="reference-link"
href="#root/_help_N4IDkixaDG9C">MindElixir</a>의 JSON 형식을 사용합니다.</li></ul><p>일부 정보는 <a class="reference-link"
href="#root/_help_0vhv7lsOLy82">첨부 파일</a>에 저장합니다. <a class="reference-link"
href="#root/_help_grjYqerjn243">캔버스</a>는 사용자 라이브러리를 첨부하며 <a class="reference-link"
href="#root/_help_gBbsAeiuUxI5">마인드맵</a> 등은 다른 노트에 포함하거나 공유할 때 사용할 SVG 미리보기도 첨부합니다.</p><p>다음은 이 문서의 HTML 형식을 설명하는 예제입니다.</p><pre><code class="language-text-x-trilium-auto">&lt;h2&gt;
노트의 내부 형식
&lt;/h2&gt;
&lt;p&gt;
본문을 저장하는 방식은 다음 유형에 따라 다릅니다.&amp;nbsp;
&lt;a class="reference-link" href="#root/_help_KSZ04uQ2D1St"&gt;
노트 유형
&lt;/a&gt;
.
&lt;/p&gt;</code></pre><h2>소스 보기</h2><p><a class="reference-link" href="#root/_help_8YBEPzcpUgxw">노트 메뉴</a>에서 노트 소스를 선택하면 새 탭에서 열립니다. 텍스트 노트처럼 일부 유형은 읽기 편하도록 들여쓰기를 적용합니다.</p><p><img src="Note source_image.png" alt="노트 소스 화면"></p><h2>소스 수정</h2><p>소스 보기 화면에서 직접 편집할 수는 없습니다. 수정하려면 노트 유형을 일반 텍스트나 JSON 또는 HTML 코드로 바꾸고 경고를 확인한 뒤 본문을 고치세요. 작업 후에는 원래 유형으로 되돌립니다.</p><p>형식을 잘못 수정하면 노트가 표시되지 않을 수 있습니다. 먼저 이전 버전을 저장하세요. 문제가 생기면 소스를 다시 수정하거나 이전 버전으로 복원합니다. 화면이 정상으로 돌아오지 않으면 새로고침이 필요할 수 있습니다.</p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

@@ -0,0 +1,12 @@
<p>선택한 노트를 누구나 읽을 수 있는 웹문서로 공개합니다. 공유 화면은 읽기 전용입니다.</p><p><img style="aspect-ratio:1144/660;" src="Sharing_image.png" width="1144"
height="660" alt="공유 페이지"></p><h2>기능과 제한</h2><p>제목 검색과 모바일 화면을 지원합니다. 브라우저 설정에 따라 밝은 모드와 어두운 모드를 적용하며 직접 전환한 설정도 기억합니다. 트리를 접거나 펼치고 로고를 바꿀 수 있습니다. 이전·다음 노트 이동과 마지막 수정 날짜도 표시합니다.</p><ul><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_iPIMuisry3hd">텍스트</a> — 목차와 수식을 표시합니다. 언어를 지정한 코드 블록은 구문 강조를 지원하지만 자동 감지는 지원하지 않습니다. 노트 포함과 본문 안의 Mermaid 도표는 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_6f9hih2hXXZk">코드</a> — 고정폭 글꼴로 본문을 보여 주지만 구문 강조는 없습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_m523cpzocqaD">저장된 검색</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_iRwzGnHPzonm">관계도</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_bdUJEHsAPYQR">노트 지도</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_HcABDtFCkbFN">렌더링 노트</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_GTwFsgaA0lCt">책</a> — 하위 노트를 정해진 형식으로 표시합니다. 달력 등 고급 보기는 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_s1aBHPd79XYj">Mermaid 도표</a> — 벡터 이미지로 표시합니다. 추가 조작은 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_grjYqerjn243">캔버스</a> — 벡터 이미지로 표시합니다. 추가 조작은 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_1vHRoWCEjj0L">웹 보기</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_gBbsAeiuUxI5">마인드맵</a> — 벡터 이미지로 표시합니다. 추가 조작은 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_81SGnPGMk7Xc">지리 지도</a> — 지원하지 않습니다.</li><li><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_W8vYD3Q1zjCR">파일</a> — 내려받기를 지원합니다.</li></ul><p>공유 트리는 정적인 구조이며 보호된 노트는 공유할 수 없습니다.</p><h2>공유하기</h2><p><a class="reference-link"
href="#root/_help_WOcw2SLH6tbX">서버 설치</a>가 필요합니다. 노트 화면에서 공유 스위치를 켜면 접근할 URL이 나타납니다.</p><p><img src="Sharing_share-single-note.png" alt="노트 공유 스위치"></p><p>표시된 링크를 브라우저에서 엽니다. 서버 주소 설정에 따라 <code>localhost</code> 주소가 보일 수도 있습니다. 외부 접속에는 외부에서 접근 가능한 서버 주소가 필요합니다.</p><h3>하위 트리</h3><p>노트를 공유하면 그 아래의 하위 노트도 함께 공유됩니다. 공유 노트 하위 트리 표시에서 전체 공개 목록을 확인할 수 있습니다.</p><h3>접근 범위</h3><p>별도 인증을 설정하지 않은 공유 문서는 URL을 아는 누구나 열 수 있습니다. 무작위 주소는 접근 제어를 대신하지 않습니다. 공개할 자료인지 확인하세요.</p><h3>암호 설정</h3><p><code>#shareCredentials="username:password"</code> 형식으로 사용자 이름과 암호를 지정합니다. 하위 노트와 이미지에도 적용하려면 <a href="#root/_help_bwZpz2ajCEwO">상속 가능</a>으로 설정합니다.</p><h2>공유 화면 꾸미기</h2><p>CSS <a class="reference-link"
href="#root/_help_6f9hih2hXXZk">코드 노트</a>를 만들고 <code>~shareCss</code> 관계로 연결합니다. 하위 트리 전체에 적용하려면 관계를 상속 가능으로 설정합니다. CSS 노트에 <code>#shareHiddenFromTree</code>를 추가하면 탐색 트리에서 숨깁니다. <code>#shareOmitDefaultCss</code>는 <a
href="#root/_help_Wy267RK4M69c">기본 스타일</a>을 제외합니다.</p><h3>JavaScript</h3><p><code>~shareJs</code> 관계로 스크립트를 넣습니다. <code>fetchNote()</code>로 노트 정보를 읽을 수 있습니다. 다음 예제는 상위 노트의 속성을 출력합니다.</p><pre><code class="language-application-javascript-env-backend">const currentNote = await fetchNote();
const parentNote = await fetchNote(currentNote.parentNoteIds[0]);
for (const attr of parentNote.attributes) {
console.log(attr.type, attr.name, attr.value);
}</code></pre><h3>읽기 쉬운 주소</h3><p>보통 주소 끝에는 노트 ID가 붙습니다. <code>#shareAlias=highlighting</code>을 지정하면 <code>http://domain.tld/share/highlighting</code>처럼 사용할 수 있습니다. 별칭은 중복되지 않아야 하며 슬래시로 하위 경로를 만드는 방식은 지원하지 않습니다.</p><h3>공유 목록 관리</h3><p>공유 노트 영역에서 목록을 확인하고 이동이나 복제로 공유 상태를 관리할 수 있습니다.</p><p><img src="Sharing_shared-list.png" alt="공유 노트 목록"></p><h3>아이콘과 시작 페이지</h3><p><code>~shareFavicon</code> 관계로 <code>.ico</code> 같은 아이콘 파일 노트를 지정합니다. <code>#shareRoot</code>가 있는 노트는 <code>http://domain.tld/share</code>의 시작 페이지가 됩니다. <code>#shareIndex</code>를 함께 사용하면 공유 루트 목록을 보여 줄 수 있습니다.</p><h2>속성 안내</h2><ul><li><code>shareHiddenFromTree</code> — 탐색 트리에서만 숨깁니다. URL로는 여전히 접근할 수 있습니다.</li><li><code>shareExternalLink</code> — 공유 트리에서 외부 웹사이트 링크로 사용합니다.</li><li><code>shareAlias</code> — <code>https://your_trilium_host/share/[your_alias]</code> 주소의 별칭입니다.</li><li><code>shareOmitDefaultCss</code> — 기본 공유 CSS를 제외합니다.</li><li><code>shareRoot</code> — <code>/share</code>의 시작 노트입니다.</li><li><code>shareDescription</code> — HTML 설명 메타 태그에 넣을 문구입니다.</li><li><code>shareRaw</code> — HTML 틀 없이 원본 내용을 제공합니다. 속성 없이 사용하는 <a
class="reference-link" href="#root/_help_Qjt68inQ2bRj">노트 원문 제공</a> 방법도 있습니다.</li><li><code>shareDisallowRobotIndexing</code> — 검색 로봇에 색인 제외를 요청합니다. <code>X-Robots-Tag: noindex</code> 헤더와 <code>noindex, follow</code> 메타 태그를 설정합니다.</li><li><code>shareCredentials</code> — <code>username:password</code> 형식의 인증 정보입니다. 하위 노트와 이미지에도 적용하려면 상속 가능으로 설정합니다.</li><li><code>shareIndex</code> — 공유 중인 모든 루트 노트를 나열합니다.</li></ul><h2>제작에 도움을 준 프로젝트</h2><p>0.95.0부터 기본 적용된 공유 테마는 <a href="https://github.com/zerebos/trilium.rocks">Trilium Rocks!</a>를 바탕으로 합니다. 원작자는 <a
href="https://github.com/zerebos">zerebos</a>입니다. 모바일 화면과 밝기 전환 및 접을 수 있는 트리 등을 제공합니다.</p>
@@ -0,0 +1,2 @@
<p>공유 노트를 열면 기본적으로 웹페이지 형태로 표시됩니다. 스크립트에서 이용하거나 파일로 내려받을 때는 원본 내용을 그대로 제공하는 편이 나을 수 있습니다.</p><table><thead><tr><th>웹페이지로 표시한 노트</th><th>원본 형식으로 표시한 노트</th></tr></thead><tbody><tr><td><img style="aspect-ratio:738/275;" src="1_Serving directly the conte.png"
width="738" height="275" alt="웹페이지 형태의 공유 노트"></td><td><img src="Serving directly the conte.png" alt="원본 형식의 공유 노트"></td></tr></tbody></table><h2>노트 속성으로 지정</h2><p><code>#shareRaw</code> 속성을 추가하면 공유 주소로 접근할 때 항상 원본 형식으로 제공합니다.</p><h2>주소에 옵션 추가</h2><p>주소 끝에 <code>?raw</code>를 붙이면 <code>#shareRaw</code> 속성이 없어도 원본 형식으로 볼 수 있습니다.</p><p><img src="Serving directly the conte.png" alt="주소로 원본 형식 요청"></p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 96 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.7 KiB

@@ -0,0 +1,2 @@
<p>Trilium은 이미 개발된 여러 라이브러리를 활용해 다양한 <a
href="#root/_help_KSZ04uQ2D1St">노트 유형</a>을 지원합니다.</p><p>하위 문서에서는 사용 중인 기술을 소개합니다. Trilium의 작동 방식을 이해하는 데 도움을 주고 각 기술을 만든 개발자들의 기여를 알리기 위한 문서입니다.</p>
@@ -0,0 +1 @@
<h2>편집기 구성</h2><p>CKEditor는 <a href="#root/_help_iPIMuisry3hd">텍스트 노트</a>에서 사용하는 편집기입니다. 편집하는 화면과 결과가 같은 방식으로 표시됩니다. 공식 사이트는 <a href="https://ckeditor.com/">ckeditor.com</a>입니다.</p><p>CKEditor는 상용 제품이지만 핵심 코드는 오픈 소스로 제공됩니다. <a href="https://ckeditor.com/docs/ckeditor5/latest/features/index.html">공식 기능 안내</a>에 설명된 기능 중 일부를 Trilium에서 사용합니다. 모든 기능이 활성화된 것은 아닙니다.</p><h2>유료 기능</h2><p>일부 기능은 별도의 상용 라이선스가 필요합니다. 원문 작성 당시에는 Trilium에서 이 기능들을 사용할 수 없었으며 <a href="https://ckeditor.com/docs/ckeditor5/latest/features/slash-commands.html">슬래시 명령</a> 같은 일부 기능의 사용 가능성을 CKEditor 팀과 논의 중이라고 설명했습니다.</p><h2>플러그인</h2><p>플러그인을 작성하면 편집기에 새로운 기능을 추가할 수 있습니다. Trilium에서는 다음 플러그인을 사용하거나 필요한 부분을 수정해 사용합니다.</p><ul><li><a href="https://github.com/isaul32/ckeditor5-math">CKEditor 5 수식 플러그인</a> — 수식 입력</li><li><a href="https://github.com/ckeditor/ckeditor5-mermaid">Mermaid 플러그인</a> — 본문 안의 Mermaid 도표</li><li><a href="https://github.com/mlewand/ckeditor5-keyboard-marker">키보드 키 표시 플러그인</a> — 단축키 서식</li><li><a href="https://github.com/ThomasAitken/ckeditor5-footnotes">각주 플러그인</a> — 각주</li></ul><p>Trilium 전용 기능도 플러그인으로 구현했습니다.</p><ul><li><a class="reference-link" href="#root/_help_2x0ZAX9ePtzV">하위 노트로 잘라내기</a></li><li><a class="reference-link" href="#root/_help_nBAXQFj20hS1">노트 포함</a></li><li>노트 연결을 위한 언급 기능</li><li><a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a></li><li><a href="#root/_help_QEAPj01N5f7w">참조 링크</a></li><li><a href="#root/_help_NwBbFdNZ9h7O">안내 상자</a> — <a href="https://github.com/aarkue/ckeditor5-admonition">기존 안내 상자 플러그인</a>과 도구 모음 아이콘에서 아이디어를 얻어 별도로 구현했습니다.</li></ul>
@@ -0,0 +1 @@
<p><a href="https://excalidraw.com/">Excalidraw</a>는 <a href="#root/_help_grjYqerjn243">캔버스 노트</a>에 사용하는 기술입니다. 소스 코드는 <a href="https://github.com/excalidraw/excalidraw">GitHub</a>에서 확인할 수 있습니다.</p><p>수정하지 않은 원본 라이브러리를 사용하므로 원본에 알려진 <a href="https://github.com/excalidraw/excalidraw/issues">문제</a>가 여기에도 나타날 수 있습니다.</p>
@@ -0,0 +1 @@
<p>Leaflet은 <a href="#root/_help_81SGnPGMk7Xc">지도 노트</a>에 사용하는 라이브러리입니다.</p><h2>플러그인</h2><p>외부 플러그인을 이용해 기능을 폭넓게 확장할 수 있습니다.</p><p>현재 다음 플러그인을 사용합니다:</p><ul><li><a href="https://github.com/mpetazzoni/leaflet-gpx">leaflet-gpx — Leaflet에서 GPX 경로를 표시하는 플러그인</a></li></ul>
@@ -0,0 +1 @@
<p>MindElixir는 <a href="#root/_help_gBbsAeiuUxI5">마인드맵 노트</a>에 사용하는 라이브러리입니다.</p><p>핵심 라이브러리는 <a href="https://github.com/SSShooter/mind-elixir-core/issues">GitHub의 mind-elixir-core</a>에서 확인할 수 있습니다.</p><p>기본 배포판에서는 라이브러리를 추가 수정 없이 포함합니다.</p><p>라이브러리 자체의 기능에 문제가 있다면 일반적으로 <a href="https://github.com/ssshooter/mind-elixir-core">원본 프로젝트</a>에 보고하는 것이 좋습니다.</p><h2>플러그인</h2><p>MindElixir는 플러그인을 지원합니다. Trilium에서는 <a href="https://github.com/SSShooter/node-menu">node-menu 플러그인</a>을 이용해 항목의 글꼴과 색상 및 링크를 편집할 수 있게 합니다.</p>
@@ -0,0 +1,2 @@
<p>템플릿은 다른 노트의 기본 구조를 정하는 노트입니다. 템플릿을 적용받는 노트에는 다음 효과가 있습니다.</p><ul><li>템플릿의 모든 속성을 <a href="#root/_help_bwZpz2ajCEwO">상속</a>합니다. 상속 가능으로 표시하지 않은 속성도 대상 노트에는 적용됩니다. 대상 노트의 하위 노트에는 상속 가능한 속성만 이어집니다.</li><li>대상 노트의 본문이 비어 있으면 템플릿 본문을 복사합니다.</li><li>템플릿의 하위 노트를 그 아래 단계까지 별도의 사본으로 복사합니다.</li></ul><h2>예제</h2><p>책 템플릿에는 출간 연도와 저자 같은 <a href="#root/_help_OFXdgB2nNk1F">주요 속성</a>을 넣고 주제와 결론 등의 독후감 틀을 작성할 수 있습니다. 인상 깊은 구절과 요약용 하위 노트도 함께 만들 수 있습니다.</p><p><img src="Templates_template.png" alt="책 템플릿"></p><h2>템플릿 적용 노트</h2><p>메뉴에서 템플릿을 선택해 노트를 만들 수 있습니다.</p><p><img src="Templates_template-create-.png" alt="하위 노트 템플릿 선택"></p><p>선택 목록에 나오게 하려면 템플릿 노트에 <code>#template</code> 라벨을 지정하세요. 대상 노트를 연결하는 <code>~template</code> 관계와는 다릅니다. <a href="#root/_help_9sRHySam5fXb">작업 공간</a>에서만 표시하려면 <code>#workspaceTemplate</code>을 사용합니다.</p><p>이미 만든 노트도 <code>~template</code> 관계를 추가하거나 바꿔 템플릿을 지정할 수 있습니다. 새 하위 노트의 기본 템플릿은 <code>~child:template</code>로 지정합니다. <code>~child:child:template</code>처럼 여러 단계에 적용할 수도 있습니다.</p><p>복사 상속은 노트를 만드는 시점에 적용됩니다. 상위 노트의 설정을 나중에 바꿔도 기존 하위 노트에 복사되어 있는 단계별 설정이 자동으로 갱신되지는 않습니다.</p><h2>추가 활용</h2><p><code>#iconClass</code>와 <code>#cssClass</code>를 템플릿에 지정하면 관련 노트의 아이콘과 모양을 통일할 수 있습니다. <a href="#root/_help_wX4HbRucYSDD">사용 예제</a>의 <a href="#root/_help_iRwzGnHPzonm">관계 지도</a>와 <a
href="#root/_help_xYjQUYhpbUEW">할 일 관리</a> 및 <a href="#root/_help_l0tKav7yLHGF">날짜별 노트</a>를 참고하세요.</p><p><a href="#root/_help_47ZrP6FNuoG8">기본 노트 제목</a>의 제목 템플릿과 함께 사용할 수도 있습니다. 노트 템플릿에 <code>#titleTemplate</code>을 지정하세요.</p>
Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

@@ -0,0 +1 @@
<p>Trilium은 Evernote의 백업·내보내기 형식인 ENEX 파일을 가져올 수 있습니다. ENEX 파일 하나에는 노트북 하나의 노트와 관련 자료가 담깁니다.</p><h2>Evernote에서 ENEX 내보내기</h2><p>원문에서 안내하는 방식은 구형 Evernote 데스크톱 앱을 사용합니다. 웹이나 모바일 버전이 아닙니다. 노트북에서 마우스 오른쪽 버튼을 누르고 내보내기를 선택한 뒤 안내를 따르세요.</p><h2>Trilium으로 ENEX 가져오기</h2><p>가져올 위치의 노트에서 마우스 오른쪽 버튼을 누르세요. 가져오기를 선택한 뒤 ENEX 파일을 지정합니다.</p><p>완료되면 노트와 자료를 살펴 누락된 내용이 없는지 확인하세요.</p><h2>제한 사항</h2><p>이미지를 제외한 자료는 노트의 첨부 파일로 만들어집니다.</p><p>ENEX 내부의 HTML은 표준과 완전히 일치하지 않아 일부 서식이 달라지거나 사라질 수 있습니다. 큰 문제가 있으면 <a href="https://github.com/TriliumNext/Notes/issues">Trilium 문제 보고 페이지</a>에 알려 주세요.</p>
@@ -0,0 +1 @@
<p>Trilium은 호환성을 최대한 유지하면서 Markdown 가져오기와 내보내기를 지원합니다.</p><h2>가져오기</h2><h3>클립보드에서 가져오기</h3><p>일부 Markdown 내용을 복사했다면 편집기의 블록 메뉴에서 가져올 수 있습니다.</p><p><img src="Markdown_markdown-inline-i.gif" alt="클립보드의 Markdown 가져오기"></p><h3>파일에서 가져오기</h3><p>확장자가 <code>.md</code>인 파일 하나를 가져오거나 여러 파일의 폴더 구조를 <a href="https://en.wikipedia.org/wiki/Tar_(computing)">압축 파일</a>로 묶어 가져올 수 있습니다. 이 기능에서는 ZIP 형식을 사용하세요. 브라우저가 폴더를 직접 읽지 못하므로 <a href="https://www.7-zip.org">7-Zip</a> 같은 도구로 폴더를 ZIP으로 압축해야 합니다.</p><p><img src="Markdown_markdown-file-imp.gif" alt="Markdown 파일 가져오기"></p><h2>내보내기</h2><h3>하위 트리 내보내기</h3><p>하위 트리 전체를 ZIP으로 내보내면 노트 구조에 맞춰 폴더가 만들어집니다.</p><p><img src="Markdown_markdown-export-s.gif" alt="하위 트리의 Markdown 내보내기"></p><h3>노트 하나만 내보내기</h3><p>하위 노트를 제외하고 현재 노트만 내보내려면 노트 작업 메뉴를 사용하세요.</p><p><img src="Markdown_markdown-export-n.gif" alt="현재 노트의 Markdown 내보내기"></p><h3>보호된 노트 내보내기</h3><p>먼저 보호 세션을 시작해야 합니다. 내보낸 파일은 암호화되지 않습니다. 다시 가져온 노트도 필요하면 보호 설정을 다시 적용하세요.</p><h2>지원 문법</h2><ul><li><a href="https://github.github.com/gfm/">GitHub 확장 Markdown</a>을 주된 기준으로 사용합니다.</li><li>이미지를 지원합니다. 사용자 지정 너비가 있으면 HTML로 내보내며 그림 요소도 HTML로 포함합니다.</li><li>표를 지원합니다. 구조가 복잡하거나 HTML이 필요한 요소를 포함한 표는 HTML로 내보냅니다.</li><li><a class="reference-link" href="#root/_help_NwBbFdNZ9h7O">안내 상자</a>는 GitHub 형식을 사용합니다.</li><li>링크를 지원합니다. 노트의 제목과 아이콘을 반영하는 참조 링크는 정보를 보존하기 위해 HTML로 포함합니다.</li><li>수식은 <code>$</code>와 <code>$$</code> 구분 기호를 지원합니다.</li></ul>
@@ -0,0 +1 @@
<aside class="admonition warning"><p>더 이상 제공되거나 정상 작동하지 않는 Evernote Legacy를 경유하는 과거의 이전 방법입니다. 현재 사용할 수 있는 절차로 안내하는 문서가 아닙니다.</p></aside><h2>OneNote 자료 준비</h2><ul><li>OneNote 태그는 이미지로 가져와질 수 있으므로 필요하면 이모지로 바꿉니다.</li><li>제목 서식을 사용하고 불필요한 공백을 정리합니다.</li><li>매우 긴 페이지는 짧은 노트와 하위 노트로 나누는 편이 편리합니다.</li><li>번호 목록 사이의 불필요한 빈 줄을 없앱니다. 가져온 뒤 번호가 다시 1부터 시작하는 문제를 줄일 수 있습니다.</li></ul><h2>과거의 이전 절차</h2><p><a href="https://web.archive.org/web/20230327110646/https://help.evernote.com/hc/en-us/articles/360052560314">Evernote Legacy 보관 문서</a>를 참고한 방법입니다. 당시에는 계정이 필요했지만 인터넷 연결 없이 가져올 수 있었으며 Evernote 서버에 노트를 동기화하지 않는 방식으로 설명되었습니다. 파일 → 가져오기 → OneNote에서 전자 필기장과 구역을 선택했습니다.</p><p>여러 구역을 한 번에 가져오면 폴더가 합쳐질 수 있습니다. 순서는 유지되므로 이후 다시 나눌 수 있습니다. 가져온 전자 필기장을 오른쪽 클릭해 노트 내보내기를 선택하고 ENEX로 저장합니다.</p><h3>ENEX 정리</h3><p>OneNote 페이지 머리말을 제거하려면 텍스트 편집기에서 정규식 <code>.&lt;div.*&gt;&lt;h1</code>을 찾아 <code>&lt;h1</code>로 바꾸는 방법이 원문에 소개되어 있습니다. 원본을 보관하고 바뀌는 범위를 확인하세요.</p><h3>Trilium으로 가져오기</h3><p>상위 노트를 오른쪽 클릭해 가져오기를 선택하고 ENEX 파일을 지정합니다. 큰 파일은 몇 분이 걸릴 수 있습니다. 파일마다 반복하세요.</p><h2>가져온 뒤 확인할 내용</h2><ul><li>가운데 정렬이 왼쪽 정렬로 바뀔 수 있습니다.</li><li>OneNote 내부 링크는 자동으로 Trilium 노트에 연결되지 않습니다. onenote://를 찾아 대상 노트로 다시 연결해야 합니다. 원문의 문단 연결 관련 제한은 당시 버전 기준입니다.</li><li>글자색과 강조 및 일반 서식은 대체로 유지됩니다.</li><li>기존 수정 이력은 가져오지 못합니다. 이후 수정은 Trilium에서 기록합니다.</li><li>노트 순서는 유지되지만 하위 구조는 다시 정리해야 할 수 있습니다.</li><li>OneNote 구역은 Evernote 태그가 되어 Trilium 속성으로 들어옵니다. 필요하지 않으면 Evernote 내보내기에서 제외합니다.</li><li>Created with OneNote라는 문구가 필요 없으면 가져오기 전에 ENEX에서 찾아 지울 수 있습니다.</li><li>일부 링크는 클릭할 수 없는 상태로 들어올 수 있습니다.</li><li>원문에서는 파일과 화면 캡처 및 첨부 파일이 보존된다고 설명합니다.</li></ul>
@@ -0,0 +1,2 @@
<p>일부 단축키는 트리나 편집기 등 특정 위치에서만 작동합니다. 기본 키는 버전에 따라 다를 수 있으므로 설정 → 단축키에서 현재 값을 확인하세요. <code>global:</code> 접두사는 앱에 초점이 없어도 동작하는 전역 단축키를 지정하며 앱을 다시 시작해야 적용됩니다.</p><h2>노트 탐색</h2><ul><li>↑와 ↓ — 목록에서 위아래 노트로 이동합니다. Ctrl+Shift+↑와 Ctrl+Shift+↓는 편집기에서도 작동합니다.</li><li>←와 → — 하위 트리를 접거나 펼칩니다.</li><li>Alt+←와 Alt+→ — 방문 기록의 이전과 다음으로 이동합니다.</li><li>Ctrl+J — <a href="#root/_help_MMiBEQljMQh2">노트로 이동</a> 창을 엽니다.</li><li>Ctrl+. — 트리의 현재 노트로 이동합니다.</li><li>Backspace — 상위 노트로 이동합니다.</li><li>Alt+C — 트리 전체를 접습니다.</li><li>Alt+- — 하위 트리를 접습니다.</li></ul><p><code>#keyboardShortcut</code> <a href="#root/_help_zEY4DaJG4YT5">라벨</a>에 키 조합을 지정하면 해당 노트로 바로 이동할 수 있습니다. 새로고침 후 적용됩니다. <a href="#root/_help_MMiBEQljMQh2">노트 탐색 예제</a>를 참고하세요.</p><h2>탭</h2><p>노트 링크를 Ctrl을 누른 채 클릭하거나 마우스 가운데 버튼으로 누르면 새 탭에서 엽니다. 데스크톱 앱에서는 Ctrl+T로 새 탭을 열고 Ctrl+W로 닫습니다. Ctrl+Tab과 Ctrl+Shift+Tab으로 다음·이전 탭을 선택합니다.</p><h2>노트 만들기</h2><p>Ctrl+O는 현재 노트 다음에 새 노트를 만듭니다. Ctrl+P는 하위 노트를 만듭니다. F2는 현재 가지의 <a href="#root/_help_MMiBEQljMQh2">접두사</a>를 편집합니다.</p><h2>이동과 복제</h2><ul><li>Ctrl+↑와 Ctrl+↓ — 목록 순서를 바꿉니다.</li><li>Ctrl+←와 Ctrl+→ — 상위·하위 단계로 옮깁니다.</li><li>Shift+↑와 Shift+↓ — 선택 범위를 늘립니다.</li><li>Ctrl+A — 같은 단계의 노트를 모두 선택합니다.</li><li>Shift를 누른 채 클릭 — 여러 노트를 선택합니다.</li><li>Ctrl+C — <a href="#root/_help_IakOLONlIfGI">복제</a>할 노트를 복사합니다.</li><li>Ctrl+X — 옮길 노트를 잘라냅니다.</li><li>Ctrl+V — 현재 노트 아래에 붙입니다. 복사했으면 복제하고 잘라냈으면 이동합니다.</li><li>Delete — 선택한 노트와 하위 트리를 삭제합니다.</li></ul><h2>편집</h2><p><a class="reference-link" href="#root/_help_iPIMuisry3hd">텍스트 노트</a>의 <a class="reference-link" href="#root/_help_oiVPnW8QfnvS">편집 단축키</a>와 <a
class="reference-link" href="#root/_help_QrtTYPmdd1qq">Markdown식 자동 서식</a>도 참고하세요. 트리에서 Enter를 누르면 제목으로 이동하고 제목에서 Enter를 누르면 본문으로 이동합니다. Ctrl+.은 트리로 돌아갑니다.</p><h2>실행 화면</h2><ul><li>F5 또는 Ctrl+R — 프런트엔드 새로고침</li><li>Ctrl+Shift+I — 개발자 도구</li><li>Ctrl+F — 찾기</li><li>Ctrl+-와 Ctrl+= — 축소와 확대</li><li>Alt+O — SQL 콘솔</li><li>Alt+M — 원문에 기록된 방해 요소 숨김 단축키. 최신 집중 모드 키는 설정에서 확인하세요.</li><li>F11 — 전체 화면</li><li>Ctrl+S — 트리의 <a href="#root/_help_eIg8jdvaoNNd">검색</a> 창 전환</li><li>Alt+A — 노트 <a href="#root/_help_zEY4DaJG4YT5">속성</a> 창</li></ul>

Some files were not shown because too many files have changed in this diff Show More