calibre - en to es translation catalogue (161 entries)

en: API documentation for the e-book editing tools
es: Documentación de la API para las herramientas de modificación de libros electrónicos

en: The e-book editing tools consist of a :class:`calibre.ebooks.oeb.polish.container.Container` object that represents a book as a collection of HTML + resource files, and various tools that can be used to perform operations on the container. All the tools are in the form of module level functions in the various ``calibre.ebooks.oeb.polish.*`` modules.
es: Las herramientas de modificación de libros electrónicos consisten en un objeto :class:`calibre.ebooks.oeb.polish.container.Container` que representa un libro como colección de archivos HTML y de recursos, y varias herramientas que pueden usarse para realizar diversas operaciones sobre el contenedor. Todas las herramientas están bajo la forma de funciones a nivel de módulo, en los distintos módulos ``calibre.ebooks.oeb.polish.*``.

en: You obtain a container object for a book at a path like this::
es: Se obtiene un objeto contenedor para un libro en una ruta como esta::

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
es: Si está escribiendo un complemento para el editor de libros electrónicos, puede obtener el contenedor actual para el libro que se está modificando de este modo::

en: The Container object
es: El objeto contenedor

en: A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
es: Un contenedor representa un libro electrónico abierto como una carpeta con archivos más un archivo opf. Hay varios conceptos importantes:

en: The root folder. This is the base of the e-book. All the e-books files are inside this folder or in its sub-folders.
es: La carpeta raíz. Ésta es la base del libro electrónico. Todos los archivos del libro se encuentran en esta carpeta o en sus subcarpetas.

en: Names: These are paths to the books' files relative to the root folder. They always contain POSIX separators and are unquoted. They can be thought of as canonical identifiers for files in the book. Most methods on the container object work with names. Names are always in the NFC Unicode normal form.
es: Nombres: Son rutas a los archivos del libro con respecto a la carpeta raíz. Siempre contienen separadores POSIX, sin comillas. Pueden considerarse como identificadores canónicos para los archivos del libro. La mayoría de los métodos en el objeto contenedor trabajan con nombres. Los nombres están siempre en la forma normalizada Unicode NFC.

en: Clones: the container object supports efficient on-disk cloning, which is used to implement checkpoints in the e-book editor. In order to make this work, you should never access files on the filesystem directly. Instead, use :meth:`raw_data` or :meth:`open` to read/write to component files in the book.
es: Clones: el objeto contenedor soporta clonación eficiente en disco, que se utiliza para implementar hitos en el editor de libros electrónicos. Para que esto funcione, nunca se debe acceder a los archivos del sistema de archivos directamente. En su lugar, debe usarse :meth:`raw_data` o :meth:`open` para leer o escribir en los archivos que integran el libro.

en: When converting between hrefs and names use the methods provided by this class, they assume all hrefs are quoted.
es: Al convertir entre hrefs y nombres utilice los métodos suministrados por esta clase, éstos asumen que todas las hrefs están entre comillas.

en: Convert an absolute path to a canonical name relative to :attr:`root`
es: Convierte una ruta absoluta en un nombre canónico con respecto a :attr:`root`

en: Parameters
es: Parámetros

en: The base folder. By default the root for this container object is used.
es: La carpeta base. De manera predeterminada se usa la raíz del objeto contenedor.

en: Add a file to this container. Entries for the file are automatically created in the OPF manifest and spine (if the file is a text document)
es: Añade un archivo a este contenedor. Se crean automáticamente las entradas para el archivo en el manifiesto OPF y el lomo (si el archivo es un documento de texto)

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
es: Añade una entrada al manifiesto para un archivo con el nombre especificado. Devuelve el id del manifiesto.

en: Add the specified properties to the manifest item identified by name.
es: Añade las propiedades especificadas (``properties``) al elemento del manifiesto identificado por ``name``.

en: Ensure that the specified properties are set on only the manifest item identified by name. You can pass None as the name to remove the property from all items.
es: Se asegura de que las propiedades especificadas (``properties``) estás establecidas sólo en el elemento del manifiesto identificado por ``name``. Pueda usarse None como ``name`` para eliminar la propiedad de todos los elementos.

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
es: El tipo de libro (epub para archivos EPUB o azw3 para archivos AZW3)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
es: Almacena todos los objetos procesados modificados en el sistema de archivos y escribe el archivo del libro en `outpath`.

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
es: La ruta de acceso donde se escribe el archivo del libro. Si es None, se usa la ruta del archivo original.

