197 lines
13 KiB
Plaintext
197 lines
13 KiB
Plaintext
스크립트가 렌더링한 전체 내용을 담는 영역
|
|
예:
|
|
ctrl+shift+a
|
|
같은 바인딩을 여러 번 호출할 수 있다면 처리 함수의 네임스페이스를 지정하세요. 같은 ID의 처리 함수가 있으면 새 함수로 교체합니다.
|
|
지정한 노트를 가리키는 jQuery 링크 객체를 만듭니다.
|
|
(또는 noteId)
|
|
사용 중단 예정
|
|
대신 api.createLink()를 사용하세요.
|
|
현재 실행 중인 소스 코드가 작성된 노트입니다.
|
|
날짜 처리를 위한 day.js 라이브러리입니다. 참고:
|
|
https://day.js.org
|
|
라이브러리 사용 안내
|
|
참고
|
|
이 함수는 현지 시각을 반환합니다.
|
|
반환값
|
|
YYYY-MM-DD 형식의 날짜
|
|
바이트 단위
|
|
api.formatSize()를 사용하세요.
|
|
지정한 날짜의 일별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
월별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
지정한 날짜의 분기별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
오늘의 일별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
지정한 날짜가 속한 주의 첫날에 해당하는 일별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
지정한 날짜의 주별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
연도별 노트를 반환합니다. 없으면 자동으로 만듭니다.
|
|
메서드
|
|
이 실행을 시작하게 한 이벤트의 엔터티
|
|
노트를 보호하려면 true를 사용하고 보호를 해제하려면 false를 사용합니다.
|
|
하위 트리를 보호하려면 true를 사용하고 보호를 해제하려면 false를 사용합니다.
|
|
지정한 길이의 임의 문자열을 반환합니다. 암호학적으로 안전한 난수를 만드는 함수가 아닙니다.
|
|
도움말을 표시할 jQuery 객체
|
|
사용자에게 확인 대화상자를 표시합니다.
|
|
사용자에게 오류 알림을 잠깐 표시합니다.
|
|
사용자에게 정보 대화상자를 표시합니다.
|
|
사용자에게 정보 알림을 잠깐 표시합니다.
|
|
사용자에게 입력 대화상자를 표시합니다.
|
|
현재 스크립트 실행이 시작된 노트입니다. 이벤트의 진입점에 해당합니다.
|
|
명령을 실행합니다. 매우 낮은 수준의 API이므로 가능하면 다른 방법을 사용하세요.
|
|
이벤트를 발생시킵니다. 매우 낮은 수준의 API이므로 가능하면 다른 방법을 사용하세요.
|
|
Trilium은 백엔드와 프런트엔드로 나뉘어 실행됩니다. 스크립트가 백엔드에서 변경한 내용은 프런트엔드에 비동기로 동기화됩니다.
|
|
이 메서드는 다음 과정이 모두 끝나면 완료되는 Promise를 반환합니다. 백엔드에서
|
|
프런트엔드로의 동기화입니다. 새 노트를 만들었다면 프런트엔드에 동기화될 때까지 기다린 뒤 활성화하는 데 사용할 수 있습니다.
|
|
새로 만든 노트를 활성화합니다. this.activateNote()와 달리 프런트엔드 동기화 완료까지 확인합니다.
|
|
트리와 노트 상세 화면에서 노트를 활성화합니다.
|
|
실행 도구 모음에 새 실행 도구를 추가합니다. 같은 ID가 있으면 변경합니다.
|
|
이제 왼쪽 위 메뉴에서 실행 도구를 만들거나 변경할 수 있습니다. 메뉴 경로:
|
|
실행 도구 모음 설정. 특수한 용도에는 백엔드 API의 createOrUpdateLauncher()도 사용할 수 있습니다.
|
|
편집기의 커서 위치에 지정한 글을 추가합니다.
|
|
일반 텍스트만 사용할 수 있습니다. HTML은 지원하지 않습니다.
|
|
https://codemirror.net/doc/manual.html#api
|
|
https://ckeditor.com/docs/ckeditor5/latest/api/module_core_editor_editor-Editor.html
|
|
반환된 인스턴스의 사용 안내
|
|
노트 상세 화면을 담당하는 위젯에 접근합니다. 사용할 수 있는 메서드의 예:
|
|
및
|
|
실제 위젯 유형의 구현체에 접근하는 데 사용합니다.
|
|
지정한 DOM 요소를 소유하는 구성 요소를 반환합니다. DOM 트리에서 가장 가까운 상위 구성 요소입니다.
|
|
DOM 요소
|
|
인스턴스 이름은 개별 Trilium 실행 환경을 구분합니다. 특정 인스턴스에서만 작업을 실행해야 하는 스크립트에 유용합니다.
|
|
noteId로 노트를 반환합니다. 캐시에 없으면 불러옵니다.
|
|
노트 목록을 반환합니다. 캐시에 없는 노트는 불러옵니다.
|
|
createLink() 등으로 노트를 하나씩 가져오는 대신 여러 노트를 한꺼번에 캐시에 채울 때 자주 사용합니다.
|
|
노트를 찾지 못해도 오류를 보고하지 않음
|
|
지정한 메시지를 화면의 로그 창에 기록합니다.
|
|
새 분할 화면에서 노트를 엽니다.
|
|
새 분할 화면을 활성화하려면 true를 사용하고 현재 화면에 머무르려면 false를 사용합니다.
|
|
새 탭에서 노트를 엽니다.
|
|
새 탭을 활성화하려면 true를 사용하고 현재 탭에 머무르려면 false를 사용합니다.
|
|
매개변수로 지정한 노트를 포함하는 현재 열린 노트를 모두 새로 고칩니다.
|
|
포함된 노트의 noteId
|
|
백엔드의 내용을 바탕으로 프런트엔드 노트 트리 캐시를 갱신합니다.
|
|
지정한 익명 함수를 백엔드에서 실행합니다. 내부적으로 함수를 문자열로 직렬화한 뒤 AJAX로 전송합니다. 비동기 함수가 필요한 고급 용도에 사용합니다. 요청 단위의 자동 트랜잭션 관리는 적용되지 않으므로 api.transactional()로 트랜잭션을 직접 지정해야 합니다.
|
|
동기 함수라면 api.runOnBackend()를 사용하세요.
|
|
백엔드에서 실행할 동기 함수
|
|
백엔드로 보낼 익명 함수의 매개변수 목록
|
|
지정한 익명 함수를 백엔드에서 실행합니다. 내부적으로 함수를 문자열로 직렬화한 뒤 AJAX로 전송합니다. 트랜잭션 관리가 올바르게 작동하려면 동기 함수를 전달해야 합니다. 트랜잭션을 직접 관리할 수 있다면 api.runAsyncOnBackendWithManualTransactionHandling()을 사용할 수 있습니다.
|
|
속성과 속성값 등을 기준으로 검색할 수 있습니다. 예:
|
|
#dateModified =* MONTH AND #log
|
|
전체 검색 옵션 안내:
|
|
https://triliumnext.github.io/Docs/Wiki/search.html
|
|
현재 탭에서 이 노트의 하위 트리만 표시합니다. 참고:
|
|
https://triliumnext.github.io/Docs/Wiki/note-hoisting.html
|
|
집중해서 표시할 노트입니다. root를 지정하면 전체 트리 표시로 돌아갑니다.
|
|
노트는 Trilium의 핵심 데이터 단위입니다.
|
|
콘텐츠 유형. 예:
|
|
application/json
|
|
이 FNote를 프런트엔드 또는 백엔드 스크립트로 실행합니다.
|
|
발생 가능한 예외
|
|
실행할 수 없는 노트 유형이나 MIME 유형이면 Error가 발생합니다.
|
|
이 노트에 도달하는 모든 노트 경로를 반환합니다. 검색 노트가 포함된 경로는 순환이 생길 수 있어 제외합니다.
|
|
속성 유형. 예: label 또는 relation
|
|
속성 이름
|
|
필터링할 속성 유형
|
|
필터링할 속성 이름
|
|
가능한 노트 경로 중에서 다음 조건에 맞는 경로를 반환합니다:
|
|
가장 적절한 경로
|
|
대신 getParentBranches()를 사용하세요.
|
|
대신 getParentBranchIds()를 사용하세요.
|
|
라벨 이름
|
|
필터링할 라벨 이름
|
|
노트의 날짜 메타데이터를 제공합니다.
|
|
대신 getBlob()을 사용하세요.
|
|
관계 이름
|
|
필터링할 관계 이름
|
|
이 노트를 대상으로 하는 관계를 조회합니다.
|
|
아무 작업도 하지 않음
|
|
이 객체에는 다음 특성을 가진 고급 기능 객체가 들어 있습니다.
|
|
사용자가 영향을 판단해야 함
|
|
하위 호환성 보장 없음
|
|
고급 사용 사례를 위한 객체입니다.
|
|
백엔드의 메모리 내 객체 그래프에 접근합니다. 참고:
|
|
Becca
|
|
HTTP 요청을 위한 Axios 라이브러리입니다. 참고:
|
|
https://axios-http.com
|
|
대신 브라우저와 호환되는 기본 fetch()를 사용하세요.
|
|
HTML 분석과 처리를 위한 cheerio 라이브러리입니다. 참고:
|
|
https://cheerio.js.org
|
|
현재 스크립트가 실행 중인 노트입니다. 코드가 여러 노트로 나뉘어 있으면 처음 실행을 시작한 노트는 다음과 같습니다:
|
|
startNote
|
|
함수 호출을 통해 다른 노트인 currentNote로 실행 위치가 바뀔 수 있습니다. C 언어에서는 다음 개념과 비슷합니다:
|
|
FILE
|
|
현재 화면에서 활성화된 노트와 혼동하지 마세요.
|
|
날짜 처리를 위한 day.js 라이브러리입니다. 참고:
|
|
이 실행을 시작하게 한 이벤트의 엔터티
|
|
sql
|
|
스크립트 실행이 시작된 노트입니다. C 언어로 비유하면 현재 프로세스의 main() 함수가 들어 있는 파일에 해당합니다.
|
|
XML 분석을 위한 xml2js 라이브러리입니다. 참고:
|
|
https://github.com/Leonidas-from-XIV/node-xml2js
|
|
예를 들어 backupName에 다음 값을 지정하면:
|
|
now
|
|
백업은 다음 이름으로 저장됩니다:
|
|
backup-now.db
|
|
파일
|
|
JSON으로 직렬화할 수 있는 객체를 데이터 노트로 만듭니다. 생성되는 노트의 유형은 code이며 MIME 유형은 JSON입니다. 더 많은 옵션은 createNewNote()를 확인하세요.
|
|
이 상위 노트 아래에 새 노트 생성
|
|
노트에 JSON을 사용할지 여부
|
|
간단한 용도에는 비슷한 API인 createTextNote()를 사용하고 복잡한 요구에는 createNewNote()를 사용하세요.
|
|
실행 도구 모음에 새 실행 도구를 만듭니다. 같은 ID가 있으면 변경합니다.
|
|
사용할 Boxicons 아이콘 이름. 예:
|
|
bx-time
|
|
영문과 숫자로만 구성된 6자리 이상의 실행 도구 ID
|
|
true이면 다음 위치에 생성합니다:
|
|
표시할 실행 도구
|
|
그 외에는 다음 위치에 생성합니다:
|
|
사용 가능한 실행 도구
|
|
누르면 대상 노트나 스크립트를 활성화할 단축키. 예:
|
|
ctrl+e
|
|
해당 유형:
|
|
script
|
|
note
|
|
다음 중 하나
|
|
실행 도구를 누르면 targetNoteId로 지정한 노트로 이동합니다.
|
|
실행 도구를 누르면 scriptNoteId로 지정한 스크립트를 실행합니다.
|
|
customWidget
|
|
widgetNoteId로 지정한 사용자 지정 위젯으로 실행 도구를 표시합니다.
|
|
텍스트 노트를 만듭니다. 더 많은 옵션은 createNewNote()를 확인하세요.
|
|
노트와 상위 노트 사이에 가지가 있으면 삭제합니다. 없으면 아무 작업도 하지 않습니다.
|
|
노트와 상위 노트 사이에 가지가 없으면 만듭니다. 이미 있으면 그대로 둡니다. 새 가지 또는 기존 가지를 반환합니다.
|
|
노트와 상위 노트 사이에 가지를 새로 만들 때 지정할 접두사
|
|
html 또는 markdown
|
|
지정한 날짜의 일별 노트를 반환합니다. 없으면 만듭니다.
|
|
YYYY-MM-DD 형식
|
|
달력 루트 노트를 지정합니다. 일반적으로 비워 두어 기본 달력을 사용합니다.
|
|
지정한 날짜의 월별 노트를 반환합니다. 없으면 만듭니다.
|
|
YYYY-MM 형식
|
|
지정한 라벨 이름을 가진 노트들을 조회합니다.
|
|
값
|
|
속성값
|
|
지정한 라벨 이름을 가진 첫 번째 노트를 조회합니다.
|
|
지정한 날짜의 분기별 노트를 반환합니다. 없으면 만듭니다.
|
|
달력의 루트 노트를 반환합니다.
|
|
오늘의 일별 노트를 반환합니다. 없으면 만듭니다.
|
|
지정한 날짜가 속한 주의 첫날에 해당하는 노트를 반환합니다.
|
|
지정한 날짜의 주별 노트를 반환합니다. 없으면 만듭니다.
|
|
지정한 연도의 연도별 노트를 반환합니다. 없으면 만듭니다.
|
|
YYYY 형식
|
|
지정한 메시지를 Trilium 로그와 화면의 로그 창에 기록합니다.
|
|
문자열 기준
|
|
지정한 익명 함수를 프런트엔드에서 실행합니다. 내부적으로 함수를 문자열로 직렬화한 뒤 WebSocket으로 전송합니다. 서로 다른 탭 등 여러 프런트엔드가 연결돼 있으면 모든 인스턴스에서 실행합니다.
|
|
프런트엔드에서 실행할 스크립트
|
|
프런트엔드로 보낼 익명 함수의 매개변수 목록
|
|
동기화 중에는 데이터가 일시적으로 일관되지 않을 수 있습니다. 강한 일관성이 필요한 스크립트는 이 함수로 진행 중인 동기화가 끝나기를 기다리고 실행 중 새 동기화가 시작되지 않게 할 수 있습니다.
|
|
비동기 처리이므로 내부 콜백에는 자동 트랜잭션 처리가 적용되지 않습니다. 데이터베이스를 변경하려면 api.transactional(...)로 호출을 감싸야 합니다.
|
|
동기화가 실행되지 않는 동안 실행할 함수
|
|
참고:
|
|
전체 옵션 안내
|
|
noteId와 접두사로 노트를 찾아 지정한 parentNoteId 아래에 배치합니다. parentNoteId를 지정하지 않으면 가지를 삭제합니다.
|
|
toggleNoteInParent()와 비슷하지만 접두사로 가지를 찾는다는 차이가 있습니다.
|
|
동작을 혼동하기 쉬운 메서드이며 특수한 용도에만 사용합니다.
|
|
지정한 노트의 하위 노트를 정렬합니다.
|
|
title 또는 dateCreated 또는 dateModified 또는 라벨 이름. 참고:
|
|
https://triliumnext.github.io/Docs/Wiki/sorting.html
|
|
자세한 안내
|
|
값에 따라 노트와 상위 노트 사이의 가지를 만들거나 삭제합니다.
|
|
가지를 유지하려면 true를 사용하고 없애려면 false를 사용합니다.
|
|
트랜잭션 안에서 실행할 코드를 감쌉니다. 이미 트랜잭션이 있으면 해당 트랜잭션을 사용합니다.
|
|
이스케이프를 해제할 대상
|