Provided by: calibre_4.99.4+dfsg+really4.12.0-1ubuntu1_all
NAME
calibredb - calibredb calibredb command [选项] [参数] calibredb is the command line interface to the calibre database. It has several sub-commands, documented below. calibredb 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 calibre-server program or in the main calibre program click Connect/share → Start Content server. Since calibredb can make changes to your calibre libraries, you must setup authentication on the server first. There are two ways to do that: • If you plan to connect only to a server running on the same computer, you can simply use the --enable-local-write 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. • If you want to enable access over the internet, then you should setup user accounts on the server and use the --username and --password options to calibredb to give it access. You can setup user authentication for calibre-server by using the --enable-auth option and using --manage-users 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. To connect to a running Content server, pass the URL of the server to the --with-library option, see the documentation of that option for details and examples. • 全局选项 • list • add • 从目录中添加 • remove • add_format • remove_format • show_metadata • set_metadata • export • catalog • EPUB 个选项 • saved_searches • add_custom_column • custom_columns • remove_custom_column • set_custom • restore_database • check_library • list_categories • backup_metadata • clone • embed_metadata • search
全局选项
--help, -h 显示此帮助信息并退出 --library-path, --with-library calibre 库的路径。默认是使用存储在设置中的路径。您还可以连接到 calibre 内容服务器,以便在远程库上执行操作。为此使用表单的URL:‐ http://hostname:port/#library_id 例如,‐ http://localhost:8080/#mylibrary。library_id是要在内容服务器上连接的库的库id。您可 以使用特殊的library_id值来获得服务器上可用库id的列表。有关如何通过内容服务器设置访 问的详细信息,请参阅https://manual.calibre-ebook.com/generated/en/calibredb.html。 --password 连接到 calibre 内容服务器的密码。若要从标准输入读取密码,请使用特殊值:<stdin>。若 要从文件读取密码,请使用<f:/path/to/file>(即<f:后跟文件的完整路径和尾随>)。上面的 角括号是必需的,记住要脱掉它们,或者使用引号。 --username 用于连接到内容服务器的用户名 --version 显示程序版本号并退出
LIST
calibredb list [选项] 列出 calibre 数据库中可用书籍。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --ascending 升序排列结果 --fields, -f 在列出数据库中书籍时要显示的字段。应该是逗号分隔的字段列表。 可用字段: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid 默认值:title,authors。特殊字段“all”可用于选择所有字段。除了 上述内置字段之外,自定义字段还等价于*field_name,例如,对于自定义字段#rating,使用 名称:*rating --for-machine 以 JSON 格式输出,更适合机器解析。忽略每行长度和分隔符选项。 --limit 结果显示的最大数目。默认:全部 --line-width, -w 输出中单行宽度最大值。默认检测屏幕大小。 --prefix 所有文件路径前缀。默认为书库目录绝对路径。 --search, -s 通过搜索请求过滤结果。对于每个搜索请求的格式,请参见用户手册中搜索相关的文档。默认 为不做过滤。 --separator 分隔各个字段的字符串。默认是空格。 --sort-by 排序结果的字段。 可用字段:author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid 默认值:id
ADD
calibredb add [选项] file1 file2 file3 ... 添加指定文件为书籍到数据库。你可以指定目录,请查看下面目录相关选项。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --authors, -a 设置已添加书籍的作者 --cover, -c 设置已添加书籍的封面路径 --duplicates, -d 即使书籍已经存在于数据库仍然添加。通过书名进行区分。 --empty, -e 添加空白书籍(无格式书籍) --identifier, -I 设置这本书的标识符,例如 -I asin:XXX -I isbn:YYY --isbn, -i 设置已添加书籍的 ISBN --languages, -l 逗号分割的语言列表(最好使用 ISO639 语言代码,即使有些语言名称也能识别) --series, -s 为添加的书籍设置丛书 --series-index, -S 为添加的书籍设置丛书编号 --tags, -T 设置已添加书籍的标签 --title, -t 设置已添加书籍的标题 从目录中添加 控制从目录中添加图书的选项。默认情况下,只添加具有已知电子书文件类型扩展名的文件。 --add 文件名 (glob) 模式,与此模式匹配的文件将在扫描文件目录时添加,即使它们不是已知的电 子书文件类型。可以为多个模式多次指定。 --ignore 文件名 (glob) 模式,与此模式匹配的文件将在扫描文件目录时被忽略。可以为多个模式多次 指定。例如:*.pdf将忽略所有PDF文件。 --one-book-per-directory, -1 假设每个目录只有一本逻辑书籍,而所有文件均是该书的不同格式电子书 --recurse, -r 递归处理目录
REMOVE
calibredb remove ids 从数据库移除指定 id 的书籍。ids 应为以逗号分隔的 id 号列表(你可以使用搜索命令来获得 id 号)。例如,23,34,57-85(如果指定一个区间,该区间的最后一个数字不会被包括在内)。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --permanent 不使用回收站
ADD_FORMAT
calibredb add_format [options] id ebook_file 用 ebook_file将电子书添加到由id标识的逻辑书的可用格式中。如果格式已经存在,则替换它,除非 指定了不替换选项。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --dont-replace 如果格式已经存在不要替换它
REMOVE_FORMAT
calibredb remove_format [选项] id fmt 从ID识别的逻辑书中删除fmt格式。你可以通过使用搜索命令获取ID。fmt应该是形如LRF或TXT或EPUB的 一个文件扩展名。如果逻辑书没有fmt可用则什么也不做。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces"
SHOW_METADATA
calibredb show_metadata [options] id 显示在 calibre 数据库中存储的id所标识的图书的元数据。 id是来自搜索命令的id号。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --as-opf 以 OPF 表单(XML)打印元数据
SET_METADATA
calibredb set_metadata [options] id [/path/to/metadata.opf] 根据OPF文件的metadata.opf设置存储在 calibre 数据库中的用于标识图书的元数据。 id是来自搜索 命令的id号。您可以通过使用--as-opf切换到show_metadata命令来快速 了解OPF格式。还可以 用--field选项设置各个字段的元数据。如果使用--field选项则 不需要指定OPF文件。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --field, -f 设置字段。格式是field_name:value,例如:--field tags:tag1,tag2。使 用:option:--list-fields`来获取所有字段名称的列表。你可以多次指定此选项来设置多个字 段。注意:对于语言,你必须使用ISO639语言代码(例如en代表英文,fr代表法语等)。对于 标识符,语法是:option:--field` identifiers:isbn:XXXX,doi:YYYYY。对于布尔(是/否)字段 使用真与假或是和否。 --list-fields, -l 列出可用于:option: ` --field`选项的元数据字段名称
EXPORT
calibredb export [options] ids 导出指定 id 的书籍至文件系统。ids 为以逗号分隔的列表。 导出操作将保存书籍的所有格式,以及 其封面和元数据(保存 至一个 opf 文件)。你可以使用搜索命令来获得 id 号。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --all 导出数据库中所有的书籍,忽略 id 列表。 --dont-asciiize 一般来说,calibre 为文件名将所有非英文字符转换为英文对应字符。警告:若关闭此项,你 可能保存文件出错,取决于你的文件系统是否支持 unicode。 选定此项将关闭此操作。 --dont-save-cover 一般来说,calibre 将把封面保存为单独文件,和原始电子书文件分开保存。 选定此项将关闭 此操作。 --dont-update-metadata 一般来说,calibre 将基于 calibre 书库升级存储所存文件的元数据。这使保存到磁盘变慢一 些。 选定此项将关闭此操作。 --dont-write-opf 一般来说,calibre 将会把元数据写入单独的 OPF 文件,和原始电子书文件分开保存。 选定 此项将关闭此操作。 --formats 每本书籍的格式列表,逗号间隔。默认保存所有可用格式。 --progress 报告进展 --replace-whitespace 下划线替换空格。 --single-dir 导出所有书籍到单个目录 --template 模板用来控制保存到设备的文件的文件名和目录结构。默认 是"{author_sort}/{title}/{title} - {authors}",它将把书籍保存到包含标题和作者的文件 名的每个作者目录中。可用的控制项是: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title} --timefmt 显示日期的格式。%d - 天, %b - 月, %m - 月数, %Y - 年。默认是: %b, %Y --to-dir 导出书籍到指定目录。默认为 . --to-lowercase 将路径转为小写。
CATALOG
calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options] 按路径/到/目的扩展指定格式输出目录。 选项控制如何在生成的目录输出中显示条目。 注意,不同的 目录格式支持不同的选项集。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --ids, -i 逗号分割数据库 ID 到书目的列表。 一旦声明,则忽略 --search 默认值:全部 --search, -s 为搜索查询过滤结果。搜索查询格式请参见用户手册中搜索相关内容。默认:不过滤 --verbose, -v 显示详细输出信息。有利调试 EPUB 个选项 --catalog-title 生成目录的标题用作元数据标题。 默认值:'My Books' 适用于:AZW3,ePub,MOBI 等输出格 式 --cross-reference-authors 为具有多个作者的书籍在作者节中创建交叉引用。 默认值: 'False' 适用于: AZW3, EPUB, MOBI输出格式 --debug-pipeline 在转换过程的不同阶段分别保存输出到指定目录。 默认: 'None' 适用于: AZW3, EPUB, MOBI 的输出格式 --exclude-genre 描述以排除类型的标签正则表达式。 默认值: '[.+]|^+$' 不包括括号内的标签,例如 '[Project Gutenberg]', 和 '+', 默认的用于阅读书籍的标签。 适用于: AZW3, EPUB, MOBI 输出格式 --exclusion-rules Specifies the rules used to exclude books from the generated catalog. The model for an exclusion rule is either ('<rule name>','Tags','<comma-separated list of tags>') or ('<rule name>','<custom column>','<pattern>'). For example: (('Archived books','#status','Archived'),) will exclude a book with a value of 'Archived' in the custom column 'status'. When multiple rules are defined, all rules will be applied. Default: "(('Catalogs','Tags','Catalog'),)" Applies to: AZW3, EPUB, MOBI output formats --generate-authors 目录中包括“作者”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --generate-descriptions 目录中包括“描述”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --generate-genres 目录中包括“类型”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --generate-recently-added 目录中包括“最近添加”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --generate-series 目录中包括“丛书系列”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --generate-titles 目录中包括“标题”部分。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式 --genre-source-field “类型”部分的源字段。 默认值: '标签' 适用于: AZW3, EPUB, MOBI 输出格式 --header-note-source-field 包含要在描述标头中插入的注释文本的自定义域。 默认值: '' 适用于: AZW3, EPUB, MOBI输 出格式 --merge-comments-rule #<custom field>:[before|after]:[True|False] 指定: <custom field> 包含与注释合并的 注释的自定义字段 [before|after] 关于注释的注释放置位置 [True|False] - 在注意和注 释之间插入水平规则 默认值: '::' 适用于: AZW3, EPUB, MOBI 输出格式 --output-profile 指定输出配置文件。在某些情况下,输出配置文件用于优化某些设备的书目分类。例 如,'kindle' 或 'kindle_dx' 以章节和文章的方式来生成目录结构。默认:'None' 适用 于:AZW3、EPUB、MOBI 等输出格式 --prefix-rules Specifies the rules used to include prefixes indicating read books, wishlist items and other user-specified prefixes. The model for a prefix rule is ('<rule name>','<source field>','<pattern>','<prefix>'). When multiple rules are defined, the first matching rule will be used. Default: "(('Read books','tags','+','✓'),('Wishlist item','tags','Wishlist','×'))" Applies to: AZW3, EPUB, MOBI output formats --preset 使用GUI目录生成器创建的命名预设。 预设指定用于构建目录的所有设置。 默认值: 'None' 适用于: AZW3, EPUB, MOBI 输出格式 --thumb-width 目录中书籍封面的大小提示(英寸)。 范围: 1.0 - 2.0 默认值: '1.0' 适用于: AZW3, EPUB, MOBI 输出格式 --use-existing-cover 在生成目录时替换现有的封面。 默认值: 'False' 适用于: AZW3, EPUB, MOBI 输出格式
SAVED_SEARCHES
calibredb saved_searches [options] (list|add|remove) 管理存储在该数据库中的保存搜索。 如果尝试添加已经存在的一个名称查询, 则它将被替换。 添加语法: calibredb saved_searches add search_name search_expression 删除语法: calibredb saved_searches remove search_name 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces"
ADD_CUSTOM_COLUMN
calibredb add_custom_column [options] label name datatype 创建一个自定义的栏目,栏目名为你自定义的名称,不能包含空格或冒号。数据类型可为:bool, comments, composite, datetime, enumeration, float, int, rating, series, text 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --display 一个自定义选项如何解释该列中数据的字典。这是一个JSON字符串。对于枚举列,使用 --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}" 有许多选项可以进入显示变 量,按列类型的选项是: 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 找到适当组合的最好方法是在GUI中创建适当类型的自定义列,然后查看图书 的备份OPF(确保自从添加该列以来已经创建了新的OPF)。在OPF中的新列中,你将看到JSON的 “显示”。 --is-multiple 此列存储类似数据的标签(即多个逗号分隔值)。仅当数据类型为文本时才适用。
CUSTOM_COLUMNS
calibredb custom_columns [options] 列出可用的自定义列。显示列标签和ids。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --details, -d 每栏显示细节。
REMOVE_CUSTOM_COLUMN
calibredb remove_custom_column [options] label 用标签删除的自定义列标识。可以使用custom_columns command命令查看可用列 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --force, -f 无需确认
SET_CUSTOM
calibredb set_custom [options] column id value 为 id 标识的书设置自定义列的值。 您可以使用搜索命令获取 id 列表。 您可以使用 custom_columns 命令获取自定义列名的列表。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --append, -a 如果栏存有多个值,将指定值附加到已有值之后,而非覆盖。
RESTORE_DATABASE
从calibre书库每个目录中OPF文件含有的元数据恢复此数据库,如果你的metadata.db文件已损坏,此方法很有用。 警告:此命令会完全重新生成数据库。你会丢失所有已保存的搜索,用户类别,插板,已保存的每本书 的版本设置和自定义配方。恢复的元数据和OPF文件中的一样准确。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --really-do-it, -r 确认做恢复。除非指定了此选项,否则命令不会运行。
CHECK_LIBRARY
calibredb check_library [options] 对表示库的文件系统执行一些检查。生成报告是invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --csv, -c 以 CSV 输出 --ignore_extensions, -e 逗号分隔的扩展列表将被忽略。 默认值:全部 --ignore_names, -n 逗号分隔的名字列表将被忽略。 默认值:全部 --report, -r 逗号分隔的报表列表。 默认值: 全部
LIST_CATEGORIES
calibredb list_categories [options] 在数据库中生成类别信息的报告。信息等同于标签窗格中显示的内容。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --categories, -r 逗号分隔类别列表查找名称。默认值:全部 --csv, -c 以 CSV 输出 --dialect 产生CSV文件的类型。选择:excel, excel-tab --item_count, -i 只输出类别中的项目数目,而不是类别内的每项计数 --width, -w 输出中单行宽度最大值。默认检测屏幕大小。
BACKUP_METADATA
calibredb backup_metadata [选项] 单独备份元数据储存到数据库到每个 OPF 文件书库。 此项默认自动发生,但是你可以运行此命令来重 新生成 OPF 文件,还可以用 --all 选项. Note that there is normally no need to do this, as the OPF files are backed up automatically, every time metadata is changed. 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --all 通常,此命令只对过时的OPF文件书籍进行操作。这个选项可使它在所有的书籍上运行。
CLONE
calibredb clone path/to/new/library 创建当前图书库的克隆。创建一个全新的,没有书籍的图书库,和之前的图书库保持同样的定制的栏 目,虚拟图书库,以及其他设置。 这个克隆的图书库不包含任何书籍。如果你想要一个完整的复 制,包括所有的书籍,那么,你只需要用系统提供的拷贝工具,拷贝整个图书库的目录就行了。 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces"
EMBED_METADATA
calibredb embed_metadata [options] book_id 从 calibre 数据库中的元数据更新存储在 calibre 库中的实际图书文件中的元数据。 通常,只有从 calibre 导出文件时才更新元数据,如果希望文件就地更新,则此命 令很有用。请注意,不同的文件 格式支持不同数量的元数据。你可以使用book_id 的特殊值“all”来更新所有书籍中的元数据。还可以 指定许多由空间分隔的书籍ID 和由连字符分隔的ID范围。例如:calibredb embed_metadata 1 2 10-15 23 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --only-formats, -f 只更新指定格式的文件中的元数据。为多种格式指定多次。默认情况下,所有格式都会更新。
SEARCH
calibredb search [options] search expression Search the library for the specified search term, returning a comma separated list of book ids matching the search expression. The output format is useful to feed into other commands that accept a list of ids as input. The search expression can be anything from calibre's powerful search query language, for example: author:asimov title:robot 每当向具有它们自己空间的calibredb传递参数时,用引号括起这些参数。例如: "/some path/with spaces" --limit, -l 返回的最大结果数。默认是所有结果。
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal