calibre - en to pt_BR translation catalogue (36 entries)

en: Snippets
pt_BR: Trechos

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
pt_BR: O editor Calibre de ebook suporta *trechos*. Um trecho é um pedaço de texto que é reutilizado com frequência ou contém algum texto redundante. O editor permite que você insira um trecho com apenas algumas combinações de teclas. Por exemplo, suponha que você insira frequentemente etiquetas de hiperligação ao editar ficheiros HTML: poderá digitar simplesmente ``<a`` no editor e premir |ct|. O editor irá expandi-lo para:

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
pt_BR: Não apenas isto, a palavra ``filename`` será selecionada, com o cursor sobre ela, assim você pode facilmente digitar o verdadeiro nome do arquivos, usando o recurso astucioso do editor :ref:`editor_auto_complete`. Assim que você terminar de digitar o nome do arquivo, pressione |ct| novamente e o cursor se moverá para a posição entre as tags ``<a>``, assim você poderá facilmente digitar o texto para o link.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
pt_BR: O sistema de trechos do editor é muito sofisticado, há uma pequena quantidade de trechos embutidos e você pode criar seus próprios trechos para se adequar ao seu estilo de edição.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
pt_BR: A seguinte discussão sobre os trechos embutidos devem ajudar a ilustrar o poder do sistema de trechos.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
pt_BR: É possível incluir trechos de texto nos campos de entrada na tela :guilabel:`Localizar & substituir`, apesar de que placeholders (usando |ct| para navegação) não irão funcionar.

en: The built-in snippets
pt_BR: Os trechos embutidos

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
pt_BR: Os trechos embutidos estão descritos logo abaixo. Note que você pode substitui-los criando seus próprios trechos com o mesmo texto de ativação.

