calibre - en to pt_BR translation catalogue (45 entries)

en: Setting up a calibre development environment
pt_BR: Configurando um ambiente de desenvolvimento do calibre

en: calibre is completely open source, licensed under the `GNU GPL v3 <https://www.gnu.org/licenses/gpl.html>`_. This means that you are free to download and modify the program to your heart's content. In this section, you will learn how to get a calibre development environment set up on the operating system of your choice. calibre is written primarily in `Python <https://www.python.org>`_ with some C/C++ code for speed and system interfacing. Note that calibre requires at least Python 3.8.
pt_BR: calibre é completamente open source, licenciado sob o 'GNU GPL v3 <https://www.gnu.org/licenses/gpl.html>'_. Isso significa que você é livre para baixar e modificar o programa para o conteúdo do seu coração. Nesta seção, você aprenderá como configurar um ambiente de desenvolvimento de calibre no sistema operacional de sua escolha. calibre é escrito principalmente em 'Python <https://www.python.org>'_ com algum código C/C++ para velocidade e interface do sistema. Note que o calibre requer pelo menos Python 3.8.

en: Contents
pt_BR: Conteúdo

en: Design philosophy
pt_BR: Filosofia de desenvolvimento

en: calibre has its roots in the Unix world, which means that its design is highly modular. The modules interact with each other via well defined interfaces. This makes adding new features and fixing bugs in calibre very easy, resulting in a frenetic pace of development. Because of its roots, calibre has a comprehensive command line interface for all its functions, documented in :doc:`generated/en/cli-index`.
pt_BR: O Calibre tem as suas raízes no mundo Unix, o que se traduz por um design altamente modular. Os módulos interagem uns com os outros através de interfaces bem definidas. Tal torna o adicionar de novas funcionalidades e a correção de erros de programação muito fáceis no Calibre, resultando num ritmo frenético de desenvolvimento. Por causa das suas raízes, o Calibre tem uma interface de linha de comando muito completa para todas as suas funções, documentadas em :doc:`generated/pt/cli-index`.

en: The modular design of calibre is expressed via ``Plugins``. There is a :ref:`tutorial <customize>` on writing calibre plugins. For example, adding support for a new device to calibre typically involves writing less than a 100 lines of code in the form of a device driver plugin. You can browse the `built-in drivers <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_. Similarly, adding support for new conversion formats involves writing input/output format plugins. Another example of the modular design is the :ref:`recipe system <news>` for fetching news. For more examples of plugins designed to add features to calibre, see the `Index of plugins <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_.
pt_BR: O design modular do calibre é expresso através de ''Plugins''. Há um :ref:'tutorial <customize>' sobre a escrita de plugins de calibre. Por exemplo, adicionar suporte para um novo dispositivo ao calibre normalmente envolve escrever menos de 100 linhas de código na forma de um plug-in de driver de dispositivo. Você pode navegar pelo 'built-in drivers <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>'_. Da mesma forma, adicionar suporte para novos formatos de conversão envolve escrever plugins de formato de entrada/saída. Outro exemplo do design modular é o sistema :ref:'recipe <news>' para buscar notícias. Para obter mais exemplos de plug-ins projetados para adicionar recursos ao calibre, consulte o 'Índice de plug-ins <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>'_.

en: Code layout
pt_BR: Layout do código

en: All the calibre Python code is in the ``calibre`` package. This package contains the following main sub-packages
pt_BR: Todo o código Python calibre está no pacote ''calibre''. Este pacote contém os seguintes subpacotes principais

en: devices - All the device drivers. Just look through some of the built-in drivers to get an idea for how they work.
pt_BR: dispositivos - Todos os drivers de dispositivo. Olhe alguns dos drivers embutidos para ter uma ideia de como eles funcionam.

en: For details, see: ``devices.interface`` which defines the interface supported by device drivers and ``devices.usbms`` which defines a generic driver that connects to a USBMS device. All USBMS based drivers in calibre inherit from it.
pt_BR: Para obter detalhes, consulte: ''devices.interface'' que define a interface suportada por drivers de dispositivo e ''devices.usbms'' que define um driver genérico que se conecta a um dispositivo USBMS. Todos os drivers baseados em USBMS em calibre herdam dele.

