From 5c53fb86e3fa725b87c1c4e9a3711216e4e6097d Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Thu, 12 Mar 2015 12:52:56 +0530 Subject: [PATCH] Update section on reading metadata from filenames --- manual/gui.rst | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/manual/gui.rst b/manual/gui.rst index 4df3ef12c7..1bce23b545 100644 --- a/manual/gui.rst +++ b/manual/gui.rst @@ -441,8 +441,6 @@ calibre allows you to save a frequently used search under a special name and the Now you can access your saved search in the Tag Browser under "Searches". A single click will allow you to reuse any arbitrarily complex search easily, without needing to re-create it. -.. _config_filename_metadata: - Virtual Libraries ------------------- @@ -452,14 +450,26 @@ partition your large collection of books into smaller, manageable chunks. To learn how to create and use virtual libraries, see the tutorial: :ref:`virtual_libraries`. +.. _config_filename_metadata: + Guessing metadata from file names -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -In the :guilabel:`Add/Save` section of the configuration dialog, you can specify a regular expression that calibre will use to try and guess metadata from the names of ebook files -that you add to the library. The default regular expression is:: +------------------------------------ + +Normally, calibre reads metadata from inside the book file. However, it can +be configured to read metadata from the file name instead, via +:guilabel:`Preferences->Adding Books->Read metadata from file contents`. + +You can also control how metadata is read from the filename using regular +expressions (see :doc:`regexp`). In the :guilabel:`Adding Books` section of +the configuration dialog, you can specify a regular expression that calibre +will use to try and guess metadata from the names of ebook files that you add +to the library. The default regular expression is:: title - author -i.e., it assumes that all characters up to the first ``-`` are the title of the book and subsequent characters are the author of the book. For example, the filename:: +that is, it assumes that all characters up to the first ``-`` are the title of +the book and subsequent characters are the author of the book. For example, the +filename:: Foundation and Earth - Isaac Asimov.txt