calibre - en to pt translation catalogue (100 entries)

en: API documentation for the e-book editing tools
pt: Documentação da API para as ferramentas de edição de ebooks

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.
pt: As ferramentas de edição de ebooks consistem num objeto contentor :class:`calibre.ebooks.oeb.polish.container.Container` que representa um livro como uma coleção de ficheiros HTML e de recursos, e diversas ferramentas que podem ser usadas para levar a cabo operações sobre o contentor. Todas as ferramentas estão na forma de funções ao nível de módulo nos vários ``calibre.ebooks.oeb.polish.*`` módulos.

en: You obtain a container object for a book at a path like this::
pt: Obtém um objeto contentor para um livro num caminho como este::

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
pt: Se estiver a escrever um plugin para o editor de ebooks, pode obter o contentor atual para o livro em edição, do seguinte modo::

en: The Container object
pt: O objeto contentor

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.
pt: Clones: o objeto contentor suporta eficientemente a clonagem para disco, o que é usado para implementar pontos de controlo no editor de ebooks. Para que isto funcione, nunca deve aceder diretamente aos ficheiros no sistema de ficheiros. Em vez disso, use :meth:`raw_data` ou :meth:`open` para leitura/escrita nos ficheiros componentes do livro.

en: When converting between hrefs and names use the methods provided by this class, they assume all hrefs are quoted.
pt: Aquando da conversão entre hrefs e nomes use os métodos fornecidos por esta classe, que assumem que todos os hrefs estão entre aspas.

en: Convert an absolute path to a canonical name relative to :attr:`root`
pt: Converte um caminho absoluto para um nome canónico relativo ao :attr:`root`

en: Parameters
pt: Parâmetros

en: The base folder. By default the root for this container object is used.
pt: A pasta base. Por predefinição, é usada a raiz deste objeto contentor.

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)
pt: Adiciona um ficheiro a este contentor. Entradas para o ficheiro são criadas automaticamente no manifesto OPF e na lombada (se o ficheiro for um documento de texto)

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
pt: Adiciona uma entrada ao manifesto para um ficheiro com o nome especificado. Devolve o ID do manifesto.

en: Add the specified properties to the manifest item identified by name.
pt: Adiciona as propriedades especificadas ao item do manifesto identificado por nome.

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.
pt: Assegura que as propriedades especificadas são definidas apenas ao item de manifesto identificado por nome. Pode passar None como valor do parâmetro Nome para remover a propriedade de todos os itens.

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
pt: O tipo de livro (epub para ficheiros EPUB e azw3 para ficheiros AZW3)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
pt: Submeter ao sistema de ficheiros todos os objetos analisados que tenham sido identificados com problemas e escrever o ficheiro de ebook no caminho de saída.

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
pt: O caminho onde será escrito o ficheiro do ebook guardado. Se for None, é usado o caminho do ficheiro do livro original

en: If True the parsed representations of committed items are kept in the cache.
pt: Se Verdadeiro, as representações analisadas dos itens confirmados são mantidas em cache.

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`
pt: Confirma a escrita de um objeto analisado para o disco (será serializado e escrito no ficheiro subjacente). Se ```keep_parsed`` for Verdadeiro a representação analisada é mantida na Cache. Ver também: :meth:`parsed`

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
pt: Marcar o objeto analisado correspondente ao nome como impuro. Ver também: :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`
pt: Verdadeiro se e só se existir um ficheiro/pasta correspondente ao nome canónico. Note que esta função sofre as limitações subjacentes ao sistema de ficheiros do sistema operativo, em particular no que respeita à (in)sensibilidade com que são tratadas as maiúsculas e minúsculas. Assim, num sistema de ficheiros que não diferencie entre maiúsculas e minúsculas, será devolvido Verdadeiro mesmo se a maiusculização do nome for diferente da que se encontra no ficheiro do sistema de ficheiros subjacente. Ver também: :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`
pt: Devolve o tamanho em bytes do ficheiro representado pelo nome canónico especificado. Manipula automaticamente os objetos analisados como impuros. Ver também: :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.
pt: Adiciona um item ao manifesto com um href derivado do nome fornecido. Assegura automaticamente a unicidade do href e do id. Devolve o item gerado.