en: If True the parsed representations of committed items are kept in the cache.
es: Si es True, la representación procesada de los elementos almacenados se mantiene en memoria.

en: Commit a parsed object to disk (it is serialized and written to the underlying file). If ``keep_parsed`` is True the parsed representation is retained in the cache. See also: :meth:`parsed`
es: Almacena un objeto procesado en el disco (se serializa y escribe en el archivo subyacente). Si ``keep_parsed`` es True la representación procesada se mantiene en el caché. Véase también: :meth:`parsed`

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
es: Marca el objeto analizado correspondiente a ``nombre`` como sucio. Véase también :meth:`parsed`.

en: True iff a file/folder corresponding to the canonical name exists. Note that this function suffers from the limitations of the underlying OS filesystem, in particular case (in)sensitivity. So on a case insensitive filesystem this will return True even if the case of name is different from the case of the underlying filesystem file. See also :meth:`has_name`
es: True si y sólo si existe un archivo o carpeta que corresponde con el nombre canónico ``name``. Tenga en cuenta que esta función sufre las limitaciones del sistema de archivos del sistema operativo subyacente, en particular la distinción o no entre mayúsculas y minúsculas. En un sistema de archivos que no distingue entre mayúsculas y minúsculas, esta función devuelve True incluso si ``name`` y el archivo en el sistema de archivos difieren en mayúsculas y minúsculas. Véase también :meth:`has_name`.

en: Return the size in bytes of the file represented by the specified canonical name. Automatically handles dirtied parsed objects. See also: :meth:`parsed`
es: Devuelve el tamaño en bytes del archivo representado por el nombre canónico ``name``. Gestiona automáticamente objectos procesados modificados. Véase también :meth:`parsed`.

en: Add an item to the manifest with href derived from the given name. Ensures uniqueness of href and id automatically. Returns generated item.
es: Añade un elemento al manifiesto con href derivado del ``name`` dado. Asegura la unicidad del href y del id automáticamente. Devuelve el elemento generado.

en: Similar to open() except that it returns a file path, instead of an open file object.
es: Parecido a open() pero devuelve una ruta de archivo en lugar de un objeto de archivo abierto.

en: Mapping of guide type to canonical name
es: Mapa de tipo de guía a nombre canónico

en: Return True iff a file with the same canonical name as that specified exists. Unlike :meth:`exists` this method is always case-sensitive.
es: Devuelve True si y sólo si existe un archivo con el mismo nombre canónico que el ``name`` especificado. A diferencia de :meth:`exists`, este método siempre distingue mayúsculas y minúsculas.

en: Convert an href (relative to base) to a name. base must be a name or None, in which case self.root is used.
es: Convierte un ``href`` (relativo a ``base``) a un nombre. ``base`` debe ser un nombre o None, en cuyo caso se usa self.root.

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
es: Inserta ``item`` en ``parent`` (o lo añade al final si ``index`` es None), arreglando la sangría. Sólo funciona con elementos con cierre incorporado.

en: If this container represents an unzipped book (a directory)
es: Si este contenedor representa un libro descomprimido (un directorio)

en: Iterate over all links in name. If get_line_numbers is True the yields results of the form (link, line_number, offset). Where line_number is the line_number at which the link occurs and offset is the number of characters from the start of the line. Note that offset could actually encompass several lines if not zero.
es: Itera sobre todos los enlaces en ``name``. Si ``get_line_numbers`` es True, los resultados producidos son de la forma (enlace, número_de_línea, desplazamiento). Donde «número_de_línea» es número de línea en el que aparece el enlace y «desplazamiente» es el número de caracteres desde el inicio de la línea. Tenga en cuenta que el desplazamiento puede de hecho abarcar varias líneas si no es cero.

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
es: Se asegura de que ``name`` no existe ya en este libro. Si existe, devuelve una versión modificada que no exista.

en: Return True if the manifest has an entry corresponding to name
es: Devuelve True si el manifiesto tiene una entrada correspondiente a ``name``

en: Mapping of manifest id to canonical names
es: Correspondencia entre id del manifiesto y nombres canónicos

