string changes

This commit is contained in:
Kovid Goyal 2021-03-10 10:28:20 +05:30
parent 3a361db030
commit baa6524c0f
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
6 changed files with 25 additions and 25 deletions

View File

@ -329,7 +329,7 @@
:: bug fixes :: bug fixes
- [1904310] Windows: Fix calibre portable launcher not working correctly from root directory in calibre 5.5 - [1904310] Windows: Fix calibre portable launcher not working correctly from root folder in calibre 5.5
- [1904505] macOS: Fix rendering of space after punctuation incorrect in Big Sur - [1904505] macOS: Fix rendering of space after punctuation incorrect in Big Sur
@ -418,7 +418,7 @@
:: new features :: new features
- [1900761] Windows: Allow adding of books to calibre from directories whose path length is larger than 260 characters - [1900761] Windows: Allow adding of books to calibre from folders whose path length is larger than 260 characters
- Tag browser: Add an option in Preferences->Look & feel->Tag browser to allow the tag browser to get keyboard focus - Tag browser: Add an option in Preferences->Look & feel->Tag browser to allow the tag browser to get keyboard focus
@ -460,7 +460,7 @@
- [1901957] Conversion: Fix a regression in calibre 5 that broke processing of some PDB files with images. - [1901957] Conversion: Fix a regression in calibre 5 that broke processing of some PDB files with images.
- [1901278] Conversion: Fix regression in calibre 5 in the handling of @import() rules in stylesheets that import from directories above themselves. - [1901278] Conversion: Fix regression in calibre 5 in the handling of @import() rules in stylesheets that import from folders above themselves.
- [1901232 1901230] Content server: Fix various controls on the book details page not working when viewing a random book. - [1901232 1901230] Content server: Fix various controls on the book details page not working when viewing a random book.
@ -1508,7 +1508,7 @@ If you turn on dark mode under the Windows Settings->Personalisation->Colors and
- [1853232] Viewer: Fix opening .txt files in the standalone viewer leaving behind a temporary index.html file in the folder of the txt file. - [1853232] Viewer: Fix opening .txt files in the standalone viewer leaving behind a temporary index.html file in the folder of the txt file.
- Linux: Make some cache removal code robust against un-decodeable filenames in the cache directories - Linux: Make some cache removal code robust against un-decodeable filenames in the cache folders
- [1851933] Viewer: Fix scrolling of panels in preferences causing artifacts. - [1851933] Viewer: Fix scrolling of panels in preferences causing artifacts.
@ -1752,7 +1752,7 @@ If you turn on dark mode under the Windows Settings->Personalisation->Colors and
- Comments editor: Workaround for Qt converting ids into anchors - Comments editor: Workaround for Qt converting ids into anchors
- Possible workaround for some Windows machines where the viewer is getting access denied errors while renaming a directory - Possible workaround for some Windows machines where the viewer is getting access denied errors while renaming a folder
- Viewer: When there is empty text for an header footer section render it as blank instead of moving the remaining sections to the left - Viewer: When there is empty text for an header footer section render it as blank instead of moving the remaining sections to the left

View File

@ -63,14 +63,14 @@ the various transforms will be applied to the XHTML and then the *Output plugin*
create the EPUB file, automatically generating all metadata, Table of Contents, et cetera. create the EPUB file, automatically generating all metadata, Table of Contents, et cetera.
You can see this process in action by using the debug option |dbgi|. Just specify the path to You can see this process in action by using the debug option |dbgi|. Just specify the path to
a directory for the debug output. During conversion, calibre will place the XHTML generated by a folder for the debug output. During conversion, calibre will place the XHTML generated by
the various stages of the conversion pipeline in different sub-folders. the various stages of the conversion pipeline in different sub-folders.
The four sub-folders are: The four sub-folders are:
.. table:: Stages of the conversion pipeline .. table:: Stages of the conversion pipeline
========== ============= ========== =============
Directory Description Folder Description
========== ============= ========== =============
input This contains the HTML output by the Input plugin. Use this to debug the Input plugin. input This contains the HTML output by the Input plugin. Use this to debug the Input plugin.
parsed The result of pre-processing and converting to XHTML the output from the Input plugin. Use to debug structure detection. parsed The result of pre-processing and converting to XHTML the output from the Input plugin. Use to debug structure detection.

View File