en: Similar to open() except that it returns a file path, instead of an open file object.
pt: Similar a open() exceto por devolver o caminho de um ficheiro em vez de um objeto de ficheiro aberto.

en: Mapping of guide type to canonical name
pt: Mapeamento de tipo de guia para o nome 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.
pt: Devolve Verdadeiro se e só se existe um ficheiro com o mesmo nome canónico que o especificado. Ao contrário de :meth:`exists` este método é sensível a maiúsculas e 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.
pt: Converte um href (relativo à base) para um nome. base tem de ser um nome ou None, caso em que self.root será utilizado.

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
pt: Insere item no contentor (ou acrescenta se Index for None), ajustando a indentação. Apenas funciona com itens auto-fecháveis.

en: If this container represents an unzipped book (a directory)
pt: Se este contentor representa um livro não comprimido (uma pasta)

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.
pt: Itera sobre todas as ligações presentes no nome. Se get_line_numbers for Verdadeiro, os resultados devolvidos estarão na forma (ligação, número_de_linha, offset), onde número_de_linha é o número_de_linha na qual a ligação ocorre e offset é o número de caracteres contado desde o início da linha. Note que offset pode englobar diversas linhas se não for zero.

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
pt: Assegura que `nome` não existe previamente neste livro. Se existe, devolve uma versão modificada que não existe.

en: Return True if the manifest has an entry corresponding to name
pt: Devolve Verdadeiro se o manifesto tiver uma entrada correspondente ao nome

en: Mapping of manifest id to canonical names
pt: Mapeamento de ID do manifesto para nomes 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.
pt: Os nomes de todos os itens de manifesto cujos tipos de media coincidem com o predicado. `predicate` pode ser um conjunto, uma lista, uma string ou uma função de um único argumento, que será chamada pelo tipo de media.

en: All manifest items that have the specified property
pt: Todos os itens de manifesto que contêm a propriedade especificada

en: Mapping of manifest media-type to list of canonical names of that media-type
pt: Mapeamento do tipo de media do manifesto para lista de nomes canónicos desse tipo de media

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.
pt: Os metadados deste livro sob a forma de um objeto Metadados. Note que este objeto é construído em tempo real de cada vez que esta propriedade é solicitada, pelo que use com moderação.

en: Convert a canonical name to an absolute OS dependent path
pt: Converte um nome canónico para um caminho absoluto dependente do 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
pt: Converte um nome para um href relativo à base, que tem de ser um nome ou None, caso em que self.root é usado como base

en: Set of names that must never be renamed. Depends on the e-book file format.
pt: Conjunto de nomes que nunca podem ser alterados. Depende do formato do ficheiro do ebook.

en: Set of names that must never be deleted from the container. Depends on the e-book file format.
pt: Conjunto de nomes que nunca podem ser apagados do contentor. Depende do formato de ficheiro do ebook.

en: Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
pt: Conjunto de nomes que são permitidos estarem em falta no manifesto. Depende do formato do ficheiro do ebook.

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.
pt: Abre o ficheiro apontado por nome para leitura/escrita direta. Note que isto efetuará as alterações ao ficheiro se o mesmo se encontrar deteriorado e irá removê-lo da cache do interpretador. É necessário terminar o trabalho neste ficheiro antes de aceder novamente à sua versão interpretada, ou coisas estranhas certamente acontecerão.

en: The parsed OPF file
pt: O ficheiro OPF interpretado

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.
pt: Método de conveniência que devolve o primeiro element XML com o nome especificado ou então cria-o debaixo do elemento opf:package e devolve-o de seguida no caso de ainda não existir.

en: The version set on the OPF's <package> element
pt: A versão definida no elemento <package>OPF