en: The names of all manifest items whose media-type matches predicate. `predicate` can be a set, a list, a string or a function taking a single argument, which will be called with the media-type.
es: Los nombres de todos los elementos del manifiesto cuyo media-type coincide con `predicate`. `predicate` puede ser un conjunto, una lista, un texto o una función que toma un único argumento, que se ejecutará con el media-type.

en: All manifest items that have the specified property
es: Todos los elementos del manifiesto que tienen la propiedad especificada

en: Mapping of manifest media-type to list of canonical names of that media-type
es: Correspondencia entre media-type del manifiesto y lista de nombres canónicos de cada media-type

en: The metadata of this book as a Metadata object. Note that this object is constructed on the fly every time this property is requested, so use it sparingly.
es: Los metadatos de este libro como un objeto Metadata. Tenga en cuenta que este objeto se construye al vuelo cada vez que se solicita la propiedad, por lo que debe usarse con moderación.

en: Convert a canonical name to an absolute OS dependent path
es: Convierte un nombre canónico en una ruta de acceso absoluta acorde al sistema operativo

en: Convert a name to a href relative to base, which must be a name or None in which case self.root is used as the base
es: Convierte un nombre a un href relativo a la base, que debe ser un nombre o None, en cuyo caso self.root se toma como la base

en: Set of names that must never be renamed. Depends on the e-book file format.
es: Conjunto de nombres que nunca deben cambiarse. Depende del formato de archivo del libro electrónico.

en: Set of names that must never be deleted from the container. Depends on the e-book file format.
es: Conjunto de nombres que nunca deben borrarse del contenedor. Depende del formato de archivo del libro electrónico.

en: Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
es: Conjunto de nombres que pueden estar ausentes del manifiesto. Depende del formato de archivo del libro electrónico.

en: Open the file pointed to by name for direct read/write. Note that this will commit the file if it is dirtied and remove it from the parse cache. You must finish with this file before accessing the parsed version of it again, or bad things will happen.
es: Abre el archivo apuntado por ``name`` para lectura o escritura directa. Tenga en cuenta que esto almacenará el archivo si se modifica y lo eliminará del caché de procesamiento. Debe acabar con este archivo antes de acceder de nuevo a la versión procesada u ocurrirán cosas malas.

en: The parsed OPF file
es: El archivo OPF analizado

en: Convenience method to either return the first XML element with the specified name or create it under the opf:package element and then return it, if it does not already exist.
es: Método práctico que devuelve el primer elemento XML con el nombre especificado (``name``) o lo crea bajo el elemento opf:package y luego lo devuelve, si no existe previamente.

en: The version set on the OPF's <package> element
es: La versión establecida en el elemento <package> del OPF

en: The version set on the OPF's <package> element as a tuple of integers
es: La versión establecida en el elemento <package> del OPF, como una tupla de enteros

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
es: Método práctico para evaluar una expresión XPath en el archivo OPF, tiene los prefijos de espacio de nombres «opf:» y «dc:» predefinidos.

en: Return a parsed representation of the file specified by name. For HTML and XML files an lxml tree is returned. For CSS files a css_parser stylesheet is returned. Note that parsed objects are cached for performance. If you make any changes to the parsed object, you must call :meth:`dirty` so that the container knows to update the cache. See also :meth:`replace`.
es: Devuelve una representación procesada del archivo especificado por ``name``. Para archivos HTML y XML, devuelve un árbol lxml. Para archivos CSS devuelve una hoja de estilos css_parser. Tenga en cuenta que los objetos procesados se mantienen en caché para mejorar el rendimiento. Si hace algún cambio en el objeto procesado, debe ejecutar :meth:`dirty` para que el contenedor sepa que tiene que actualizar el caché. Véase también :meth:`replace`.

en: Return the raw data corresponding to the file specified by name
es: Devuelve el contenido en bruto correspondiente al archivo especificado por su ``name``

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
es: Si es True y el archivo tiene un tipo MIME basado en texto, lo descodifica y devuelve un objeto unicode en lugar de bytes en bruto.

en: If True the returned unicode object is normalized to the NFC normal form as is required for the EPUB and AZW3 file formats.
es: Si es True el objeto Unicode devuelto se normaliza a la norma NFC, como requieren los formatos de archivo EPUB y AZW3.

