.\" 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" "fevereiro 17, 2023" "6.13.0" "calibre"
.SH NAME
calibredb \- calibredb
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb comando [options] [arguments]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\fBcalibredb\fP é a interface de linha de comandos para a base de dados do Calibre. Possui vários subcomandos, documentados a seguir.
.sp
\fBcalibredb\fP pode ser usado para manipular quer uma base de dados Calibre especificada por caminho quer um Servidor de conteúdos  Calibre em execução em máquina local ou na Internet.
Você pode iniciar um :guilabel: \fIServidor de conteúdos\fP Calibre usando o programa \fBcalibre\-server\fP ou, no programa principal Calibre, clicar em Ligar/Partilhar \-> Iniciar servidor de conteúdos\(ga.
Como o \fBcalibredb\fP pode efetuar alterações nas suas bibliotecas Calibre, primeiro você deve configurar a autenticação no servidor.
Existem duas maneiras de o fazer:
.INDENT 0.0
.IP \(bu 2
Se planeia ligar\-se apenas a um servidor a funcionar no mesmo computador, você pode simplesmente usar a opção \fB\-\-enable\-local\-write\fP do servidor de conteúdos, para permitir que qualquer programa que seja executado no computador local, incluindo o calibredb, possa fazer alterações nos seus dados Calibre. Ao executar o servidor a partir do programa principal do Calibre, esta opção está em Preferências → Partilhar na rede → Avançado\&.
.IP \(bu 2
Se deseja ativar o acesso pela internet então deve configurar contas de utilizador no servidor e usar as opções :option: \fI\-\-username\fP e :option:\(ga \-\-password\(ga para :command: \fIcalibredb\fP para fornecer acesso.
.UNINDENT
.sp
Você pode configurar a autenticação de utilizadores para :command: \fIcalibre\-server\fP usando a opção \fB\-\-enable\-auth\fP e usando \fB\-\-manage\-users\fP para criar as contas de utilizador.
Se estiver a executar o servidor a partir do programa Calibre principal, use Preferências →  Partilhar na rede → Exigir nome de utilizador / senha\&.
.sp
Para ligar a um servidor de conteúdo em execução, passe a URL do servidor para a opção :option: \fI\-\-with\-library\fP\&. Veja a documentação dessa opção para detalhes e exemplos.
.INDENT 0.0
.IP \(bu 2
\fI\%OPÇÕES GLOBAIS\fP
.IP \(bu 2
\fI\%list\fP
.IP \(bu 2
\fI\%add\fP
.INDENT 2.0
.IP \(bu 2
\fI\%Adicionar a partir de pastas\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 OPÇÕES\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 OPÇÕES GLOBAIS
.INDENT 0.0
.TP
.B \-\-help, \-h
mostrar esta mensagem de ajuda e sair
.UNINDENT
.INDENT 0.0
.TP
.B \-\-library\-path, \-\-with\-library
Caminho para a biblioteca do Calibre. Por predefinição é usado o caminho armazenado nas definições. Pode também ligar\-se a um servidor de conteúdos Calibre para executar ações em bibliotecas remotas. Para tal, use um URL na forma: \fI\%http://hostname:port/#id_da_biblioteca\fP , por exemplo, \fI\%http://localhost:8080/#mylibrary\fP . id_da_biblioteca é o identificador da biblioteca à qual se pretende ligar no servidor de conteúdos. Pode usar o valor especial de id_da_bilbioteca \- para obter uma lista de identificadores de bibliotecas disponíveis no servidor. Para detalhes sobre como configurar o acesso através de um servidor de conteúdos, veja \fI\%https://manual.calibre\-ebook.com/pt/generated/pt/calibredb.html\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-password
Senha para se ligar a um servidor de conteúdos Calibre. Para ler a senha a partir da entrada padrão, use o valor especial: <stdin>. Para ler a senha de um ficheiro use: <f:/path/to/file> (isto é: <f: followed by the full path to the file and a trailing >). Os parênteses angulares acima são obrigatórios, lembre\-se de os escapar ou use aspas para a sua Shell.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-timeout
O tempo limite, em segundos, para se ligar a uma biblioteca Calibre pela rede. A predefinição é de dois minutos.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-username
Nome de utilizador para ligar ao servidor de conteúdos do Calibre
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
mostrar o número da versão do programa e sair
.UNINDENT
.SH LIST
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb list [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Lista de livros disponíveis na base de dados do Calibre.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-ascending
Ordenar os resultados por ordem crescente
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fields, \-f
Os campos a apresentar ao listar os livros na base dados. Deve ser uma lista de campos separados por virgulas. Campos disponíveis: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid A predefinição é: title,authors. O campo especial \fB\(dq\fPall\fB\(dq\fP pode ser utilizado para selecionar todos os campos. Para além dos campos internos acima, os campos personalizados também estão disponíveis como *field_name, por exemplo, para o campo personalizado #rating, use o nome: *rating
.UNINDENT
.INDENT 0.0
.TP
.B \-\-for\-machine
Gerar ficheiro de saída no formato JSON que é mais adequado para análise de máquina. Isto fará com que a largura de linha e as opções de separador sejam ignorados.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-limit
O número máximo de resultados a mostrar. Predefinição: todos
.UNINDENT
.INDENT 0.0
.TP
.B \-\-line\-width, \-w
A largura máxima de uma linha no ficheiro de destino. A predefinição será detetar o tamanho do ecrã.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-prefix
O prefixo para todos os caminhos para os ficheiros. A predefinição é usar o caminho absoluto para a pasta da biblioteca.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-search, \-s
Filtrar resultados pela expressão de pesquisa. Sobre o formato da expressão de pesquisa, veja a documentação relacionada com as pesquisas no Manual do utilizador. A predefinição é não filtrar.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-separator
A expressão utilizada para separar os campos. A predefinição é um espaço.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sort\-by
O campo pelo qual ordenar os resultados. Pode especificar múltiplos campos separando\-os por vírgulas. Campos disponíveis: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Predefinição: 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 [options] ficheiro1 ficheiro2 ficheiro3 ...
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Adicionar os ficheiros especificados à base de dados. Também pode especificar pastas: ver abaixo as opções relativas às pastas.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-authors, \-a
Definir o autor do(s)  livro(s) adicionado(s)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-automerge, \-m
Se forem encontrados livros com títulos e autores semelhantes, fundir automaticamente os formatos (ficheiros) a receber nos registos de livros existentes. Um valor de \fB\(dq\fPignore\fB\(dq\fP (Ignorar) significa que os formatos duplicados são descartados. Um valor \fB\(dq\fPoverwrite\fB\(dq\fP (Sobrepor) significa que os formatos duplicados na biblioteca são substituídos pelos ficheiros recém\-adicionados. Um valor de \fB\(dq\fPnew_record\fB\(dq\fP (Novo registo) significa que os formatos duplicados são colocados num novo registo de livro.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cover, \-c
Caminho para a capa utilizar no livro adicionado
.UNINDENT
.INDENT 0.0
.TP
.B \-\-duplicates, \-d
Adicionar livros à base de dados mesmo se estes já existem. A comparação é feita baseada nos títulos e autores dos livros. Note que a opção \fI\%\-\-automerge\fP tem precedência.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-empty, \-e
Adicionar livro vazio (um registo sem qualquer formato)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-identifier, \-I
Definir identificadores para este livro, por exemplo \-I asin:XXX \-I isbn:YYY
.UNINDENT
.INDENT 0.0
.TP
.B \-\-isbn, \-i
Definir o ISBN do(s)  livro(s) adicionado(s)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-languages, \-l
Uma lista de idiomas separada por vírgulas (é melhor utilizar códigos de idioma ISO639, apesar de alguns nomes de idiomas poderem ser reconhecidos)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-series, \-s
Definir as séries do(s) livro(s) adicionado(s)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-series\-index, \-S
Definir o numero na série do(s)  livro(s) adicionado(s)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tags, \-T
Definir as etiquetas do(s)  livro(s) adicionado(s)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-title, \-t
Definir o título do(s) livro(s) adicionado(s)
.UNINDENT
.SS Adicionar a partir de pastas
.sp
Opções para controlar a inclusão de livros a partir de pastas. Por predefinição só serão adicionados ficheiros com extensões conhecidas de formatos de livros.
.INDENT 0.0
.TP
.B \-\-add
Um padrão (glob) de nomes de ficheiros, em que os ficheiros que correspondam a este padrão serão adicionados quando se varrem pastas na pesquisa de ficheiros, mesmo que não sejam de um tipo de ficheiro conhecido como ebook. Pode ser especificado múltiplas vezes para múltiplos padrões.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore
Um padrão (glob) de nomes de ficheiros, em que os ficheiros que correspondam a este padrão serão ignorados quando se varrem pastas na pesquisa de ficheiros. Pode ser especificado múltiplas vezes para múltiplos padrões. Exemplo: *.pdf ignorará todos os ficheiros pdf
.UNINDENT
.INDENT 0.0
.TP
.B \-\-one\-book\-per\-directory, \-1
Assumir que cada pasta tem um único livro lógico e que todos os ficheiros nela contidos são formatos diferentes desse livro
.UNINDENT
.INDENT 0.0
.TP
.B \-\-recurse, \-r
Processar pastas recursivamente
.UNINDENT
.SH REMOVE
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb remover ids
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Remover os livros, identificados por ID, da base de dados. Os ID devem estar numa lista de números de ID, separados por vírgulas. Você pode obter o numero de ID através do comando de pesquisa. Por exemplo, 23,34,57\-85 (se especificar um intervalo, o último número do intervalo não será incluído).
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-permanent
Não usar a Reciclagem
.UNINDENT
.SH ADD_FORMAT
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb add_format [options] ID ebook_file
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Adicionar o livro em ebook_file para os formatos disponíveis para o livro lógico identificado por ID. Pode obter o ID usando o comando de pesquisa. Caso o formato já exista será substituído, a menos que esteja especificada a opção de não substituir.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-dont\-replace
Não substituir o formato se o formato já existir
.UNINDENT
.SH REMOVE_FORMAT
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb remove_format [options] id fmt
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Remover o formato fmt do livro lógico identificado pelo ID. Pode saber o ID usando o comando search. fmt deve ser uma extensão de ficheiro como LRF ou TXT ou EPUB. Se o livro lógico não tem fmt disponível, não fazer nada.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.SH SHOW_METADATA
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb show_metadata [options] id
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Mostrar os metadados armazenados na base de dados do Calibre para o livro identificado pelo ID.
O ID é um número de identificação do comando de pesquisa.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-as\-opf
Imprimir os metadados no formulário 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
Definir os metadados armazenados na base de dados Calibre para o livro identificado por book_id do ficheiro OPF metadata.opf.
book_id é um número de identificação do comando de pesquisa. Pode ter uma ideia do formato OPF utilizando a opção \-\-as\-opf alternando para o comando show_metadata.
Também pode definir os metadados de campos individuais com a opção \-\-field.
Se usar a opção \-\-field, não é necessário especificar um ficheiro OPF.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-field, \-f
O campo a ser definido. O formato é field_name:value, por exemplo: \fI\%\-\-field\fP tags:tag1,tag2. Use \fI\%\-\-list\-fields\fP para obter uma lista de todos os nomes de campo. Pode especificar esta opção várias vezes para definir vários campos. Nota: para idiomas deve usar os códigos de idioma ISO639 (por exemplo, en para Inglês, pt para Português e assim por diante). Para identificadores, a sintaxe é \fI\%\-\-field\fP identifiers:isbn:XXXX,doi:YYYYY. Para campos booleanos (sim/não) use verdadeiro e falso ou sim e não.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-list\-fields, \-l
Lista de nomes de campos de metadados que podem ser usadas com a opção \fI\%\-\-field\fP
.UNINDENT
.SH EXPORT
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb exportar [options] ID
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Exporta os livros especificados pelos ID (numa lista separada por virgulas) para o sistema de ficheiros.
A operação de exportação guarda todos os formatos do livro, a sua capa e os metadados (num ficheiro OPF).
Pode saber os números de ID através do comando de pesquisa.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-all
Exportar todos os livros da base de dados, ignorando a lista de ID.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dont\-asciiize
Converter com o Calibre todos os caracteres não ingleses para equivalentes ingleses nos nomes dos ficheiros. Isto é útil se estiver a guardar para um sistema de ficheiros antigo que não possua suporte total Unicode a nomes de ficheiros. Especificar este parâmetro irá desligar este comportamento.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dont\-save\-cover
Normalmente o Calibre guarda a capa num ficheiro separado, junto aos ficheiros do livro em causa. Especificar este parâmetro irá desligar este comportamento.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dont\-update\-metadata
Normalmente o Calibre atualiza os metadados nos ficheiros exportados a partir da biblioteca do Calibre. Torna a exportação de ficheiros mais lenta. Especificar este parâmetro irá desligar este comportamento.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dont\-write\-opf
Normalmente o Calibre escreve os metadados num ficheiro OPF separado, junto aos ficheiros do livro em causa. Especificar este parâmetro irá desligar este comportamento.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-formats
Lista separada por vírgulas de de formatos a guardar para cada livro. A predefinição todos os formatos disponíveis são guardados.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-progress
Relatório de execução
.UNINDENT
.INDENT 0.0
.TP
.B \-\-replace\-whitespace
Substituir espaços por sobtraços
.UNINDENT
.INDENT 0.0
.TP
.B \-\-single\-dir
Exportar todos os livros para uma única pasta
.UNINDENT
.INDENT 0.0
.TP
.B \-\-template
Modelo para controlar a estrutura do nome de ficheiro e pastas para os ficheiros exportados. A predefinição é \fB\(dq\fP{author_sort}/{title}/{title} \- {authors}\fB\(dq\fP, o que vai guardar os livros numa subpasta por autor com o nome dos ficheiros contendo título e autor. As variáveis disponíveis são: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title}
.UNINDENT
.INDENT 0.0
.TP
.B \-\-timefmt
O formato para exibir datas. %d \- dia, %b \- mês, %m \- número do mês, %Y \- ano. A predefinição é: %b, %Y
.UNINDENT
.INDENT 0.0
.TP
.B \-\-to\-dir
Exportar livros para a pasta especificada. O predefinido é .
.UNINDENT
.INDENT 0.0
.TP
.B \-\-to\-lowercase
Converter os caminhos para minúsculas.
.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 passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-ids, \-i
Lista separada por vírgulas de ID de base de dados a catalogar. Se declarada, \fI\%\-\-search\fP será ignorada. Predefinição: all (todas)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-search, \-s
Filtrar os resultados dos termos de pesquisa. Para saber mais sobre o formato dos termos da pesquisa, consulte a documentação relacionada com a pesquisa no manual de utilizador. Predefinição: sem filtragem
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose, \-v
Mostrar informação de saída detalhada. Útil para depurar.
.UNINDENT
.SS EPUB OPÇÕES
.INDENT 0.0
.TP
.B \-\-catalog\-title
Título do catálogo gerado utilizado como título nos metadados. Predefinição: \fB\(aq\fPMy Books\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cross\-reference\-authors
Criar referências cruzadas na secção de autores para livros com múltiplos autores. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3,EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug\-pipeline
Guarda o resultado, na pasta especificada, dos diferentes estágios da cadeia de conversão. Será útil se não tiver a certeza onde é que está a ocorrer o erro do processo de conversão. Predefinição: \fB\(aq\fPNone\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclude\-genre
Expressão regular descrevendo etiquetas a excluir como géneros. Predefinição: \fB\(aq\fP[.+]|^+$\fB\(aq\fP exclui etiquetas com colchetes, por ex. \fB\(aq\fP[Projeto Gutenberg]\fB\(aq\fP, e ainda \fB\(aq\fP+\fB\(aq\fP, a etiqueta predefinida para os livros lidos. Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclusion\-rules
Especifica as regras usadas para excluir livros do catálogo gerado. O modelo para uma regra de exclusão é (\fB\(aq\fP<rule name>\fB\(aq\fP,\fB\(aq\fPTags\fB\(aq\fP,\fB\(aq\fP<comma\-separated list of tags>\fB\(aq\fP) ou (\fB\(aq\fP<rule name>\fB\(aq\fP,\fB\(aq\fP<custom column>\fB\(aq\fP,\fB\(aq\fP<pattern>\fB\(aq\fP). Por exemplo: ((\fB\(aq\fPLivros arquivados\fB\(aq\fP,\fB\(aq\fP#status\fB\(aq\fP,\fB\(aq\fPArquivado\fB\(aq\fP),) irá excluir um livro com um valor de \fB\(aq\fPArquivado\fB\(aq\fP na coluna personalizada \fB\(aq\fPstatus\fB\(aq\fP\&. Quando estiverem definidas várias regras serão aplicadas todas as regras. Predefinição:  \fB\(dq\fP((\fB\(aq\fPCatalogs\fB\(aq\fP,\fB\(aq\fPTags\fB\(aq\fP,\fB\(aq\fPCatalog\fB\(aq\fP),)\fB\(dq\fP Aplica\-se aos formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-authors
Incluir a secção \fB\(aq\fPAutores\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-descriptions
Incluir a secção \fB\(aq\fPDescrição\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-genres
Incluir a secção \fB\(aq\fPGéneros\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-recently\-added
Incluir a secção \fB\(aq\fPRecentemente adicionado\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-series
Incluir a secção \fB\(aq\fPSéries\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-generate\-titles
Incluir a secção \fB\(aq\fPTítulos\fB\(aq\fP no catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-genre\-source\-field
Campo fonte para a secção \fB\(aq\fPGéneros\fB\(aq\fP\&. Predefinição: \fB\(aq\fPEtiquetas\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-header\-note\-source\-field
Campo personalizado que contém texto de notas para inserir no cabeçalho \fB\(dq\fPDescrição\fB\(dq\fP\&. Predefinição: \fB\(aq\fP\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-merge\-comments\-rule
#<custom field>:[before|after]:[True|False] especificando:  <custom field> Campo personalizado contendo notas para fundir com os comentários  [before|after] Colocação de notas em relação aos comentários  [True|False] \- Uma linha horizontal é inserida entre notas e comentários Predefinição: \fB\(aq\fP::\fB\(aq\fP Aplica\-se a formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-profile
Especifica um perfil de saída para um dispositivo. Em alguns casos, um perfil de saída é necessário para otimizar o catálogo para um dispositivo específico. Por exemplo, \fB\(aq\fPkindle\fB\(aq\fP ou \fB\(aq\fPkindle_dx\fB\(aq\fP cria um índice com secções e artigos. Predefinição: \fB\(aq\fPNone\fB\(aq\fP Aplica\-se aos formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-prefix\-rules
Especifica as regras usadas para incluir prefixos que indiquem livros de leitura, itens de lista de desejos e outros prefixos especificados pelo utilizador. O modelo para uma regra de prefixo é (\fB\(aq\fP<rule name>\fB\(aq\fP,\fB\(aq\fP<source field>\fB\(aq\fP,\fB\(aq\fP<pattern>\fB\(aq\fP,\fB\(aq\fP<prefix>\fB\(aq\fP). Quando forem definidas várias regras será usada a primeira regra correspondente. Predefinição: \fB\(dq\fP((\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))\fB\(dq\fP Aplica\-se a formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-preset
Utilizar um nome predefinido criado com a IGU do construtor de catálogo. Uma predefinição especifica todas as configurações para construir um catálogo. Predefinição: \fB\(aq\fPNone\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-thumb\-width
Dica sobre o tamanho (em pol.) para as capas de livros no catálogo. Faixa: 1.0 \- 2.0 Predefinição: \fB\(aq\fP1.0\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.INDENT 0.0
.TP
.B \-\-use\-existing\-cover
Substituir uma capa existente quando gerar o catálogo. Predefinição: \fB\(aq\fPFalse\fB\(aq\fP Aplica\-se a: formatos de saída AZW3, EPUB, MOBI
.UNINDENT
.SH SAVED_SEARCHES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb saved_searches [opções] (list|add|remove)
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Gerir as pesquisas guardadas armazenadas nesta base de dados.
Se tentar adicionar uma consulta com um nome que já exista, este será substituído.
.sp
Sintaxe para adicionar:
.sp
calibredb \fBsaved_searches\fP add search_name search_expression
.sp
Sintaxe para remover:
.sp
calibredb \fBsaved_searches\fP remove search_name
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.SH ADD_CUSTOM_COLUMN
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb add_custom_column [options] label name datatype
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Cria uma coluna personalizada. LABEL é o nome amigável da coluna para a máquina. Não pode conter espaços ou dois pontos.
NAME é o nome amigável da coluna para humanos.
DATATYPE pode ser um dos seguintes: bool, comments, composite, datetime, enumeration, float, int, rating, series, text
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-display
Um dicionário de opções para personalizar a forma como os dados nesta coluna serão interpretados. Esta é uma string JSON. Para colunas de enumeração, use \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 Existem muitas opções que podem ir para as opções de variáveis de exibição. As opções por tipo de coluna são: 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  A melhor maneira de encontrar combinações válidas é criar uma coluna personalizada do tipo apropriado na GUI e em seguida olhar para o backup OPF de um livro (assegure\-se que um novo OPF foi criado da coluna foi acrescentado). Vai ver o JSON da \fB\(dq\fPexibição\fB\(dq\fP para a nova coluna em OPF.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-is\-multiple
Esta coluna armazena etiquetas como dados (ex. múltiplos valores separados por vírgulas). Só se aplica caso o tipo de dados seja de texto.
.UNINDENT
.SH CUSTOM_COLUMNS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb custom_columns [opções]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Lista as colunas personalizadas disponíveis. Mostra rótulos de colunas e os ID.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-details, \-d
Mostrar detalhes para cada coluna.
.UNINDENT
.SH REMOVE_CUSTOM_COLUMN
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb remove_custom_column [opções] etiquetas
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Remover o campo personalizado com o rótulo especificado.
Pode ver quais os campos personalizados disponíveis com o comando custom_columns.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-force, \-f
Não solicitar confirmação
.UNINDENT
.SH SET_CUSTOM
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb set_custom [opções] valor ID coluna
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Define o conteúdo de um coluna personalizada para o livro identificado pelo ID.
Pode obter uma lista dos ID usando o comando search.
Pode obter uma lista de colunas personalizadas usando o comando custom_columns.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-append, \-a
Se a coluna armazena valores múltiplos, adicione os valores especificados aos já existentes em vez de os substituir.
.UNINDENT
.SH RESTORE_DATABASE
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb restore_database [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Restaurar esta base de dados a partir dos metadados armazenados nos ficheiros OPF em cada pasta da biblioteca do Calibre. Isto é útil apenas se o seu ficheiro metadata.db tiver sido corrompido.
.sp
AVISO: Este comando regenera completamente a sua base de dados. Vai perder todas as pesquisas guardadas, categorias do utilizador, conectores, preferências de conversão por livro e receitas personalizadas. Os metadados restaurados serão tão exatos quanto os encontrados nos ficheiros OPF.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-really\-do\-it, \-r
Executar efetivamente a recuperação. O comando não irá ser executado se esta opção não for especificada.
.UNINDENT
.SH CHECK_LIBRARY
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb check_library [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Executar algumas verificações no sistema de ficheiros representando uma biblioteca. Os relatórios são invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-csv, \-c
Saída em CSV
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore_extensions, \-e
Lista separada por vírgulas de extensões a ignorar: Predefinição: todas
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore_names, \-n
Lista separada por vírgulas de nomes a ignorar: Predefinição: todos
.UNINDENT
.INDENT 0.0
.TP
.B \-\-report, \-r
Lista separada por vírgulas de relatórios: Predefinição: todos
.UNINDENT
.INDENT 0.0
.TP
.B \-\-vacuum\-fts\-db
Esvaziar a base de dados de pesquisa em texto integral. Dependendo do tamanho da base de dados isto pode ser muito lento e consumir muita memória.
.UNINDENT
.SH LIST_CATEGORIES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb list_categories [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Produzir um relatório das informações da categoria na base de dados. A
informação é equivalente à que é mostrada no navegador de conteúdos.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-categories, \-r
Lista separada por vírgulas de categorias de limitadores de pesquisa. Predefinição: tudo
.UNINDENT
.INDENT 0.0
.TP
.B \-\-csv, \-c
Saída em CSV
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dialect
O tipo de ficheiro CSV a criar. Opções: excel, excel\-tab, unix
.UNINDENT
.INDENT 0.0
.TP
.B \-\-item_count, \-i
Na saída apresentar apenas o número de itens numa categoria em vez da contagem por item dentro de cada categoria
.UNINDENT
.INDENT 0.0
.TP
.B \-\-width, \-w
A largura máxima de uma linha no ficheiro de destino. A predefinição será detetar o tamanho do ecrã.
.UNINDENT
.SH BACKUP_METADATA
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb backup_metadata [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Cópia de segurança dos metadados armazenados na base de dados em ficheiros OPF individuais em cada diretório de livros. Normalmente isto acontece automaticamente, mas pode executar este comando para forçar uma recriação dos ficheiros OPF, com a opção \-\-all.
.sp
Note que normalmente não há necessidade de fazer isto, pois os ficheiros OPF são copiados automaticamente sempre que os metadados sejam alterados.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-all
Por norma, este comando só funciona com livros que tenham ficheiros OPF antiquados. Esta opção faz com que funcione com todos os livros.
.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
Criar um \fBclone\fP da biblioteca atual. Isto cria uma nova biblioteca, vazia, mas que contém as mesmas colunas personalizadas, bibliotecas virtuais e outras configurações da biblioteca atual.
.sp
A biblioteca clonada não contém livros. Se quiser criar uma cópia completa, incluindo todos os livros, use as ferramentas do sistema operativo para copiar a pasta da biblioteca.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.SH EMBED_METADATA
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb embed_metadata [opções] book_id
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Atualiza os metadados nos ficheiros atuais dos livros existentes na biblioteca do Calibre a partir dos metadados guardados na base de dados do Calibre.
Normalmente, os metadados são atualizados apenas quando se exportam ficheiros a partir do Calibre, donde este comando é útil quando pretende que os ficheiros sejam atualizados na pasta onde estão guardados. Note que diferentes formatos de ficheiro suportam diferentes quantidades de metadados. Pode usar o valor especial \(aqall\(aq para o parâmetro book_id de modo a atualizar os metadados em todos os livros. Pode também especificar múltiplos ID de livros separando\-os com espaços ou usando gamas de ID, separados por hífenes. Por exemplo: calibredb \fBembed_metadata\fP 1 2 10\-15 23
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-only\-formats, \-f
Atualizar metadados apenas em ficheiros de formato especifico. Especifique\-o vários vezes para vários formatos. Por definição, todos os formatos são atualizados.
.UNINDENT
.SH SEARCH
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb search [opções] expressão_de_pesquisa
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Procura nesta biblioteca o termo de pesquisa especificado, devolvendo uma lista de ID de livros, separada por virgulas, que correspondem ao critério de pesquisa.
O formato de saída é útil como fonte de dados para outros comandos que aceitem uma lista de ID como valor de entrada.
.sp
A expressão de pesquisa pode ser qualquer das possíveis construções da poderosa linguagem de queries de pesquisa do Calibre, como por exemplo: calibredb \fBsearch\fP author:asimov \(aqtitle:\(dqi robot\(dq\(aq
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-limit, \-l
O número máximo de resultados a mostrar. A predefinição é todos os resultados.
.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 passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-indexing\-speed
A velocidade da indexação. Escolha entre Rápida para indexação rápida que utilizará todos os recursos do seu computador ou, Lenta para indexação menos intensiva a nível dos recursos. Note que a velocidade é redefinida para lenta depois de cada invocação.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-wait\-for\-completion
Aguarde até que todos os livros sejam indexados. Periodicamente será mostrado o progresso da ação
.UNINDENT
.SH FTS_SEARCH
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
calibredb fts_search [opções] expressão de pesquisa
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Executa uma pesquisa de texto integral em toda a biblioteca ou num seu subconjunto.
.sp
Sempre que passar argumentos para o calibredb que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq
.INDENT 0.0
.TP
.B \-\-do\-not\-match\-on\-related\-words
Encontrar apenas palavras exatas, e não palavras relacionadas. Dessa forma, \fB\(aq\fPcorrigir\fB\(aq\fP não irá encontrar \fB\(aq\fPcorrigindo\fB\(aq\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-include\-snippets
Incluir trechos do texto à volta de cada correspondência. Note que isto torna a pesquisa muito mais lenta.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-indexing\-threshold
A parte da biblioteca que deve ser indexada antes que a pesquisa seja permitida, tal como uma percentagem. Valor predefinido é 90
.UNINDENT
.INDENT 0.0
.TP
.B \-\-match\-end\-marker
O marcador usado para indicar o final de uma palavra correspondente dentro de um trecho
.UNINDENT
.INDENT 0.0
.TP
.B \-\-match\-start\-marker
O marcador usado para indicar o início de uma palavra correspondente dentro de um trecho
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-format
O formato de saída dos resultados da pesquisa. Use \fB\(dq\fPtext\fB\(dq\fP para texto simples ou \fB\(dq\fPjson\fB\(dq\fP para saída JSON.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-restrict\-to
Restringir os livros pesquisados, seja usando uma expressão de pesquisa ou por ID. Por exemplo: ids:1,2,3 para restringir por ID ou search:tag:foo para restringir a livros com a etiqueta \fB\(aq\fPfoo\fB\(aq\fP\&.
.UNINDENT
.SH AUTHOR
Kovid Goyal
.SH COPYRIGHT
Kovid Goyal
.\" Generated by docutils manpage writer.
.