en: The version set on the OPF's <package> element as a tuple of integers
pt: A versão definida no elemento do <package> OPF sob a forma de um énuplo de inteiros

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
pt: Método de conveniência para avaliar uma expressão XPath no ficheiro OPF, que tem os prefixos opf; e dc:namespace 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`.
pt: Devolve uma representação analisada lexicograficamente do ficheiro especificado pelo nome. Para ficheiros HTML e XML é devolvida uma árvore lxml. Para ficheiros CSS é devolvida uma folha de estilo do tipo css_parser. Note que os objetos analisados ficam em cache para melhorar a performance. Se fizer quaisquer alterações ao objeto analisado, tem de invocar :meth:`dirty` de modo a que o contentor saiba que tem de atualizar a cache. Veja também :meth:`replace`.

en: Return the raw data corresponding to the file specified by name
pt: Devolve os dados em bruto correspondentes ao ficheiro especificado por nome

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
pt: Se Verdadeiro, e se o ficheiro tiver um tipo de MIME baseado em texto, descodificar e devolver um objeto Unicode em vez de bytes em 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.
pt: Se Verdadeiro o objeto Unicode devolvido é normalizado sob a forma normal NFC tal como requerido pelos formatos de ficheiro EPUB e 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.
pt: Converte um caminho absoluto (com separadores do SO) para um caminho relativo à base (por predefinição, self.root). O caminho relativo *não* é um nome. Use :meth:`abspath_to_name` para esse fim.

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.
pt: Remove os itens especificados (por nome canónico) da lombada. Se ``remove_if_no_longer_in_spine`` for Verdadeiro, os itens também são apagados do livro, e não apenas da lombada.

en: Removes item from parent, fixing indentation (works only with self closing items)
pt: Remove o item do contentor, ajustando a indentação (funciona apenas com itens que se auto-fecham).

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.
pt: Remove o item identificado por nome deste contentor. Isto remove todas as referências ao item do manifesto OPF, guia e lombada bem como de todas as caches internas.

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.
pt: Substitui os objetos analisados correspondentes ao nome por obj, que tem de ser um objeto similar, isto é, uma árvore lxml no caso de HTML/XML ou uma folha de estilo css_parser no caso de ficheiros CSS.

en: Managing component files in a container
pt: Gerir ficheiros componentes num contentor

en: Pretty printing and auto fixing parse errors
pt: Impressão elegante e correção automática de erros de análise

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
pt: Corrija os erros de análise do HTML representados por uma cadeia de caracteres em bruto. A correção é efetuada usando o algoritmo de análise do HTML5.

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
pt: Corrija os erros de análise em todos os ficheiros HTML do contentor. A correção é efetuada usando o algoritmo de análise do HTML5.

en: Pretty print all HTML/CSS/XML files in the container
pt: Imprime de forma visualmente apelativa todos os ficheiros HTML/CSS/XML existentes no contentor

en: Managing book jackets
pt: Gerir sobrecapas de livros

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
pt: Remove uma sobrecapa existente, se existir. Devolve False se não for encontrada uma sobrecapa.

en: Either create a new jacket from the book's metadata or replace an existing jacket. Returns True if an existing jacket was replaced.
pt: Efetua uma de duas operações: cria uma nova sobrecapa a partir dos metadados do livro ou substitui a sobrecapa existente. Devolve Verdadeiro se a sobrecapa existente for substituída.

en: Splitting and merging of files
pt: Separar e fundir ficheiros

en: If True the split occurs before the identified element otherwise after it.
pt: Se Verdadeiro a separação ocorre antes do elemento identificado; se não, ocorre depois dele.

en: Used internally
pt: Usado internamente

en: If True the splits occur before the identified element otherwise after it.
pt: Se Verdadeiro as separações ocorrem antes do elemento identificado; se não, ocorrem depois dele.

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.
pt: Funde os ficheiros especificados num único ficheiro, com a migração automática de todas as ligações e referências dos ficheiros afetados. Os ficheiros têm todos de ser HTML ou CSS.

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
pt: Tem de ser ``'text'`` para ficheiros HTML ou ``'styles'`` para CSS

en: The list of files to be merged
pt: A lista de ficheiros a serem fundidos

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
pt: Qual dos ficheiros a fundir será o ficheiro *mestre*, ou seja, qual é o ficheiro que será mantido depois da fusão.

en: Managing covers
pt: Gerir capas

en: Set the cover of the book to the image pointed to by cover_path.
pt: Torna a capa do livro na imagem apontada por cover_path.

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.
pt: O caminho absoluto para um ficheiro de imagem ou o nome canónico de uma imagem no livro. Quando usa uma imagem no livro tem também de definir opções, ver abaixo.

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
pt: Um função opcional que pode ser chamada e que tem um único argumento. Será chamada com informação acerca das tarefas em processamento.

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)
pt: Vazio, ou um dicionário que controla como a capa é criada. O dicionário pode conter as entradas: **keep_aspect**: Verdadeiro ou Falso (Preservar a proporção das imagens de capa no EPUB) **no_svg**: Verdadeiro ou Falso (Usar um embrulho SVG para a capa na página de título do EPUB) **existing**: Verdadeiro ou Falso (``cover_path`` refere-se a uma imagem existente no livro)

en: Mark the specified image as the cover image.
pt: Marca a imagem especificada como a imagem da capa.

en: Mark the specified HTML file as the titlepage of the EPUB.
pt: Marca o ficheiro HTML especificado como a página de capa do EPUB.

en: If True the HTML file is moved to the start of the spine
pt: Se verdadeiro, o ficheiro HTML será movido para o início da lombada

en: Working with CSS
pt: Trabalhar com CSS

en: If True, rules with identical selectors are merged.
pt: Se Verdadeiro, regras com selectores idênticos são fundidas.

en: Remove the specified CSS properties from all CSS rules in the book.
pt: Remove as propriedades CSS especificadas de todas as regras CSS no livro.

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
pt: Conjunto de propriedades a remover. Por exemplo: :code:`{'font-family', 'color'}`.

en: Working with the Table of Contents
pt: Trabalhar com o Í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.
pt: Cria um índice a partir de uma lista de expressões XPath. Cada expressão na lista corresponde a um nível do índice gerado. Por exemplo: :code:`['//h:h1', '//h:h2', '//h:h3']` criará um índice de três níveis partindo das etiquetas ``<h1>``, ``<h2>`` e ``<h3>``.

en: Generate a Table of Contents from links in the book.
pt: Gerar um índice a partir de hiperligações no livro.

en: Generate a Table of Contents from files in the book.
pt: Gerar um índice a partir de ficheiros no livro.

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
pt: Criar um índice incorporado (HTML) a partir de um índice NCX existente.

en: The title for this table of contents.
pt: O título para este índice.

en: Edit book tool
pt: Editar ferramenta do livro

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
pt: Devolve o :class:`calibre.ebooks.oeb.polish.container.Container` objeto atual que representa o livro a ser editado.

en: An optional short description of this action. If not specified the text from the QAction will be used.
pt: Uma descrição breve opcional desta ação. Se não especificada será usado o texto de QAction.

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
pt: Uma descrição mais detalhada desta ação, que será usada na entrada das preferências deste atalho.

en: Create a QAction that will be added to either the plugins toolbar or the plugins menu depending on ``for_toolbar``. For example::
pt: Cria uma QAction que será adicionada à barra de ferramentas dos plugins ou ao menu de plugins, dependendo valor de ``for_toolbar``. Por exemplo::

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

en: Controlling the editor's user interface
pt: Controlar a interface de utilizador do 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.
pt: A interface de utilizador do editor de ebook é controlada por um único objeto *Boss* global. Isto permite vários métodos úteis que podem ser usados no código do plugin para realizar tarefas comuns.

en: Sync the position of the preview panel to the current cursor position in the current editor
pt: Sincronizar posição do painel de pré-visualização com a posição atual do cursor no editor atual