en: Inserting filler text [Lorem]
pt_BR: Inserindo texto de preenchimento [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
pt_BR: O primeiro trecho embutido, e o mais simples, é usado para inserir texto de preenchimento em um documento. O texto de preenchimento é tirado de `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ uma obra filosófica da autoria de Cicero (traduzido para o Inglês). Para usá-lo, apenas digite ``Lorem`` em um arquivo HTML e pressione  |ct|. O texto será substituído por dois parágrafos do texto de preenchimento.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
pt_BR: A definição deste trecho é bem simples, o texto de ativação é definido como ``Lorem`` e o modelo é definido simplesmente como o texto literal a ser inserido. Você pode facilmente personaliza-lo para usar sua forma favorita de texto de preenchimento.

en: Inserting a self-closing HTML tag [<>]
pt_BR: Inserindo uma tag HTML de fechamento automático [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
pt_BR: Agora olhe um simples exemplo do poderoso conceito de *placeholders*. Digamos que você queira inserir a tag de fechamento automático ``<hr/>``. Apenas digite ``<>``, e pressione |ct|, o editor expandirá o trecho para::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
pt_BR: Aqui, o símbolo ``|`` representa a atual posição do cursor. Você pode então pressionar ``hr`` e pressionar |ct| para mover o cursor para o final da tag. Este trecho é definido como::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
pt_BR: Placeholders são simplesmente o símbolo dólar ($) seguido por um número. Quando o trecho é expandido ao pressionar |ct| o cursor é posicionado no primeiro placeholder (aquele com o menor número). Quando você pressionar |ct| novamente, o cursor move-se para o próximo placeholder (aquele com o próximo número superior).

en: Inserting an HTML link tag [<a]
pt_BR: Inserindo uma tag de link HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
pt_BR: Todas as tags HTML de link compartilham uma estrutura comum. Elas tem um atributo ``href`` e algum texto entre as tags de abertura e fechamento. Um trecho para tornar a digitação delas mais eficiente nos introduzirá a mais características dos placeholders. Para usar esse trecho, simplesmente digite ``<a`` e pressione |ct|. O editor vai expandir isso para::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
pt_BR: Não só isso, a palavra "filename" vai ser selecionada, com o cursor localizado sobre esta, assim você pode facilmente digitar no nome do arquivo, usando o recurso de estilo do editor :ref:`editor_auto_complete`. E uma vez que você acabou de digitar o nome do arquivo, pressione |ct| novamente e o cursor vai pular para a posição entre as tags ``<a>`` assim você pode facilmente digitar o texto para o link. Depois de você acabar de digitar o texto, pressione |ct| novamente para pular para o ponto depois da tag de fechamento. Esse fragmento é definido como::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
pt_BR: Existem alguns recursos novos aqui. Primeiro o marcador ``$1`` ficou mais complexo. Agora ele inclui um *texto padrão* (a palavra ``filename``). Se um marcador contiver o texto padrão, o texto padrão é substituído pelo marcador quando o trecho for expandido. Além disso, quando se pula para um marcador com o texto padrão usando |ct|, o texto padrão é selecionado. Assim, é possível usar o texto padrão para atuar como um lembrete para incluir partes importantes do modelo. Pode-se especificar o texto padrão para um marcador usando a sintaxe: ``${<number>:texto padrão}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
pt_BR: O outro recurso novo é que o segundo marcador tem um asterisco depois dele (``${2*}``). Isto quer dizer que qualquer texto selecionado antes da expansão do modelo é substituído pelo marcador. Para ver como este recurso funciona, selecione algum texto no editor, pressione |ct|, digite ``<a`` e pressione |ct| novamente, o modelo será expandido para ::

en: Inserting a HTML image tag [<i]
pt_BR: Inserindo uma etiqueta HTML de imagem [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
pt_BR: Isto é bem semelhante a inserir um link HTML, como se viu acima. Ela permite que se coloque rapidamente uma ``<img src="filename" alt="description" />`` etiqueta e coloca entre os atributos ``src`` e ``alt``::

en: Insert an arbitrary HTML tag [<<]
pt_BR: Inserir uma etiqueta HTML aleatória [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. The editor will expand it to::
pt_BR: Isto permite que se insira uma etiqueta HTML completa  (ou termine um texto previamente selecionado na etiqueta). Para usar, basta digitar ``<<`` e pressionar |ct|. O editor vai expandir para::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
pt_BR: Digite o nome da tag, por exemplo: ``span`` e pressione |ct|, isto irá resultar em::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
pt_BR: Repare que a etiqueta de fechamento foi automaticamente preenchida com ``span``. Isto é possível com mais um tipo de placeholder, *mirroring*. Mirroring (espelhamento) significa simplesmente que se se especificar o placeholder de exemplo mais de uma vez no modelo, a segunda e todas as posições subsequentes serão automaticamente preenchidas com o que for especificado na primeira posição, quando se pressionar |ct|. A definição para este trecho é::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
pt_BR: Como é possível perceber, o primeiro marcador ($1) foi especificado duas vezes, a segunda vez na tag de fechamento, que simplesmente copiará o que for digitado na tag de abertura.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
pt_BR: A inserir uma etiqueta HTML aleatória com o atributo de classe [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
pt_BR: Isto é semelhante ao exemplo de inserção arbitrária de etiqueta acima, exceto que se presume que se deseja especificar uma classe para a etiqueta::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
pt_BR: Isto irá permitir que se digite o nome da etiqueta primeiro, pressione |ct|, digite o nome da classe, pressione |ct|, digite o conteúdo da etiqueta e pressione |ct| uma última vez para sair da etiqueta. O fechamento da etiqueta irá ser auto-preenchido.

en: Creating your own snippets
pt_BR: Criando seus próprios trechos

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
pt_BR: Trechos são bastantes versáteis pois é possível criar um que seja adequado ao seu estilo de edição. Para criar seus trechos, vá para :guilabel:`Editar->Opções->Ajustes do editor->Gerenciar trechos` no editor. Irá aparecer uma tela fácil de itilizar, para ajudar a criar os seus trechos. Clique no botão :guilabel:`Adicionar trecho` e aparecerá uma tela semelhante a:

en: The create your own snippets tool
pt_BR: A ferramenta Criando seus próprios trechos

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
pt_BR: Primeiro dê um nome ao seu trecho, algo descritivo para identificá-lo no futuro. Depois especifique o *gatilho*. Um gatilho é simplesmente o texto que é necessário digitar no editor  antes de pressionar |ct| para expandir o trecho.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
pt_BR: Depois especifique o modelo do trecho. É recomendável começar com um dos exemplos acima e modificá-lo para se adequar às suas necessidades. Finalmente, especifique para quais tipos de arquivos você quer que o trecho esteja ativo. Assim, é possível ter vários trechos com o mesmo texto de gatilho que funcionarão de formas diferentes em tipos de arquivos diferentes.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
pt_BR: O próximo passo é testar o seu novo trecho criado. Use a caixa :guilabel:`Teste` na parte inferior. Digite o texto de ativação e pressione |ct| para expandir o trecho e mover-se entre os placeholders.
