.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CALIBREDB" "1" "de febrer 17, 2023" "6.13.0" "calibre" .SH NAME calibredb \- calibredb .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb ordre [opcions] [arguments] .ft P .fi .UNINDENT .UNINDENT .sp \fBcalibredb\fP is the command line interface to the calibre database. It has several sub\-commands, documented below. .sp \fBcalibredb\fP can be used to manipulate either a calibre database specified by path or a calibre Content server running either on the local machine or over the internet. You can start a calibre Content server using either the \fBcalibre\-server\fP program or in the main calibre program click Connect/share  →  Start Content server\&. Since \fBcalibredb\fP can make changes to your calibre libraries, you must setup authentication on the server first. There are two ways to do that: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 If you plan to connect only to a server running on the same computer, you can simply use the \fB\-\-enable\-local\-write\fP option of the Content server, to allow any program, including calibredb, running on the local computer to make changes to your calibre data. When running the server from the main calibre program, this option is in Preferences → Sharing over the net → Advanced\&. .IP \(bu 2 If you want to enable access over the internet, then you should setup user accounts on the server and use the \fI\%\-\-username\fP and \fI\%\-\-password\fP options to \fBcalibredb\fP to give it access. You can setup user authentication for \fBcalibre\-server\fP by using the \fB\-\-enable\-auth\fP option and using \fB\-\-manage\-users\fP to create the user accounts. If you are running the server from the main calibre program, use Preferences → Sharing over the net → Require username/password\&. .UNINDENT .UNINDENT .UNINDENT .sp To connect to a running Content server, pass the URL of the server to the \fI\%\-\-with\-library\fP option, see the documentation of that option for details and examples. .INDENT 0.0 .IP \(bu 2 \fI\%OPCIONS GLOBALS\fP .IP \(bu 2 \fI\%list\fP .IP \(bu 2 \fI\%add\fP .INDENT 2.0 .IP \(bu 2 \fI\%AFEGIR DES DE CARPETES\fP .UNINDENT .IP \(bu 2 \fI\%remove\fP .IP \(bu 2 \fI\%add_format\fP .IP \(bu 2 \fI\%remove_format\fP .IP \(bu 2 \fI\%show_metadata\fP .IP \(bu 2 \fI\%set_metadata\fP .IP \(bu 2 \fI\%export\fP .IP \(bu 2 \fI\%catalog\fP .INDENT 2.0 .IP \(bu 2 \fI\%EPUB OPCIONS\fP .UNINDENT .IP \(bu 2 \fI\%saved_searches\fP .IP \(bu 2 \fI\%add_custom_column\fP .IP \(bu 2 \fI\%custom_columns\fP .IP \(bu 2 \fI\%remove_custom_column\fP .IP \(bu 2 \fI\%set_custom\fP .IP \(bu 2 \fI\%restore_database\fP .IP \(bu 2 \fI\%check_library\fP .IP \(bu 2 \fI\%list_categories\fP .IP \(bu 2 \fI\%backup_metadata\fP .IP \(bu 2 \fI\%clone\fP .IP \(bu 2 \fI\%embed_metadata\fP .IP \(bu 2 \fI\%search\fP .IP \(bu 2 \fI\%fts_index\fP .IP \(bu 2 \fI\%fts_search\fP .UNINDENT .SH OPCIONS GLOBALS .INDENT 0.0 .TP .B \-\-help, \-h mostra aquest missatge d\fB\(aq\fPajuda i surt .UNINDENT .INDENT 0.0 .TP .B \-\-library\-path, \-\-with\-library Camí a la biblioteca de calibre. Per defecte s\fB\(aq\fPutilitza el camí emmagatzemat a la configuració. També és possible connectar\-se al servidor de contingut de calibre per dur a terme accions a biblioteques remotes. Per fer\-ho utilitzeu una URL com aquesta: \fI\%http://nomdelservidor:port/#library_id\fP per exemple, \fI\%http://localhost:8080/#mylibrary\fP\&. library_id és l\fB\(aq\fPidentificador de la biblioteca que voleu connectar al servidor de contingut. Podeu utilitzar el valor especial \fB\(dq\fPlibrary_id value of\fB\(dq\fP per obtenir una llista d\fB\(aq\fPidentificadors de biblioteques disponibles al servidor. Per a més detalls sobre com configurar l\fB\(aq\fPaccés a través d\fB\(aq\fPun servidor de contingut, vegeu \fI\%https://manual.calibre\-ebook.com/generated/en/calibredb.html\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-password Contrasenya per connectar a un servidor de continguts de calibre. Per llegir la contrasenya des d\fB\(aq\fPuna entrada estàndard, utilitzeu el valor especial: . Per a llegir la contrasenya des d\fB\(aq\fPun fitxer, utilitzeu: (és a dir ). Els angles de dalt són obligatòries, recordeu tancar\-los o utilitzar cometes per a la closca. .UNINDENT .INDENT 0.0 .TP .B \-\-timeout The timeout, in seconds, when connecting to a calibre library over the network. The default is two minutes. .UNINDENT .INDENT 0.0 .TP .B \-\-username Nom d\fB\(aq\fPusuari per connectar a un servidor de continguts de calibre .UNINDENT .INDENT 0.0 .TP .B \-\-version mostra el número de versió del programa i surt .UNINDENT .SH LIST .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb list [opcions] .ft P .fi .UNINDENT .UNINDENT .sp Llista dels llibres disponibles a la base de dades de calibre. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-ascending Ordena els resultats en ordre ascendent .UNINDENT .INDENT 0.0 .TP .B \-\-fields, \-f Els camps que es mostraran quan es llistin els llibres a la base de dades. Hauria de ser una llista de camps separada per comes. Camps disponibles: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Per defecte: %per defecte. El camp especial \fB\(dq\fPtots\fB\(dq\fP es pot utilitzar per seleccionar tots els camps. A més dels camps predefinits abans, hi ha camps personalitzats disponibles amb *nom_del_camp, per exemple, per a un camp personalitzat #valoració, utilitzaríeu el nom: *valoració .UNINDENT .INDENT 0.0 .TP .B \-\-for\-machine Genera la sortida en format JSON, que és més adequada per a l\fB\(aq\fPanàlisi amb autòmats. Provoca que s\fB\(aq\fPignorin les opcions de l\fB\(aq\fPample de línia i del separador. .UNINDENT .INDENT 0.0 .TP .B \-\-limit El nombre màxim de resultats a mostrar. Per defecte: tots .UNINDENT .INDENT 0.0 .TP .B \-\-line\-width, \-w Amplada màxima d\fB\(aq\fPuna línia a la sortida. Per defecte es detecta la mida de la pantalla. .UNINDENT .INDENT 0.0 .TP .B \-\-prefix Prefix per a tots els camins dels fitxers. Per defecte és el camí d\fB\(aq\fPaccés a la carpeta de la biblioteca. .UNINDENT .INDENT 0.0 .TP .B \-\-search, \-s Filtra els resultats amb la consulta de cerca. Per al format de la consulta de cerca vegeu la documentació relacionada al Manual de l\fB\(aq\fPusuari. Per defecte no es filtra. .UNINDENT .INDENT 0.0 .TP .B \-\-separator Cadena que s\fB\(aq\fPutilitzarà per separar els camps. Per defecte és un espai. .UNINDENT .INDENT 0.0 .TP .B \-\-sort\-by The field by which to sort the results. You can specify multiple fields by separating them with commas. Available fields: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Default: id .UNINDENT .INDENT 0.0 .TP .B \-\-template The template to run if \fB\(dq\fPtemplate\fB\(dq\fP is in the field list. Default: None .UNINDENT .INDENT 0.0 .TP .B \-\-template_file, \-t Path to a file containing the template to run if \fB\(dq\fPtemplate\fB\(dq\fP is in the field list. Default: None .UNINDENT .INDENT 0.0 .TP .B \-\-template_heading Heading for the template column. Default: template. This option is ignored if the option \fI\%\-\-for\-machine\fP is set .UNINDENT .SH ADD .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb add [opcions] fitxer1 fitxer2 fitxer3 ... .ft P .fi .UNINDENT .UNINDENT .sp Afegeix els fitxers especificats com a llibres a la base de dades. Podeu indicar també directoris, vegeu les opcions relacionades amb els directoris més avall. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-authors, \-a Estableix els autors del(s) llibre(s) afegit(s) .UNINDENT .INDENT 0.0 .TP .B \-\-automerge, \-m Si es troben llibres amb títols i autors similars, fusiona els formats (fitxers) entrants automàticament amb els registres de llibres existents. El valor \fB\(dq\fPignore\fB\(dq\fP significa que es descarten els formats duplicats. El valor \fB\(dq\fPsobreescriure\fB\(dq\fP significa que els formats duplicats de la biblioteca se sobreescriuen amb els fitxers afegits recentment. Un valor de \fB\(dq\fPnew_record\fB\(dq\fP significa que els formats duplicats es col·loquen en un registre de llibre nou. .UNINDENT .INDENT 0.0 .TP .B \-\-cover, \-c Camí a la portada que s\fB\(aq\fPutilitzarà per al llibre afegit .UNINDENT .INDENT 0.0 .TP .B \-\-duplicates, \-d Afegeix els llibres a la base de dades encara que ja existeixin. La comparació es fa a partir dels títols dels llibres i els autors. Tingues en compte que l\fB\(aq\fPopció \fI\%\-\-automerge\fP té precedència. .UNINDENT .INDENT 0.0 .TP .B \-\-empty, \-e Afegeix un llibre en blanc (un llibre sense format) .UNINDENT .INDENT 0.0 .TP .B \-\-identifier, \-I Estableix els identificadors per a aquest llibre, p. ex. \-I asin:XXX \-I isbn:YYY .UNINDENT .INDENT 0.0 .TP .B \-\-isbn, \-i Estableix l\fB\(aq\fPISBN del(s) llibre(s) afegit(s) .UNINDENT .INDENT 0.0 .TP .B \-\-languages, \-l Una llista de llengües separades per comes (millor si s\fB\(aq\fPutilitzen els codis de llengües ISO639, tot i que pot ser que també es reconegui els noms d\fB\(aq\fPalgunes llengües) .UNINDENT .INDENT 0.0 .TP .B \-\-series, \-s Estableix la sèrie del(s) llibre(s) afegit(s) .UNINDENT .INDENT 0.0 .TP .B \-\-series\-index, \-S Estableix el nombre de sèrie del(s) llibre(s) afegit(s) .UNINDENT .INDENT 0.0 .TP .B \-\-tags, \-T Estableix les etiquetes del(s) llibre(s) afegit(s) .UNINDENT .INDENT 0.0 .TP .B \-\-title, \-t Estableix el títol del(s) llibre(s) afegit(s) .UNINDENT .SS AFEGIR DES DE CARPETES .sp Options to control the adding of books from folders. By default only files that have extensions of known e\-book file types are added. .INDENT 0.0 .TP .B \-\-add A filename (glob) pattern, files matching this pattern will be added when scanning folders for files, even if they are not of a known e\-book file type. Can be specified multiple times for multiple patterns. .UNINDENT .INDENT 0.0 .TP .B \-\-ignore A filename (glob) pattern, files matching this pattern will be ignored when scanning folders for files. Can be specified multiple times for multiple patterns. For example: *.pdf will ignore all PDF files .UNINDENT .INDENT 0.0 .TP .B \-\-one\-book\-per\-directory, \-1 Assume that each folder has only a single logical book and that all files in it are different e\-book formats of that book .UNINDENT .INDENT 0.0 .TP .B \-\-recurse, \-r Process folders recursively .UNINDENT .SH REMOVE .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb remove IDs .ft P .fi .UNINDENT .UNINDENT .sp Suprimeix els llibres identificats amb els identificadors de la base de dades. Els «IDs» han d\(aqindicar\-se en una llista separada per comes amb els nombres dels identificadors (es poden obtenir els nombres dels identificadors mitjançant l\(aqordre «search»). Per exemple, 23,34,57\-85 (quan s\(aqespecifica un interval, no s\(aqinclou l\(aqúltim nombre de l\(aqinterval). .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-permanent No feu servir els Paperera de reciclatge .UNINDENT .SH ADD_FORMAT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb add_format [opcions] id fitxer_llibre .ft P .fi .UNINDENT .UNINDENT .sp Afegeix el llibre electrònic «fitxer_llibre» als formats disponibles per al llibre lògic identificat per l\(aq«id». Podeu obtenir l\(aq«id» mitjançant l\(aqordre «search». Si ja existeix el format, se substituirà, a no ser que s\(aqespecifiqui l\(aqopció de no substitució. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-dont\-replace No reemplacis el format si ja existeix .UNINDENT .SH REMOVE_FORMAT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb remove_format [opcions] ID fmt .ft P .fi .UNINDENT .UNINDENT .sp Suprimeix el format «fmt» del llibre lògic identificat per l\(aqID. Podeu obtenir l\(aqID mitjançant l\(aqordre «search». «fmt» ha de ser una extensió de fitxer com ara LRF, TXT o EPUB. Si el llibre lògic no té el disponible el «fmt», no fa res. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .SH SHOW_METADATA .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb show_metadata [opcions] ID .ft P .fi .UNINDENT .UNINDENT .sp Mostra les metadades emmagatzemades a la base de dades de calibre per al llibre identificat amb l\(aqID. L\(aqID és un nombre d\(aqidentificador de l\(aqordre «search». .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-as\-opf Imprimeix les metadades en format OPF (XML) .UNINDENT .SH SET_METADATA .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb set_metadata [options] book_id [/path/to/metadata.opf] .ft P .fi .UNINDENT .UNINDENT .sp Set the metadata stored in the calibre database for the book identified by book_id from the OPF file metadata.opf. book_id is a book id number from the search command. You can get a quick feel for the OPF format by using the \-\-as\-opf switch to the show_metadata command. You can also set the metadata of individual fields with the \-\-field option. If you use the \-\-field option, there is no need to specify an OPF file. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-field, \-f El camp a establir. El format és nom_del_camp:valor, per exemple: \fI\%\-\-field\fP etiquetes:etiqueta1,etiqueta2. Utilitzeu \fI\%\-\-list\-fields\fP per obtenir una llista de tots els noms de camps. Es pot especificar aquesta opció diverses vegades per establir diversos camps. Nota: Per llengües cal utilitzar els codis de llengua ISO639 (per exemple, \fB\(dq\fPen\fB\(dq\fP per l\fB\(aq\fPanglès, \fB\(dq\fPca\fB\(dq\fP per al català...). Per identificadors, la sintaxi és \fI\%\-\-field\fP identifiers:isbn:XXXX,doi:YYYYY. Per als camps boolean (sí/no) utilitzeu \fB\(dq\fPtrue\fB\(dq\fP i \fB\(dq\fPfalse\fB\(dq\fP o \fB\(dq\fPyes\fB\(dq\fP i \fB\(dq\fPno\fB\(dq\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-list\-fields, \-l Mostra una llista dels noms dels camps de metadades que es poden utilitzar amb l\fB\(aq\fPopció \fI\%\-\-field\fP opció .UNINDENT .SH EXPORT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb export [opcions] IDs .ft P .fi .UNINDENT .UNINDENT .sp Exporta els llibres identificats pels IDs (una llista separada per comes) al sistema de fitxers. L\(aqoperació d\(aqexportació desa tots els formats del llibre, la portada i les metadades (a un fitxer opf). Podeu obtenir els nombres dels IDs de l\(aqordre «search». .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-all Exporta tots els llibres de la base de dades, ignorant la llista dels id. .UNINDENT .INDENT 0.0 .TP .B \-\-dont\-asciiize Have calibre convert all non English characters into English equivalents for the file names. This is useful if saving to a legacy filesystem without full support for Unicode filenames. Si s\fB\(aq\fPespecifica aquesta opció, es desactiva aquest comportament. .UNINDENT .INDENT 0.0 .TP .B \-\-dont\-save\-cover Normally, calibre will save the cover in a separate file along with the actual e\-book files. Si s\fB\(aq\fPespecifica aquesta opció, es desactiva aquest comportament. .UNINDENT .INDENT 0.0 .TP .B \-\-dont\-update\-metadata Normalment calibre actualitza les metadades als fitxers que es desen a partir del que hi ha a la biblioteca de calibre. Fa que es desi més lentament. Si s\fB\(aq\fPespecifica aquesta opció, es desactiva aquest comportament. .UNINDENT .INDENT 0.0 .TP .B \-\-dont\-write\-opf Normalment calibre escriurà les metadades a un fitxer OPF separat, junt amb els fitxers reals del llibre electrònic. Si s\fB\(aq\fPespecifica aquesta opció, es desactiva aquest comportament. .UNINDENT .INDENT 0.0 .TP .B \-\-formats Llista separada per comes de la llista de formats que es desaran de cada llibre. Per defecte es desen tots els formats disponibles. .UNINDENT .INDENT 0.0 .TP .B \-\-progress Informe de progrés .UNINDENT .INDENT 0.0 .TP .B \-\-replace\-whitespace Reemplaça els espais en blanc amb guions baixos. .UNINDENT .INDENT 0.0 .TP .B \-\-single\-dir Export all books into a single folder .UNINDENT .INDENT 0.0 .TP .B \-\-template The template to control the filename and folder structure of the saved files. Default is \fB\(dq\fP{author_sort}/{title}/{title} \- {authors}\fB\(dq\fP which will save books into a per\-author subfolder with filenames containing title and author. Available controls are: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title} .UNINDENT .INDENT 0.0 .TP .B \-\-timefmt El format en què es visualitzaran les dates. %d: dia, %b: mes, %m: nombre del mes, %Y: any. Per defecte: %b, %Y .UNINDENT .INDENT 0.0 .TP .B \-\-to\-dir Exporta els llibres a la carpeta especificada. Per defecte és . .UNINDENT .INDENT 0.0 .TP .B \-\-to\-lowercase Converteix els camins a minúscules. .UNINDENT .SH CATALOG .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options] .ft P .fi .UNINDENT .UNINDENT .sp Export a \fBcatalog\fP in format specified by path/to/destination extension. Options control how entries are displayed in the generated \fBcatalog\fP output. Note that different \fBcatalog\fP formats support different sets of options. To see the different options, specify the name of the output file and then the \-\-help option. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-ids, \-i Llista d\fB\(aq\fPIDs de la base de dades separada per comes per catalogar. Si es declara, s\fB\(aq\fPignora \fI\%\-\-search\fP\&. Per defecte: totes .UNINDENT .INDENT 0.0 .TP .B \-\-search, \-s Filtra els resultats segons la consulta de cerca. Per al format de la cerca vegeu la documentació del tema al manual d\fB\(aq\fPusuari. Per defecte: sense filtrar .UNINDENT .INDENT 0.0 .TP .B \-\-verbose, \-v Mostra informació detallada de sortida. Útil per depurar .UNINDENT .SS EPUB OPCIONS .INDENT 0.0 .TP .B \-\-catalog\-title Títol del catàleg generat, que s\fB\(aq\fPutilitzarà com a títol a les metadades. Per defecte: «My Books» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-cross\-reference\-authors Crea referències creuades a la secció dels autors per als llibres amb diversos autors. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-pipeline Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring. Default: \fB\(aq\fPNone\fB\(aq\fP Applies to: AZW3, EPUB, MOBI output formats .UNINDENT .INDENT 0.0 .TP .B \-\-exclude\-genre Expressió regular que descriu les etiquetes que s\fB\(aq\fPexclouran com a gèneres. Per defecte: «[.+]|^+$» exclou les etiquetes entre claudàtors, per exemple «[Projecte Gutemberg]», i «+», l\fB\(aq\fPetiqueta per defecte per als llibres llegits. S\fB\(aq\fPaplica als formats de sortida: AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-exclusion\-rules Especifica les regles que s\fB\(aq\fPutilitzaran per excloure llibres del catàleg generat. El model per a una regla d\fB\(aq\fPexclusió pot ser (\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fPTags\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP) o bé (\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP). Per exemple: ((\fB\(aq\fPLlibres emmagatzemats\fB\(aq\fP,\fB\(aq\fP#estat\fB\(aq\fP,\fB\(aq\fPEmmagatzemat\fB\(aq\fP),) exclourà un llibre amb un valor d\fB\(aq\fP«Emmagatzemat» a la columna personalitzada «estat». Si es defineixen diverses regles, s\fB\(aq\fPapliquen totes les regles. Per defecte: «((\fB\(aq\fPCatalogs\fB\(aq\fP,\fB\(aq\fPTags\fB\(aq\fP,\fB\(aq\fPCatalog\fB\(aq\fP),)» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-authors Inclou la secció «Autors» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-descriptions Inclou la secció «Descripcions» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-genres Inclou la secció «Gèneres» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-recently\-added Inclou una secció «Afegits recentment» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-series Inclou la secció «Sèries» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-generate\-titles Inclou la secció «Títols» al catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-genre\-source\-field Camp origen de la secció «Gèneres». Per defecte «Etiquetes» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-header\-note\-source\-field Camp personalitzat que conté una nota de text per inserir a l\fB\(aq\fPencapçalament «Descripció». Per defecte: «» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-merge\-comments\-rule #:[before|after]:[True|False] specifying: Custom field containing notes to merge with comments [before|after] Placement of notes with respect to comments [True|False] \- A horizontal rule is inserted between notes and comments Default: \fB\(aq\fP::\fB\(aq\fP Applies to: AZW3, EPUB, MOBI output formats .UNINDENT .INDENT 0.0 .TP .B \-\-output\-profile Especifica el perfil de sortida. En alguns casos, cal un perfil de sortida per optimitzar el catàleg per al dispositiu. Per exemple, \fB\(aq\fPkindle\fB\(aq\fP o \fB\(aq\fPkindle_dx\fB\(aq\fP crea una taula del contingut estructurada en seccions i articles. Per defecte: \fB\(aq\fPNone\fB\(aq\fP S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI. .UNINDENT .INDENT 0.0 .TP .B \-\-prefix\-rules Especifica les regles que s\fB\(aq\fPutilitzen per incloure prefixos que indiquin els llibres llegits, els ítems de la llista de desitjos i altres prefixos especificats per l\fB\(aq\fPusuari. El model per a una regla de prefix és (\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP,\fB\(aq\fP\fB\(aq\fP). Si es defineixen diverses regles, s\fB\(aq\fPutilitza la primera que coincideixi. Per defecte: «((\fB\(aq\fPRead books\fB\(aq\fP,\fB\(aq\fPtags\fB\(aq\fP,\fB\(aq\fP+\fB\(aq\fP,\fB\(aq\fP✓\fB\(aq\fP),(\fB\(aq\fPWishlist item\fB\(aq\fP,\fB\(aq\fPtags\fB\(aq\fP,\fB\(aq\fPWishlist\fB\(aq\fP,\fB\(aq\fP×\fB\(aq\fP))» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-preset Utilitza una predefinició creada amb la interfície gràfica del constructor de catàlegs. Una predefinició especifica tots els ajusts per a la construcció d\fB\(aq\fPun catàleg. Per defecte: «None» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-thumb\-width Mida recomanada (en polzades) per a les portades dels llibres del catàleg. Interval: 1,0 \- 2,0 Per defecte: «1.0» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .INDENT 0.0 .TP .B \-\-use\-existing\-cover Reemplaça la portada existent quan es genera el catàleg. Per defecte: «False» S\fB\(aq\fPaplica als formats de sortida AZW3, EPUB i MOBI .UNINDENT .SH SAVED_SEARCHES .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb saved_searches [opcions] (llista|afegeix|elimina) .ft P .fi .UNINDENT .UNINDENT .sp Gestiona les cerques guardades en aquesta base de dades. Si proveu d\(aqafegir una cerca amb un nom que ja existeix, se substituirà. .sp Sintaxi per afegir: .sp calibredb \fBsaved_searches\fP afegir cerca_nom cerca_expressió .sp Sintaxi per eliminar: .sp calibredb \fBsaved_searches\fP elimina cerca_nom .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .SH ADD_CUSTOM_COLUMN .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb add_custom_column [opcions] etiqueta nom tipus_de_dades .ft P .fi .UNINDENT .UNINDENT .sp Crea una columna personalitzada. L\(aqetiqueta és el nom intern de la columna. No hauria de contenir espais o dos punts. El nom és el nom visible de la columna. El tipus de dades és un de: bool, comments, composite, datetime, enumeration, float, int, rating, series, text .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-display Un diccionari d\fB\(aq\fPopcions per personalitzar com s\fB\(aq\fPinterpretaran les dades en aquesta columna. Això és una cadena JSON. Per columnes d\fB\(aq\fPenumeració, utilitzeu \fI\%\-\-display\fP\fB\(dq\fP{\e \fB\(dq\fPenum_values\e \fB\(dq\fP:[\e \fB\(dq\fPval1\e \fB\(dq\fP, \e \fB\(dq\fPval2\e \fB\(dq\fP]}\fB\(dq\fP Hi ha moltes opcions per a la variable \fB\(dq\fPdisplay\fB\(dq\fP\&. Les opcions per tipus de columna són: composite: composite_template, composite_sort, make_category,contains_html, use_decorations datetime: date_format enumeration: enum_values, enum_colors, use_decorations int, float: number_format text: is_names, use_decorations La millor manera de trobar combinacions legals és creant una columna personalitzada del tipus adient a la interfície gràfica i després cercar un llibre al fitxer OPF (comproveu que s\fB\(aq\fPha creat un OPF nou des de l\fB\(aq\fPaddició de la columna). Veureu el JSON per a la \fB\(dq\fPdisplay\fB\(dq\fP de la columna nova a l\fB\(aq\fPOPF. .UNINDENT .INDENT 0.0 .TP .B \-\-is\-multiple Aquesta columna emmagatzema les etiquetes com a dades (amb valors separats per comes). Només s\fB\(aq\fPaplica si les dades són de tipus text. .UNINDENT .SH CUSTOM_COLUMNS .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb custom_columns [opcions] .ft P .fi .UNINDENT .UNINDENT .sp Llista les columnes personalitzades disponibles. Mostra les etiquetes ies id. de les columnes. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-details, \-d Mostra els detalls per a cada columna. .UNINDENT .SH REMOVE_CUSTOM_COLUMN .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb remove_custom_column [opcions] etiqueta .ft P .fi .UNINDENT .UNINDENT .sp Suprimeix la columna personalitzada identificada per l\(aqetiqueta. Podeu veure les columnes disponibles amb l\(aqordre «custom_columns». .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-force, \-f No demanis confirmació .UNINDENT .SH SET_CUSTOM .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb set_custom [opcions] columna ID valor .ft P .fi .UNINDENT .UNINDENT .sp Estableix el valor d\(aquna columna personalitzada per al llibre identificat per l\(aqID. Podeu obtenir una llista dels ID mitjançant l\(aqordre «search». Podeu obtenir una llista dels noms de les columnes personalitzades mitjançant l\(aqordre «custom_columns». .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-append, \-a Si la columna emmagatzema diversos valors, annexa els valors especificats als ja existents, en lloc de substituir\-los. .UNINDENT .SH RESTORE_DATABASE .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb restore_database [options] .ft P .fi .UNINDENT .UNINDENT .sp Restore this database from the metadata stored in OPF files in each folder of the calibre library. This is useful if your metadata.db file has been corrupted. .sp WARNING: This command completely regenerates your database. You will lose all saved searches, user categories, plugboards, stored per\-book conversion settings, and custom recipes. Restored metadata will only be as accurate as what is found in the OPF files. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-really\-do\-it, \-r Fes la recuperació. L\fB\(aq\fPordre no s\fB\(aq\fPexecuta llevat que no s\fB\(aq\fPespecifiqui aquesta opció. .UNINDENT .SH CHECK_LIBRARY .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb check_library [opcions] .ft P .fi .UNINDENT .UNINDENT .sp Realitza algunes comprovacions al sistema de fitxers que representa una biblioteca. Els informes són invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-csv, \-c Sortida CSV .UNINDENT .INDENT 0.0 .TP .B \-\-ignore_extensions, \-e Llista de les extensions que s\fB\(aq\fPignoraran separada per comes. Per defecte: totes .UNINDENT .INDENT 0.0 .TP .B \-\-ignore_names, \-n Llista de noms a ignorar separada per comes. Per defecte: tot .UNINDENT .INDENT 0.0 .TP .B \-\-report, \-r Llista d\fB\(aq\fPinformes separats per comes. Per defecte: tots .UNINDENT .INDENT 0.0 .TP .B \-\-vacuum\-fts\-db Vacuum the full text search database. This can be very slow and memory intensive, depending on the size of the database. .UNINDENT .SH LIST_CATEGORIES .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb list_categories [options] .ft P .fi .UNINDENT .UNINDENT .sp Produce a report of the category information in the database. The information is the equivalent of what is shown in the Tag browser. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-categories, \-r Llista separada per comes dels noms de consulta de la categoria. Per defecte: tot .UNINDENT .INDENT 0.0 .TP .B \-\-csv, \-c Sortida CSV .UNINDENT .INDENT 0.0 .TP .B \-\-dialect El tipus de fitxer CSV a produir. Opcions: excel, excel\-tab, unix .UNINDENT .INDENT 0.0 .TP .B \-\-item_count, \-i Genera només la sortida del nombre d\fB\(aq\fPítems en una categoria en lloc del recompte per ítem a cada categoria .UNINDENT .INDENT 0.0 .TP .B \-\-width, \-w Amplada màxima d\fB\(aq\fPuna línia a la sortida. Per defecte es detecta la mida de la pantalla. .UNINDENT .SH BACKUP_METADATA .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb backup_metadata [options] .ft P .fi .UNINDENT .UNINDENT .sp Backup the metadata stored in the database into individual OPF files in each books folder. This normally happens automatically, but you can run this command to force re\-generation of the OPF files, with the \-\-all option. .sp Note that there is normally no need to do this, as the OPF files are backed up automatically, every time metadata is changed. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-all Normalment aquesta ordre només actua en llibres que tenen fitxers OPF obsolets. Aquesta opció fa que actuï en tots els llibres. .UNINDENT .SH CLONE .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb clone path/to/new/library .ft P .fi .UNINDENT .UNINDENT .sp Create a \fBclone\fP of the current library. This creates a new, empty library that has all the same custom columns, Virtual libraries and other settings as the current library. .sp The cloned library will contain no books. If you want to create a full duplicate, including all books, then simply use your filesystem tools to copy the library folder. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .SH EMBED_METADATA .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb embed_metadata [options] book_id .ft P .fi .UNINDENT .UNINDENT .sp Actualitza les metadades als fitxers del llibre real que estan emmagatzemats a la biblioteca de calibre a partir de les metadades de la base de dades de calibre. Normalment, les metadades només s\(aqactualitzen quan s\(aqexporten els fitxers de calibre; per tant, aquesta ordre és útil si voleu que s\(aqactualitzin a la vostra base de dades. Tingueu en compte que cada tipus de fitxer admet quantitats diferents de metadades. Es pot utilitzar el valor especial «all» perquè l\(aqidentificador de llibre actualitzi les metadades en tots els llibres. També es poden especificar diversos identificadors de llibre separats per espais o conjunts d\(aqidentificadors separats per guions. Per exemple: calibredb \fBembed_metadata\fP 1 2 10\-15 23 .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-only\-formats, \-f Només actualitza les metadades als fitxers del format especificat. Especifiqueu\-ho diverses vegades per diversos formats. Per defecte, tots els formats s\fB\(aq\fPactualitzen. .UNINDENT .SH SEARCH .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb search [options] search expression .ft P .fi .UNINDENT .UNINDENT .sp Search the library for the specified \fBsearch\fP term, returning a comma separated list of book ids matching the \fBsearch\fP expression. The output format is useful to feed into other commands that accept a list of ids as input. .sp The \fBsearch\fP expression can be anything from calibre\(aqs powerful \fBsearch\fP query language, for example: calibredb \fBsearch\fP author:asimov \(aqtitle:\(dqi robot\(dq\(aq .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-limit, \-l El nombre màxim de resultats que retornarà. Per defecte es mostren tots els resultats. .UNINDENT .SH FTS_INDEX .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb fts_index [options] enable/disable/status/reindex .ft P .fi .UNINDENT .UNINDENT .sp Control the Full text search indexing process. .INDENT 0.0 .TP .B enable Turns on FTS indexing for this library .TP .B disable Turns off FTS indexing for this library .TP .B status Shows the current indexing status .TP .B reindex Can be used to re\-index either particular books or the entire library. To re\-index particular books specify the book ids as additional arguments after the reindex command. If no book ids are specified the entire library is re\-indexed. .UNINDENT .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-indexing\-speed The speed of indexing. Use fast for fast indexing using all your computers resources and slow for less resource intensive indexing. Note that the speed is reset to slow after every invocation. .UNINDENT .INDENT 0.0 .TP .B \-\-wait\-for\-completion Wait till all books are indexed, showing indexing progress periodically .UNINDENT .SH FTS_SEARCH .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C calibredb fts_search [options] search expression .ft P .fi .UNINDENT .UNINDENT .sp Do a full text search on the entire library or a subset of it. .sp Sempre que passeu arguments a calibredb i aquests tinguin espais en blanc, delimiteu els arguments amb cometes. Per exemple: \(dq/some path/with spaces\(dq .INDENT 0.0 .TP .B \-\-do\-not\-match\-on\-related\-words Only match on exact words not related words. So correction will not match correcting. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-snippets Include snippets of the text surrounding each match. Note that this makes searching much slower. .UNINDENT .INDENT 0.0 .TP .B \-\-indexing\-threshold How much of the library must be indexed before searching is allowed, as a percentage. Defaults to 90 .UNINDENT .INDENT 0.0 .TP .B \-\-match\-end\-marker The marker used to indicate the end of a matched word inside a snippet .UNINDENT .INDENT 0.0 .TP .B \-\-match\-start\-marker The marker used to indicate the start of a matched word inside a snippet .UNINDENT .INDENT 0.0 .TP .B \-\-output\-format The format to output the search results in. Either \fB\(dq\fPtext\fB\(dq\fP for plain text or \fB\(dq\fPjson\fB\(dq\fP for JSON output. .UNINDENT .INDENT 0.0 .TP .B \-\-restrict\-to Restrict the searched books, either using a search expression or ids. For example: ids:1,2,3 to restrict by ids or search:tag:foo to restrict to books having the tag foo. .UNINDENT .SH AUTHOR Kovid Goyal .SH COPYRIGHT Kovid Goyal .\" Generated by docutils manpage writer. .