en: Convert an absolute path (with OS separators) to a path relative to base (defaults to self.root). The relative path is *not* a name. Use :meth:`abspath_to_name` for that.
es: Convierte una ruta absoluta (con separadores de sistema operativo) a una ruta relativa a ``base`` (de manera predeterminada, self.root). La ruta relativa *no es* un nombre. Use :meth:`abspath_to_name` para obtener un nombre.

en: Remove the specified items (by canonical name) from the spine. If ``remove_if_no_longer_in_spine`` is True, the items are also deleted from the book, not just from the spine.
es: Elimina los elementos especificados (por nombre canónico) del lomo. Si ``remove_if_no_longer_in_spine`` es True, los elementos también se borran del libro, no sólo del lomo.

en: Removes item from parent, fixing indentation (works only with self closing items)
es: Elimina ``item`` del elemento superior, arreglando la sangría (sólo funciona con elementos con cierre incorporado)

en: Remove the item identified by name from this container. This removes all references to the item in the OPF manifest, guide and spine as well as from any internal caches.
es: Elimina el elemento identificado por ``name`` de este contenedor. Esto elimina todas las referencias al elemento del manifiesto, guía y lomo del OPF, así como de cualquier caché interno.

en: Renames a file from current_name to new_name. It automatically rebases all links inside the file if the folder the file is in changes. Note however, that links are not updated in the other files that could reference this file. This is for performance, such updates should be done once, in bulk.
es: Cambia el nombre de un archivo de ``current_name`` a ``new_name``. Cambia automáticamente la base de todos los enlaces en el archivo si cambia la carpeta en que se encuentra el archivo. Tenga en cuenta, no obstante, que no se actualizan los enlaces en otros archivos que puedan hacer referencia a éste. Esto es así por motivos de rendimiento, tales actualizaciones deben hacerse una sola vez en masa.

en: Replace the parsed object corresponding to name with obj, which must be a similar object, i.e. an lxml tree for HTML/XML or a css_parser stylesheet for a CSS file.
es: Sustituye el objeto procesado correspondiente a ``name`` por ``obj``, que debe ser un objeto similar, es decir, un árbol lxml para archivos HTML o XML o una hoja de estilos css_parser para archivos CSS.

en: Replace all links in name using replace_func, which must be a callable that accepts a URL and returns the replaced URL. It must also have a 'replaced' attribute that is set to True if any actual replacement is done. Convenient ways of creating such callables are using the :class:`LinkReplacer` and :class:`LinkRebaser` classes.
es: Sustituye todos los enlaces en ``name`` usando ``replace_func``, que debe ser un objeto ejecutable que acepte un URL y devuelva el URL sustituido. También debe tener un atributo ``replaced`` que sea True si se ha efectuado alguna sustitución. Pueden crearse tales objetos ejecutables de forma práctica usando las clases :class:`LinkReplacer` y :class:`LinkRebaser`.

en: Convert a parsed object (identified by canonical name) into a bytestring. See :meth:`parsed`.
es: Convierte un objeto analizado (identificado por su nombre canónico) en una cadena de bytes. Vea :meth:`parsed`.

en: Set the spine to be spine_items where spine_items is an iterable of the form (name, linear). Will raise an error if one of the names is not present in the manifest.
es: Establece el lomo como ``spine_items``, donde ``spine_items`` es un objeto iterable de la forma (nombre, lineal). Se producirá un error si alguno de los nombres no está presente en el manifiesto.

en: An iterator yielding the path for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
es: Un iterador que proporciona la ruta de acceso para cada elemento del lomo de los libros. Véase también: :attr:`spine_iter` y :attr:`spine_items`.

en: An iterator that yields item, name is_linear for every item in the books' spine. item is the lxml element, name is the canonical file name and is_linear is True if the item is linear. See also: :attr:`spine_names` and :attr:`spine_items`.
es: Un iterador que proporciona elemento, nombre, es_lineal para cada elemento del lomo de los libros. ``elemento`` es el elemento lxml, ``nombre`` es el nombre canónico del archivo y ``es_lineal`` es True si el elemento es lineal. Véase también: :attr:`spine_names` y :attr:`spine_items`.

en: An iterator yielding name and is_linear for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
es: Un iterador que proporciona nombre y es_lineal para cada elemento del lomo de los libros. Véase también: :attr:`spine_iter` y :attr:`spine_items`.

en: Managing component files in a container
es: Gestionar los archivos dentro de un contenedor

