calibre:// URL-schema

calibre registrerar sig som hanterare för calibre://-URL:er. De kan användas för att utföra åtgärder från andra program, dokument eller kommandoraden, till exempel öppna eller söka efter böcker. Om du exempelvis kör följande på kommandoraden:

calibre calibre://switch-library/Some_Library

Detta öppnar calibre med biblioteket Some Library. Biblioteksnamnet är namnet på biblioteksmappen, där blanksteg har ersatts med understreck. Specialvärdet _ betyder det aktuella biblioteket. De olika URL-typerna beskrivs nedan.

Du kan till och med placera dessa länkar inuti HTML-filer eller Word-dokument eller liknande och operativsystemet kommer automatiskt att köra calibre för att utföra den angivna åtgärden.

Växla till ett specifikt bibliotek

URL-syntaxen är:

calibre://switch-library/Library_Name

Biblioteksnamn är bibliotekets mappnamn med blanksteg ersatta med understrykningar. Specialvärdet _ betyder det aktuella biblioteket. Du kan också använda hexkodning för biblioteksnamnen, användbart om biblioteksnamnen har specialtecken som annars skulle kräva URL-kodning. Hexkodade biblioteksnamn ser ut som:

_hex_-AD23F4BC

Där delen efter prefixet _hex_- är biblioteksnamnet kodat som UTF-8 och varje byte representerad av två hexadecimala tecken.

Visa en specifik bok i calibre

URL-syntaxen är:

calibre://show-book/Library_Name/book_id

Detta visar boken med book_id (ett tal) i calibre. Du kan se bok-ID:t i calibres gränssnitt genom att hålla muspekaren över länken Klicka för att öppna i panelen Bokdetaljer. ID:t är talet inom parentes i slutet av sökvägen till bokmappen.

Du kan kopiera en länk till den aktuella boken genom att högerklicka i panelen Bokdetaljer och välja Kopiera länk till bok.

Om en sökning är aktiv och boken inte matchas av sökningen rensas sökningen.

Om ett virtuellt bibliotek väljs kommer calibre att använda det när boken visas. Om boken inte finns i det virtuella biblioteket rensas det virtuella biblioteket.

Om du vill byta till ett visst virtuellt bibliotek när du visar boken, använd:

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

ersätter mellanslag i det virtuella bibliotekets namn med %20. Om boken inte finns i det virtuella biblioteket ignoreras det virtuella biblioteket.

Öppna en specifik bok i e-bokvisaren på en specifik position

URL-syntaxen är:

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

Här är book_format bokens format, till exempel EPUB eller MOBI, och location är en valfri position i boken. Det enklaste sättet att skapa en sådan länk är att öppna boken i visaren och välja Gå till → Plats bland visningskontrollerna. Där visas en länk som du kan kopiera och klistra in någon annanstans.

Söka efter böcker

URL-syntaxen är:

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

Här är query ett giltigt sökuttryck. Om uttrycket är komplicerat kan du koda det som en hexsträng och använda eq i stället. Om query utelämnas rensas den aktuella sökningen.

Som standard rensar calibre ett valt virtuellt bibliotek innan sökningen genomförs, så att alla böcker kan hittas. Om du vill behålla det virtuella biblioteket använder du:

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

Om du vill växla till ett särskilt virtuellt bibliotek, använd:

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

ersätta blanksteg i det virtuella biblioteksnamnet med %20.

Om du utför en sökning i calibre och vill skapa en länk för den kan du göra det genom att högerklicka på sökfältet och välja Kopiera sökning som URL.

Öppna bokdetaljerna för en bok i ett bibliotek

URL-syntaxen är:

calibre://book-details/Library_Name/book_id

Det här öppnar ett fönster med bokdetaljer för den angivna boken från det angivna biblioteket utan att ändra det aktuella biblioteket eller den valda boken.

Öppna anteckningarna som är kopplade till en författare/serie/etc.

URL-syntaxen är:

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

Detta öppnar ett fönster som visar anteckningarna för den angivna posten. Det enklaste sättet att skapa sådana URL:er är att visa de anteckningar du vill ha i calibre och klicka på knappen Kopiera URL för att kopiera URL:en till urklipp och klistra in den där du behöver.

Här är Field_Name namnet på en kolumn, till exempel authors eller tags. För användarskapade kolumner ersätter du det inledande # i fältnamnet med ett understreck, så att #mytags blir _mytags.

Förutom att ange poster efter ID med Item_Id kan du ange dem efter namn med antingen val_Item_Name eller hex_Hex_Encoded_Item_Name. Exempel:

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

Hexkodning av URL-parametrar

URL-parametrar hexkodas genom att parametern först kodas som UTF-8-byte och varje byte sedan ersätts med två hexadecimala tecken. Strängen abc motsvarar exempelvis bytevärdena 0x61 0x62 and 0x63 i UTF-8, så den kodade strängen blir 616263.