@ -23,14 +23,14 @@ use *plugins* to add functionality to calibre.
Environment variables Environment variables
----------------------- -----------------------
* ``CALIBRE_CONFIG_DIRECTORY`` - sets the directory where configuration files are stored/read. * ``CALIBRE_CONFIG_DIRECTORY`` - sets the folder where configuration files are stored/read.
* ``CALIBRE_TEMP_DIR`` - sets the temporary directory used by calibre * ``CALIBRE_TEMP_DIR`` - sets the temporary folder used by calibre
* ``CALIBRE_CACHE_DIRECTORY`` - sets the directory calibre uses to cache persistent data between sessions * ``CALIBRE_CACHE_DIRECTORY`` - sets the folder calibre uses to cache persistent data between sessions
* ``CALIBRE_OVERRIDE_DATABASE_PATH`` - allows you to specify the full path to metadata.db. Using this variable you can have metadata.db be in a location other than the library folder. Useful if your library folder is on a networked drive that does not support file locking. * ``CALIBRE_OVERRIDE_DATABASE_PATH`` - allows you to specify the full path to metadata.db. Using this variable you can have metadata.db be in a location other than the library folder. Useful if your library folder is on a networked drive that does not support file locking.
* ``CALIBRE_DEVELOP_FROM`` - Used to run from a calibre development environment. See :ref:`develop`. * ``CALIBRE_DEVELOP_FROM`` - Used to run from a calibre development environment. See :ref:`develop`.
* ``CALIBRE_OVERRIDE_LANG`` - Used to force the language used by the interface (ISO 639 language code) * ``CALIBRE_OVERRIDE_LANG`` - Used to force the language used by the interface (ISO 639 language code)
* ``CALIBRE_TEST_TRANSLATION`` - Used to test a translation .po file (should be the path to the .po file) * ``CALIBRE_TEST_TRANSLATION`` - Used to test a translation .po file (should be the path to the .po file)
* ``CALIBRE_NO_NATIVE_FILEDIALOGS`` - Causes calibre to not use native file dialogs for selecting files/directories. * ``CALIBRE_NO_NATIVE_FILEDIALOGS`` - Causes calibre to not use native file dialogs for selecting files/folders.
* ``CALIBRE_NO_NATIVE_MENUBAR`` - Causes calibre to not create a native (global) menu on Ubuntu Unity and similar linux desktop environments. The menu is instead placed inside the window, as is traditional. * ``CALIBRE_NO_NATIVE_MENUBAR`` - Causes calibre to not create a native (global) menu on Ubuntu Unity and similar linux desktop environments. The menu is instead placed inside the window, as is traditional.
* ``CALIBRE_USE_SYSTEM_THEME`` - By default, on Linux, calibre uses its own * ``CALIBRE_USE_SYSTEM_THEME`` - By default, on Linux, calibre uses its own
builtin Qt style. This is to avoid crashes and hangs caused by incompatibilities builtin Qt style. This is to avoid crashes and hangs caused by incompatibilities
@ -83,7 +83,7 @@ choose to install calibre.
You should not change the files in this resources folder, as your changes will You should not change the files in this resources folder, as your changes will
get overwritten the next time you update calibre. Instead, go to get overwritten the next time you update calibre. Instead, go to
:guilabel:`Preferences->Advanced->Miscellaneous` and click :guilabel:`Preferences->Advanced->Miscellaneous` and click
:guilabel:`Open calibre configuration folder`. In this configuration directory, create a :guilabel:`Open calibre configuration folder`. In this configuration folder, create a
sub-folder called resources and place the files you want to override in it. sub-folder called resources and place the files you want to override in it.
Place the files in the appropriate sub folders, for example place images in Place the files in the appropriate sub folders, for example place images in
:file:`resources/images`, etc. calibre will automatically use your custom file :file:`resources/images`, etc. calibre will automatically use your custom file
@ -93,7 +93,7 @@ For example, if you wanted to change the icon for the :guilabel:`Remove books`
action, you would first look in the built-in resources folder and see that the action, you would first look in the built-in resources folder and see that the
relevant file is :file:`resources/images/remove_books.png`. Assuming you have an relevant file is :file:`resources/images/remove_books.png`. Assuming you have an
alternate icon in PNG format called :file:`my_remove_books.png` you would save it in alternate icon in PNG format called :file:`my_remove_books.png` you would save it in
the configuration directory as :file:`resources/images/remove_books.png`. All the the configuration folder as :file:`resources/images/remove_books.png`. All the
icons used by the calibre user interface are in :file:`resources/images` and icons used by the calibre user interface are in :file:`resources/images` and
its sub-folders. its sub-folders.
@ -105,7 +105,7 @@ calibre users via calibre's builtin icon theme support, you can easily package
up your icons into a theme. To do so, go to up your icons into a theme. To do so, go to
:guilabel:`Preferences->Miscellaneous->Create icon theme`, select the folder :guilabel:`Preferences->Miscellaneous->Create icon theme`, select the folder
where you have put your icons (usually the :file:`resources/images` folder in where you have put your icons (usually the :file:`resources/images` folder in
the calibre config directory, as described above). Then fill up the theme the calibre config folder, as described above). Then fill up the theme
metadata and click OK. This will result in a ZIP file containing the theme metadata and click OK. This will result in a ZIP file containing the theme
icons. You can upload that to the calibre forum at `Mobileread icons. You can upload that to the calibre forum at `Mobileread
<https://www.mobileread.com/forums/forumdisplay.php?f=166>`_ and then I will <https://www.mobileread.com/forums/forumdisplay.php?f=166>`_ and then I will