en: Replace links to files in the container. Will iterate over all files in the container and change the specified links in them.
es: Sustituye enlaces a archivos en el contenedor. Iterará sobre todos los archivos en el contenedor y cambiará los enlaces especificados en ellos.

en: A mapping of old canonical name to new canonical name. For example: :code:`{'images/old.png': 'images/new.png'}`
es: Un mapa de nombre canónico antiguo a nombre canónico nuevo. Por ejemplo: :code:`{'images/antiguo.png': 'images/nuevo.png'}`

en: A callable that takes two arguments ``(name, anchor)`` and returns a new anchor. This is useful if you need to change the anchors in HTML files. By default, it does nothing.
es: Un objeto ejecutable que toma dos argumentos ``(name, anchor)`` y devuelve un punto de anclaje. Esto es útil si tiene que cambiar los puntos de anclaje en archivos HTML. De manera predeterminada, no hace nada.

en: If False, links are not replaced in the OPF file.
es: Si es False, no se sustituyen los enlaces en el archivo OPF.

en: Rename files in the container, automatically updating all links to them.
es: Cambia el nombre de archivos en el contenedor, actualizando automáticamente actualizando todos los enlaces a que apunten a ellos.

en: A mapping of old canonical name to new canonical name, for example: :code:`{'text/chapter1.html': 'chapter1.html'}`.
es: Un mapo de nombres canónicos antiguo a nombre canónico nuevo, por ejemplo: :code:`{'text/capitulo1.html': 'capitulo1.html'}`.

en: Return the folders that are recommended for the given filenames. The recommendation is based on where the majority of files of the same type are located in the container. If no files of a particular type are present, the recommended folder is assumed to be the folder containing the OPF file.
es: Devuelve las carpetas recomendadas para los nombres de archivo dados. La recomendación se basa en dónde se encuentra la mayoría de los archivos del mismo tipo en el contenedor. Si no hay archivos de un tipo concreto, la carpeta recomendada es la que contiene el archivo OPF.

en: Pretty printing and auto fixing parse errors
es: Presentación mejorada y corrección automática de errores

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
es: Corrige cualquier error de procesado en el HTML representado como un texto en ``raw``. La corrección se realiza usando el algoritmo de procesado HTML5.

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
es: Corrige cualquer error de procesado en todos los archivos HTML del contenedor. La corrección ser realiza usando el algoritmo de procesado HTML5.

en: Pretty print the HTML represented as a string in raw
es: Redistribuye el HTML representado como un texto en ``raw``

en: Pretty print the CSS represented as a string in raw
es: Redistribuye el CSS representado como un texto en ``raw``

en: Pretty print the XML represented as a string in raw. If ``name`` is the name of the OPF, extra OPF-specific prettying is performed.
es: Redistribuye el XML representado como un texto en ``raw``. Si ``name`` es el nombre del OPF, se realiza una redistribución adicional específica para OPF.

en: Pretty print all HTML/CSS/XML files in the container
es: Redistribuye todos los archivos HTML, CSS y XML del contenedor

en: Managing book jackets
es: Gestionar las sobrecubiertas de los libros

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
es: Elimina una sobrecubierta existente, si la hay. Devuelve False si no se encontró una sobrecubierta.

en: Either create a new jacket from the book's metadata or replace an existing jacket. Returns True if an existing jacket was replaced.
es: Crea una nueva sobrecubierta a partir de los metadatos del libro o sustituye una sobrecubierta existente. Devuelve True si se sustutuyó una sobrecubierta existente.

en: Splitting and merging of files
es: Dividir y combinar archivos

en: Split the file specified by name at the position specified by loc_or_xpath. Splitting automatically migrates all links and references to the affected files.
es: Divide el archivo especificado por ``name`` en la ubicación especificada por ``loc_or_xpath``. La división migra automáticamente todos los enlaces y referencias a los archivos afectados.

en: Should be an XPath expression such as //h:div[@id="split_here"]. Can also be a *loc* which is used internally to implement splitting in the preview panel.
es: Debería ser una expresión XPath como «//h:div[@id="dividir_aqui"]». También puede ser un *loc*, que se usa internamente para ejecutar la división en el panel de vista previa.

en: If True the split occurs before the identified element otherwise after it.
es: Si es True, la división ocurre antes del elemento identificado, en caso contrario ocurre después.

en: Used internally
es: Usado internamente