en: e-books  - All the e-book conversion/metadata code. A good starting point is ``calibre.ebooks.conversion.cli`` which is the module powering the :command:`ebook-convert` command. The conversion process is controlled via ``conversion.plumber``. The format independent code is all in ``ebooks.oeb`` and the format dependent code is in ``ebooks.format_name``.
pt_BR: e-books - Todo o código de conversão/metadados do e-book. Um bom ponto de partida é ''calibre.ebooks.conversion.cli'', que é o módulo que alimenta o comando :command:'ebook-convert'. O processo de conversão é controlado através de ''conversion.plumber''. O código independente de formato está todo em ''ebooks.oeb'' e o código dependente de formato está em ''ebooks.format_name''.

en: Metadata reading, writing, and downloading is all in ``ebooks.metadata``
pt_BR: A leitura, escrita e download de metadados estão em ``ebooks.metadata``

en: Conversion happens in a pipeline, for the structure of the pipeline, see :ref:`conversion-introduction`. The pipeline consists of an input plugin, various transforms and an output plugin. The code that constructs and drives the pipeline is in :file:`plumber.py`. The pipeline works on a representation of an e-book that is like an unzipped epub, with manifest, spine, toc, guide, html content, etc. The class that manages this representation is OEBBook in ``ebooks.oeb.base``. The various transformations that are applied to the book during conversions live in :file:`oeb/transforms/*.py`. And the input and output plugins live in :file:`conversion/plugins/*.py`.
pt_BR: A conversão acontece em um pipeline, para a estrutura do pipeline, veja :ref:'conversion-introduction'. O pipeline consiste em um plugin de entrada, várias transformações e um plugin de saída. O código que constrói e conduz o pipeline está em :file:'plumber.py'. O pipeline funciona em uma representação de um e-book que é como um epub descompactado, com manifesto, coluna, toc, guia, conteúdo html, etc. A classe que gerencia essa representação é OEBBook em ''ebooks.oeb.base''. As várias transformações que são aplicadas ao livro durante as conversões vivem em :file:'oeb/transforms/*.py'. E os plugins de entrada e saída vivem em :file:'conversion/plugins/*.py'.

en: E-book editing happens using a different container object. It is documented in :ref:`polish_api`.
pt_BR: A edição de e-book acontece usando um objeto de contêiner diferente. Está documentado em :ref:'polish_api'.

en: db - The database back-end. See :ref:`db_api` for the interface to the calibre library.
pt_BR: db - O back-end do banco de dados. Consulte :ref:'db_api' para a interface com a biblioteca de calibre.

en: Content server: ``srv`` is the calibre Content server.
pt_BR: Servidor de conteúdo: ''srv'' é o servidor de conteúdo de calibre.

en: gui2 - The Graphical User Interface. GUI initialization happens in ``gui2.main`` and ``gui2.ui``. The e-book-viewer is in ``gui2.viewer``. The e-book editor is in ``gui2.tweak_book``.
pt_BR: gui2 - A Interface Gráfica do Usuário. A inicialização da GUI acontece em ''gui2.main'' e ''gui2.ui''. O e-book-viewer está em ''gui2.viewer''. O editor de e-book está em ''gui2.tweak_book''.

en: If you want to locate the entry points for all the various calibre executables, look at the ``entry_points`` structure in `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_.
pt_BR: Se você quiser localizar os pontos de entrada para todos os vários executáveis de calibre, observe a estrutura ''entry_points'' em 'linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>'_.

en: If you need help understanding the code, post in the `development forum <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ and you will most likely get help from one of calibre's many developers.
pt_BR: Se você precisar de ajuda para entender o código, poste no 'fórum de desenvolvimento <https://www.mobileread.com/forums/forumdisplay.php?f=240>'_ e você provavelmente receberá ajuda de um dos muitos desenvolvedores do calibre.

