calibre:// URL 스키마

캘리버는 calibre:// URL의 처리 프로그램으로 스스로를 등록합니다. 따라서 다른 프로그램/문서에서 또는 명령줄을 통해 책 열기, 책 검색 등의 작업을 수행하는 데 사용할 수 있습니다. 예를 들어 명령줄에서 다음을 실행하면:

calibre calibre://switch-library/Some_Library

``Some Library``라는 이름의 라이브러리로 캘리버를 엽니다. 라이브러리 이름은 라이브러리 폴더의 폴더 이름에서 공백이 밑줄로 바뀐 것입니다. 특수 값 ``_``는 현재 라이브러리를 의미합니다. 다양한 유형의 URL은 아래에 문서화되어 있습니다.

HTML 파일이나 Word 문서 등에 이러한 링크를 넣을 수도 있으며, 운영 체제가 자동으로 캘리버를 실행하여 지정된 작업을 수행합니다.

특정 라이브러리로 전환

URL 구문은 다음과 같습니다:

calibre://switch-library/Library_Name

라이브러리 이름은 라이브러리의 폴더 이름에서 공백이 밑줄로 바뀐 것입니다. 특수 값 ``_``는 현재 라이브러리를 의미합니다. 라이브러리 이름에 :ref:`16진수 인코딩 <hex_encoding>`을 사용할 수도 있는데, 라이브러리 이름에 URL 인코딩이 필요한 특수 문자가 있는 경우 유용합니다. 16진수로 인코딩된 라이브러리 이름은 다음과 같습니다:

_hex_-AD23F4BC

여기서 _hex_- 접두사 뒤의 부분은 UTF-8로 인코딩된 라이브러리 이름이며 각 바이트는 두 개의 16진수 문자로 표현됩니다.

캘리버에서 특정 책 표시

URL 구문은 다음과 같습니다:

calibre://show-book/Library_Name/book_id

이렇게 하면 캘리버에서 ``book_id``(숫자)에 해당하는 책이 표시됩니다. 책의 ID는 캘리버 인터페이스에서 책 세부정보 패널의 클릭하여 열기 링크 위에 마우스를 올리면 볼 수 있으며, 책 폴더 경로 끝의 괄호 안에 있는 숫자입니다.

책 세부정보 패널을 마우스 오른쪽 버튼으로 클릭하고 :guilabel:`책 링크 복사`를 선택하여 캘리버에 표시된 현재 책의 링크를 복사할 수 있습니다.

검색이 활성 상태이고 해당 책이 검색과 일치하지 않으면 검색이 지워집니다.

가상 라이브러리가 선택되어 있으면 캘리버는 책을 표시할 때 이를 사용합니다. 해당 가상 라이브러리에서 책을 찾을 수 없으면 가상 라이브러리가 지워집니다.

책을 표시할 때 특정 가상 라이브러리로 전환하려면 다음을 사용하세요:

calibre://show-book/Library_Name/book_id?virtual_library=Library%20Name
or
calibre://show-book/Library_Name/book_id?encoded_virtual_library=hex_encoded_virtual_library_name

가상 라이브러리 이름의 공백을 ``%20``으로 바꾸세요. 해당 가상 라이브러리에서 책을 찾을 수 없으면 가상 라이브러리가 무시됩니다.

전자책 뷰어에서 특정 위치의 특정 책 열기

URL 구문은 다음과 같습니다:

calibre://view-book/Library_Name/book_id/book_format?open_at=location

여기서 book_format``은 책의 형식(예: ``EPUB 또는 MOBI)이고 ``location``은 책 내부의 선택적 위치입니다. 이러한 링크를 얻는 가장 쉬운 방법은 뷰어에서 책을 연 다음 뷰어 컨트롤에서 :guilabel:`이동->위치`를 선택하면 다른 곳에 복사/붙여넣기할 수 있는 링크가 제공됩니다.

책 검색

URL 구문은 다음과 같습니다:

calibre://search/Library_Name?q=query
calibre://search/Library_Name?eq=hex_encoded_query

여기서 쿼리는 유효한 :ref:`검색 표현식 <search_interface>`입니다. 검색 표현식이 복잡하면 :ref:`16진수 문자열로 인코딩 <hex_encoding>`하고 대신 ``eq``를 사용하세요. 쿼리를 생략하면 현재 검색이 지워집니다.

기본적으로 가상 라이브러리가 선택되어 있으면 캘리버는 검색을 수행하기 전에 이를 지워 모든 책이 검색되도록 합니다. 가상 라이브러리를 유지하려면 다음을 사용하세요:

calibre://search/Library_Name?q=query&virtual_library=_

특정 가상 라이브러리로 전환하려면 다음을 사용하세요:

calibre://search/Library_Name?virtual_library=Library%20Name
or
calibre://search/Library_Name?encoded_virtual_library=hex_encoded_virtual_library_name

가상 라이브러리 이름의 공백을 ``%20``으로 바꾸세요.

캘리버에서 검색을 수행하고 링크를 생성하려면 검색 표시줄을 마우스 오른쪽 버튼으로 클릭하고 :guilabel:`검색을 URL로 복사`를 선택하면 됩니다.

특정 라이브러리의 책에 대한 책 세부정보 창 열기

URL 구문은 다음과 같습니다:

calibre://book-details/Library_Name/book_id

현재 라이브러리나 선택한 책을 변경하지 않고 지정된 라이브러리의 지정된 책에 대한 책 세부정보 창을 엽니다.

저자/시리즈 등과 연결된 메모 열기

URL 구문은 다음과 같습니다:

calibre://show-note/Library_Name/Field_Name/id_Item_Id

이렇게 하면 지정된 항목의 메모를 보여주는 창이 열립니다. 이러한 URL을 만드는 가장 쉬운 방법은 캘리버에서 원하는 메모를 표시하고 URL 복사 버튼을 클릭하여 URL을 클립보드에 복사한 다음 필요한 곳에 붙여넣는 것입니다.

여기서 Field_Name``은 ``authors``나 ``tags 같은 열의 이름입니다. 사용자가 만든 열의 경우 필드 이름의 앞에 오는 ``#``을 밑줄로 바꾸세요. 예를 들어 ``#mytags``는 ``_mytags``가 됩니다.

Item_Id``를 사용하여 ID로 항목을 지정하는 것 외에도 ``val_Item_Name 또는 ``hex_Hex_Encoded_Item_Name``을 사용하여 이름으로 지정할 수도 있습니다. 예를 들어:

calibre://book-details/Library_Name/authors/val_John%20Doe

URL 매개변수의 16진수 인코딩

URL 매개변수의 16진수 인코딩은 먼저 매개변수를 UTF-8 바이트로 인코딩한 다음 각 바이트를 해당 바이트를 나타내는 두 개의 16진수 문자로 바꾸는 방식으로 수행됩니다. 예를 들어 문자열 ``abc``는 UTF-8에서 바이트 ``0x61 0x62 0x63``이므로 인코딩된 버전은 문자열 ``616263``입니다.