en: Split the specified file at multiple locations (all tags that match the specified XPath expression). See also: :func:`split`. Splitting automatically migrates all links and references to the affected files.
es: Divide el archivo especificado en múltiples ubicaciones (todas las etiquetas que coincidan con la expresión XPath especificada). Véase también :func:`split`. La división migra automáticamente todos los enlaces y referencias a los archivos afectados.

en: If True the splits occur before the identified element otherwise after it.
es: Si es True las divisiones se producen antes del elemento identificado, en caso contrario se producen después.

en: Merge the specified files into a single file, automatically migrating all links and references to the affected files. The file must all either be HTML or CSS files.
es: Combina los archivos especificados en un único archivo, migrando automáticamente todos los enlaces y referencias a los archivos afectados. Los archivos deben ser todos HTML o todos CSS.

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
es: Debe ser ``'text'`` para archivos HTML o ``'styles'`` para archivos CSS

en: The list of files to be merged
es: La lista de archivos para combinar.

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
es: Cuál de los archivos combinados es el archivo *maestro*, es decir, el archivo que se mantendrá después del proceso.

en: Managing covers
es: Gestionar portadas

en: Set the cover of the book to the image pointed to by cover_path.
es: Establece la imagen a la que apunta ``cover_path`` como la portada del libro.

en: Either the absolute path to an image file or the canonical name of an image in the book. When using an image in the book, you must also set options, see below.
es: La ruta absoluta a un archivo de imagen o el nombre canónico de una imagen en el libro. Si usa una imagen del libro, debe especificar también ``options``, ver más abajo.

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
es: Un objeto ejecutable opcional que toma un solo argumento. Se ejecutará con información sobre las tareas que se llevan a cabo.

en: None or a dictionary that controls how the cover is set. The dictionary can have entries: **keep_aspect**: True or False  (Preserve aspect ratio of covers in EPUB) **no_svg**: True or False  (Use an SVG cover wrapper in the EPUB titlepage) **existing**: True or False  (``cover_path`` refers to an existing image in the book)
es: None o un diccionario que controla cómo se establece la portada. El diccionario puede tener entradas: **keep_aspect**: True o False (mantiene la proporción de las portadas en EPUB) **no_svg**: True o False (Usa un envoltorio de portada SVG en la página de título EPUB) **existing**: True o False (``cover_path`` se refiere a una imagen existente en el libro)

en: Mark the specified image as the cover image.
es: Marca la imagen especificada como la imagen de portada.

en: Mark the specified HTML file as the titlepage of the EPUB.
es: Marca el archivo HTML especificado como la página de título del EPUB.

en: If True the HTML file is moved to the start of the spine
es: Si es True, el archivo HTML se mueve al inicio del lomo

en: Working with CSS
es: Trabajar con CSS

en: Change a font family from old_name to new_name. Changes all occurrences of the font family in stylesheets, style tags and style attributes. If the old_name refers to an embedded font, it is removed. You can set new_name to None to remove the font family instead of changing it.
es: Cambia un tipo de letra de ``old_name`` a ``new_name``. Modifica todas las ocasiones en que aparece el tipo de letra en hojas de estilo, etiquetas estilo y atributos de estilo. Si ``old_name`` se refiere a un tipo de letr incrustado, se elimina. Puede establecer ``new_name`` como None para eliminar el tipo de letra en lugar de cambiarlo.

en: Remove all unused CSS rules from the book. An unused CSS rule is one that does not match any actual content.
es: Elimina todas las reglas CSS no utilizadas en el libro. Una regla CSS sin usar es una que no coincide con ningún contenido real.

en: An optional callable that takes a single argument. It is called with information about the operations being performed.
es: Un objeto ejecutable opcional que toma un único argumento. Se ejecuta con información sobre las operaciones que se lleva a cabo.

en: If True, class attributes in the HTML that do not match any CSS rules are also removed.
es: Si es True, también se eliminan los atributos de clase del HTML que no correspondan a ninguna regla CSS.

en: If True, rules with identical selectors are merged.
es: Si es True, se combinan las reglas con selectores idénticos.

en: If True, rules with identical properties are merged.
es: Si es True, se combinan las reglas con propiedades idénticas.

en: If True, stylesheets that are not referenced by any content are removed
es: Si es True, se eliminan las hojas de estilos que no tienen referencias en otros archivos