View File

@ -186,7 +186,7 @@ If your device appears as a USB disk to the operating system, adding support for
We just need some information from you: We just need some information from you:
* Complete list of e-book formats that your device supports. * Complete list of e-book formats that your device supports.
* Is there a special directory on the device in which all e-book files should be placed? Also does the device detect files placed in sub-folders? * Is there a special folder on the device in which all e-book files should be placed? Also does the device detect files placed in sub-folders?
* We also need information about your device that calibre will collect automatically. First, if your * We also need information about your device that calibre will collect automatically. First, if your
device supports SD cards, insert them. Then connect your device to the computer. In calibre go to :guilabel:`Preferences->Miscellaneous` device supports SD cards, insert them. Then connect your device to the computer. In calibre go to :guilabel:`Preferences->Miscellaneous`
and click the "Debug device detection" button. This will create some debug output. Copy it to a file and click the "Debug device detection" button. This will create some debug output. Copy it to a file
@ -586,10 +586,10 @@ With all this flexibility, it is possible to have calibre manage your author nam
* Press OK, at which point calibre will change the authors in all your books. This can take a while. * Press OK, at which point calibre will change the authors in all your books. This can take a while.
Why doesn't calibre let me store books in my own directory structure? Why doesn't calibre let me store books in my own folder structure?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The whole point of calibre's library management features is that they provide a search and sort based interface for locating books that is *much* more efficient than any possible directory scheme you could come up with for your collection. Indeed, once you become comfortable using calibre's interface to find, sort and browse your collection, you wont ever feel the need to hunt through the files on your disk to find a book again. By managing books in its own directory structure of Author -> Title -> Book files, calibre is able to achieve a high level of reliability and standardization. To illustrate why a search/tagging based interface is superior to folders, consider the following. Suppose your book collection is nicely sorted into folders with the following scheme:: The whole point of calibre's library management features is that they provide a search and sort based interface for locating books that is *much* more efficient than any possible folder scheme you could come up with for your collection. Indeed, once you become comfortable using calibre's interface to find, sort and browse your collection, you wont ever feel the need to hunt through the files on your disk to find a book again. By managing books in its own folder structure of Author -> Title -> Book files, calibre is able to achieve a high level of reliability and standardization. To illustrate why a search/tagging based interface is superior to folders, consider the following. Suppose your book collection is nicely sorted into folders with the following scheme::
Genre -> Author -> Series -> ReadStatus Genre -> Author -> Series -> ReadStatus
@ -673,7 +673,7 @@ then import it on another computer. First let's see how to export the data:
to the previously copied folder. If the computer you are transferring to to the previously copied folder. If the computer you are transferring to
already has a calibre installation, then the :guilabel:`Welcome wizard` wont run. In already has a calibre installation, then the :guilabel:`Welcome wizard` wont run. In
that case, right-click the calibre icon in the toolbar and point it to the that case, right-click the calibre icon in the toolbar and point it to the
newly copied directory. You will now have two calibre libraries on your newly copied folder. You will now have two calibre libraries on your
computer and you can switch between them by clicking the calibre icon on computer and you can switch between them by clicking the calibre icon on
the toolbar. Transferring your library in this manner preserver all your the toolbar. Transferring your library in this manner preserver all your
metadata, tags, custom columns, etc. metadata, tags, custom columns, etc.
@ -771,7 +771,7 @@ only TrueType and OpenType (.ttf and .otf) fonts. Most fonts on macOS systems
are in .dfont format, thus they cannot be embedded. calibre shows only TrueType are in .dfont format, thus they cannot be embedded. calibre shows only TrueType
and OpenType fonts found on your system. You can obtain many such fonts on the and OpenType fonts found on your system. You can obtain many such fonts on the
web. Simply download the .ttf/.otf files and add them to the Library/Fonts web. Simply download the .ttf/.otf files and add them to the Library/Fonts
directory in your home directory. folder in your home folder.
calibre is not starting on Windows? calibre is not starting on Windows?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -959,7 +959,7 @@ The most important thing to backup is the calibre library folder, that contains
You can switch calibre to using a backed up library folder by simply clicking the calibre icon on the toolbar and choosing your backup library folder. A backed up library folder backs up your custom columns and saved searches as well as all your books and metadata. You can switch calibre to using a backed up library folder by simply clicking the calibre icon on the toolbar and choosing your backup library folder. A backed up library folder backs up your custom columns and saved searches as well as all your books and metadata.
If you want to backup the calibre configuration/plugins, you have to backup the config directory. You can find this config directory via :guilabel:`Preferences->Miscellaneous`. Note that restoring configuration directories is not officially supported, but should work in most cases. Just copy the contents of the backup directory into the current configuration directory to restore. If you want to backup the calibre configuration/plugins, you have to backup the config folder. You can find this config folder via :guilabel:`Preferences->Miscellaneous`. Note that restoring configuration folders is not officially supported, but should work in most cases. Just copy the contents of the backup folder into the current configuration folder to restore.
How do I use purchased EPUB books with calibre (or what do I do with .acsm files)? How do I use purchased EPUB books with calibre (or what do I do with .acsm files)?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -294,7 +294,7 @@ them to the EPUB file :file:`myrecipe.epub`. The ``-vv`` option makes
ebook-convert spit out a lot of information about what it is doing. The ebook-convert spit out a lot of information about what it is doing. The
:option:`ebook-convert-recipe-input --test` option makes it download only a couple of articles from at most two :option:`ebook-convert-recipe-input --test` option makes it download only a couple of articles from at most two
feeds. In addition, ebook-convert will put the downloaded HTML into the feeds. In addition, ebook-convert will put the downloaded HTML into the
``debug/input`` directory, where ``debug`` is the directory you specified in ``debug/input`` folder, where ``debug`` is the folder you specified in
the :option:`ebook-convert --debug-pipeline` option. the :option:`ebook-convert --debug-pipeline` option.
Once the download is complete, you can look at the downloaded :term:`HTML` by opening the file :file:`debug/input/index.html` in a browser. Once you're satisfied that the download and preprocessing is happening correctly, you can generate e-books in different formats as shown below:: Once the download is complete, you can look at the downloaded :term:`HTML` by opening the file :file:`debug/input/index.html` in a browser. Once you're satisfied that the download and preprocessing is happening correctly, you can generate e-books in different formats as shown below::

