1# SOME DESCRIPTIVE TITLE. 2# Copyright (C) Kovid Goyal 3# This file is distributed under the same license as the calibre package. 4# 5# Translators: 6msgid "" 7msgstr "" 8"Project-Id-Version: calibre\n" 9"Report-Msgid-Bugs-To: \n" 10"POT-Creation-Date: 2021-12-02 15:47+0000\n" 11"PO-Revision-Date: 2021-11-23 15:50+0000\n" 12"Last-Translator: Kovid Goyal <kovid@kovidgoyal.net>\n" 13"Language-Team: Pashto (http://www.transifex.com/calibre/calibre/language/ps/)\n" 14"MIME-Version: 1.0\n" 15"Content-Type: text/plain; charset=UTF-8\n" 16"Content-Transfer-Encoding: 8bit\n" 17"Language: ps\n" 18"Plural-Forms: nplurals=2; plural=(n != 1);\n" 19 20#: ../../__w/calibre/calibre/manual/polish.rst:4 21msgid "API documentation for the e-book editing tools" 22msgstr "" 23 24#: ../../__w/calibre/calibre/manual/polish.rst:6 25msgid "" 26"The e-book editing tools consist of a " 27":class:`calibre.ebooks.oeb.polish.container.Container` object that " 28"represents a book as a collection of HTML + resource files, and various " 29"tools that can be used to perform operations on the container. All the tools" 30" are in the form of module level functions in the various " 31"``calibre.ebooks.oeb.polish.*`` modules." 32msgstr "" 33 34#: ../../__w/calibre/calibre/manual/polish.rst:15 35msgid "You obtain a container object for a book at a path like this::" 36msgstr "" 37 38#: ../../__w/calibre/calibre/manual/polish.rst:20 39msgid "" 40"If you are writing a plugin for the E-book editor, you get the current " 41"container for the book being edited like this::" 42msgstr "" 43 44#: ../../__w/calibre/calibre/manual/polish.rst:30 45msgid "The Container object" 46msgstr "" 47 48#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 49#: of calibre.ebooks.oeb.polish.container.Container:1 50msgid "" 51"A container represents an open e-book as a folder full of files and an OPF " 52"file. There are two important concepts:" 53msgstr "" 54 55#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 56#: of calibre.ebooks.oeb.polish.container.Container:4 57msgid "" 58"The root folder. This is the base of the e-book. All the e-books files are " 59"inside this folder or in its sub-folders." 60msgstr "" 61 62#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 63#: of calibre.ebooks.oeb.polish.container.Container:7 64msgid "" 65"Names: These are paths to the books' files relative to the root folder. They" 66" always contain POSIX separators and are unquoted. They can be thought of as" 67" canonical identifiers for files in the book. Most methods on the container " 68"object work with names. Names are always in the NFC Unicode normal form." 69msgstr "" 70 71#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 72#: of calibre.ebooks.oeb.polish.container.Container:13 73msgid "" 74"Clones: the container object supports efficient on-disk cloning, which is " 75"used to implement checkpoints in the e-book editor. In order to make this " 76"work, you should never access files on the filesystem directly. Instead, use" 77" :meth:`raw_data` or :meth:`open` to read/write to component files in the " 78"book." 79msgstr "" 80 81#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 82#: of calibre.ebooks.oeb.polish.container.Container:18 83msgid "" 84"When converting between hrefs and names use the methods provided by this " 85"class, they assume all hrefs are quoted." 86msgstr "" 87 88#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 89#: of calibre.ebooks.oeb.polish.container.Container.abspath_to_name:1 90msgid "Convert an absolute path to a canonical name relative to :attr:`root`" 91msgstr "" 92 93#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 94#: of calibre.ebooks.oeb.polish.container.Container.abspath_to_name:0 95#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 96#: of calibre.ebooks.oeb.polish.container.Container.commit:0 97#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 98#: of calibre.ebooks.oeb.polish.container.Container.raw_data:0 99#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 100#: of calibre.ebooks.oeb.polish.replace.replace_links:0 101#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 102#: of calibre.ebooks.oeb.polish.replace.rename_files:0 103#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 104#: of calibre.ebooks.oeb.polish.split.split:0 105#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 106#: of calibre.ebooks.oeb.polish.split.multisplit:0 107#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 108#: of calibre.ebooks.oeb.polish.split.merge:0 109#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 110#: of calibre.ebooks.oeb.polish.cover.set_cover:0 111#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 112#: of calibre.ebooks.oeb.polish.cover.mark_as_titlepage:0 113#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 114#: calibre.ebooks.oeb.polish.css.remove_unused_css:0 115#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 116#: calibre.ebooks.oeb.polish.css.filter_css:0 117#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 118#: calibre.ebooks.oeb.polish.toc.create_inline_toc:0 119#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 120#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:0 121#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 122#: calibre.gui2.tweak_book.boss.Boss.apply_container_update_to_gui:0 123#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 124#: calibre.gui2.tweak_book.boss.Boss.edit_file:0 125#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 126#: calibre.gui2.tweak_book.boss.Boss.open_book:0 127#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 128#: calibre.gui2.tweak_book.boss.Boss.show_current_diff:0 129msgid "Parameters" 130msgstr "" 131 132#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 133#: of calibre.ebooks.oeb.polish.container.Container.abspath_to_name:3 134msgid "" 135"The base folder. By default the root for this container object is used." 136msgstr "" 137 138#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 139#: of calibre.ebooks.oeb.polish.container.Container.add_file:1 140msgid "" 141"Add a file to this container. Entries for the file are automatically created" 142" in the OPF manifest and spine (if the file is a text document)" 143msgstr "" 144 145#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 146#: of calibre.ebooks.oeb.polish.container.Container.add_name_to_manifest:1 147msgid "" 148"Add an entry to the manifest for a file with the specified name. Returns the" 149" manifest id." 150msgstr "" 151 152#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 153#: of calibre.ebooks.oeb.polish.container.Container.add_properties:1 154msgid "Add the specified properties to the manifest item identified by name." 155msgstr "" 156 157#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 158#: of calibre.ebooks.oeb.polish.container.Container.apply_unique_properties:1 159msgid "" 160"Ensure that the specified properties are set on only the manifest item " 161"identified by name. You can pass None as the name to remove the property " 162"from all items." 163msgstr "" 164 165#: ../../__w/calibre/calibre/manual/docstring of 166#: calibre.ebooks.oeb.polish.container.Container.book_type:1 167msgid "The type of book (epub for EPUB files and azw3 for AZW3 files)" 168msgstr "" 169 170#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 171#: of calibre.ebooks.oeb.polish.container.Container.commit:1 172msgid "" 173"Commit all dirtied parsed objects to the filesystem and write out the e-book" 174" file at outpath." 175msgstr "" 176 177#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 178#: of calibre.ebooks.oeb.polish.container.Container.commit:3 179msgid "" 180"The path to write the saved e-book file to. If None, the path of the " 181"original book file is used." 182msgstr "" 183 184#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 185#: of calibre.ebooks.oeb.polish.container.Container.commit:4 186msgid "" 187"If True the parsed representations of committed items are kept in the cache." 188msgstr "" 189 190#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 191#: of calibre.ebooks.oeb.polish.container.Container.commit_item:1 192msgid "" 193"Commit a parsed object to disk (it is serialized and written to the " 194"underlying file). If ``keep_parsed`` is True the parsed representation is " 195"retained in the cache. See also: :meth:`parsed`" 196msgstr "" 197 198#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 199#: of calibre.ebooks.oeb.polish.container.Container.dirty:1 200msgid "" 201"Mark the parsed object corresponding to name as dirty. See also: " 202":meth:`parsed`." 203msgstr "" 204 205#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 206#: of calibre.ebooks.oeb.polish.container.Container.exists:1 207msgid "" 208"True iff a file/folder corresponding to the canonical name exists. Note that" 209" this function suffers from the limitations of the underlying OS filesystem," 210" in particular case (in)sensitivity. So on a case insensitive filesystem " 211"this will return True even if the case of name is different from the case of" 212" the underlying filesystem file. See also :meth:`has_name`" 213msgstr "" 214 215#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 216#: of calibre.ebooks.oeb.polish.container.Container.filesize:1 217msgid "" 218"Return the size in bytes of the file represented by the specified canonical " 219"name. Automatically handles dirtied parsed objects. See also: :meth:`parsed`" 220msgstr "" 221 222#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 223#: of calibre.ebooks.oeb.polish.container.Container.generate_item:1 224msgid "" 225"Add an item to the manifest with href derived from the given name. Ensures " 226"uniqueness of href and id automatically. Returns generated item." 227msgstr "" 228 229#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 230#: of 231#: calibre.ebooks.oeb.polish.container.Container.get_file_path_for_processing:1 232msgid "" 233"Similar to open() except that it returns a file path, instead of an open " 234"file object." 235msgstr "" 236 237#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 238#: of calibre.ebooks.oeb.polish.container.Container.guide_type_map:1 239msgid "Mapping of guide type to canonical name" 240msgstr "" 241 242#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 243#: of calibre.ebooks.oeb.polish.container.Container.has_name:1 244msgid "" 245"Return True iff a file with the same canonical name as that specified " 246"exists. Unlike :meth:`exists` this method is always case-sensitive." 247msgstr "" 248 249#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 250#: of calibre.ebooks.oeb.polish.container.Container.href_to_name:1 251msgid "" 252"Convert an href (relative to base) to a name. base must be a name or None, " 253"in which case self.root is used." 254msgstr "" 255 256#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 257#: of calibre.ebooks.oeb.polish.container.Container.insert_into_xml:1 258msgid "" 259"Insert item into parent (or append if index is None), fixing indentation. " 260"Only works with self closing items." 261msgstr "" 262 263#: ../../__w/calibre/calibre/manual/docstring of 264#: calibre.ebooks.oeb.polish.container.Container.is_dir:1 265msgid "If this container represents an unzipped book (a directory)" 266msgstr "" 267 268#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 269#: of calibre.ebooks.oeb.polish.container.Container.iterlinks:1 270msgid "" 271"Iterate over all links in name. If get_line_numbers is True the yields " 272"results of the form (link, line_number, offset). Where line_number is the " 273"line_number at which the link occurs and offset is the number of characters " 274"from the start of the line. Note that offset could actually encompass " 275"several lines if not zero." 276msgstr "" 277 278#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 279#: of calibre.ebooks.oeb.polish.container.Container.make_name_unique:1 280msgid "" 281"Ensure that `name` does not already exist in this book. If it does, return a" 282" modified version that does not exist." 283msgstr "" 284 285#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 286#: of calibre.ebooks.oeb.polish.container.Container.manifest_has_name:1 287msgid "Return True if the manifest has an entry corresponding to name" 288msgstr "" 289 290#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 291#: of calibre.ebooks.oeb.polish.container.Container.manifest_id_map:1 292msgid "Mapping of manifest id to canonical names" 293msgstr "" 294 295#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 296#: of calibre.ebooks.oeb.polish.container.Container.manifest_items_of_type:1 297msgid "" 298"The names of all manifest items whose media-type matches predicate. " 299"`predicate` can be a set, a list, a string or a function taking a single " 300"argument, which will be called with the media-type." 301msgstr "" 302 303#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 304#: of 305#: calibre.ebooks.oeb.polish.container.Container.manifest_items_with_property:1 306msgid "All manifest items that have the specified property" 307msgstr "" 308 309#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 310#: of calibre.ebooks.oeb.polish.container.Container.manifest_type_map:1 311msgid "" 312"Mapping of manifest media-type to list of canonical names of that media-type" 313msgstr "" 314 315#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 316#: of calibre.ebooks.oeb.polish.container.Container.mi:1 317msgid "" 318"The metadata of this book as a Metadata object. Note that this object is " 319"constructed on the fly every time this property is requested, so use it " 320"sparingly." 321msgstr "" 322 323#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 324#: of calibre.ebooks.oeb.polish.container.Container.name_to_abspath:1 325msgid "Convert a canonical name to an absolute OS dependent path" 326msgstr "" 327 328#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 329#: of calibre.ebooks.oeb.polish.container.Container.name_to_href:1 330msgid "" 331"Convert a name to a href relative to base, which must be a name or None in " 332"which case self.root is used as the base" 333msgstr "" 334 335#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 336#: of 337#: calibre.ebooks.oeb.polish.container.Container.names_that_must_not_be_changed:1 338msgid "" 339"Set of names that must never be renamed. Depends on the e-book file format." 340msgstr "" 341 342#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 343#: of 344#: calibre.ebooks.oeb.polish.container.Container.names_that_must_not_be_removed:1 345msgid "" 346"Set of names that must never be deleted from the container. Depends on the " 347"e-book file format." 348msgstr "" 349 350#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 351#: of 352#: calibre.ebooks.oeb.polish.container.Container.names_that_need_not_be_manifested:1 353msgid "" 354"Set of names that are allowed to be missing from the manifest. Depends on " 355"the e-book file format." 356msgstr "" 357 358#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 359#: of calibre.ebooks.oeb.polish.container.Container.open:1 360msgid "" 361"Open the file pointed to by name for direct read/write. Note that this will " 362"commit the file if it is dirtied and remove it from the parse cache. You " 363"must finish with this file before accessing the parsed version of it again, " 364"or bad things will happen." 365msgstr "" 366 367#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 368#: of calibre.ebooks.oeb.polish.container.Container.opf:1 369msgid "The parsed OPF file" 370msgstr "" 371 372#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 373#: of calibre.ebooks.oeb.polish.container.Container.opf_get_or_create:1 374msgid "" 375"Convenience method to either return the first XML element with the specified" 376" name or create it under the opf:package element and then return it, if it " 377"does not already exist." 378msgstr "" 379 380#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 381#: of calibre.ebooks.oeb.polish.container.Container.opf_version:1 382msgid "The version set on the OPF's <package> element" 383msgstr "" 384 385#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 386#: of calibre.ebooks.oeb.polish.container.Container.opf_version_parsed:1 387msgid "The version set on the OPF's <package> element as a tuple of integers" 388msgstr "" 389 390#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 391#: of calibre.ebooks.oeb.polish.container.Container.opf_xpath:1 392msgid "" 393"Convenience method to evaluate an XPath expression on the OPF file, has the " 394"opf: and dc: namespace prefixes pre-defined." 395msgstr "" 396 397#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 398#: of calibre.ebooks.oeb.polish.container.Container.parsed:1 399msgid "" 400"Return a parsed representation of the file specified by name. For HTML and " 401"XML files an lxml tree is returned. For CSS files a css_parser stylesheet is" 402" returned. Note that parsed objects are cached for performance. If you make " 403"any changes to the parsed object, you must call :meth:`dirty` so that the " 404"container knows to update the cache. See also :meth:`replace`." 405msgstr "" 406 407#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 408#: of calibre.ebooks.oeb.polish.container.Container.raw_data:1 409msgid "Return the raw data corresponding to the file specified by name" 410msgstr "" 411 412#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 413#: of calibre.ebooks.oeb.polish.container.Container.raw_data:3 414msgid "" 415"If True and the file has a text based MIME type, decode it and return a " 416"unicode object instead of raw bytes." 417msgstr "" 418 419#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 420#: of calibre.ebooks.oeb.polish.container.Container.raw_data:4 421msgid "" 422"If True the returned unicode object is normalized to the NFC normal form as " 423"is required for the EPUB and AZW3 file formats." 424msgstr "" 425 426#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 427#: of calibre.ebooks.oeb.polish.container.Container.relpath:1 428msgid "" 429"Convert an absolute path (with os separators) to a path relative to base " 430"(defaults to self.root). The relative path is *not* a name. Use " 431":meth:`abspath_to_name` for that." 432msgstr "" 433 434#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 435#: of calibre.ebooks.oeb.polish.container.Container.remove_from_spine:1 436msgid "" 437"Remove the specified items (by canonical name) from the spine. If " 438"``remove_if_no_longer_in_spine`` is True, the items are also deleted from " 439"the book, not just from the spine." 440msgstr "" 441 442#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 443#: of calibre.ebooks.oeb.polish.container.Container.remove_from_xml:1 444msgid "" 445"Removes item from parent, fixing indentation (works only with self closing " 446"items)" 447msgstr "" 448 449#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 450#: of calibre.ebooks.oeb.polish.container.Container.remove_item:1 451msgid "" 452"Remove the item identified by name from this container. This removes all " 453"references to the item in the OPF manifest, guide and spine as well as from " 454"any internal caches." 455msgstr "" 456 457#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 458#: of calibre.ebooks.oeb.polish.container.Container.rename:1 459msgid "" 460"Renames a file from current_name to new_name. It automatically rebases all " 461"links inside the file if the folder the file is in changes. Note however, " 462"that links are not updated in the other files that could reference this " 463"file. This is for performance, such updates should be done once, in bulk." 464msgstr "" 465 466#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 467#: of calibre.ebooks.oeb.polish.container.Container.replace:1 468msgid "" 469"Replace the parsed object corresponding to name with obj, which must be a " 470"similar object, i.e. an lxml tree for HTML/XML or a css_parser stylesheet " 471"for a CSS file." 472msgstr "" 473 474#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 475#: of calibre.ebooks.oeb.polish.container.Container.replace_links:1 476msgid "" 477"Replace all links in name using replace_func, which must be a callable that " 478"accepts a URL and returns the replaced URL. It must also have a 'replaced' " 479"attribute that is set to True if any actual replacement is done. Convenient " 480"ways of creating such callables are using the :class:`LinkReplacer` and " 481":class:`LinkRebaser` classes." 482msgstr "" 483 484#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 485#: of calibre.ebooks.oeb.polish.container.Container.serialize_item:1 486msgid "" 487"Convert a parsed object (identified by canonical name) into a bytestring. " 488"See :meth:`parsed`." 489msgstr "" 490 491#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 492#: of calibre.ebooks.oeb.polish.container.Container.set_spine:1 493msgid "" 494"Set the spine to be spine_items where spine_items is an iterable of the form" 495" (name, linear). Will raise an error if one of the names is not present in " 496"the manifest." 497msgstr "" 498 499#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 500#: of calibre.ebooks.oeb.polish.container.Container.spine_items:1 501msgid "" 502"An iterator yielding the path for every item in the books' spine. See also: " 503":attr:`spine_iter` and :attr:`spine_items`." 504msgstr "" 505 506#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 507#: of calibre.ebooks.oeb.polish.container.Container.spine_iter:1 508msgid "" 509"An iterator that yields item, name is_linear for every item in the books' " 510"spine. item is the lxml element, name is the canonical file name and " 511"is_linear is True if the item is linear. See also: :attr:`spine_names` and " 512":attr:`spine_items`." 513msgstr "" 514 515#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/container.pydocstring 516#: of calibre.ebooks.oeb.polish.container.Container.spine_names:1 517msgid "" 518"An iterator yielding name and is_linear for every item in the books' spine. " 519"See also: :attr:`spine_iter` and :attr:`spine_items`." 520msgstr "" 521 522#: ../../__w/calibre/calibre/manual/polish.rst:36 523msgid "Managing component files in a container" 524msgstr "" 525 526#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 527#: of calibre.ebooks.oeb.polish.replace.replace_links:1 528msgid "" 529"Replace links to files in the container. Will iterate over all files in the " 530"container and change the specified links in them." 531msgstr "" 532 533#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 534#: of calibre.ebooks.oeb.polish.replace.replace_links:3 535msgid "" 536"A mapping of old canonical name to new canonical name. For example: " 537":code:`{'images/old.png': 'images/new.png'}`" 538msgstr "" 539 540#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 541#: of calibre.ebooks.oeb.polish.replace.replace_links:4 542msgid "" 543"A callable that takes two arguments ``(name, anchor)`` and returns a new " 544"anchor. This is useful if you need to change the anchors in HTML files. By " 545"default, it does nothing." 546msgstr "" 547 548#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 549#: of calibre.ebooks.oeb.polish.replace.replace_links:7 550msgid "If False, links are not replaced in the OPF file." 551msgstr "" 552 553#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 554#: of calibre.ebooks.oeb.polish.replace.rename_files:1 555msgid "" 556"Rename files in the container, automatically updating all links to them." 557msgstr "" 558 559#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 560#: of calibre.ebooks.oeb.polish.replace.rename_files:3 561msgid "" 562"A mapping of old canonical name to new canonical name, for example: " 563":code:`{'text/chapter1.html': 'chapter1.html'}`." 564msgstr "" 565 566#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/replace.pydocstring 567#: of calibre.ebooks.oeb.polish.replace.get_recommended_folders:1 568msgid "" 569"Return the folders that are recommended for the given filenames. The " 570"recommendation is based on where the majority of files of the same type are " 571"located in the container. If no files of a particular type are present, the " 572"recommended folder is assumed to be the folder containing the OPF file." 573msgstr "" 574 575#: ../../__w/calibre/calibre/manual/polish.rst:47 576msgid "Pretty printing and auto fixing parse errors" 577msgstr "" 578 579#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 580#: of calibre.ebooks.oeb.polish.pretty.fix_html:1 581msgid "" 582"Fix any parsing errors in the HTML represented as a string in raw. Fixing is" 583" done using the HTML5 parsing algorithm." 584msgstr "" 585 586#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 587#: of calibre.ebooks.oeb.polish.pretty.fix_all_html:1 588msgid "" 589"Fix any parsing errors in all HTML files in the container. Fixing is done " 590"using the HTML5 parsing algorithm." 591msgstr "" 592 593#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 594#: of calibre.ebooks.oeb.polish.pretty.pretty_html:1 595msgid "Pretty print the HTML represented as a string in raw" 596msgstr "" 597 598#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 599#: of calibre.ebooks.oeb.polish.pretty.pretty_css:1 600msgid "Pretty print the CSS represented as a string in raw" 601msgstr "" 602 603#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 604#: of calibre.ebooks.oeb.polish.pretty.pretty_xml:1 605msgid "" 606"Pretty print the XML represented as a string in raw. If ``name`` is the name" 607" of the OPF, extra OPF-specific prettying is performed." 608msgstr "" 609 610#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/pretty.pydocstring 611#: of calibre.ebooks.oeb.polish.pretty.pretty_all:1 612msgid "Pretty print all HTML/CSS/XML files in the container" 613msgstr "" 614 615#: ../../__w/calibre/calibre/manual/polish.rst:65 616msgid "Managing book jackets" 617msgstr "" 618 619#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/jacket.pydocstring 620#: of calibre.ebooks.oeb.polish.jacket.remove_jacket:1 621msgid "" 622"Remove an existing jacket, if any. Returns False if no existing jacket was " 623"found." 624msgstr "" 625 626#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/jacket.pydocstring 627#: of calibre.ebooks.oeb.polish.jacket.add_or_replace_jacket:1 628msgid "" 629"Either create a new jacket from the book's metadata or replace an existing " 630"jacket. Returns True if an existing jacket was replaced." 631msgstr "" 632 633#: ../../__w/calibre/calibre/manual/polish.rst:74 634msgid "Splitting and merging of files" 635msgstr "" 636 637#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 638#: of calibre.ebooks.oeb.polish.split.split:1 639msgid "" 640"Split the file specified by name at the position specified by loc_or_xpath. " 641"Splitting automatically migrates all links and references to the affected " 642"files." 643msgstr "" 644 645#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 646#: of calibre.ebooks.oeb.polish.split.split:5 647msgid "" 648"Should be an XPath expression such as //h:div[@id=\"split_here\"]. Can also " 649"be a *loc* which is used internally to implement splitting in the preview " 650"panel." 651msgstr "" 652 653#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 654#: of calibre.ebooks.oeb.polish.split.split:8 655msgid "" 656"If True the split occurs before the identified element otherwise after it." 657msgstr "" 658 659#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 660#: of calibre.ebooks.oeb.polish.split.split:9 661msgid "Used internally" 662msgstr "" 663 664#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 665#: of calibre.ebooks.oeb.polish.split.multisplit:1 666msgid "" 667"Split the specified file at multiple locations (all tags that match the " 668"specified XPath expression). See also: :func:`split`. Splitting " 669"automatically migrates all links and references to the affected files." 670msgstr "" 671 672#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 673#: of calibre.ebooks.oeb.polish.split.multisplit:5 674msgid "" 675"If True the splits occur before the identified element otherwise after it." 676msgstr "" 677 678#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 679#: of calibre.ebooks.oeb.polish.split.merge:1 680msgid "" 681"Merge the specified files into a single file, automatically migrating all " 682"links and references to the affected files. The file must all either be HTML" 683" or CSS files." 684msgstr "" 685 686#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 687#: of calibre.ebooks.oeb.polish.split.merge:4 688msgid "Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files" 689msgstr "" 690 691#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 692#: of calibre.ebooks.oeb.polish.split.merge:5 693msgid "The list of files to be merged" 694msgstr "" 695 696#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/split.pydocstring 697#: of calibre.ebooks.oeb.polish.split.merge:6 698msgid "" 699"Which of the merged files is the *master* file, that is, the file that will " 700"remain after merging." 701msgstr "" 702 703#: ../../__w/calibre/calibre/manual/polish.rst:85 704msgid "Managing covers" 705msgstr "" 706 707#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 708#: of calibre.ebooks.oeb.polish.cover.set_cover:1 709msgid "Set the cover of the book to the image pointed to by cover_path." 710msgstr "" 711 712#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 713#: of calibre.ebooks.oeb.polish.cover.set_cover:3 714msgid "" 715"Either the absolute path to an image file or the canonical name of an image " 716"in the book. When using an image in the book, you must also set options, see" 717" below." 718msgstr "" 719 720#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 721#: of calibre.ebooks.oeb.polish.cover.set_cover:6 722msgid "" 723"An optional callable that takes a single argument. It will be called with " 724"information about the tasks being processed." 725msgstr "" 726 727#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 728#: of calibre.ebooks.oeb.polish.cover.set_cover:8 729msgid "" 730"None or a dictionary that controls how the cover is set. The dictionary can " 731"have entries: **keep_aspect**: True or False (Preserve aspect ratio of " 732"covers in EPUB) **no_svg**: True or False (Use an SVG cover wrapper in the " 733"EPUB titlepage) **existing**: True or False (``cover_path`` refers to an " 734"existing image in the book)" 735msgstr "" 736 737#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 738#: of calibre.ebooks.oeb.polish.cover.mark_as_cover:1 739msgid "Mark the specified image as the cover image." 740msgstr "" 741 742#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 743#: of calibre.ebooks.oeb.polish.cover.mark_as_titlepage:1 744msgid "Mark the specified HTML file as the titlepage of the EPUB." 745msgstr "" 746 747#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/cover.pydocstring 748#: of calibre.ebooks.oeb.polish.cover.mark_as_titlepage:3 749msgid "If True the HTML file is moved to the start of the spine" 750msgstr "" 751 752#: ../../__w/calibre/calibre/manual/polish.rst:96 753msgid "Working with CSS" 754msgstr "" 755 756#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/fonts.pydocstring 757#: of calibre.ebooks.oeb.polish.fonts.change_font:1 758msgid "" 759"Change a font family from old_name to new_name. Changes all occurrences of " 760"the font family in stylesheets, style tags and style attributes. If the " 761"old_name refers to an embedded font, it is removed. You can set new_name to " 762"None to remove the font family instead of changing it." 763msgstr "" 764 765#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 766#: calibre.ebooks.oeb.polish.css.remove_unused_css:1 767msgid "" 768"Remove all unused CSS rules from the book. An unused CSS rule is one that " 769"does not match any actual content." 770msgstr "" 771 772#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 773#: calibre.ebooks.oeb.polish.css.remove_unused_css:3 774msgid "" 775"An optional callable that takes a single argument. It is called with " 776"information about the operations being performed." 777msgstr "" 778 779#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 780#: calibre.ebooks.oeb.polish.css.remove_unused_css:4 781msgid "" 782"If True, class attributes in the HTML that do not match any CSS rules are " 783"also removed." 784msgstr "" 785 786#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 787#: calibre.ebooks.oeb.polish.css.remove_unused_css:5 788msgid "If True, rules with identical selectors are merged." 789msgstr "" 790 791#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 792#: calibre.ebooks.oeb.polish.css.remove_unused_css:6 793msgid "If True, rules with identical properties are merged." 794msgstr "" 795 796#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 797#: calibre.ebooks.oeb.polish.css.remove_unused_css:7 798msgid "" 799"If True, stylesheets that are not referenced by any content are removed" 800msgstr "" 801 802#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 803#: calibre.ebooks.oeb.polish.css.filter_css:1 804msgid "Remove the specified CSS properties from all CSS rules in the book." 805msgstr "" 806 807#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 808#: calibre.ebooks.oeb.polish.css.filter_css:3 809msgid "" 810"Set of properties to remove. For example: :code:`{'font-family', 'color'}`." 811msgstr "" 812 813#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/css.pydocstring of 814#: calibre.ebooks.oeb.polish.css.filter_css:4 815msgid "" 816"The files from which to remove the properties. Defaults to all HTML and CSS " 817"files in the book." 818msgstr "" 819 820#: ../../__w/calibre/calibre/manual/polish.rst:108 821msgid "Working with the Table of Contents" 822msgstr "" 823 824#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 825#: calibre.ebooks.oeb.polish.toc.from_xpaths:1 826msgid "" 827"Generate a Table of Contents from a list of XPath expressions. Each " 828"expression in the list corresponds to a level of the generate ToC. For " 829"example: :code:`['//h:h1', '//h:h2', '//h:h3']` will generate a three level " 830"Table of Contents from the ``<h1>``, ``<h2>`` and ``<h3>`` tags." 831msgstr "" 832 833#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 834#: calibre.ebooks.oeb.polish.toc.from_links:1 835msgid "Generate a Table of Contents from links in the book." 836msgstr "" 837 838#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 839#: calibre.ebooks.oeb.polish.toc.from_files:1 840msgid "Generate a Table of Contents from files in the book." 841msgstr "" 842 843#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 844#: calibre.ebooks.oeb.polish.toc.create_inline_toc:1 845msgid "" 846"Create an inline (HTML) Table of Contents from an existing NCX Table of " 847"Contents." 848msgstr "" 849 850#: ../../__w/calibre/calibre/src/calibre/ebooks/oeb/polish/toc.pydocstring of 851#: calibre.ebooks.oeb.polish.toc.create_inline_toc:3 852msgid "The title for this table of contents." 853msgstr "" 854 855#: ../../__w/calibre/calibre/manual/polish.rst:122 856msgid "Edit book tool" 857msgstr "" 858 859#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 860#: calibre.gui2.tweak_book.plugin.Tool:1 861msgid "Bases: :py:class:`object`" 862msgstr "" 863 864#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 865#: calibre.gui2.tweak_book.plugin.Tool:1 866msgid "" 867"The base class for individual tools in an Edit Book plugin. Useful members " 868"include:" 869msgstr "" 870 871#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 872#: calibre.gui2.tweak_book.plugin.Tool:3 873msgid "" 874"``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object" 875" to which this tool belongs." 876msgstr "" 877 878#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 879#: calibre.gui2.tweak_book.plugin.Tool:4 880msgid "self. :attr:`boss`" 881msgstr "" 882 883#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 884#: calibre.gui2.tweak_book.plugin.Tool:5 885msgid "self. :attr:`gui`" 886msgstr "" 887 888#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 889#: calibre.gui2.tweak_book.plugin.Tool:7 890msgid "Methods that must be overridden in sub classes:" 891msgstr "" 892 893#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 894#: calibre.gui2.tweak_book.plugin.Tool:9 895msgid ":meth:`create_action`" 896msgstr "" 897 898#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 899#: calibre.gui2.tweak_book.plugin.Tool:10 900msgid ":meth:`register_shortcut`" 901msgstr "" 902 903#: ../../__w/calibre/calibre/manual/docstring of 904#: calibre.gui2.tweak_book.plugin.Tool.name:1 905msgid "Set this to a unique name it will be used as a key" 906msgstr "" 907 908#: ../../__w/calibre/calibre/manual/docstring of 909#: calibre.gui2.tweak_book.plugin.Tool.allowed_in_toolbar:1 910msgid "If True the user can choose to place this tool in the plugins toolbar" 911msgstr "" 912 913#: ../../__w/calibre/calibre/manual/docstring of 914#: calibre.gui2.tweak_book.plugin.Tool.allowed_in_menu:1 915msgid "If True the user can choose to place this tool in the plugins menu" 916msgstr "" 917 918#: ../../__w/calibre/calibre/manual/docstring of 919#: calibre.gui2.tweak_book.plugin.Tool.toolbar_button_popup_mode:1 920msgid "" 921"The popup mode for the menu (if any) of the toolbar button. Possible values " 922"are 'delayed', 'instant', 'button'" 923msgstr "" 924 925#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 926#: calibre.gui2.tweak_book.plugin.Tool.boss:1 927msgid "" 928"The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the " 929"user interface." 930msgstr "" 931 932#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 933#: calibre.gui2.tweak_book.plugin.Tool.gui:1 934msgid "The main window of the user interface" 935msgstr "" 936 937#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 938#: calibre.gui2.tweak_book.plugin.Tool.current_container:1 939msgid "" 940"Return the current :class:`calibre.ebooks.oeb.polish.container.Container` " 941"object that represents the book being edited." 942msgstr "" 943 944#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 945#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:1 946msgid "" 947"Register a keyboard shortcut that will trigger the specified ``qaction``. " 948"This keyboard shortcut will become automatically customizable by the user in" 949" the Keyboard shortcuts section of the editor preferences." 950msgstr "" 951 952#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 953#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:4 954msgid "" 955"A QAction object, it will be triggered when the configured key combination " 956"is pressed by the user." 957msgstr "" 958 959#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 960#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:6 961msgid "" 962"A unique name for this shortcut/action. It will be used internally, it must " 963"not be shared by any other actions in this plugin." 964msgstr "" 965 966#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 967#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:9 968msgid "" 969"A list of the default keyboard shortcuts. If not specified no default " 970"shortcuts will be set. If the shortcuts specified here conflict with either " 971"builtin shortcuts or shortcuts from user configuration/other plugins, they " 972"will be ignored. In that case, users will have to configure the shortcuts " 973"manually via Preferences. For example: ``default_keys=('Ctrl+J', 'F9')``." 974msgstr "" 975 976#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 977#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:15 978msgid "" 979"An optional short description of this action. If not specified the text from" 980" the QAction will be used." 981msgstr "" 982 983#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 984#: calibre.gui2.tweak_book.plugin.Tool.register_shortcut:17 985msgid "" 986"An optional longer description of this action, it will be used in the " 987"preferences entry for this shortcut." 988msgstr "" 989 990#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 991#: calibre.gui2.tweak_book.plugin.Tool.create_action:1 992msgid "" 993"Create a QAction that will be added to either the plugins toolbar or the " 994"plugins menu depending on ``for_toolbar``. For example::" 995msgstr "" 996 997#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/plugin.pydocstring of 998#: calibre.gui2.tweak_book.plugin.Tool.create_action:19 999msgid "Method :meth:`register_shortcut`." 1000msgstr "" 1001 1002#: ../../__w/calibre/calibre/manual/polish.rst:131 1003msgid "Controlling the editor's user interface" 1004msgstr "" 1005 1006#: ../../__w/calibre/calibre/manual/polish.rst:133 1007msgid "" 1008"The e-book editor's user interface is controlled by a single global *Boss* " 1009"object. This has many useful methods that can be used in plugin code to " 1010"perform common tasks." 1011msgstr "" 1012 1013#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1014#: calibre.gui2.tweak_book.boss.Boss.add_savepoint:1 1015msgid "Create a restore checkpoint with the name specified as ``msg``" 1016msgstr "" 1017 1018#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1019#: calibre.gui2.tweak_book.boss.Boss.apply_container_update_to_gui:1 1020msgid "" 1021"Update all the components of the user interface to reflect the latest data " 1022"in the current book container." 1023msgstr "" 1024 1025#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1026#: calibre.gui2.tweak_book.boss.Boss.apply_container_update_to_gui:3 1027msgid "" 1028"If True, the book will be marked as modified, so the user will be prompted " 1029"to save it when quitting." 1030msgstr "" 1031 1032#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1033#: calibre.gui2.tweak_book.boss.Boss.close_editor:1 1034msgid "Close the editor that is editing the file specified by ``name``" 1035msgstr "" 1036 1037#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1038#: calibre.gui2.tweak_book.boss.Boss.commit_all_editors_to_container:1 1039msgid "" 1040"Commit any changes that the user has made to files open in editors to the " 1041"container. You should call this method before performing any actions on the " 1042"current container" 1043msgstr "" 1044 1045#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1046#: calibre.gui2.tweak_book.boss.Boss.currently_editing:1 1047msgid "" 1048"Return the name of the file being edited currently or None if no file is " 1049"being edited" 1050msgstr "" 1051 1052#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1053#: calibre.gui2.tweak_book.boss.Boss.edit_file:1 1054msgid "Open the file specified by name in an editor" 1055msgstr "" 1056 1057#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1058#: calibre.gui2.tweak_book.boss.Boss.edit_file:3 1059msgid "" 1060"The media type of the file, for example, ``'text/html'``. If not specified " 1061"it is guessed from the file extension." 1062msgstr "" 1063 1064#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1065#: calibre.gui2.tweak_book.boss.Boss.edit_file:4 1066msgid "A template to initialize the opened editor with" 1067msgstr "" 1068 1069#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1070#: calibre.gui2.tweak_book.boss.Boss.open_book:1 1071msgid "" 1072"Open the e-book at ``path`` for editing. Will show an error if the e-book is" 1073" not in a supported format or the current book has unsaved changes." 1074msgstr "" 1075 1076#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1077#: calibre.gui2.tweak_book.boss.Boss.open_book:3 1078msgid "" 1079"The name of a file inside the newly opened book to start editing. Can also " 1080"be a list of names." 1081msgstr "" 1082 1083#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1084#: calibre.gui2.tweak_book.boss.Boss.rewind_savepoint:1 1085msgid "" 1086"Undo the previous creation of a restore checkpoint, useful if you create a " 1087"checkpoint, then abort the operation with no changes" 1088msgstr "" 1089 1090#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1091#: calibre.gui2.tweak_book.boss.Boss.save_book:1 1092msgid "Save the book. Saving is performed in the background" 1093msgstr "" 1094 1095#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1096#: calibre.gui2.tweak_book.boss.Boss.set_modified:1 1097msgid "Mark the book as having been modified" 1098msgstr "" 1099 1100#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1101#: calibre.gui2.tweak_book.boss.Boss.show_current_diff:1 1102msgid "Show the changes to the book from its last checkpointed state" 1103msgstr "" 1104 1105#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1106#: calibre.gui2.tweak_book.boss.Boss.show_current_diff:3 1107msgid "" 1108"If True the diff dialog will have a button to allow the user to revert all " 1109"changes" 1110msgstr "" 1111 1112#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1113#: calibre.gui2.tweak_book.boss.Boss.show_current_diff:4 1114msgid "" 1115"A container object to compare the current container to. If None, the " 1116"previously checkpointed container is used" 1117msgstr "" 1118 1119#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1120#: calibre.gui2.tweak_book.boss.Boss.show_editor:1 1121msgid "Show the editor that is editing the file specified by ``name``" 1122msgstr "" 1123 1124#: ../../__w/calibre/calibre/src/calibre/gui2/tweak_book/boss.pydocstring of 1125#: calibre.gui2.tweak_book.boss.Boss.sync_preview_to_editor:1 1126msgid "" 1127"Sync the position of the preview panel to the current cursor position in the" 1128" current editor" 1129msgstr "" 1130