en: Remove the specified CSS properties from all CSS rules in the book.
es: Elimina las propiedades CSS especificadas de todas las reglas CSS del libro.

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
es: Conjunto de propiedades para eliminar. Por ejemplo: :code:`{'font-family', 'color'}`.

en: The files from which to remove the properties. Defaults to all HTML and CSS files in the book.
es: Los archivos en los que se eliminan las propiedades. De manera predeterminada, todos los archivos HTML y CSS del libro.

en: Working with the Table of Contents
es: Trabajar con el índice

en: Generate a Table of Contents from a list of XPath expressions. Each expression in the list corresponds to a level of the generate ToC. For example: :code:`['//h:h1', '//h:h2', '//h:h3']` will generate a three level Table of Contents from the ``<h1>``, ``<h2>`` and ``<h3>`` tags.
es: Genera un índice a partir de una lista de expresiones XPath. Cada expresión de la lista corresponde a un nivel del índice generado. Por ejemplo: :code:`['//h:h1', '//h:h2', '//h:h3']` generará un índice de tres niveles a partir de las etiquetas ``<h1>``, ``<h2>`` y ``<h3>``.

en: Generate a Table of Contents from links in the book.
es: Genera un índice a partir de los enlaces del libro.

en: Generate a Table of Contents from files in the book.
es: Genera un índice a partir de los archivos del libro.

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
es: Crea un índice explícito (HTML) a partir de un índice NCX existente.

en: The title for this table of contents.
es: El título de este índice.

en: Edit book tool
es: Herramienta para modificar libro

en: The base class for individual tools in an Edit Book plugin. Useful members include:
es: La clase básica para las herramientas individuales en un complemento para modificar libros. Algunos miembros útiles incluyen:

en: ``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object to which this tool belongs.
es: ``self.plugin``: Una referencia al objeto :class:`calibre.customize.Plugin` al que pertenece esta herramienta.

en: Methods that must be overridden in sub classes:
es: Métodos que deben reemplazarse en subclases:

en: Set this to a unique name it will be used as a key
es: Especifique un nombre único que se utilizará como clave

en: If True the user can choose to place this tool in the plugins toolbar
es: Si es True, el usuario puede colocar esta herramienta en la barra de herramientas de complementos

en: If True the user can choose to place this tool in the plugins menu
es: Si es True, el usuario puede colocar esta herramienta en el menú de complementos

en: The popup mode for the menu (if any) of the toolbar button. Possible values are 'delayed', 'instant', 'button'
es: El modo emergente para el menú (si lo hay) del botón de la barra de herramientas. Los valores posibles son «delayed», «instant», «button»

en: The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the user interface.
es: El objeto :class:`calibre.gui2.tweak_book.boss.Boss`. Utilizado para controlar la interfaz de usuario.

en: The main window of the user interface
es: La ventana principal de la interfaz del usuario

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
es: Devuelve el objeto :class:`calibre.ebooks.oeb.polish.container.Container` actual que representa el libro que se está modificando.

en: Register a keyboard shortcut that will trigger the specified ``qaction``. This keyboard shortcut will become automatically customizable by the user in the Keyboard shortcuts section of the editor preferences.
es: Registra un atajo de teclado que ejecutará la ``qaction`` especificada. Este atajo de teclado será automáticamente personalizable por el usuario a través de la sección Atajos de teclado de las preferencias del editor.

en: A QAction object, it will be triggered when the configured key combination is pressed by the user.
es: Un objeto QAction, se ejecutará cuando el usuario pulse la combinación de teclas configurada.

en: A unique name for this shortcut/action. It will be used internally, it must not be shared by any other actions in this plugin.
es: Un nombre único para este atajo o acción. Se usará internamente, no debe coincidir con ninguna otra acción de este complemento.

en: A list of the default keyboard shortcuts. If not specified no default shortcuts will be set. If the shortcuts specified here conflict with either builtin shortcuts or shortcuts from user configuration/other plugins, they will be ignored. In that case, users will have to configure the shortcuts manually via Preferences. For example: ``default_keys=('Ctrl+J', 'F9')``.
es: Una lista de los atajos de teclado predeterminados. Si no se especifica, no se establecerá ningún atajo predeterminado. Si los atajos especificados están en conflicto on atajos predefinidos, con la configuración del usuario o con otros complementos, no se tendrán en cuenta. En tal caso, los usuarios tendrán que configurar los atajos manualmente a través de las Preferencias. Por ejemplo: ``default_keys=('Ctrl+J', 'F9')``.