en: Getting the code
pt_BR: Obtendo o código

en: You can get the calibre source code in two ways, using a version control system or directly downloading a :website_base:`tarball <dist/src>`.
pt_BR: Você pode obter o código-fonte do calibre de duas maneiras, usando um sistema de controle de versão ou baixando diretamente um :website_base:'tarball <dist/src>'.

en: calibre uses `Git <https://www.git-scm.com/>`_, a distributed version control system. Git is available on all the platforms calibre supports.  After installing Git, you can get the calibre source code with the command::
pt_BR: calibre usa 'Git <https://www.git-scm.com/>'_, um sistema de controle de versão distribuído. O Git está disponível em todas as plataformas suportadas. Depois de instalar o Git, você pode obter o código-fonte do calibre com o comando::

en: On Windows you will need the complete path name, that will be something like :file:`C:\\Program Files\\Git\\git.exe`.
pt_BR: No Windows, você precisará do nome completo do caminho, que será algo como :file:'C:\\Arquivos de Programas\\Git\\git.exe'.

en: calibre is a very large project with a very long source control history, so the above can take a while (10 mins to an hour depending on your internet speed).
pt_BR: O calibre é um projeto muito grande com um histórico de controle de fonte muito longo, então o acima pode levar um tempo (10 minutos a uma hora, dependendo da velocidade da sua internet).

en: You can also browse the code at `GitHub <https://github.com/kovidgoyal/calibre>`_.
pt_BR: Também é possível navegar pelo código no `GitHub <https://github.com/kovidgoyal/calibre>`_.

en: Submitting your changes to be included
pt_BR: Enviando suas alterações para serem incluídas

en: In a Terminal do::
pt_BR: Em um Terminal faça::

en: Windows development environment
pt_BR: Ambiente de Desenvolvimento Windows

en: macOS development environment
pt_BR: ambiente de desenvolvimento no macOS

en: Create a plain text file::
pt_BR: Crie um arquivo de texto simples::

en: Save this file as :file:`/usr/local/bin/calibre-develop`, then set its permissions so that it can be executed::
pt_BR: Guardar este ficheiro como :file:`/usr/local/bin/calibre-develop`, e depois defina as suas permissões para que possa ser executado::

en: Once you have done this, run::
pt_BR: Depois de fazer isso, execute::

en: Linux development environment
pt_BR: Ambiente de Desenvolvimento Linux

en: Once you have set the environment variable, open a new terminal and check that it was correctly set by using the command::
pt_BR: Depois de definir a variável de ambiente, abra uma nova janela de terminal e verifique se foi configurado corretamente usando o comando::

en: Using print statements
pt_BR: Usando declarações ``print()``

en: The e-book-editor can be started as::
pt_BR: O editor de e-book pode ser iniciado como::

en: Using an interactive Python interpreter
pt_BR: Usando um interpretador *Python* interativo

en: You can insert the following two lines of code to start an interactive Python session at that point::
pt_BR: É possível inserir as duas linhas de código a seguir para iniciar uma sessão *Python* interativa nesse ponto::

en: Using the Python debugger as a remote debugger
pt_BR: Usando o depurador *Python* como depurador remoto

en: Now open a terminal or command prompt and use the following command to start the debugging session::
pt_BR: Agora abra uma janela de terminal ou Prompt de Comando e use o seguinte comando para iniciar a sessão de depuração::

en: Using the debugger in your favorite Python IDE
pt_BR: Usar o depurador no seu IDE Python favorito

en: Using calibre in your projects
pt_BR: Usando o *Calibre* em seus projetos

en: It is possible to directly use calibre functions/code in your Python project. Two ways exist to do this:
pt_BR: É possível usar funções/código do *Calibre* diretamente em seu projeto *Python*. Existem duas maneiras de fazer isso:

en: Binary install of calibre
pt_BR: Instalação binária de *Calibre*

en: Source install on Linux
pt_BR: Instalação de Origem no Linux