View File

@ -233,7 +233,7 @@ computer/user account, you can also manage users using just the command-line.
You can manage user accounts using the ``--manage-users`` option You can manage user accounts using the ``--manage-users`` option
to the standalone ``calibre-server`` program. Suppose you want to store to the standalone ``calibre-server`` program. Suppose you want to store
the user database in the directory ``/srv/calibre``, then you create it the user database in the folder ``/srv/calibre``, then you create it
by running:: by running::
calibre-server --userdb /srv/calibre/users.sqlite --manage-users calibre-server --userdb /srv/calibre/users.sqlite --manage-users
@ -364,7 +364,7 @@ based Linux system. Just create the file
Type=simple Type=simple
User=mylinuxuser User=mylinuxuser
Group=mylinuxgroup Group=mylinuxgroup
ExecStart=/opt/calibre/calibre-server "/path/to/calibre library directory" ExecStart=/opt/calibre/calibre-server "/path/to/calibre library folder"
[Install] [Install]
WantedBy=multi-user.target WantedBy=multi-user.target
@ -372,9 +372,9 @@ based Linux system. Just create the file
Change ``mylinuxuser`` and ``mylinuxgroup`` to whatever user and group you want Change ``mylinuxuser`` and ``mylinuxgroup`` to whatever user and group you want
the server to run as. This should be the same user and group that own the files the server to run as. This should be the same user and group that own the files
in the calibre library directory. Note that it is generally not a good idea to in the calibre library folder. Note that it is generally not a good idea to
run the server as root. Also change the path to the calibre library run the server as root. Also change the path to the calibre library
directory to suit your system. You can add multiple libraries if needed. See folder to suit your system. You can add multiple libraries if needed. See
the help for the ``calibre-server`` command. the help for the ``calibre-server`` command.
Now run:: Now run::