en: An optional short description of this action. If not specified the text from the QAction will be used.
es: Una breve descripción opcional de esta acción. Si no se especifica, se utilizará el texto de la QAction.

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
es: Una descripción opcional más extensa de esta acción, que se usará en la entrada de las preferencias para este acceso directo.

en: Create a QAction that will be added to either the plugins toolbar or the plugins menu depending on ``for_toolbar``. For example::
es: Crea una QAction que se añadirá a la barra de herramientas de complementos, o al menú de complementos según el valor de ``for_toolbar``. Por ejemplo::

en: Method :meth:`register_shortcut`.
es: Método :meth:`register_shortcut`.

en: Controlling the editor's user interface
es: Controlar la interfaz de usuario del editor

en: The e-book editor's user interface is controlled by a single global *Boss* object. This has many useful methods that can be used in plugin code to perform common tasks.
es: La interfaz de usuario del editor de libros electrónicos está controlada por un único objeto global *Boss*. Este objeto posee varios métodos útiles que pueden utilizarse en el código de los complementos para realizar diversas tareas.

en: Create a restore checkpoint with the name specified as ``msg``
es: Crea un hito de restauración con el nombre especificado como ``msg``

en: Update all the components of the user interface to reflect the latest data in the current book container.
es: Actualiza todos los componentes de la interfaz para reflejar los datos más recientes del contenedor de libro actual.

en: If True, the book will be marked as modified, so the user will be prompted to save it when quitting.
es: Si es True, el libro se marcará como modificado, por lo que al usuario se le pedirá guardarlo al salir.

en: Close the editor that is editing the file specified by ``name``
es: Cierra el editor que está modificando el archivo especificado por ``name``

en: Commit any changes that the user has made to files open in editors to the container. You should call this method before performing any actions on the current container
es: Almacena todos los cambios que el usuario haya hecho en los archivos abiertos en el contenedor. Debe ejecutar este método antes de realizar cualquier acción sobre el contenedor actual.

en: Return the name of the file being edited currently or None if no file is being edited
es: Devuelve el nombre del archivo que está se está modificando actualmente o None si no se está modificando ningún archivo.

en: Open the file specified by name in an editor
es: Abre el archivo especificado por ``name`` en un editor

en: The media type of the file, for example, ``'text/html'``. If not specified it is guessed from the file extension.
es: El tipo de medio del archivo, por ejemplo: ``'text/html'``. Si no se especifica, se supone uno a partir de la extensión del archivo.

en: A template to initialize the opened editor with
es: Una plantilla con la que inicializar el editor abierto

en: Open the e-book at ``path`` for editing. Will show an error if the e-book is not in a supported format or the current book has unsaved changes.
es: Abre el libro electrónico en ``path`` para modificarlo. Mostrará un error si el libro electrónico no está en un formato compatible o si el libro actual tiene cambios sin guardar.

en: The name of a file inside the newly opened book to start editing. Can also be a list of names.
es: El nombre de un archivo dentro del libro abierto para iniciar la modificación. También puede ser una lista de nombres.

en: Undo the previous creation of a restore checkpoint, useful if you create a checkpoint, then abort the operation with no changes
es: Deshace la creación anterior de un hito de restauración, útil si crea un hito y luego cancela la operación sin ningún cambio

en: Save the book. Saving is performed in the background
es: Guarda el libro. El guardado se lleva a cabo en segundo plano

en: Mark the book as having been modified
es: Marca el libro como modificado

en: Show the changes to the book from its last checkpointed state
es: Muestra los cambios en el libro desde el estado del último hito

en: If True the diff dialog will have a button to allow the user to revert all changes
es: Si es True el cuadro de diferencias tendrá un botón que le permitirá al usuario deshacer los cambios

en: A container object to compare the current container to. If None, the previously checkpointed container is used
es: Un objeto de contenedor para compararlo con el contenedor actual. Si es None, se usará el contenedor del hito anterior.

en: Show the editor that is editing the file specified by ``name``
es: Muestra el editor que está modificando el archivo especificado por ``name``

en: Sync the position of the preview panel to the current cursor position in the current editor
es: Sincroniza la posición del panel de previsualización con la posición actual del cursor en el editor.
