docs-documentation-guide - en to pt translation catalogue (821 entries)

en: Red Hat, Inc. and others
pt: Red Hat, Inc. e outros

en: Fedora Documentation Guide
pt: Guia de Documentação do Fedora

en: Guidelines and procedures for producing documentation for Fedora
pt: As orientações e procedimentos para produzir a documentação do Fedora

en: Add L10n chapter (#441190)
pt: Adicionar capítulo L10n (#441190)

en: Fix some organization and missing targets (#371531)
pt: Corrigida alguma organização e prazos não cumpridos  (#371531)

en: Add link to DocBook XML help for Windows
pt: Adicionar atalho a DocBook XML ajuda para windows

en: Add guidance on CVS web access and previewing work
pt: Adição de indicações sobre o acesso Web ao CVS e à antevisão do trabalho

en: Add new chapter on publishing
pt: Adição de um novo capítulo sobre a publicação

en: Include information on LINGUAS usage
pt: Incluir a informação sobre a utilização do LINGUAS

en: Remove unnecessary chapter on XML tags
pt: Remover um capítulo desnecessário sobre as etiquetas de XML

en: Assorted fixes to reflect newer version of reality
pt: Correcções associadas para reflectir uma versão mais recente da realidade

en: Update to new content and build requirements
pt: Actualização para o novo conteúdo e requisitos de compilação

en: Localization (L10n)
pt: Localização (L10n)

en: This chapter discusses how translations are provided in Fedora documentation.
pt: Este capítulo trata do modo como as traduções são fornecidas na documentação do Fedora.

en: PO Files
pt: Ficheiros PO

en: The cornerstone of translation when using XML files such as DocBook is the <firstterm>Portable Object</firstterm> or <acronym>PO</acronym> file. PO files provide a way for independent individuals or teams to translate documents. The Fedora Documentation Project toolchain includes rules for creating, updating, and maintaining these PO files.
pt: A pedra angular para a tradução quando se utiliza ficheiros XML tais como o DocBook é o <firstterm>Portable Object</firstterm> ou ficheiros <acronym>PO</acronym>. Os ficheiros PO permitem a tradução individual ou por equipas, de documentos. O conjunto de ferramentas do Projecto de Documentação do Fedora inclui as regras para a criação, actualização e manutenção destes ficheiros PO.

en: PO files are usually found in two forms:
pt: Os ficheiros PO encontram-se, normalmente, sob duas formas:

en: the <filename class="extension">.pot</filename> file, or <firstterm>PO Template</firstterm> (<acronym>POT</acronym>)
pt: o <filename class="extension">.pot</filename> ficheiro, ou <firstterm>Padrão PO</firstterm> (<acronym>POT</acronym>)

en: the <filename class="extension">.po</filename> file, or translation file (<acronym>PO</acronym>)
pt: O ficheiro <filename class="extension">.po</filename>, ou ficheiro de tradução (<acronym>PO</acronym>)

en: A POT is, as the name suggests, a blank template for new translations. It contains some header information and a list of strings based on the content of the original XML file from which it was created. Translators do not alter the POT. The POT should only be changed after changes are made to the original XML file from which it is derived.
pt: Um ficheiro POT é, como o nome sugere, um template em branco para novas traduções. Contém alguma informação no cabeçalho e uma lista de strings relacionadas com o conteúdo do ficheiro XML original a partir do qual foi criado. Os tradutores não alteram o POT. O POT só deve ser alterado depois de terem sido feitas as alterações ao ficheiro XML original a partir do qual este teve origem.

en: A translator who wishes to start working on a new language copies the POT to a locale-specific PO file. Then the translator uses any of a number of command-line or graphical tools to translate each of the strings in the list. A single POT is used to create many POs, one for each locale. These files are normally named for their locale code, such as <filename>de.po</filename>, <filename>it.po</filename>, and so on.
pt: Um tradutor que pretenda começar a trabalhar numa nova língua, copia o ficheiro POT para um ficheiro PO específico para a sua língua. Posteriormente, o tradutor utiliza um conjunto de comandos ou ferramentas gráficas para traduzir cada uma das strings na lista. Um único ficheiro POT pode ser usado para criar muitos ficheiros PO, um por cada localização. A estes ficheiros atribui-se normalmente  um nome em função do código da sua localização, tais como <filename>de.po</filename>, <filename>it.po</filename>, e assim por diante.

en: Creating or Updating a POT
pt: A criar ou a actualizar um POT

en: The POT is named after the document from which it is derived. If document named in the <filename>Makefile</filename>) is <filename>foo-tutorial.xml</filename>, the POT is named <filename>foo-tutorial.pot</filename>.
pt: É atribuído um nome ao ficheiro POT em função do documento a partir do qual este teve origem. Se o documento cujo nome no <filename>Makefile</filename>) é <filename>foo-tutorial.xml</filename>, o ficheiro POT é designado por <filename>foo-tutorial.pot</filename>.

en: To create a new POT, use the following command:
pt: Para criar um novo POT, utilize o seguinte comando:

en: The same command is used to update the POT when the original XML sources change.
pt: O mesmo comando é utilizado para actualizar o POT quando mudam códigos originais do XML.

en: Keep POT Fresh
pt: Manter POT actualizado.

en: Update the POT whenever the original XML changes. Many translators' tools automatically notify them of the change so they can update translations quickly.
pt: Actualizar o POT sempre que o XML original for alterado. Muitas das ferramentas dos tradutores fazem a notificação automática desta alteração permitindo que se efectuem rapidamente as actualizações nas traduções.

en: Updating PO Files
pt: A actualizar os ficheiros PO

en: The translation files are created by the individual translators, and document maintainers do not normally need to create them. Translators update a list of locales in the <filename>po/LINGUAS</filename> file which defines all the locales for which translations exist.
pt: Os fiheiros de tradução são criados por cada tradutor, individualmente, e os gestores de documentos normalmente não precisam de os criar. Os tradutores actualizam uma lista de locais no ficheiro  <filename>po/LINGUAS</filename> o qual define todos os locais para os quais existe tradução.

en: Whenever the source XML files are updated, the maintainer must at least update the POT. It is helpful, however, to also merge these changes with the existing translations for those translators who are not automatically notified of changes.
pt: Sempre que os ficheiros fonte XML são actualizados, o gestor deve, pelo menos, actualizar o POT. Ajuda, contudo, também adicionar estas alterações às traduções existentes para aqueles tradutores que não são automaticamente notificados das alterações.

en: Staying Current
pt: A manter-se actualizado

en: Always make sure your local copy of PO is fresh, using the CVS "update" command:
pt: Assegure-se sempre que a sua cópia do ficheiro PO é recente, utilizando o comando CVS "update"

en: To merge new changes into the existing PO translations, use the following command:
pt: Para juntar novas alterações às traduções existentes do PO, utilize o seguinte comando:

en: Checking Statistics
pt: A confirmar estatísticas

en: PO strings fall into three categories:
pt: As strings dos ficheiros PO recaem em três categorias:

en: <firstterm>translated</firstterm>, meaning the string has been handled by a translator and its source has not changed since then
pt: <firstterm>traduzida</firstterm>, significa que a string foi manuseada por um tradutor e que a sua fonte não se modificou desde então.

en: <firstterm>fuzzy</firstterm>, meaning the string has changed since it was last handled by a translator
pt: <firstterm>fuzzy</firstterm>, significa que a string se alterou desde a última vez que foi modificada por um tradutor

en: <firstterm>untranslated</firstterm>, meaning no translation has yet been provided for this string, or it is brand new
pt: <firstterm>por traduzir</firstterm>, significa que ainda não foi adiantada qualquer tradução para a string em questão, ou então, tratar-se de uma string recente.

en: To see a rough statistical tally of the string handling inside the PO for a module, use the following command:
pt: Para ver uma aproximação estatística relativamente ao tratamento das strings num PO para determinado módulo, use o seguinte comando:

en: For each locale in the list, a count is shown of translated, fuzzy, and untranslated strings in that order. Tallies that only provide two numerals are usually translated followed by untranslated. Tallies with only one numeral are usually fully translated.
pt: Para cada local nas listas, é mostrada uma contagem das strings traduzidas, fuzzy, e por traduzir, nesta mesma ordem. Tallies

en: To see only a specific locale, append a dash and the locale code to the <command>postat</command> target:
pt: Para visualizar especificamente uma língua, acrescente uma barra e o código da localização ao comando <command>postat</command> destino:

en: Publishing Official Documentation
pt: Publicar a Documentação Oficial

en: This chapter shows how to publish official Fedora Documentation Project work to the <systemitem class="fqdomainname">docs.fedoraproject.org</systemitem> website. To publish official documentation, you must be approved to write to the web repository in CVS. Access for publishing is limited to contributors who have demonstrated capacity for working with CVS and other project tools. Once you have acquired and are comfortable with these skills, contributions as a publisher are welcome.
pt: Este capítulo mostra como publicar o trabalho no Projecto de Documentação do Fedora oficial para o servidor <systemitem class="fqdomainname">docs.fedoraproject.org</systemitem>. Para publicar a documentação oficial, deverá estar aprovado para escrever o repositório Web no CVS. O acesso de publicação está limitado aos contribuintes que tenham demonstrado capacidade para trabalhar com o CVS e as outras ferramentas do projecto. Logo que a tenha adquirido e esteja à vontade com esses conhecimentos, as contribuições como responsável de publicação são bem-vindas.

en: How the Site Works
pt: Como Funciona o Site

en: The <systemitem class="fqdomainname">docs.fedoraproject.org</systemitem> website is a set of PHP files and scripts. Publishers maintain these files in a CVS repository, and the website host retrieves them hourly to refresh the site. The host does not automatically use the newest content for the website. Instead, it pulls files with the CVS tag <systemitem>LIVE</systemitem> to populate the website.
pt: A página Web do <systemitem class="fqdomainname">docs.fedoraproject.org</systemitem> é um conjunto de ficheiros e programas em PHP. Os responsáveis de publicação mantêm estes ficheiros num repositório de CVS e a página Web transfere-os de hora a hora para actualizar a página. A máquina não usa automaticamente o conteúdo mais recente para a página Web. Em vez disso, transfere os ficheiros com a marca de CVS <systemitem>LIVE</systemitem> para preencher a página Web.

en: Each publisher sets up a local testing website on an available Fedora system. This site, sometimes called a <firstterm>sandbox</firstterm>, allows the publisher to test and view changes to documents, and ensure stability on the public site.
pt: Cada responsável pela publicação configura uma página de testes num sistema Fedora que que esteja disponível. Esta página do servidor, chamada normalmente de <firstterm>ambiente de testes</firstterm>, permite ao responsável testar e ver as alterações dos documentos, garantindo a estabilidade da página para o público.

en: Setting Up a Web Sandbox
pt: A configurar um ambiente de testes na Web

en: To test document publishing, first set up a web sandbox on a local Fedora system.
pt: Para testar a publicação do documento, configure primeiro um ambiente de testes na Web numa máquina local de Fedora.

en: Install the "Web Server" package group:
pt: Instale o grupo de pacotes "Web Server" (Servidor Web):

en: Create a folder for the web server to access the site files.
pt: Crie uma pasta para o servidor Web aceder aos ficheiros da página.

en: Change the permissions on this directory to make it easier to access for your normal user account.
pt: Mude as permissões nesta pasta para facilitar o acesso para a sua conta normal de utilizador.

en: username
pt: utilizador

en: Link to the new directory from your home directory.
pt: Associe a pasta nova à sua pasta pessoal.

en: Retrieve the web module from CVS.
pt: Transfira o módulo 'web' do CVS.

en: Web CVS Access
pt: Acesso de CVS ao Web

en: You must have access to the <systemitem>cvsweb</systemitem> module through the Fedora Account System to check in changes. If you do not have access, you can use <userinput><![CDATA[:pserver:anonymous]]></userinput> in place of <userinput><![CDATA[:ext:username]]></userinput> above. Visit the Fedora Account System at <ulink url="http://admin.fedoraproject.org/accounts/"/> for more information.
pt: Deverá ter acesso ao módulo <systemitem>cvsweb</systemitem> através do Sistema de Contas do Fedora para verificar e enviar as alterações. Se não tiver acesso, poderá usar o <userinput><![CDATA[:pserver:anonymous]]></userinput> em vez do <userinput><![CDATA[:ext:utilizador]]></userinput> indicado acima. Visite o Sistema de Contas do Fedora em <ulink url="http://admin.fedoraproject.org/accounts/"/> para mais informações.

en: Edit the <filename>/etc/hosts</filename> file and add the following line <emphasis>after</emphasis> all other lines:
pt: Edite o ficheiro <filename>/etc/hosts</filename> e adicione a seguinte linha <emphasis>depois</emphasis> de todas as outras linhas:

en: Create a file <filename>/etc/httpd/conf.d/fpo.conf</filename> with the following content:
pt: Crie um ficheiro <filename>/etc/httpd/conf.d/fpo.conf</filename> com o seguinte conteúdo:

en: Create a file <filename>/etc/php.d/fpo.ini</filename> with the following content:
pt: Crie um ficheiro <filename>/etc/php.d/fpo.ini</filename> com o seguinte conteúdo:

en: Start the web server using the following command:
pt: Inicie o servidor Web com o seguinte comando:

en: To have the web server start at every boot, use the following command:
pt: Para que o servidor Web seja iniciado sempre no arranque, execute o seguinte comando:

en: To test the new sandbox site, open a Web browser and point it at the URL <uri>http://docs.localhost.localdomain</uri>.
pt: Para testar a página do novo ambiente de teste, abra um navegador Web e aponte-o para o URL <uri>http://docs.localhost.localdomain</uri>.

en: Creating a New Publication
pt: Criar uma Publicação Nova

en: General Guidelines
pt: Recomendações Gerais

en: Follow these guidelines to ensure maintainability and ease of use for all publishers.
pt: Siga estas recomendações para garantir a facilidade de uso e manutenção para todos os responsáveis pela publicação.

en: Use a short, descriptive name for the document directory. The module name from its Docs CVS location is usually appropriate. Good examples include <filename class="directory">install-guide/</filename> or <filename class="directory">example-tutorial/</filename>.
pt: Use um nome breve e descritivo para a pasta de documentos. O nome do módulo no seu local do CVS é normalmente apropriado. Os bons exemplos incluem o <filename class="directory">install-guide/</filename> ou o <filename class="directory">example-tutorial/</filename>.

en: Under the document directory, include a branch directory if the document references specific features of a particular Fedora release.
pt: Sob a pasta do documento, inclua a pasta de uma ramificação, caso o documento faça referência a funcionalidades específicas de uma dada versão do Fedora.

en: Under the branch directory (or document directory if no branches are necessary), make at least a <filename class="directory">en_US/</filename> directory. Make an additional directory for each locale that has been fully translated.
pt: Na pasta da ramificação (ou na pasta do documento se não existirem ramificações), crie pelo menos uma pasta <filename class="directory">en_US/</filename>. Crie uma pasta adicional para cada código de país cuja documentação tenha sido completamente traduzida.

en: Adding Content
pt: Adicionar Conteúdos

en: To add content, follow the procedure below. The following commands show an example of adding content for a new document called the <citetitle>Foobar Tutorial</citetitle>. This document includes a translation for the "zz_XX" locale and follows specifics of each Fedora release.
pt: Para adicionar conteúdos, siga o procedimento abaixo. Os comandos seguintes mostra um exemplo de adição de conteúdos para um documento novo chamado <citetitle>Tutorial XPTO</citetitle>. Este documento inclui uma tradução para o código de país "zz_XX" e segue as especificidades de cada versão do Fedora.

en: Make the required directory structure.
pt: Crie a estrutura de pastas desejadas.

en: cd ~/fedora/web/html/docs/
    mkdir foobar-tutorial
    mkdir foobar-tutorial/f7
    mkdir foobar-tutorial/f7/{en_US,zz_XX}
pt: cd ~/fedora/web/html/docs/
    mkdir tutorial-xpto
    mkdir tutorial-xpto/f7
    mkdir tutorial-xpto/f7/{en_US,zz_XX}

en: Build the HTML version of each translation of the document from Docs CVS.
pt: Crie a versão em HTML de cada tradução do documento a partir do CVS de documentação.

en: ~/my-docs/foobar-tutorial/F-7/
pt: ~/os-meus-docs/tutorial-xpto/F-7/

en: Copy the HTML content to the web sandbox.
pt: Copie o conteúdo em HTML para o ambiente de teste da Web.

en: cd ~/fedora/web/html/docs/foobar-tutorial/f7/
    cp -r ~/my-docs/foobar-tutorial/F-7/foobar-tutorial-en_US/ en_US/
    cp -r ~/my-docs/foobar-tutorial/F-7/foobar-tutorial-zz_XX/ zz_XX/
pt: cd ~/fedora/web/html/docs/tutorial-xpto/f7/
    cp -r ~/os-meus-docs/tutorial-xpto/F-7/tutorial-xpto-en_US/ en_US/
    cp -r ~/os-meus-docs/tutorial-xpto/F-7/tutorial-xpto-zz_XX/ zz_XX/

en: Convert the HTML in each directory to PHP using the provided <filename>docbookhtml2php.py</filename> script.
pt: Converta o HTML em cada pasta para PHP, usando o programa <filename>docbookhtml2php.py</filename> que é fornecido.

en: Create any necessary <filename>index.php</filename> files for the overall directories. Each document and branch directory must have an <filename>index.php</filename> file directing users to appropriate content. In this example, the necessary files are <filename>foobar-tutorial/index.php</filename> and <filename>foobar-tutorial/f7/index.php</filename>. You do not need to write these files from scratch. Copy an existing file from another document, and change it as needed to suit the new document.
pt: Crie os ficheiros <filename>index.php</filename> necessários para as pastas globais. Cada pasta de documento e ramificação deverá ter um ficheiro <filename>index.php</filename> que direcciona os utilizadores para o conteúdo apropriado. Neste exemplo, os ficheiros necessários são o <filename>tutorial-xpto/index.php</filename> e o <filename>tutorial-xpto/f7/index.php</filename>. Não precisa de escrever estes ficheiros do zero. Copie um ficheiro existente a partir de outro documento e mude-o da forma adequada para o novo documento.

en: Depending on content, publication may include changing a higher-level <filename>index.php</filename> file.
pt: Dependendo do contexto, a publicação poderá incluir a mudança de um ficheiro <filename>index.php</filename> de um nível superior.

en: To test the changes in your sandbox, open a web browser and point it at <uri>http://docs.localhost.localdomain/</uri>.
pt: Para testar as alterações no seu ambiente de teste, abra um navegador Web e aponte-o para <uri>http://docs.localhost.localdomain/</uri>.

en: Always Test Changes
pt: Teste Sempre as Alterações

en: <emphasis>Do not proceed further until you test all changes.</emphasis> Check that all links and index pages work.
pt: <emphasis>Não siga mais em frente até que teste todas as alterações.</emphasis> Verifique se todas as ligações e páginas de índice funcionam.

en: Pushing Content to the Web
pt: Enviar o Conteúdo para a Web

en: To push your new content to the web site, follow this procedure:
pt: Para enviar o seu novo conteúdo para a página Web, siga este procedimento:

en: Add all the new file content to CVS.
pt: Adicione todos os conteúdos novos de ficheiros ao CVS.

en: cd ~/fedora/web/html/docs/
    cvs add foobar-tutorial
    cd foobar-tutorial
    cvs add f7
    cd f7
    cvs add en_US/ zz_XX/
    cvs add en_US/*php en_US/stylesheet-images/
    cvs add zz_XX/*php zz_XX/stylesheet-images/
    cvs add en_US/stylesheet-images/*png
    cvs add zz_XX/stylesheet-images/*png
    cd ../../
    cvs add foobar-tutorial/index.php
    cvs add foobar-tutorial/f7/index.php
pt: cd ~/fedora/web/html/docs/
    cvs add tutorial-xpto
    cd tutorial-xpto
    cvs add f7
    cd f7
    cvs add en_US/ zz_XX/
    cvs add en_US/*php en_US/stylesheet-images/
    cvs add zz_XX/*php zz_XX/stylesheet-images/
    cvs add en_US/stylesheet-images/*png
    cvs add zz_XX/stylesheet-images/*png
    cd ../../
    cvs add tutorial-xpto/index.php
    cvs add tutorial-xpto/f7/index.php

en: Commit the changes to CVS. Use a message that describes the document being committed.
pt: Envie as alterações para o CVS. Use uma mensagem que descreva o conteúdo a ser enviado.

en: message about document
pt: mensagem acerca do documento

en: cvs ci -m '<placeholder-1/>' foobar-tutorial/
pt: cvs ci -m '<placeholder-1/>' tutorial-xpto/

en: Tag the content <systemitem>LIVE</systemitem> in CVS.
pt: Marque o conteúdo como <systemitem>LIVE</systemitem> no CVS.

en: cvs tag -F LIVE foobar-tutorial/
pt: cvs tag -F LIVE tutorial-xpto/

en: VIM and DocBook
pt: O VIM e o DocBook

en: VIM has many features to help you write XML content such as DocBook, including syntax highlighting and customizable key bindings. Additionally, one can easily use external programs from VIM for features such as spell-checking. This chapter assumes you already know generally how to use VIM; if you want to learn how, try the <command>vimtutor</command> or by typing <userinput>:help tutor</userinput> from inside VIM.
pt: O VIM tem diversas funcionalidades que o ajudam a criar conteúdos em XML, como o DocBook, incluindo o realce de sintaxe e a atribuição de atalhos de teclado personalizados. Para além disso, poderá usar facilmente programas externos a partir do VIM para funcionalidades como a verificação ortográfica. Este capítulo assume que já tem algum conhecimento geral de utilização do VIM; se quiser aprender como, experimente o <command>vimtutor</command> ou escrevendo <userinput>:help tutor</userinput> dentro do VIM.

en: Setting Up Your <filename>.vimrc</filename> File
pt: Configurar o seu Ficheiro <filename>.vimrc</filename>

en: configuration file
pt: ficheiro de configuração

en: Below is a short sample <filename>.vimrc</filename> file that turns on some VIM features useful for editing SGML or XML content such as DocBook: <screen>
    <computeroutput>" Turn off vi compatibility settings like limited undo
    set nocompatible
    " Syntax highlighting based on file extension
    syntax on
    " Automatically insert newlines after 80 characters
    set textwidth=80
    " Automatically indent
    set autoindent
    " Match SGML tags with %
    source $VIMRUNTIME/macros/matchit.vim</computeroutput>
    </screen>
pt: Segue-se um pequeno exemplo do ficheiro <filename>.vimrc</filename> que activa algumas das funcionalidades úteis do VIM para editar conteúdos em SGML ou XML, como o DocBook: <screen>
    <computeroutput>" Desligar as opções de compatibilidade, como o 'desfazer' limitado
    set nocompatible
    " Realce de sintaxe com base na extensão do ficheiro
    syntax on
    " Inserir automaticamente mudanças de linha ao fim de 80 caracteres
    set textwidth=80
    " Indentação automática
    set autoindent
    " Corresponder as marcas de SGML com o %
    source $VIMRUNTIME/macros/matchit.vim</computeroutput>
    </screen>

en: Some of these features require the <filename>vim-enhanced</filename> package to be installed. If you are using or the <filename>vim-minimal</filename> package, or if you are using an older version of VIM, you may not have the <filename>$VIMRUNTIME/macros/matchit.vim</filename> file. You can still download <ulink url="http://vim.org/scripts/script.php?script_id=39">matchit.zip from Vim.org</ulink> and load it separately.
pt: Algumas destas funcionalidades necessitam de ter instalado o pacote <filename>vim-enhanced</filename>. Se estiver a usar o pacote <filename>vim-minimal</filename> ou se estiver a usar uma versão antiga do VIM, poderá não ter o ficheiro <filename>$VIMRUNTIME/macros/matchit.vim</filename>. Poderá à mesma transferir o <ulink url="http://vim.org/scripts/script.php?script_id=39">ficheiro matchit.zip do Vim.org</ulink> e carregá-lo em separado.

en: Keymapping with VIM
pt: Mapeamento de teclas com o VIM

en: VIM can speed up your DocBook creation by mapping frequently typed tags (or any words or phrases) onto short key combinations. By default, the keymap leader is the backslash (<literal>\</literal>), but it can be redefined with a command like <userinput>let mapleader =
          ","</userinput>. There are two ways to use the following example; you can put it directly in your <filename>.vimrc</filename>, or you can save it in a separate file and load it with a <userinput>source</userinput> command in your <filename>.vimrc</filename>. <screen>
    <![CDATA[let mapleader = ","
    
    " skip ahead to after next tag without leaving insert mode
    imap <leader>e <esc>/><cr>:nohlsearch<cr>a
    
    " common tags that start a new text block
    imap<leader>pa <para><cr></para><esc>O
    imap<leader>sn <section id=""><cr><para><esc>jo</section><esc>O
    imap<leader>pl <programlisting><cr></programlisting><esc>O<esc>0i
    imap<leader>cp <computeroutput></computeroutput><esc>O<esc>0i
    
    " common tags that are placed inline
    " use <esc>F>a
    imap<leader>en <envar></envar><esc>F>a
    imap<leader>fi <filename></filename><esc>F>a
    imap<leader>lt <literal></literal><esc>F>a
    imap<leader>re <replaceable></replaceable><esc>F>a
    imap<leader>ui <userinput></userinput><esc>F>a
    imap<leader>ul <ulink url=""></ulink><esc>F>a
    imap<leader>si <systemitem></systemitem><esc>F>a
    imap<leader>us <systemitem class="username"></systemitem><esc>F>a
    imap<leader>sy <systemitem class="systemname"></systemitem><esc>F>a
    imap<leader>cm <command></command><esc>F>a                                  
    " entities
    imap <leader>> &gt;
    imap <leader>< &lt;]]>
    </screen>
pt: O VIM poderá acelerar a criação do seu DocBook, mapeando as teclas escritas com mais frequência (ou palavras ou frases) em combinações de teclas breves. Por omissão, o líder do mapa de teclados é a barra invertida (<literal>\</literal>), mas poderá ser redefinida com um comando do tipo <userinput>let mapleader =
          ","</userinput>. Existem duas formas de usar o seguinte exemplo; podê-lo-á colocar direcamente no seu ficheiro <filename>.vimrc</filename> ou podê-lo-a gravar num ficheiro separado e fazendo referência com o comando <userinput>source</userinput> no seu <filename>.vimrc</filename>. <screen>
    <![CDATA[let mapleader = ","
    " passar à frente, a seguir à próxima marca, sem deixar o modo de inserção
    imap <leader>e <esc>/><cr>:nohlsearch<cr>a
    " marcas comuns que iniciam um novo bloco de texto
    imap<leader>pa <para><cr></para><esc>O
    imap<leader>sn <section id=""><cr><para><esc>jo</section><esc>O
    imap<leader>pl <programlisting><cr></programlisting><esc>O<esc>0i
    imap<leader>cp <computeroutput></computeroutput><esc>O<esc>0i
    " marcas comuns que se colocam de forma incorporada
    " use <esc>F>a
    imap<leader>en <envar></envar><esc>F>a
    imap<leader>fi <filename></filename><esc>F>a
    imap<leader>lt <literal></literal><esc>F>a
    imap<leader>re <replaceable></replaceable><esc>F>a
    imap<leader>ui <userinput></userinput><esc>F>a
    imap<leader>ul <ulink url=""></ulink><esc>F>a
    imap<leader>si <systemitem></systemitem><esc>F>a
    imap<leader>us <systemitem class="username"></systemitem><esc>F>a
    imap<leader>sy <systemitem class="systemname"></systemitem><esc>F>a
    imap<leader>cm <command></command><esc>F>a                                  
    " entidades
    imap <leader>> &gt;
    imap <leader>< &lt;]]>
    </screen>

en: Unfortunately, there is not currently a complete macro set for all DocBook commands, so you will need to define them yourself or customize the definitions in the examples from <xref linkend="sn-vim-additional-resources"/>.
pt: Infelizmente, não existe de momento um conjunto de macros completo para todos os comandos do DocBook, pelo que terá de os definir você mesmo ou personalizar as definições nos exemplos em <xref linkend="sn-vim-additional-resources"/>.

en: Additional VIM Resources
pt: Recursos Adicionais do VIM

en: Additional information about VIM may be found from:
pt: Poderá encontrar mais informações acerca do VIM em:

en: <ulink url="http://newbiedoc.sourceforge.net/text_editing/vim.html#JESSE-SGMLRC"> Example sgml-vimrc</ulink> from the <citetitle>Beginner's guide to Vi Improved (VIM)</citetitle>
pt: <ulink url="http://newbiedoc.sourceforge.net/text_editing/vim.html#JESSE-SGMLRC"> Exemplo de sgml-vimrc</ulink> do <citetitle>Guia para principiantes do Vi Improved (VIM)</citetitle>

en: The <ulink url="http://tnerual.eriogerg.free.fr/vim.html">VIM Quick Reference Card</ulink>
pt: O <ulink url="http://tnerual.eriogerg.free.fr/vim.html">Cartão de Referências Rápidas do VIM</ulink>

en: Vim as XML Editor
pt: O Vim como Editor de XML

en: The <citetitle>VIM REFERENCE MANUAL</citetitle>, which comes with the <filename>vim-common</filename> package &mdash;<filename>/usr/share/vim/<replaceable>&lt;version&gt;</replaceable>/doc/intro.txt</filename> or type <userinput>:help intro</userinput> from within VIM
pt: O <citetitle>MANUAL DE REFERÊNCIA DO VIM</citetitle>, que vem com o pacote <filename>vim-common</filename> &mdash;<filename>/usr/share/vim/<replaceable>&lt;versão&gt;</replaceable>/doc/intro.txt</filename> ou escrevendo <userinput>:help intro</userinput> dentro do VIM

en: The Layout of a Tutorial
pt: O Formato de um Tutorial

en: In this chapter, you will find an example of a very short tutorial as used by the Fedora Documentation Project. This example is specific to the way the Docs Project uses DocBook XML. The example consists of a set of files used to hold the content and metadata for the tutorial.
pt: Neste capítulo, irá descobrir um exemplo de um tutorial bastante curto de documentação do Projecto Fedora. Este exemplo é específico para a forma como o Projecto de Documentação usa o DocBook em XML. O exemplo consiste num conjunto de ficheiros usados para manter o conteúdo, bem como metadados para o tutorial.

en: The Article
pt: O Artigo

en: tutorial layout
pt: formato do tutorial

en: article
pt: artigo

en: Below is a sample article:
pt: Em baixo, encontra-se um artigo de exemplo:

en: The Metadata
pt: Os Metadados

en: metadata
pt: metadados

en: The <filename>rpm-info.xml</filename> file contains all the required metadata for the document. This metadata includes title, authorship, licensing, and revision history. <xref linkend="ex-rpminfo"/> illustrates the content of this file:
pt: O ficheiro <filename>rpm-info.xml</filename> contém todos os metadados necessários para o documento. Estes metadados incluem o título, a autoria, a licença e o histórico de versões. O <xref linkend="ex-rpminfo"/> ilustra o conteúdo deste ficheiro:

en: Example <filename>rpm-info.xml</filename> File
pt: Ficheiro <filename>rpm-info.xml</filename> de Exemplo

en: If you are not familiar with XML editing, copy and paste this file from an existing module and then edit the values for the various elements as appropriate. Consult Fedora Documentation Project members and help channels for more assistance if needed.
pt: Se não estiver familiarizado com a edição em XML, copie e cole este ficheiro a partir de um módulo existente e edite depois os valores dos vários elementos, como for mais apropriado. Consulte os membros do Projecto de Documentação do Fedora e os canais de ajuda para maior assistência, se for necessário.

en: Style
pt: Estilo

en: Writing good technical documentation is not simply reproducing command lines and instruction sets. Good documentation is easy to read, understand, and translate, and presents a concise logical progression of concepts. Good documentation can also be defined by what it does <emphasis>not</emphasis> contain. Your tutorial should avoid:
pt: A escrita de boa documentação técnica não é simplemente reproduzir as linhas de comandos e os conjuntos de instruções. A boa documentação é fácil de ler, compreender e traduzir, oferecendo uma progressão lógica concisa dos conceitos. A boa documentação também poderá ser definida pelo que <emphasis>não</emphasis> contém. O seu tutorial deverá evitar:

en: Excessive wordiness
pt: Uso excessivo de palavras

en: Unnecessary or undefined jargon
pt: Uso de calão técnico indefinido ou desnecessário

en: Grammatical or spelling errors
pt: Erros ortográficos ou gramaticais

en: References to yourself or your experiences
pt: Referências a si próprio ou às suas experiências

en: Remarks which might offend or confuse any reader
pt: Comentários que possam ofender ou confundir qualquer leitor

en: This chapter contains style rules and guidelines for writing Fedora documentation. Guidelines are not the same as rules. It is acceptable to violate a guideline when it makes your material easier to understand. Follow guidelines whenever possible, but follow rules at all times. Assume any advice is a guideline unless identified otherwise.
pt: Este capítulo contém regras e instruções de estilo para escrever documentação para o Fedora. As instruções não são necessariamente regras. É aceitável voltar uma instrução, se esta tornar o seu material mais fácil de compreender. Siga as instruções se possível, mas siga sempre as regras. Assuma que qualquer conselho é uma instrução a menos que seja identificado em contrário.

en: Why Style Is Important
pt: Porque é que o Estilo é Importante

en: Writing well comes naturally to almost no one. It is a skill that professional writers, even famous ones, must practice constantly. <firstterm>Style</firstterm><indexterm><primary>style</primary></indexterm> is the quality that separates elegant writing from the merely functional.
pt: A boa escrita não vem naturalmente para a maior parte das pessoas. É um dom que os escritores profissionais, até mesmo os famosos, precisam de praticar constantemente. O <firstterm>Estilo</firstterm><indexterm><primary>estilo</primary></indexterm> é a qualidade que separa a escrita elegante da meramente funcional.

en: For example, refer to. <ulink url="http://www.online-literature.com/james_joyce/ulysses/18/">http://www.online-literature.com/james_joyce/ulysses/18/</ulink>. Please note that this example contains some mature themes and language, and is not suitable for all readers.
pt: Por exemplo, veja em <ulink url="http://www.online-literature.com/james_joyce/ulysses/18/">http://www.online-literature.com/james_joyce/ulysses/18/</ulink>. Por favor, note que este exemplo contém alguns temas e linguagem madura, não sendo, por isso, adequado a todos os leitores.

en: Elegance comes in many forms. In prose and poetry, elegant writing may not follow some (or any) common rules of grammar, syntax, or spelling. A good example is Episode 18, "Penelope," in James Joyce's novel <citetitle>Ulysses</citetitle><placeholder-1/>. There, Joyce uses long streams of words without punctuation to simulate a character's internal consciousness. By violating basic rules of grammar and syntax, Joyce simulates the disorganized but loosely connected thought patterns of the narrator.
pt: A elegância surge sob diversas formas. Na prosa e na poesia, a escrita elegante poderá não seguir algumas (ou todas) as regras comuns da gramática, sintaxe ou ortografia. Um bom exemplo é o Episódio 18, "Penélope," do romance de James Joyce <citetitle>Ulisses</citetitle><footnote id="fn-ulysses"><placeholder-1/></footnote>. Aqui, Joyce usa grandes sequências de palavras sem pontuação, de modo a simular a consciência interna de uma personagem. Ao violar as regras básicas da sintaxe e da gramática, Joyce simula os padrões de pensamento desorganizados mas levemente ligados do narrador.

en: Technical documentation, however, should always respect these rules. The more a document departs from standard language usage, the more difficult the material becomes for the reader. For example, readers may not be native speakers of the language used, or they might be reading a translation. If the writer uses slang, idioms, or jargon, a reader or translator may easily become confused. The following example compares two different written executions of the same idea:
pt: Contudo, a documentação técnica deverá sempre respeitar estas regras. Quanto mais um documento se desviar da utilização comum da língua, mais difícil se torna o material para o leitor. Por exemplo, os leitores poderão não usar a língua do documento como língua nativa ou poderão estar a ler uma tradução. Se o escritor usar 'calão', dialectos ou termos demasiado técnicos, o leitor ou o tradutor poderão ficar facilmente confusos. O exemplo seguinte compara duas execuções da mesma ideia, escritas de forma diferente:

en: Incorrect style
pt: Estilo incorrecto

note: I prefer "incorrect," because I think terms such as "problematic" are mealy-mouthed.  They remind me of the late 1980's English textbook trend toward the politically correct yet wholly unhelpful "standard/nonstandard."  But then, I tend to be dogmatic; it's probably my Catholic upbringing. [PWF]
en: So you made the changes I showed you in the last section. What's the next thing you should do? Just pop your thumb drive onto your system and read the <filename>messages</filename> log. When you see "USB device found," then Bob's your uncle.
pt: Portanto, já fez as alterações que lhe mostrei na última secção. Qual é a próxima coisa que deseja fazer? Basta colocar a sua caneta no seu sistema e ler o ficheiro de registo <filename>messages</filename>. Quando vir "USB device found,", então teve sucesso.

en: Correct style
pt: Estilo correcto

note: I prefer "correct." See above. [PWF]
en: After you complete the configuration changes above, attach the USB removable media to your system. Use the <command>dmesg</command> command to examine the kernel message log. The message <computeroutput>USB device
    	  found</computeroutput> indicates that your device was installed successfully.
pt: Depois de terminar as mudanças de configuração acima, ligue o dispositivo removível USB ao seu sistema. Use o comando <command>dmesg</command> para examinar o registo de mensagens do kernel. A mensagem <computeroutput>USB device found</computeroutput> indica que o seu dispositivo foi instalado com sucesso.

en: The first example is more conversational English, which is not appropriate for official written documentation. The second example is more formal, but as a result it is easier to comprehend, both for native readers and translators.
pt: O primeiro exemplo é um Inglês mais coloquial, o qual não é apropriado para documentação oficial escrita. O segundo exemplo é mais formal, mas tem como resultado uma maior facilidade de compreensão, quer para os leitores nativos quer para os tradutores.

en: Following style rules and guidelines also makes readers more comfortable with a set of documents. Consistent style enhances the professional appearance of documentation, and its perceived value. On the other hand, lapses in punctuation or poor grammar negatively affect a reader's reaction to written material. A reader can feel that an otherwise correct technical document is lacking in authority, simply because it is poorly written. Readers feel at ease when they do not have to struggle to understand an author's use of language.
pt: Seguir as regras e instruções de estilo também deixa os leitores mais confortáveis com um determinado conjunto de documentos. Um estilo consistente melhor a aparência profissional da documentação, bem como o valor que é transmitido. Por outro lado, os lapsos de pontuação ou uma gramática incorrecta afectam de forma negativa a reacção de um leitor ao material escrito. Um leitor poderá sentir que um documento técnico não tem qualquer autoridade, simplesmente por estar mal escrito. Os leitores facilmente sentem que não têm de lidar com a compreensão da utilização da língua por parte de um autor.

en: This chapter cannot possibly cover enough material to make every reader a good writer. Some manuals devoted entirely to writing style are themselves hundreds of pages long. This chapter provides enough guidelines for intermediate writers to understand style usage in technical documentation.
pt: Este capítulo não poderá cobrir possivelmente material suficiente para que um leitor seja um bom escritor. Existem alguns manuais dedicados por inteiro ao estilo de escrita, tendo alguns deles centenas de páginas. Este capítulo contém instruções suficientes para os escritores médios compreenderem a utilização do estilo de documentação técnica.

en: If you are not a practiced writer, whether of technical documentation or otherwise, you may benefit from other style resources. The following list is far from comprehensive, but provides a starting point:
pt: Se não for um escritor com prática, seja em documentação técnica ou noutra qualquer, poderá beneficiar de outros recursos de estilo. A lista que se segue não é excelente, mas oferece um bom ponto de partida:

en: <citetitle>The Elements of Style</citetitle>, by William Strunk. Basic rules and links to online versions can be found at: <ulink url="http://en.wikipedia.org/wiki/The_Elements_of_Style">http://en.wikipedia.org/wiki/The_Elements_of_Style</ulink>
pt: <citetitle>The Elements of Style</citetitle>, de William Strunk. Poderá encontrar algumas regras básicas e referências para as versões 'online' em: <ulink url="http://en.wikipedia.org/wiki/The_Elements_of_Style">http://en.wikipedia.org/wiki/The_Elements_of_Style</ulink>

en: <citetitle>The Chicago Manual of Style</citetitle>, by the University of Chicago Press. Online version: <ulink url="http://www.chicagomanualofstyle.org/">http://www.chicagomanualofstyle.org/</ulink>
pt: <citetitle>The Chicago Manual of Style</citetitle>, da University of Chicago Press. Versão 'online': <ulink url="http://www.chicagomanualofstyle.org/">http://www.chicagomanualofstyle.org/</ulink>

en: <citetitle>Paradigm Online Writing Assistant</citetitle>, maintained by Chuck Guilford, Ph.D. Online only: <ulink url="http://www.powa.org/">http://www.powa.org/</ulink>
pt: <citetitle>Paradigm Online Writing Assistant</citetitle>, mantido por Chuck Guilford, Ph.D. Apenas 'online': <ulink url="http://www.powa.org/">http://www.powa.org/</ulink>

en: There are many free software documentation projects which have developed their own style guidelines. This chapter, in fact, draws heavily on the <citetitle>GNOME Documentation Style Guidelines</citetitle> (<firstterm>GDSG</firstterm>). You may read the original <citetitle>GDSG</citetitle> at <ulink url="http://developer.gnome.org/documents/style-guide/">http://developer.gnome.org/documents/style-guide/</ulink>.
pt: Existem diversos projectos de documentação de software que desenvolveram as suas próprias recomendações de estilo. Este capítulo, de facto, baseia-se em grande medida nas <citetitle>Recomendações de Estilo de Documentação do GNOME</citetitle> (<firstterm>GDSG</firstterm>). Poderá ler a <citetitle>GDSG</citetitle> original em <ulink url="http://developer.gnome.org/documents/style-guide/">http://developer.gnome.org/documents/style-guide/</ulink>.

en: Fundamental Concepts of Technical Documentation
pt: Conceitos Fundamentais da Documentação Técnica

en: Bibliographic Information
pt: Informação Bibliográfica

en: This section is drawn primarily from the <citetitle>GDSG</citetitle>.
pt: Esta secção baseia-se principalmente na <citetitle>GDSG</citetitle>.

note: This section will reproduce mostly what is in Chapter 1 of the GDSG.  There may be minor changes.  FIXME: Make sure the appropriate front matter of the Documentation Guide includes attribution as required by the GNU FDL.
en: This chapter provides a brief introduction to writing technical documentation.
pt: Este capítulo oferece uma breve introdução à escrita de documentação técnica.

en: General Style Requirements
pt: Requisitos Gerais de Estilo

en: Technical writing for the Fedora Project imposes special constraints beyond the basic requirements of good prose. Good Fedora technical documentation has the following characteristics:
pt: A escrita técnica para o Projecto Fedora impõe restrições especiais para além dos requisitos básicos da boa prosa. Uma boa documentação técnica do Fedora tem as seguintes características:

en: Comprehensive
pt: Compreensível

en: Describe all of the functionality of a product. Do not omit functionality that you regard as irrelevant for the user.
pt: Descreve todas as funcionalidades de um produto. Não omita funcionalidades que considere irrelevantes para o utilizador.

en: Conforming
pt: Em Conformidade

en: Describe what you see. Do not describe what you want to see. Present your information in the order that users experience the subject matter.
pt: Descreva o que vê. Não descreva o que deseja ver. Apresente a sua informação pela ordem em que os utilizadores se deparam com o assunto.

en: Clear
pt: Limpar

en: Read <citetitle>The Elements of Style</citetitle> (<ulink url="http://en.wikipedia.org/wiki/The_Elements_of_Style">http://en.wikipedia.org/wiki/The_Elements_of_Style</ulink>) to help make your writing clear.
pt: Leia <citetitle>The Elements of Style</citetitle> (<ulink url="http://en.wikipedia.org/wiki/The_Elements_of_Style">http://en.wikipedia.org/wiki/The_Elements_of_Style</ulink>) que o ajuda a tornar a sua escrita mais clara.

en: Consistent
pt: Consistente

en: Use agreed vocabulary throughout your documentation. Use the same vocabulary as other writers who are working on related documentation.
pt: Utilize vocabulário considerado consensual ao longo da sua documentação. Use o mesmo vocabulário dos outros escritores que estão a trabalhar sobre documentos relacionados com este.

en: Concise
pt: Conciso

en: Review your work frequently as you write your document. Ask yourself which words you can take out. Refer to <xref linkend="sn-fundamentals-2"/> for specific guidelines.
pt: Reveja o seu trabalho com frequência, à medida que escreve o seu documento. Pergunte-se quais as palavras que poderá retirar. Veja algumas recomendações específicas em <xref linkend="sn-fundamentals-2"/>.

en: Golden Rules
pt: Regras de Ouro

en: This section contains some basic style guidelines. Subsequent sections in this chapter expand on these guidelines to give more detailed guidance.
pt: Esta secção contém algumas recomendações básicas de estilo. As secções seguintes deste capítulo expandem essas recomendações, para lhe dar conselhos mais detalhados.

en: Golden Rule 1: Be brief
pt: Regra de Ouro 1: Seja breve

en: Limit each sentence to fewer than 25 words.
pt: Limite cada frase a menos de 25 palavras.

en: Limit each procedure step to 23 words.
pt: Limite cada passo de procedimento a 23 palavras.

en: Incorrect: Too long
pt: Incorrecto: Demasiado comprido

en: Under normal operating conditions, the kernel does not always immediately write file data to the disks, storing it in a memory buffer and then periodically writing to the disks to speed up operations.
pt: Em condições normais de operação, o kernel não grava sempre imediatamente os dados do ficheiros nos discos, guardando-os numa área em memória e escrevendo periodicamente para os discos, de modo a acelerar as operações.

en: Correct: Less wordy
pt: Correcto: Com menos palavreado

en: Normally, the kernel stores the data in memory prior to periodically writing the data to the disk.
pt: Normalmente, o kernel guarda os dados em memória antes de os gravar periodicamente no disco.

en: Golden Rule 2: Be organized
pt: Regra de Ouro 2: Ser organizado

en: Limit each paragraph to one topic.
pt: Limite cada parágrafo a um tópico.

en: Limit each sentence to one idea.
pt: Limite cada frase a uma ideia.

en: Limit each procedure step to one action.
pt: Limite cada passo de procedimento a uma acção.

en: Incorrect: Disorganized topics
pt: Incorrecto: Tópicos desorganizados

en: The <application>Workspace Switcher</application> applet helps you navigate all of the virtual desktops available on your system. The X Window system, working in hand with a piece of software called a <emphasis>window manager</emphasis>, allows you to create more than one virtual desktop, known as <emphasis>workspaces</emphasis>, to organize your work, with different applications running in each workspace. The <application>Workspace Switcher</application> applet is a navigational tool to get around the various workspaces, providing a miniature road map in the GNOME panel showing all your workspaces and allowing you to switch easily between them.
pt: A applet do <application>Alternador de ambiente de trabalho</application> ajuda-o a navegar em todos os ecrãs virtuais do seu sistema. O sistema X Window, funcionando em conjunto com uma pequena componente aplicacional, chamada de <emphasis>gestor de janelas</emphasis>, permite-lhe criar mais de um ecrã virtual, também conhecido por <emphasis>espaço de trabalho</emphasis>, para organizar o seu trabalho, com diferentes aplicações a correr em cada espaço de trabalho. A applet do <application>Selector do Espaço de Trabalho</application> é uma ferramenta de navegação para percorrer os diversos espaços de trabalho, oferecendo um roteiro em miniatura no painel do GNOME, mostrando todos os seus espaços de trabalho e permitindo uma mudança simples entre eles.

en: Correct: Organized topics
pt: Correcto: Tópicos organizados

en: Use the <application>Workspace Switcher</application> to add new <emphasis>workspaces</emphasis> to the GNOME Desktop. You can run different applications in each workspace. The <application>Workspace Switcher</application> applet provides a miniature map that shows all of your workspaces. You can use the <application>Workspace Switcher</application> applet to switch between workspaces.
pt: Use o <application>Alternador do Ambiente de Trabalho/application> para adicionar novos <emphasis>espaços de trabalho</emphasis> ao ambiente gráfico GNOME. Poderá executar diferentes aplicações em cada um dos espaços de trabalho. A applet do <application>Selector de Espaços de Trabalho</application> oferece um mapa em miniatura que mostra todos os seus espaços de trabalho. Poderá usar a applet do <application>Selector de Espaços de Trabalho</application>, de modo a mudar de espaços de trabalho.

en: Plan the order of paragraphs before you start writing. Decide which topic you want to cover in each paragraph.
pt: Planeie a ordem dos parágrafos antes de começar a escrever. Decida o tópico que deseja tratar em cada parágrafo.

en: Golden Rule 3: Be demonstrative
pt: Regra de Ouro 3: Seja demonstrativo

en: Use explicit examples to demonstrate how an application works. Provide instructions rather than descriptions.
pt: Use exemplos explícitos que demonstram como funciona uma aplicação. Forneça instruções em vez de descrições.

en: Incorrect: Describes but does not demonstrate
pt: Incorrecto: Descreve mas não demonstra

en: There is a text box that you can use to find out the definition of a word.
pt: Existe um campo de texto que poderá usar para descobrir a definição de uma palavra.

en: Correct: Demonstrates usage
pt: Correcto: Demonstra a utilização

en: To request a definition of a word, type the word in the text box, then select <guilabel>Lookup</guilabel>.
pt: Para pedir a definição de uma palavra, escreva a palavra no campo de texto, seleccionando depois a opção <guilabel>Procurar</guilabel>.

en: Do not apply this guideline too rigidly. Sometimes you must explain how software works to support your how-to examples.
pt: Não aplique esta recomendação de forma muito rígida. Algumas vezes tem de explicar como funciona o software para suportar os seus exemplos.

en: Golden Rule 4: Be objective
pt: Regra de Ouro 4: Ser objectivo

en: Write in a neutral tone.
pt: Escreva num tom neutro.

en: Incorrect: Sentence takes sides
pt: Incorrecto: A frase tem um conteúdo de opinião parcial

en: The applet is a handy little screen grabber.
pt: A applet é um pequeno e útil módulo de captura do ecrã.

en: Correct: Sentence is objective
pt: Correcto: A frase é objectiva

en: Use the applet to take screenshots.
pt: Use a applet para fazer capturas do ecrã.

en: Tone
pt: Tom

en: Inappropriate tone hinders reader access to information. A neutral tone free of opinion or personal flavor improves the reader's comprehension. Neutral tone helps writers to work in parallel on a large technical documentation project. Furthermore, additional writers may join the project at any time. Use of a neutral tone helps to achieve consistency across a documentation set, and thereby facilitates user access to information. The best way to achieve a common, neutral tone is to apply the following principles:
pt: Um tom inapropriado retrai o acesso do utilizador à informação. Um tom neutro e livre de opiniões ou escolhas pessoais aumenta a compreensão por parte do leitor. Um tom netruo ajuda os escritores a trabalharem em paralelo num projecto de documentação técnica grande. Para além disso, poder-se-ão juntar escritores adicionais ao projecto em qualquer altura. A utilização de um tom netruo ajuda a obter alguma consistência em torno de um conjunto de documentos, facilitando deste modo o acesso dos utilizadores à informação. A melhor forma de obter um tom neutro e comum é aplicar os seguintes princípios:

en: Avoid humor
pt: Evite o humor

en: Humor distracts from the information you are trying to provide. Humor also makes documentation difficult to translate. Stay factual.
pt: O humor distrai o leitor da informação que você está a tentar transmitir. O humor também torna a documentação mais difícil de traduzir. Resuma-se a factos.

en: Avoid personal opinions
pt: Evite opiniões pessoais

en: Whether you think a function is useful or woeful is irrelevant. Report the function to the user, with instructions about how to use the function. Stay accurate.
pt: Se acha que uma dada função é útil ou inútil é irrelevante. Relate a função para o utilizador, com instruções de utilização da mesma. Mantenha-se correcto.

en: Avoid colloquial language
pt: Evite a linguagem coloquial

en: Colloquial language is difficult to translate and usually culture-specific. Stay neutral.
pt: A linguagem coloquial é difícil de traduzir e normalmente é específica da caltura. Mantenha-se neutro.

en: Avoid topical expressions
pt: Evite expressões por tópicos

en: An expression that is in common use today might convey something completely different tomorrow. Stay technical.
pt: Uma expressão que seja de uso comum nos dias de hoje poderá representar algo completamente diferente amanhã. Mantenha-se técnico.

en: Avoid aspirational statements
pt: Evite frases baseadas em suposições futuras

en: Statements about the future developments of a product do not belong in technical documentation. Write about what you see right now. Stay real.
pt: As referências aos futuros desenvolvimentos de um produto não pertencem à documentação técnica. Escreva apenas sobre o que existe agora. Mantenha-se realista.

en: Reaching the Right Audience
pt: Atinja a Audiência Correcta

en: All of the decisions that you make about the structure and content of a manual follow from an understanding of the audience. Consider how the audience accesses the documentation, what sort of information the audience needs, and the experience level of the audience. Usually, you need to create documentation that is suitable for different audiences. The following sections introduce some of the audience-related topics you need to consider.
pt: Todas as decisões que fizer acerca da estrutura e conteúdo de um manual partem de uma compreensão por parte da audiência. Pense na forma como a audiência acede à documentação, ao tipo de informação que a audiência necessita e ao nível de experiência da audiência. Normalmente, é necessário criar uma documentação que seja adequada para diferentes audiências. As seguintes secções introduzem alguns dos tópicos relacionados com a audiência que necessita de ter em consideração.

en: User Motivation
pt: Motivação do Utilizador

en: Do not waste the time of the user who looks for information in your documentation. Users do not read technical documentation for entertainment. Users usually have specific questions. You need to give clear answers to those questions.
pt: Não ocupe o tempo do utilizador que procura informações na sua documentação. Os utilizadores não lêem documentação técnica por entretenimento. Os utilizadores normalmente têm questões específicas. Terá de dar respostas claras a essas questões.

en: New Users
pt: Novos Utilizadores

en: New users to Fedora are likely to consult online tutorials for guidance about unfamiliar applications or functionality. Each tutorial should contain enough introductory information to tell new users how to start using the relevant functions. Each tutorial should also contain enough usage instructions to tell users the different actions that they can perform with the command or function. Keep these instructions task-oriented. Do not describe GUI screens, dialogs, and dialog elements in a tutorial, unless there is an unusual feature that affects your instructions.
pt: Os utilizadores novos no Fedora provavelmente irão consultar os tutoriais 'onyline' para se orientarem nas aplicações ou funcionalidades pouco familiares. Cada tutorial deverá conter informação introdutória sufciente para indicar aos novos utilizadores como começar a usar as funções relevantes. Cada tutorial deverá também conter instruções de utilização suficientes para informar os utilizadores das diferentes acções que podem efectuar com o comando ou a função. Mantenha estas instruções orientadas às tarefas. Não descreva as janelas gráficas e os seus elementos num tutoria, a menos que exista alguma funcionalidade anormal que afecte as suas instruções.

en: Experienced Users
pt: Utilizadores Experientes

en: Experienced users are more likely to use documentation as a reference. The documentation therefore needs to be complete, well-organized, and in the case of printed manuals, well-indexed.
pt: Os utilizadores experientes são mais aptos para usar a documentação como referência. A documentação aí tem de ser completa, bem organizada e, no caso dos manuais impressos, bem indexada.

en: Do Not Offend Your Audience
pt: Não Ofenda a sua Audiência

en: To avoid offending your readers, apply the following guidelines to your documentation:
pt: Para evitar ofender os seus leitores, aplique as seguintes recomendações à sua documentação:

en: Avoid insider language
pt: Evite a linguagem própria

en: Insider language includes both undefined jargon and the tendency of the computer community to shorten words. For example, use the term <literal>documentation</literal> instead of the term <literal>docs</literal>. A term may be jargon if it fails all the following conditions:
pt: A linguagem própria ou interna inclui algum calão indefinido e a tendência da comunidade informática de reduzir as palavras. Por exemplo, use o termo <literal>documentação</literal> em vez do termo <literal>docs</literal>. Um termo poderá ser considerado 'calão', se não respeitar qualquer uma das seguintes condições:

en: The term does not appear in the <citetitle>Fedora Jargon Buster</citetitle> (<ulink url="http://fedora.redhat.com/docs/jargon-buster/">http://fedora.redhat.com/docs/jargon-buster/</ulink>).
pt: O termo não aparece no <citetitle>Jargon Buster do Fedora</citetitle> (<ulink url="http://fedora.redhat.com/docs/jargon-buster/">http://fedora.redhat.com/docs/jargon-buster/</ulink>).

en: The term does not appear in the <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/ </ulink>).
pt: O termo não aparece no <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/ </ulink>).

en: The term does not appear in the glossary of the manual that you are writing.
pt: O termo não aparece no glossário do manual que está a escrever.

en: The term is not defined in the body text of the manual that you are writing.
pt: O termo não está definido no texto do conteúdo do manual que está a escrever.

en: Avoid gender-specific language
pt: Evite a linguagem dependente do sexo

en: Pronoun constructions such as <literal>his/her</literal> or <literal>s/he</literal> do not exist. There is no need to identify gender in your instructions.
pt: As construções de pronomes como o <literal>dele/dela</literal> ou <literal>ele/a</literal> não existem. Não existe a necessidade de reflectir o sexo da audiência na suas instruções.

en: Avoid culture-specific language
pt: Evite a linguagem específica da cultura

en: There is little point in giving an example that everyone in your town knows about, but is a complete mystery to everyone else in the world.
pt: Não vale a pena dar um exemplo que seja conhecido em toda a sua cidade, mas que seja um completo mistério para o resto do mundo.

en: Avoid talking down to your reader
pt: Evite rebaixar o seu leitor

en: There are few experiences more irritating for a user than documentation that says an action is easy or quick, when in fact the user cannot complete the action. Do not qualify or prejudge actions.
pt: Existem poucas experiências mais irritantes para um utilizador que a documentação que diz que uma determinada acção é fácil ou rápida, quando o utilizador não consegue desempenhá-la de facto. Não qualifique ou faça juízos de valor das acções.

en: Other parts of this guide discuss in more detail tone and language usage that can cause offense.
pt: Outras partes deste guia descrevem com mais detalhe o tom e linguagem que possam ser considerados ofensivos.

en: Grammar and Usage Guidelines
pt: Recomendações de Gramática e Utilização

en: Bibliographical Information
pt: Informação Bibliográfica

en: This section is drawn partly from the <citetitle>GDSG</citetitle>, and partly from <citetitle>The Elements of Style</citetitle>, updated as necessary for the needs of 21st-century technical documentation writers.
pt: Esta secção é retirada em parte da <citetitle>GDSG</citetitle> e também em parte do documento <citetitle>The Elements of Style</citetitle>, actualizado de acordo com as necessidades dos escritores de documentação técnica do século XXI.

note: FIXME: Again, check attribution viz.  GNU FDL.  This will be more work than the previous section.
en: This section contains an alphabetical list of grammar and usage guidelines for use in Fedora documentation. Many of these guidelines are only applicable to English-language usage, refer to the <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) and the <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html">http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)
pt: Esta secção contém uma lista alfabética das recomendações de gramática e utilização na documentação do Fedora. Muitas destas recomendações só se aplicam na utilização da língua Inglesa; para mais informações, consulte o <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) e o <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html">http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)

en: Abbreviations
pt: Abreviaturas

en: A shortened form of a word or phrase that takes the place of the full word or phrase, such as <literal>Dr.</literal>, <literal>a.m.</literal>, <literal>p.m.</literal>, and so on. Apply the following rules when you use abbreviations:
pt: Uma forma resumida de uma palavra ou frase que toma o lugar da palavra ou frase completa, como por exemplo <literal>Dr.</literal>, <literal>a.m.</literal>, <literal>p.m.</literal>, e assim por diante. Aplique as seguintes regras quando usar abreviaturas:

en: Avoid creating new abbreviations. Unfamiliar abbreviations can confuse rather than clarify a concept.
pt: Evite a criação de novas abreviaturas. As abreviaturas pouco familiares poderão confundir mais um conceito que clarificar.

en: Do not explain or expand familiar abbreviations.
pt: Não explique ou expanda as abreviaturas conhecidas.

en: Do not include familiar abbreviations in the glossary of your manual.
pt: Não inclua as abreviaturas conhecidas no glossário do seu manual.

en: For abbreviations of phrases, such as <literal>i.e.</literal> for "in other words" and <literal>e.g.</literal> for "for example", do not use the abbreviation. Spell out the entire phrase.
pt: Para as abreviaturas das frases, como o <literal>i.e.</literal> para "isto é" e o <literal>p.ex.</literal> como "por exemplo", não use a abreviatura. Descreva a frase por inteiro.

en: Adjectives
pt: Adjectivos

en: Use adjectives with caution. If an adjective is necessary to differentiate between items, then use adjectives. In all cases, test whether the phrase can stand alone without the adjective.
pt: Use os adjectivos com cuidado. Se um adjectivo for necessário para diferenciar itens, então use os adjectivos. Em qualquer um dos casos, este se a frase poderá ficar bem sem o adjectivo.

en: Acronyms
pt: Acrónimos

en: A term that represents a multi-word term. Typically, acronyms are formed in the following ways:
pt: Um termo que representa um conjunto de palavras. Tipicamente, os acrónimos são formados da seguinte forma:

en: From the first letters of each word in a compound term, for example Table of Contents (TOC).
pt: Das primeiras letras de cada palavra num termo composto. Por exemplo, TOC significa 'Table of Contents' (Índice Analítico).

en: From recognizable parts of a compound term, such as GNU Object Model Environment (GNOME).
pt: A partir de partes reconhecíveis de um termo composto, como o GNU Object Model Environment (GNOME).

en: Apply the following rules when you use acronyms:
pt: Aplique as seguintes regras quando usar acrónimos:

en: On the first occurrence of an acronym, spell out the full term, with the acronym in parentheses.
pt: Na primeira ocorrência de um acrónimo, descreva por completo o termo completo, tendo o acrónimo entre parêntesis.

en: Do not spell out the full compound for well-known acronyms, unless you think the information is useful for readers.
pt: Não descreva extensivamente o termo completo para os acrónimos conhecidos, a menos que saiba que a informação é útil para os leitores.

en: Avoid creating new acronyms. Unfamiliar acronyms can confuse rather than clarify a concept.
pt: Evite a criação de novos acrónimos. Os acrónimos não conhecidos poderão confundir mais um conceito que clarificá-lo.

en: Write the acronym in uppercase letters, unless there is a compelling case for lowercase.
pt: Escreva o acrónimo em maiúsculas, a não ser que haja um caso explícito para o uso de minúsculas.

en: Include the acronym and the full term in the glossary of your manual.
pt: Inclua o acrónimo e o termo completo no glossário do seu manual.

en: Adverbs
pt: Advérbios

en: Use adverbs with caution. If an adverb is necessary to qualify the function of a component, then use an adverb. In all cases, test whether the phrase can stand alone without the adverb. Classic superfluous adverbs <literal>simply</literal>, <literal>easily</literal>, <literal>quickly</literal>.
pt: Use os advérbios com cuidado. Se for necessário um advérbio para qualificar a função de um componente, então use um advérbio. Em qualquer dos casos, teste se a frase pode ser usada sem o advérbio. Alguns exemplos de advérbios supérfluos são o <literal>simplesmente</literal>, <literal>facilmente</literal>, <literal>rapidamente</literal>.

en: Anthropomorphism
pt: Antropomorfismo

en: Do not apply emotions, desires, or opinions to software applications.
pt: Não aplique emoções, desejos ou opiniões nas aplicações informáticas.

en: Do not apply a sense of location or dimension to a software application. A user can not be "in" a text editor.
pt: Não aplique um sentido de localização ou dimensão a uma aplicação informática. Um utilizador não pode estar "dentro" de um editor de texto.

en: Articles
pt: Artigos

en: Do not use the definite article <literal>the</literal> to begin any of the following items:
pt: Não use o artigo definido <literal>the</literal> (o/a) para iniciar um dos seguintes itens (nota específica do Inglês):

en: Manual titles
pt: Títulos de manuais

en: Chapter titles
pt: Títulos de capítulos

en: Headings
pt: Destaques

en: Figure captions
pt: Títulos de figuras

en: Table captions
pt: Títulos de tabelas

en: Callouts
pt: Chamadas de atenção

en: Apostrophe
pt: Apóstrofo

en: Do not use apostrophes except where absolutely required
pt: Não use apóstrofos, excepto se for absolutamente necessário

en: Do not use apostrophes to denote possession.
pt: Não use apóstrofos para denotar a pertença (específico do Inglês).

en: Do not use apostrophes to denote contractions.
pt: Não use os apóstrofos para demarcar as contracções.

en: Do not use apostrophes to denote plurals.
pt: Não use os apóstrofos para denotar formas plurais.

en: Incorrect: Apostrophes
pt: Incorrecto: Apóstrofos

en: the <guimenu>Main Menu's</guimenu><guimenuitem>Help</guimenuitem> option
pt: <guimenu>Main Menu's</guimenu><guimenuitem>Help</guimenuitem> (opção Ajuda do Menu Principal)

en: don't use the default option
pt: 'don't use the default option': não usar a opção predefinida

en: several SCSI disk's
pt: SCSI disk's (discos SCSI)

en: Correct: No apostrophes
pt: Correcto: Sem apóstrofos

en: the <guimenuitem>Help</guimenuitem> option on the <guimenu>Main Menu</guimenu>
pt: the <guimenuitem>Help</guimenuitem> option on the <guimenu>Main Menu</guimenu> (a opção Ajuda no Menu Principal)

en: several SCSI disks
pt: SCSI disks

en: Brackets
pt: Parêntesis Rectos

en: Do not use brackets [such as these] as a substitute for parentheses (such as these).
pt: Não use parêntesis [deste tipo] como substituição dos parêntesis (deste tipo).

en: Use brackets for optional command line entries.
pt: Use os parêntesis rectos para os itens opcionais da linha de comandos.

en: Do not use angle brackets to indicate variables in text, instead use the <sgmltag class="starttag">replaceable</sgmltag> tag. Refer to <xref linkend="sn-xml-tags-replaceable"/> for information about using this tag.
pt: Não use os símbolos '&lt;' e '&gt;' para indicar as variáveis no texto; em vez disso, use a marca <sgmltag class="starttag">replaceable</sgmltag>. Veja a utilização do <xref linkend="sn-xml-tags-replaceable"/> para mais informações sobre a utilização desta marca.

en: Capitalization
pt: Capitalização (Uso de maiúsculas/minúsculas)

en: Capitalize in the following situations:
pt: Aplique a capitalização nas seguintes situações:

en: All letters in acronyms, unless the acronym is a well-known exception
pt: Todas as letras dos acrónimos, a menos que o acrónimo seja uma excepção conhecida

en: Initial letter of the first word in a list
pt: A letra inicial da primeira palavra de uma lista

en: Initial letter of the first word in a callout
pt: A letra inicial da primeira palavra de uma chamada de atenção

en: Initial letter of a key name, such as the <keycap>Shift</keycap> key
pt: A letra inicial do nome de uma tecla, como a tecla <keycap>Shift</keycap>

en: Initial letter of a sentence
pt: A letra inicial de uma frase

en: Command Names
pt: Nomes de Comandos

en: Avoid starting a sentence with a command name or application name that has a lowercase initial letter.
pt: Evite começar uma frase com o nome de um comando ou aplicação que tenha um nome que começa por minúsculas.

en: Initial letter of a complete sentence after a colon
pt: A letra inicial de uma frase completa, a seguir aos dois-pontos

en: Do not capitalize in the following situations:
pt: Não capitalizar nas seguintes situações:

en: A compound term that is followed by an abbreviation or an acronym
pt: Um termo composto que seja seguido de uma abreviatura ou acrónimo

en: When you want to emphasize something
pt: Quando quiser aumentar a ênfase sobre algo

en: Variable names
pt: Nomes de variáveis

en: The initial letter of an incomplete sentence after a colon
pt: A letra inicial de uma frase incompleta, após os dois-pontos

en: Captions
pt: Legendas

en: Use the same rules as for headings, for all captions accompanying figures and tables. Do not put a period at the end of a caption.
pt: Use as mesmas regras dos destaques para todas as legendas das tabelas e figuras. Não coloque um ponto no fim de uma legenda.

en: Colon
pt: Dois-Pontos (:)

en: Use a colon in the following situations:
pt: Use os dois-pontos nas seguintes situações:

en: To introduce a list
pt: Para introduzir uma lista

en: Before an explanation
pt: Antes de uma explicação

en: After an introduction
pt: Após uma introdução

en: Do not use a colon in the following situations:
pt: Não use os dois-pontos nas seguintes situações:

en: To introduce a figure or a table
pt: Para introduzir uma figura ou uma tabela

en: To introduce headings
pt: Para introduzir os destaques

en: At the end of an introduction to a procedure
pt: No fim da introdução de um procedimento

en: Column headings
pt: Destaques das colunas

en: Use the same rules as for headings.
pt: Use as mesmas regras dos destaques.

en: Comma
pt: Vírgula

en: Use commas in the following situations:
pt: Use as vírgulas nas seguintes situações:

en: To separate items in a series
pt: Para separar os itens de uma dada série

en: To separate the parts of a sentence
pt: Para separar as partes de uma frase

en: To separate nonrestrictive phrases
pt: Para separar as frases não-restritivas

en: Instead of dashes to set off appositives
pt: Em vez dos hífenes, para definir apositivos

en: With <emphasis>for example</emphasis> and similar expressions
pt: Com as expressões <emphasis>por exemplo</emphasis> e similares

en: Do not use commas in the following situations:
pt: Não use as vírgulas nas seguintes situações:

en: In a series of adjectives used as one modifier
pt: Numa série de adjectivos usados como um modificador único

en: Between two short independent clauses
pt: Entre duas cláusulas breves e independentes

en: Commands
pt: Comandos

en: Do not use commands as verbs.
pt: Não use os comandos como verbos.

en: Contractions
pt: Contracções

en: Do not use contractions such as <emphasis>can't</emphasis>, <emphasis>don't</emphasis>, or <emphasis>isn't</emphasis>.
pt: Não use contracções do tipo <emphasis>tá</emphasis>, <emphasis>tar</emphasis>, or <emphasis>né</emphasis>.

en: Dash
pt: Hífen

en: Do not use the em dash or the en dash. Use a paragraph break or a colon instead, where you want to create an introductory piece of text. If you have several items that you want to introduce, then you can use a variable list.
pt: Não use o hífen 'mdash' ou 'ndash'. Use uma quebra de parágrafo ou os dois-pontos em alternativa onde pretender criar um pedaço introdutório de texto. Se tiver vários itens que deseja introduzir, então poderá usar uma lista variável.

en: Ellipsis
pt: Reticências

en: Use an ellipsis in the following situations:
pt: Use as reticências nas seguintes situações:

en: To show that you have omitted something from a sentence
pt: Para mostrar que omitiu algo de uma frase

en: To indicate a pause when you quote displayed text
pt: Para indicar uma pausa quando fizer uma citação do texto apresentado

en: Fractions
pt: Fracções

en: Follow these rules when using fractions:
pt: Siga estas regras quando usar as fracções:

en: Use numerals for fractions in tables and in units of measurement, but spell out fractions in prose.
pt: Use numerais para as fracções nas tabelas e nas unidades de medida, mas descreva por extenso as fracções.

en: Use a space between a numeral and a related fraction, if there is a possible ambiguity. For example: 1 1/2 instead of 11/2.
pt: Use um espaço entre um numeral e uma fracção relacionada, se puder existir alguma ambiguidadde. Por exemplo: 1 1/2 em vez de 11/2.

en: If a fraction is used in a compound modifier, insert a hyphen between the fraction and the unit of measurement.
pt: Se uma fracção for usada num modificador composto, indique um hífen entre a fracção e a unidade de medida.

en: Gender
pt: Género

en: Refer to <xref linkend="sn-fundamentals-9"/>.
pt: Veja em <xref linkend="sn-fundamentals-9"/>.

en: Grammar
pt: Gramática

en: Use standard American English grammar rules, refer to the <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html"> http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)
pt: Use as regras-padrão do Inglês Americano (para documentos em Inglês); veja em <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html"> http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)

en: Use the following capitalization rules in headings:
pt: Use as seguintes regras de capitalização nos destaques:

en: Initial uppercase letter of the first word
pt: Letra maiúscula inicial da primeira palavra

en: Initial uppercase letter for all nouns, adjectives, and verbs.
pt: Letra maiúscula inicial para todos os substantivos, adjectivos e verbos.

en: All lowercase letters for conjunctions, articles, and prepositions of fewer than four letters
pt: Todas as letras em minúsculas para as conjunções, artigos e proposições com menos de quatro letras

en: Initial uppercase letter for prepositions of four letters or longer
pt: Letra maiúscula inicial para as proposições com quatro ou mais letras

en: Initial uppercase letter for conjunctions of four letters or longer
pt: Letra maiúscula inicial para as conjunções com quatro ou mais letras

en: Hyphen
pt: Hífen

en: Use hyphens in the following situations:
pt: Use os hífenes nas seguintes situações:

en: With a numeral in a compound modifier
pt: Com um numeral num modificador composto

en: To prevent ambiguity
pt: Para evitar ambiguidades

en: With some standard prefixes and suffixes. Use the <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) for guidance
pt: Com alguns prefixos e sufixos padrão. Use o <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) para ter algumas linhas-guia

en: In spelled-out fractions
pt: Nas fracções por extenso

en: In variable names of two or more words, such as <replaceable>directory-name</replaceable>. Note: <replaceable>filename</replaceable> is an exception.
pt: Nos nomes de variáveis com duas ou mais palavras, como o <replaceable>nome-pasta</replaceable>. Nota: <replaceable>filename</replaceable> (nome de ficheiro) é uma excepção.

en: Do not use hyphens in the following situations:
pt: Não use hífenes nas seguintes situações:

en: For industry-accepted terms
pt: Para os termos aceites na indústria

en: To construct verbs
pt: Para construir verbos (excepto nos compostos)

en: With an adverb ending in <emphasis>ly</emphasis>
pt: Com um advérbio terminado em <emphasis>mente</emphasis>

en: With numerals as single modifiers
pt: Com os numerais como modificadores únicos

en: With a word that is listed as unhyphenated in the <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>), and that uses a common prefix
pt: Com uma palavra que aparece como não-hifenizada no <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) e que use um prefixo comum

en: With trademarked terms
pt: Com termos de marcas registadas

en: Latin terms
pt: Termos em Latim

en: Do not use Latin terms. Use an equivalent English term instead.
pt: Não use termos em Latim. Tente usar um termo em Inglês, em alternativa.

en: Like
pt: Do Tipo

en: Do not use the term <emphasis>like</emphasis> to denote equivalence or similarity.
pt: Não use o <emphasis>do tipo</emphasis> para demarcar uma equivalência ou semelhança.

en: Lists
pt: Listas

en: Introduce a list with a complete sentence that ends with a colon.
pt: Introduza uma lista com uma frase completa que termine com dois-pontos.

en: Numbers
pt: Números

en: Spell out numbers in the following situations:
pt: Diga os números por extenso nas seguintes situações:

en: Numbers from zero through nine unless the number is part of a measurement
pt: Números de zero a nove, a menos que o número faça parte de uma medida

en: Approximations
pt: Aproximações

en: Extreme values such as <emphasis>million</emphasis>, but precede the value with a numeral
pt: Valores extremos como o <emphasis>milhão</emphasis>, se bem que pode anteceder o valor com um numeral

en: Any number that begins a sentence
pt: Qualquer número que inicie uma frase

en: A number that is immediately followed by a numeral, for example: <literal>two 10 MB files</literal>
pt: Um número que seja seguido imediatamente de um numeral, como por exemplo: <literal>dois ficheiros de 10 MB</literal>

en: Numerals
pt: Numerais

en: Use numerals in the following situations:
pt: Use os numerais (em oposição aos números por extenso) nas seguintes situações:

en: The number 10 or greater
pt: O número 10 ou superior

en: Negative numbers
pt: Números negativos

en: Most fractions
pt: A maioria das fracções

en: Percentages
pt: Percentagens

en: Decimals
pt: Casas decimais

en: Measurements
pt: Medidas

en: Units of time smaller than one second
pt: Unidades de tempo inferiores ao segundo

en: References to bits and bytes
pt: Referências a 'bits' e 'bytes'

en: Parentheses
pt: Parêntesis

en: Use parentheses in the following situations:
pt: Use os parêntesis nas seguintes situações:

en: To contain the abbreviation of a term on the first occurrence of the full term
pt: Para conter a abreviatura de um termo na primeira ocorrência do termo completo

en: In man page references, specifically the section number
pt: Nas referências a páginas do 'man', especificamente no número da secção

en: Period
pt: Ponto final

en: Use a period in the following situations:
pt: Use um ponto final nas seguintes situações:

en: To end a sentence
pt: Para terminar uma frase

en: In file and directory names
pt: Nos nomes dos ficheiros e pastas

en: In abbreviations that can be mistaken for words, such as a.m. and U.S.
pt: Nas abreviaturas que possam ser confundidas com palavras, como por exemplo C.O.M., E.U.

en: Punctuation
pt: Pontuação

en: Use standard American English punctuation rules. In addition to the specific points of punctuation in this section, refer also to the <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html">http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)
pt: Use as regras de pontuação normais do Inglês Americano. Para além dos sinais de pontuação específicos nesta secção, veja também no <citetitle>Chicago Manual of Style</citetitle> (<ulink url="http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html">http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html</ulink>.)

en: Punctuation in numbers
pt: Pontuação nos números

en: Do not use a comma in numerals of four digits. Use a comma in numerals of more than four digits.
pt: Não use um ponto nos numerais de quatro algarismos. Use o ponto nos numerais com mais de quatro algarismos.

en: Quotation marks
pt: Marcas de citações

en: Use quotation marks to indicate material that is taken verbatim from another source. Do not use quotation marks to excuse terms from legitimacy. If the term is not legitimate, then use another term. If you must use that term, declare the term in the glossary and make the term legitimate.
pt: Use as marcas de citação (plicas, aspas) para indicar o material que foi explicitamente retirado de outra fonte. Não use as aspas para retirar a legitimidade dos termos. Se o termo não for legítimo, então use outro termo. Se precisar de usar esse termo, declare-o no glossário e torne-o legítimo.

en: See v. Refer to
pt: 'Veja' vs. 'Consulte'

en: When referring a user to another resource, use "refer to" instead of "see", and "refer also to" instead of "see also". This differentiates from the <sgmltag class="starttag">see</sgmltag> and <sgmltag class="starttag">seealso</sgmltag> tags that are used in indexing. These tags create special links in the index. To be consistent throughout the document, we reserve the special words "see" and "see also" for hyperlinked index references, and use "refer to" and "refer also to" for non-hyperlinked and non-indexed references.
pt: Ao referenciar um outro recurso, use o "consulte" em vez do "veja", ou então "consulte também" em vez de "veja também". Isto cria uma separação em relação às marcas <sgmltag class="starttag">see</sgmltag> e <sgmltag class="starttag">seealso</sgmltag>, as quais são usadas na indexação. Estas marcas criam referências especiais no índice. Para ser consistente ao longo do tempo, reservam-se as palavras especiais "ver" e "ver também" para o caso das referências com hiperligações, sendo que existe o "consultar" e o "consultar também" para o caso das referências não-ligadas e não-indexadas.

en: Semicolon
pt: Ponto-e-vírgula

en: Do not use semicolons.
pt: Não use pontos-e-vírgulas.

en: Slash
pt: Barra

en: Except where required as part of a filename, do not use slashes "/" in your writing. The construction <literal>and/or</literal>, for example, does not exist. Use one or the other term instead.
pt: Excepto no caso de ser necessário como parte do nome de um ficheiro, não use as barras "/" na sua escrita. A construção <literal>e/ou</literal>, por exemplo, não existe. Use um termo ou o outro, em alternativa.

en: Spelling
pt: Ortografia

en: Use standard American English spelling rules, refer to the <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) for guidelines.
pt: Use as regras-padrão ortográficas do Inglês Americano; consulte o <citetitle>American Heritage Dictionary</citetitle> (<ulink url="http://www.bartleby.com/61/">http://www.bartleby.com/61/</ulink>) para obter mais informações.

en: Titles
pt: Títulos

en: For manual titles use the same rules as for headings.
pt: Para os títulos manuais, use as mesmas regras dos destaques.

en: Units
pt: Unidades

en: Follow these rules when using units:
pt: Siga estas regras ao usar unidades:

en: Use standard abbreviations for units of measurements, do not invent your own abbreviations.
pt: Use as abreviaturas-padrão para as unidades de medida, não invente as suas próprias.

en: For further guidelines, refer to the <citetitle>IEEE Standard Dictionary of Electrical and Electronics Terms</citetitle>.
pt: Para mais informações, veja em <citetitle>IEEE Standard Dictionary of Electrical and Electronics Terms</citetitle>.

en: Use periods for abbreviated units that might be mistaken for a word.
pt: Use pontos nas unidades abreviadas que possam ser confundidas com palavras.

en: Most standard abbreviations of units account for both singular and plural usage.
pt: A maior parte das abreviaturas-padrão das unidades têm em conta a utilização singular e plural.

en: Insert a space between the numeral and the unit of measurement.
pt: Indique um espaço entre o numeral e a unidade de medida.

en: Composition Tips
pt: Sugestões de Composição

note: This section will collect miscellanea and advice for specific situations that the FDP editors encounter.  I hope they will feel free to e-mail me sticky situations or particularly interesting examples of work they've beautified.  Hopefully not too much will be drawn from my own work! - PWF.
en: This section contains usage tips based on situations the Fedora Documentation Project editors have encountered in the past. You should read and understand these examples to improve your own documentation. The Fedora Documentation Project editors welcome additional examples.
pt: Esta secção contém sugestões de utilização que se baseiam nas situações que os editores do Projecto de Documentação do Fedora encontraram no passado. Deverá ler e compreender estes exemplos para melhorar a sua própria documentação. Os editores do Projecto de Documentação do Fedora agradecem os exemplos adicionais.

en: Active Voice
pt: Voz Activa

en: Always use active voice, except when it is awkward to do so. The tutorial tells the user how to accomplish a task, and should give instructions clearly and concisely. Avoid using "must," "need to," and the like. These words are redundant in a tutorial, since the reader assumes you are outlining necessary steps to accomplish a task. Also avoid using "maybe," "might," and other words that indicate you are unsure about the subject matter. Your tutorial should cover a subject authoritatively. The reader should never be concerned about unknown effects of following the tutorial.
pt: Use sempre a voz activa, excepto se ficar estranha a sua utilização num determinado contexto. O tutorial diz ao utilizador como desempenhar uma tarefa, devendo dar as instruções de forma clara e concisa. Evite usar os termos "dever", "ser necessário", entre outros. Estas palavras são redundantes num tutorial, dado que o leitor assume que você já está a destacar os passos necessários para efectuar uma tarefa. Evite também usar os termos "talvez", "poderá" e outras palavras que indiquem que não tenha a certeza sobre a matéria em estudo. O seu tutorial deverá cobrir um assunto de forma autoritária. O leitor nunca se deverá preocupar com os efeitos desconhecidos de seguir o tutorial.

en: Incorrect: Passive voice
pt: Incorrecto: Voz passiva

en: The <command>yum update</command> command must be run.
pt: O comando <command>yum update</command> deverá ser executado.

en: You might want to run the <command>yum update</command> command.
pt: Poderá querer executar o comando <command>yum update</command>.

en: Correct: Active voice
pt: Correcto: Voz activa

en: Run the <command>yum update</command> command.
pt: Execute o comando <command>yum update</command>.

en: Present Tense
pt: Tempo Presente

en: Write in the present tense. A good rule of thumb is that the words "will" and "shall" are almost never needed in describing what the user should do or see. They add unnecessary length to sentences and can confuse translators. They are also often indicators of passive voice; refer also to <xref linkend="sn-misc-active-voice"/>.
pt: Escreva no tempo presente. Uma boa regra de algibeira é que palavras como "será" ou "deverá" quase nunca são necessárias para descrever o que o utilizador deverá ou fazer. Estas adicionam um tamanho desnecessário às frases e poderão confundir os tradutores. Estas normalmente também são indicações de voz passiva; consule também o tópico <xref linkend="sn-misc-active-voice"/>.

en: Incorrect: Future tense
pt: Incorrecto: Tempo futuro

en: The application will display a list of target files.
pt: A aplicação irá mostrar uma lista dos ficheiros-alvo.

en: A list of target files will be displayed by the application.
pt: Uma lista de ficheiros-alvo será apresentada pela aplicação.

en: Correct: Present tense
pt: Correcto: Tempo presente

en: The application displays a list of target files.
pt: A aplicação mostra uma lista dos ficheiros-alvo.

en: Narrative Voice
pt: Voz Narrativa

en: Do not use the first person "I," "we," or "us" to refer to yourself the writer (whether including the reader or not), the Fedora Documentation Project, the Fedora community, or any other group. Do not refer to users with a third person pronoun ("he," "she," or "he or she") or the word "one." It is acceptable to refer to the reader with the second person pronoun "you."
pt: Não use a primeira pessoa "Eu," ou "nós" para se referir a si próprio como escritor (quer inclua o leitor quer não), o Projecto de Documentação do Fedora, a comunidade do Fedora ou qualquer outro grupo. Não faça referências aos utilizadores com um pronome na terceira pessoa ("ele", "ela" ou "eles/elas"). É aceitável fazer referências ao leitor na segunda pessoa com o pronome "você".

en: Incorrect: First or third person
pt: Incorrecto: Primeira ou terceira pessoa

en: As described in the last section, I always run <command>up2date</command> before configuring the Samba server.
pt: Como foi descrito na última secção, eu executo sempre o <command>up2date</command> antes de configurar o servidor do Samba.

en: If the user needs to back up his or her files, s/he should use the <command>tar</command> or <command>cpio</command> command.
pt: Se o utilizador precisar de salvaguardar os ficheiros dele ou dela, ele/a deverá usar o comando <command>tar</command> ou <command>cpio</command>.

en: Correct: Second (or no) person
pt: Correcto: Segunda pessoa (ou omisso)

en: Refer to the section on <command>up2date</command> before configuring the Samba server.
pt: Veja a secção sobre o <command>up2date</command> antes de configurar o servidor do Samba.

en: If necessary, users can back up files with the <command>tar</command> or <command>cpio</command> command.
pt: Se necessário, os utilizadores poderão salvaguardar os ficheiros com o comando <command>tar</command> ou <command>cpio</command>.

en: Negative Words
pt: Palavras pela Negativa

en: Avoid negative words when possible, since they give documentation an overly dogmatic tone. The word "avoid" is useful for this purpose. Note that contractions are often used for negative words such as <emphasis>don't</emphasis> or <emphasis>can't</emphasis>. Refer to <xref linkend="vle-contractions"/>.
pt: Evite as palavras negativas sempre que possível, dado que atribuem à documentação um carácter dogmático, de certa forma. A palavra "evitar" é útil para esse fim. De um modo geral na língua inglesa, as contracções são usadas para as palavras negativas como o <emphasis>don't</emphasis> ou o <emphasis>can't</emphasis>. Consulte a secção <xref linkend="vle-contractions"/>.

en: Uncertainty
pt: Incerteza

en: Avoid overuse of "typically," "usually," "most of," "many," and the like. While occasional use of these constructions is acceptable, overuse reduces the authority of your documentation. The documentation should adequately cover a stock installation of Fedora. It is impossible for a tutorial-length document to cover every possible configuration scenario. Address the most common scenarios and note discrepancies only as required.
pt: Evite o uso excessivo do "tipicamente", "normalmente", "na maior parte", "muitos", entre outros. Embora seja aceitável um uso ocasional destas conjugações, o uso em ecesso reduz a autoridade da sua documentação. A documentação deverá cobrir de forma adequada uma instalação predefinida do Fedora. É impossível, para um documento com a dimensão de um tutorial, cobrir todos os cenários de configuração possíveis. Analise os cenários mais comuns e aponte apenas as discrepâncias mais necessárias.

en: Redundant Coverage
pt: Cobertura Redundante

en: Avoid covering redundant material, such as how to update a Fedora system. These overarching topics may be covered in other tutorials. Writers frequently violate this guideline because they feel their tutorial is not long enough. Keep your tutorial from wandering off-topic. Instead, refer the reader to a separate tutorial whenever possible for complete coverage of that topic.
pt: Evite a cobertura de material redundante, como a actualização de um sistema Fedora. Estes tópicos mais complicados podem ser cobertos noutros tutoriais. Os escritores violam normalmente esta recomendação por acharem que o seu tutorial não é suficientemente comprido. Mantenha o seu tutorial com o tópico bem definido e sem grandes desvios. Em vez disso, indique ao leitor para consultar um tutorial sparado, sempre que possível, para uma cobertura completa desse tópico.

en: Self-referential Value Judgments
pt: Juízos de Valor com Referências Próprias

en: Avoid statements such as "One of the most important things to do is <replaceable>XYZ</replaceable>." If the procedure is important, the reader already expects it to be in your tutorial. The converse is also true: If a procedure appears in your tutorial, the reader expects it is important. This is especially true if you use a whole section for the procedure in question. Merely state, "Do <replaceable>XYZ</replaceable>." Then elaborate as required. If the whole section concerns how to do <replaceable>XYZ</replaceable>, leave this sentence out entirely. Refer also to <xref linkend="vle-golden-rule-4"/>.
pt: Evite frases do tipo "Uma das coisas mais importantes a fazer é <replaceable>XYZ</replaceable>." Se o procedimento for importante, o leitor já está à espera dele no seu tutorial. O inverso também se aplica: se um procedimento aparece no seu tutorial, o leitor espera que este seja importante. Isto é particularmente verdadeiro se usar uma secção inteira para o procedimento em questão. Basta dizer, "Faça <replaceable>XYZ</replaceable>.". Depois disso, desenvolva de acordo com as necessidades. Se a secção completa disser respeito à forma como fazer <replaceable>XYZ</replaceable>, retire esta frase por inteiro. Consulte também a secção <xref linkend="vle-golden-rule-4"/>.

en: Precision of Language
pt: Precisão da Linguagem

en: Use precise words for actions users should take. Do not instruct users to "go" to a selection, or "find" a menu.
pt: Use palavras exactas para as acções que os utilizadores deverão efectuar. Não diga aos utilizadores para "ir" para uma selecção ou "procurar" um menu.

en: Incorrect: Imprecise wording
pt: Incorrecto: Palavras pouco exactas

en: Go to the <guimenu>Main Menu</guimenu> -&gt; <guimenuitem>Foobar</guimenuitem>
pt: Vá a <guimenu>Menu Principal</guimenu> -&gt; <guimenuitem>XPTO</guimenuitem>

en: Find the option labeled <guilabel>Search</guilabel>
pt: Descubra a opção <guilabel>Procurar</guilabel>

en: Correct: Precise wording
pt: Correcto: Frases exactas

en: From the <guimenu>Main Menu</guimenu>, select <guimenuitem>Foobar</guimenuitem>
pt: No <guimenu>Menu Principal</guimenu>, seleccione o <guimenuitem>XPTO</guimenuitem>

en: Select the <guilabel>Search</guilabel> option
pt: Seleccione a opção <guilabel>Procurar</guilabel>

en: Do Not Discriminate Against Non-GUI Users
pt: Não Discrimine em Relação aos Utilizadores Não-Gráficos

en: If you are writing about a GUI-only application, you may use "click" freely. If you are writing about an application that has a text-mode interface, use "select" instead as shown above.
pt: Se estiver a escrever a escrever sobre uma aplicação somente gráfica, poderá usar o termo "carregar" ou "clicar" à vontade. Se estiver a escrever acerca de uma aplicação que também tem uma interface em modo texto, use o "seleccionar" como aparece acima.

en: DocBook Tips
pt: Sugestões do DocBook

en: This section contains tips on how to use DocBook tags more effectively in your documentation.
pt: Esta secção contém sugestões sobre a utilização mais eficiente da marcas de DocBook na sua documentação.

en: Admonitions
pt: Advertências

en: Avoid overuse of admonitions. Keep admonitions short and effective by using only the most important material inside the admonition. Move any background material required to explain the admonition statements outside the admonition. Use a short but descriptive title for an admonition. Use title case for the admonition title.
pt: Evite o uso excessivo de advertências. Mantenha-as resumidas e efectivas, usando apenas o material mais importante dentro da advertência. Passe todo o material de segundo plano necessário para explicar as advertências para fora destas. Use um título breve mas descritivo para uma advertência. Use a capitalização no título da advertência.

en: Incorrect: Lengthy admonition
pt: Incorrecto: Advertência comprida

en: Use <command>sfdisk</command> to check input
pt: Use o <command>sfdisk</command> para verificar os dados de entrada

en: The <command>sfdisk</command> command accepts a script file as standard input to set up partitions on a hard disk. Sometimes <command>sfdisk</command> will simply reject an erroneous input file. In other cases, it will use the input verbatim, writing an incorrect partition table to your disk. Always use the <command>sfdisk -n</command> command to check your input file before writing to the disk.
pt: O comando <command>sfdisk</command> aceita um ficheiro de programa como dados de entrada para configurar as partições num disco rígido. Em alguns casos, o <command>sfdisk</command> irá rejeitar simplesmente um ficheiro de entrada inválido. Nos outros, irá usar os dados de entrada tal-e-qual, criando uma tabela de partições incorrecta no seu disco. Use sempre o comando <command>sfdisk -n</command> para verificar o seu ficheiro antes de efectuar gravações no disco.

en: Correct: Brief admonition
pt: Correcto: Advertência breve

en: Check Input
pt: Verifique os Dados de Entrada

en: Always use the <command>sfdisk -n</command> command to check your input file before writing to the disk.
pt: Use sempre o comando <command>sfdisk -n</command> para verificar os seus dados de entrada, antes de gravar no disco.

en: The <command>sfdisk</command> command accepts a script file as standard input to set up partitions on a hard disk. Sometimes <command>sfdisk</command> will simply reject an erroneous input file. In other cases, it will use the input verbatim, writing an incorrect partition table to your disk. <placeholder-1/>
pt: O comando <command>sfdisk</command> aceita um script como um standard de entrada para configurar as partições num disco rígido. Em alguns casos, o <command>sfdisk</command> irá simplesmente rejeitar um ficheiro de entrada inválido. Nos outros, irá usar os dados de entrada tal-e-qual, criando uma tabela de partições incorrecta no seu disco. <placeholder-1/>

en: Avoid punctuation in titles for sections or admonitions, except for commas only where demanded. Use a title that says something about the admonition comment, such as "Reboot Required," instead of simply using the admonition type for a title ("Note").
pt: Evite a pontuação nos títulos das secções ou advertências, excepto as vírgulas e somente quando necessário. Use um título que diga algo sobre o comentário da advertência, como "É Necessário Reiniciar," em vez de usar apenas o tipo de advertência como título ("Nota").

en: Follow the capitalization rules for headings in the title of an admonition.
pt: Siga as regras de capitalização dos destaques no título de uma advertência.

en: The <sgmltag class="starttag">replaceable</sgmltag> Tag
pt: A Marca <sgmltag class="starttag">replaceable</sgmltag>

en: If your documentation formally states a specific value will be used as a convention, do not use the <sgmltag class="starttag">replaceable</sgmltag> tag in your text or examples.
pt: Se a sua documentação relatar formalmente que um determinado valor será usado como convenção, não use a marca <sgmltag class="starttag">replaceable</sgmltag> no seu texto ou exemplos.

en: XML Entities
pt: Entidades de XML

en: Use the entities provided by the Fedora Documentation Project. These entities are found in the <filename>common/</filename> folder in the <filename>fedora-docs</filename> distribution. (Refer also to <xref linkend="ch-getting-files"/>.) For instance, do not use abbreviations such as "FC2." Instead, use the predefined entities "&amp;FC; &amp;FCVER;," which produces the text "Fedora 9."
pt: Use as entidades oferecidas pelo Projecto de Documentação do Fedora. Estas entidades estão na pasta <filename>common/</filename> da distribuição <filename>fedora-docs</filename>. (Consulte também a secção <xref linkend="ch-getting-files"/>.) Por exemplo, não use abreviaturas do tipo "FC2." Em vez disso, use as entidades predefinidas "&amp;FC; &amp;FCVER;," que irá gerar o texto "Fedora 9."

en: Fedora Documentation Guidelines
pt: Recomendações de Documentação do Fedora

en: recursion
pt: recorrência

en: read the fine manual
pt: leia o belo manual

en: Please read this chapter carefully. This chapter describes the guidelines that must be followed such as naming conventions.
pt: Por favor, leia este capítulo com cuidado. O mesmo descreve as recomendações que deverão ser seguidas, como as nomenclaturas.

en: This chapter only discusses tags used for documentation for the Fedora Project, not all available DocBook XML tags. For the complete list, refer to <ulink url="http://www.docbook.org/tdg/en/html/docbook.html"/>.
pt: Este capítulo só discute as marcas usadas na documentação do Projecto Fedora, não refere todas as marcas de XML do DocBook. Para uma lista completa, veja em <ulink url="http://www.docbook.org/tdg/en/html/docbook.html"/>.

en: File Header
pt: Cabeçalho do Ficheiro

en: XML Header
pt: Cabeçalho de XML

en: In accordance with good XML practices, the first line in any DocBook XML source files should identify the file as XML. Use the following line as the first line of any new XML file:
pt: De acordo com as boas práticas de XML, a primeira linha de qualquer ficheiro de DocBook em XML deverá identificar o ficheiro como XML. Use a seguinte linha como primeira linha de qualquer ficheiro em XML novo:

en: CVS Id Header
pt: Cabeçalho do ID do CVS

en: All the files must contain the CVS Id header. Use the following line as the second line of any new XML file:
pt: Todos os ficheiros deverão conter o cabeçalho Id do CVS. Use a seguinte linha como segunda linha para qualquer ficheiro em XML novo:

en: Any time the file is committed to CVS, the line is updated automatically to include information about the file. For example:
pt: Sempre que este ficheiro for enviado para o CVS, a linha é actualizada automaticamente para incluir informações acerca do ficheiro. Por exemplo:

en: ID Naming Conventions
pt: Convenções dos Nomes dos Identificadores

en: XML tags
pt: Marcas XML

en: naming conventions
pt: nomenclaturas

en: This section explains the ID naming convention. IDs are unique identifiers that allow DocBook XML to cross-reference a section, chapter, or other element.
pt: Esta secção explica a nomenclaturas de IDs. Os IDs são identificadores únicos que permitem ao DocBook em XML fazer referências a uma dada secção, capítulo ou outro elemento.

en: rules for defining an ID
pt: regras de definição de um ID

en: The following general rules apply to IDs:
pt: As seguintes regras gerais aplicam-se aos IDs:

en: Keep an ID as short and simple as possible.
pt: Mantenha um ID o mais curto e simples possível.

en: Start the ID with the special short two-character label. This makes URLs and other references to this ID human readable, by self-identifying the XML container type.
pt: Inicie o ID pela legenda especial de dois caracteres. Esta faz com que os URLs e as outras referências a este ID sejam legíveis, identificando autoamticamente o tipo do contentor de XML.

en: <xref linkend="ex-id-usage"/> demonstrates some example ID attributes used properly.
pt: O <xref linkend="ex-id-usage"/> demonstra alguns atributos de IDs usados correctamente como exemplos.

en: Proper ID Usage
pt: Utilização Adequada de IDs

en: Two-Character Naming Conventions
pt: Nomenclaturas de Dois Caracteres

en: Tag
pt: Marca

en: Prefix
pt: Prefixo

en: preface
pt: prefácio

en: section
pt: secção

en: appendix
pt: apêndice

en: Use the title of the item as the ID. Make your titles unique within a document to prevent conflicts. For example:
pt: Use o título do item como ID. Torne os seus títulos únicos dentro de um documento para evitar conflitos. Por exemplo:

en: XML Tags
pt: Marcas XML

en: xml tags
pt: marcas em XML

en: caveats
pt: contrapartidas

en: It is very important that you remember the caveats in this section. These are learned suggestions or rules that make your XML experience better.
pt: É muito importante que recorde as contrapartidas desta secção. Estas são sugestões ou regras de aprendizagem que tornam melhor a sua experiência em XML.

en: Do Not Use Trademark Entities
pt: Não Use Entidades de Marcas Registadas

en: Do not use the trademark entities <sgmltag class="genentity">trade</sgmltag>, <sgmltag class="genentity">copy</sgmltag>, or <sgmltag class="genentity">reg</sgmltag> because the do not produce HTML output that works for all charsets. The HTML output produces by these entities are declared in the DTD and cannot be changed via the stylesheet.
pt: Não use as entidades de marcas registadas <sgmltag class="genentity">trade</sgmltag>, <sgmltag class="genentity">copy</sgmltag> ou <sgmltag class="genentity">reg</sgmltag>, porque não produzem HTML válido que funcione em todas as codificações de caracteres. O resultado em HTML produzido por estas entidades está descrito na DTD e não pode ser alterado com a folha de estilo.

en: Instead, use the <sgmltag>trademark</sgmltag> tag and its associates classes as follows:
pt: Em vez disso, use a marca <sgmltag>trademark</sgmltag> e as suas classes associadas, como se segue:

en: DocBook XML source
pt: Código XML do DocBook

en: Rendered content
pt: Conteúdo representado

en: trademark symbol after me
pt: símbolo de marca comercial a seguir a mim

en: registered trademark symbol after me
pt: símbolo de marca registada a seguir a mim

en: copyright symbol after me
pt: símbolo de direitos de cópia a seguir a mim

en: Content inside <sgmltag>para</sgmltag> tags
pt: Conteúdo dentro das marcas <sgmltag>para</sgmltag>

en: In general, use <sgmltag>para</sgmltag> tags around anything other than a simple paragraph. Doing so will create additional white space within the text itself in the PDF version.
pt: De um modo geral, não use as marcas <sgmltag>para</sgmltag> em torno de tudo o que não seja um parágrafo simples. Ao fazê-lo, irá criar espaços em branco adicionais dentro do próprio texto, na versão em PDF.

en: Specifically, do not use <sgmltag>para</sgmltag> tags around the following (or, to put this another way, do not embed the following within <sgmltag class="element">para</sgmltag> elements):
pt: Especificamente, não use as marcas <sgmltag>para</sgmltag> em torno do seguinte (ou, posto de outra forma, não incorpore o seguinte dentro das marcas <sgmltag class="element">para</sgmltag>):

en: Content inside <sgmltag class="element">para</sgmltag> elements within <sgmltag>listitem</sgmltag> tags
pt: Conteúdo dentro de elementos <sgmltag class="element">para</sgmltag> residentes em marcas <sgmltag>listitem</sgmltag>

en: Content inside <sgmltag class="element">para</sgmltag> elements within <sgmltag class="element">listitem</sgmltag> elements <emphasis>must</emphasis> start immediately after the beginning <sgmltag class="starttag">para</sgmltag> tag to avoid extra white space in the PDF version.
pt: O conteúdo dentro das marcas <sgmltag class="element">para</sgmltag> inseridas em marcas <sgmltag class="element">listitem</sgmltag> <emphasis>deverá</emphasis> começar logo a seguir à marca inicial <sgmltag class="starttag">para</sgmltag>, para evitar espaços em branco extra na versão em PDF.

en: Content inside <sgmltag>screen</sgmltag> tags
pt: Conteúdo dentro das marcas <sgmltag>screen</sgmltag>

en: The content inside <sgmltag>screen</sgmltag> tags (<sgmltag class="starttag">screen</sgmltag> and <sgmltag class="endtag">screen</sgmltag>) <emphasis>must</emphasis> be flush left in the XML file; otherwise, the extraneous whitespace will appear in the HTML version.
pt: O conteúdo dentro das marcas <sgmltag>screen</sgmltag> (<sgmltag class="starttag">screen</sgmltag> e <sgmltag class="endtag">screen</sgmltag>) <emphasis>deverão</emphasis> ser retirados à esquerda no ficheiro em XML; caso contrário, os espaços em branco estranhos irão aparecer na versão em HTML.

en: admonitions
pt: advertências

en: There are five types of admonitions in DocBook: <sgmltag class="element">caution</sgmltag>, <sgmltag class="element">important</sgmltag>, <sgmltag class="element">note</sgmltag>, <sgmltag class="element">tip</sgmltag>, and <sgmltag class="element">warning</sgmltag>. All of the admonitions have the same structure: an optional <sgmltag class="element">title</sgmltag> followed by paragraph-level elements. The DocBook DTD does not impose any specific semantics on the individual admonitions. For example, DocBook does not mandate that a <sgmltag class="element">warning</sgmltag> is reserved for cases where bodily harm can result.
pt: Existem cinco tipos de advertências no DocBook: <sgmltag class="element">caution</sgmltag> (cuidado), <sgmltag class="element">important</sgmltag> (importante), <sgmltag class="element">note</sgmltag> (nota), <sgmltag class="element">tip</sgmltag> (sugestão) e <sgmltag class="element">warning</sgmltag> (aviso). Todas as advertências têm a mesma estrutura: um <sgmltag class="element">title</sgmltag> opcional, seguido dos elementos do nível dos parágrafos. A DTD do DocBook não impõe qualquer semântica específica das advertências individuais. Por exemplo, o DocBook não obriga que um <sgmltag class="element">warning</sgmltag> esteja reservado para os casos em que possam resultar danos corporais.

en: Creating a <sgmltag class="element">note</sgmltag>, <sgmltag class="element">tip</sgmltag>, <sgmltag class="element">caution</sgmltag>, <sgmltag class="element">important</sgmltag>, or <sgmltag class="element">warning</sgmltag>
pt: Criar um <sgmltag class="element">note</sgmltag>, <sgmltag class="element">tip</sgmltag>, <sgmltag class="element">caution</sgmltag>, <sgmltag class="element">important</sgmltag> ou <sgmltag class="element">warning</sgmltag>

en: There are several ways to bring attention to text within a document. A <emphasis><sgmltag class="element">note</sgmltag></emphasis> is used to bring additional information to the users' attention. A <emphasis><sgmltag class="element">tip</sgmltag></emphasis> is used to show the user helpful information or another way to do something. A <emphasis><sgmltag class="element">caution</sgmltag></emphasis> is used to show the user they must be careful when attempting a certain step. An <emphasis><sgmltag class="element">important</sgmltag></emphasis> tag set can be used to show the user a piece of information that should not be overlooked. While this information may not change anything the user is doing, it should show the user that this piece of information could be vital. A <emphasis><sgmltag class="element">warning</sgmltag></emphasis> is used to show the reader that their current setup will change or be altered, such as files being removed, and they should not choose this operation unless they are alright with the consequences.
pt: Existem diversas formas de chamar a atenção ao texto dentro de um documento. Uma <emphasis><sgmltag class="element">note</sgmltag></emphasis> (nota) é usada para trazer informações para a atenção dos utilizadores. Uma <emphasis><sgmltag class="element">tip</sgmltag></emphasis> (sugestão) é usada para mostrar ao utilizador alguma informação útil ou outra forma de fazer algo. Uma <emphasis><sgmltag class="element">caution</sgmltag></emphasis> é usada para mostrar ao utilizador que deverá ter cuidado ao efectuar um determinado passo. Uma marca <emphasis><sgmltag class="element">important</sgmltag></emphasis> pode ser usada para mostrar ao utilizador um pedaço de informação que não deva ser ignorado. Embora esta informação possa não alterar o que o utilizador irá fazer, deverá mostrar ao utilizador que esta informação poderá ser vital. Um <emphasis><sgmltag class="element">warning</sgmltag></emphasis> é usado para mostrar ao leitor que a sua configuração actual irá mudar ou ser alterada, como a remoção de ficheiros, pelo que não deverão escolher esta operação, a menos que estejam de acordo com as consequências.

en: The following lines of code show the basic setup for each case mentioned above, along with its appearance in HTML.
pt: As seguintes linhas de código mostram a configuração básica de cada um dos casos indicados acima, em conjunto com a sua aparência em HTML.

en: Note
pt: Nota

en: Body of text goes here.
pt: O conteúdo do texto aparece aqui.

en: Tip
pt: Sugestão

en: Body of text goes here
pt: O conteúdo do texto aparece aqui

en: Caution
pt: Atenção

en: Important
pt: Importante

en: Warning
pt: Aviso

en: Screenshots
pt: Imagens

en: screenshots
pt: imagens

en: how to take
pt: como fazer

en: screen captures
pt: capturas do ecrã

en: screen grabs
pt: gravações do ecrã

en: Screenshots are illustrations that show the state of a display the user may encounter. Screenshots can be either graphical or textual. However, screenshots use a great deal of space in a text document to convey relatively small amounts of information. The same space in the document can hold a greater amount of more descriptive and helpful information. Therefore, authors should avoid screenshots whenever possible in favor of descriptive text.
pt: As imagens ou capturas de ecrã são ilustrações que apresentam o estado do ecrã que o utilizador poderá encontrar. As imagens poderão ser gráficas ou textuais. Contudo, as imagens usam bastante espaço num documento de texto para representar pedaços de informação relativamente pequenos. o mesmo espaço num documento poderá conter uma quantidade maior de informação mais descritiva e útil. Como tal, os autores deverão evitar as imagens sempre que possível, em detrimento de texto mais descritivo.

en: One of the isolated instances in which screenshots are useful is to demonstrate a physical screen layout that is unfamiliar to a reader. <emphasis>This does not mean that illustrations of dialog boxes are good uses of screenshots.</emphasis> On the contrary, dialogs are simply instances of a user interface element with which a reader is already familiar. An annotated diagram in certain cases, however, explains to the reader where to find functional landmarks on the screen such as menu bars.
pt: Uma das instâncias isoladas em que as imagens são úteis é para demonstrar a disposição física de um ecrã que não seja familiar para um leitor. <emphasis>Isto não significa que as ilustrações de janelas sejam bons usos para as imagens.</emphasis> Pelo contrário, as janelas são simplesmente instâncias de um elemento da interface com o qual o leitor já está familiarizado. Um diagrama anotado em certos casos, todavia, explica ao leitor onde encontrar certos blocos funcionais no ecrã, como as barras de menu.

en: The steps for taking a graphical screenshot illustrate how using text to describe a procedure is more concise than a series of screenshots.
pt: Os passos para tirar uma imagem gráfica ilustram como a utilização de texto para descrever um dado procedimento é mais conciso que uma série de imagens.

en: Graphical Screenshot
pt: Imagem Gráfica

en: Create a new user account to make screenshots. The new account uses the distribution default theme, fonts, and element sizes. The resulting screenshot has an appearance familiar to the largest number of readers, and makes Fedora Documentation Project documents consistent.
pt: Crie uma nova conta de utilizador para criar as imagens. A conta nova usa o tema, tipos de letra e tamanhos dos elementos predefinidos da instalação. A imagem resultante tem uma aparência familiar ao maior número de leitores, e faz com que os documentos do Projecto de Documentação do Fedora sejam consistentes.

en: Before taking the screenshot, if possible, resize the targeted GUI element(s) to the smallest possible size. The target image should be 500 pixels wide or less. If the screenshot includes more than one GUI element, you may need to resize the screenshot in a following step.
pt: Antes de tirar a fotografia, tente dimensionar os elementos gráficos com o tamanho mais pequeno possível. O seu objectivo é uma imagem com 500 pixels ou menos ainda. Se estiver a tirar  uma fotografia com mais de um elemento gráfico, terá de dimensionar a imagem num passo seguinte.

en: To take the screenshot, select the GUI element with the mouse to bring it to the forefront, or otherwise arrange the elements. Press <keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo> to capture a single GUI window. For capturing the entire desktop use <keycap>Print Screen</keycap>. If the shot includes multiple elements grouped closely together, crop the resulting PNG format image in <application>The GIMP</application>.
pt: Para tirar a imagem, seleccione o elemento gráfico com o seu rato, passando-o para primeiro plano, ou organizando os elementos. Carregue em <keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo> para capturar uma única janela. Para capturar o ecrã completo, use o <keycap>Print Screen</keycap>. Se estiver a tirar uma fotografia de vários elementos e os tiver agrupado em conjunto, poderá recortar a imagem resultante no <application>The GIMP</application>. A imagem estará no formato PNG.

en: If necessary, resize the image using <application>The GIMP</application>. Open the image, then right-click on it and choose <menuchoice><guimenu>Image</guimenu><guimenuitem>Scale Image...</guimenuitem></menuchoice>. With the chain symbol intact, set the <guilabel>New Width</guilabel> to <guilabel>500 px</guilabel>, and click <guibutton>OK</guibutton>. Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> to save changes to the image before converting it.
pt: Se precisar, poderá dimensionar a imagem com o <application>The GIMP</application>. Com a imagem aberta, carregue com o botão direito nesta e escolha a opção <menuchoice><guimenu>Imagem</guimenu><guimenuitem>Escalar a Imagem...</guimenuitem></menuchoice>. Com o símbolo da corrente intacto, configure a <guilabel>Nova Largura</guilabel> com o valor <guilabel>500 px</guilabel> e carregue em <guibutton>OK</guibutton>. Certifique-se que carrega em <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo> para gravar as suas alterações no seu PNG, antes da conversão para EPS.

en: With the image open in <application>The GIMP</application>, right-click the image, and select <menuchoice><guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice>. Under <guimenu>Determine File Type:</guimenu>, select <guimenuitem>PostScript</guimenuitem>, then click <guibutton>OK</guibutton>. Allow flattening of the image by clicking <guibutton>Export</guibutton>.
pt: Com a imagem aberta no <application>The GIMP</application>, carregue com o botão direito na imagem e seleccione a opção <menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Gravar Como...</guimenuitem></menuchoice>. Em <guimenu>Determinar o Tipo de Ficheiro:</guimenu>, seleccione <guimenuitem>PostScript</guimenuitem>, carregando depois em <guibutton>OK</guibutton>. Active o alisamento da imagem com a opção <guibutton>Exportar</guibutton>.

en: A <guilabel>Save as PostScript</guilabel> window appears. Select <guilabel>Encapsulated PostScript</guilabel>, and click <guibutton>OK</guibutton>.
pt: Na janela para <guilabel>Gravar como PostScript</guilabel>, seleccione <guilabel>PostScript Encapsulado</guilabel> e carregue em <guibutton>OK</guibutton>.

en: Text Screenshot
pt: Imagem de Texto

en: Textual screen information is also useful for readers. Follow these guidelines for textual screenshots:
pt: A informação textual do ecrã também é útil para os leitores. Siga estas recomendações para as imagens textuais:

en: If a graphical screenshot illustrates a function, and the textual mode has identical functions, do not include both, unless omitting either would make your description unclear.
pt: Se usar uma imagem gráfica para ilustrar uma função e o modo textual tiver funções idênticas, não inclua ambas, a menos que a omissão de uma delas torne a sua descrição menos clara.

en: Make the information generic over specific, and omit any username and machine information if possible. Do not include the shell prompt unless it is vital to the demonstration.
pt: Opte por ter a sua informação genérica em vez de específica, omitindo a informação do utilizador e da máquina, se possível. Não inclua a linha de comandos, a menos que seja vital para a demonstração.

en: Separate what the user types from sample command output.
pt: Separe o que o utilizador escreve do resultado do comando.

en: When using <sgmltag class="element">screen</sgmltag> to demonstrate a procedure, use <sgmltag class="element">userinput</sgmltag> tags to show what the user types, and use <sgmltag class="element">computeroutput</sgmltag> tags to show the resulting output.
pt: Ao usar o <sgmltag class="element">screen</sgmltag> para demonstrar um procedimento, use as marcas <sgmltag class="element">userinput</sgmltag> para mostrar o que o utilizador escreve, usando as marcas <sgmltag class="element">computeroutput</sgmltag> para mostrar o resultado.

en: <xref linkend="ex-text-screenshot-good"/> is an example of textual screenshot usage.
pt: O <xref linkend="ex-text-screenshot-good"/> é um exemplo de utilização de uma imagem textual.

en: Correct Textual Screenshot (XML Source and HTML)
pt: Corrigir a Imagem Textual (Código em XML e HTML)

en: To find all the currently active ssh sessions, execute the following command:
pt: Para descobrir todas as sessões de SSH activas, execute o seguinte comando:

en: Output appears similar to the following:
pt: O resultado aparece semelhante ao seguinte:

en:  2564 ?        S      0:23 /usr/sbin/sshd
     3092 ?        S      0:00 /usr/bin/ssh-agent /etc/X11/xinit/Xclients
     8032 pts/0    S      0:00 ssh user@host.example.com
     8032 pts/1    S      0:00 ssh root@backup.example.com
pt:  2564 ?        S      0:23 /usr/sbin/sshd
     3092 ?        S      0:00 /usr/bin/ssh-agent /etc/X11/xinit/Xclients
     8032 pts/0    S      0:00 ssh utilizador@maquina.exemplo.com
     8032 pts/1    S      0:00 ssh root@salvaguarda.exemplo.com

en: Previewing Your Work
pt: Antever o seu Trabalho

en: The GNOME <application>Help</application> browser, also known as <command>yelp</command>, and the KDE <application>Khelp</application> documentation browser can render DocBook XML information as needed. Use these applications to preview your work if you prefer reading your work in a browser-like environment. Run the following command:
pt: O navegador de <application>Ajuda</application> do GNOME, também conhecido como <command>yelp</command> e o <application>Khelp</application> do KDE poderão representar a informação em XML do DocBook à medida das necessidades. Use estas aplicações para antever o seu trabalho, se o preferir ler num ambiente de um navegador. Execute assim o seguinte comando:

en: Make sure to point the preferred help browser at the top parent file of your XML document. Once the document loads, you can add a bookmark for it for ease of use later.
pt: Certifique-se que aponta o navegador de ajuda preferido para o ficheiro-pai do seu documento em XML. Logo que o documento seja carregado, poderá adicionar um favorito para o mesmo para o poder usar mais tarde.

en: Using Bookmarks
pt: Usar os Favoritos

en: Keeping your documents in the same place for every checkout session makes help browser bookmarks more effective.
pt: Manter os seus documentos no mesmo local para cada sessão de recepção torna os favoritos do navegador de ajuda mais efectivos.

en: Once you have a bookmark stored, it will appear in the help browser at every use. You can now hit <keycap>F1</keycap> during any GUI session to launch the help browser. Then choose your bookmark from the menu to preview your document at any time.
pt: Logo que tenha guardado um favorito, este irá aparecer no navegador de ajuda sempre que o usar. Poderá agora carregar em <keycap>F1</keycap> durante qualquer sessão gráfica para lançar o navegador de ajuda. Depois, escolha o seu favorito do menu para antever o seu documento em qualquer altura.

en: How Modules Work
pt: Como Funcionam os Módulos

en: Documentation modules have a specific structure that enables the preconfigured tools to work correctly. Follow this structure exactly or you may have problems building your module. The Fedora Documentation Project build tools locate resources in the module and use them to build new output such as HTML or RPM packages.
pt: Os módulos de documentação têm uma estrutura específica que activa as ferramentas pré-configuradas para funcionarem correctamente. Siga esta estrutura exacta ou então poderá vir a ter problemas com a compilação do seu módulo. As ferramentas de compilação do Projecto de Documentação do Fedora localizam os recursos no módulo e usam-nos para criar novos formatos de saída, como HTML ou pacotes RPM.

en: Structure of a Module
pt: Estrutura de um Módulo

en: <xref linkend="ex-module-structure"/> shows a directory tree of an example module, excluding any <filename class="directory">CVS</filename> folders. Note that this example document does not have branches.
pt: A secção <xref linkend="ex-module-structure"/> mostra uma árvore de pastas de um módulo de exemplo, excluindo as pastas <filename class="directory">CVS</filename>. Repare que este documento de exemplo não tem ramificações.

en: Example Module Structure
pt: Estrutura do Módulo de Exemplo

en: CVS Module Contents
pt: Conteúdo do Módulo de CVS

en: Component
pt: Componente

en: Type
pt: Tipo

en: Usage Notes
pt: Notas de Utilização

en: Primary language directory
pt: Pasta da língua primária

en: required
pt: obrigatória

en: en_US
pt: pt

en: entities
pt: entidades

en: Think of an XML entity as a predefined snippet of information. It can represent a chunk of XML source, or simply a word or character. If the information changes, it need be replaced only once, in the definition, to fix all usage.
pt: Pense numa entidade de XML como um pedaço predefinido de informação. Poderá representar um bloco de código em XML, ou simplesmente uma palavra ou carácter. Se a informação se alterar, terá de ser substituída apenas uma vez na definição, de modo a corrigir todas as alterações.

en: This is the only directory absolutely required. It is named for the original language of the document, such as <placeholder-1/> (US English). The primary language does not have to be US English; all languages are supported. This directory contains all the XML source for the actual document, as well as XML source for document-specific <placeholder-2/><placeholder-3/>.
pt: Esta é a única pasta que constitui um requisito obrigatório. É nomeada em função da língua original do documento, como por exemplo <placeholder-1/> (Inglês dos EUA). A língua primária não tem de ser o Inglês dos EUA; são suportadas todas as línguas. Esta pasta contém todo o código em XML do documento actual, assim como o código em XML específico do documento para <placeholder-2/><footnote><placeholder-3/></footnote>.

en: Graphics directory
pt: Pasta de imagens

en: optional
pt: opcional

en: The <placeholder-1/> directory is an optional directory where graphics for the document should be stored. If graphics are screenshots that are particular to a language, the <placeholder-2/> directory can and should be stored in a language directory.
pt: A pasta <placeholder-1/> é uma pasta opcional onde serão gravadas as imagens do documento. Se estas forem imagens particulares para uma determinada língua, a pasta <placeholder-2/> pode e deve ser gravada numa pasta de línguas.

en: Translation (PO) directory
pt: Pasta de traduções (PO)

en: locales
pt: locais

en: The <placeholder-1/> directory contains specially formatted Portable Object, or <placeholder-2/>, files created and used by translators. The Fedora Documentation Project build tools use these files to create translated versions of documents. The translated documents are not stored in CVS; they are created as needed from these PO files. The <placeholder-3/> directory also contains the <placeholder-4/> file, which lists the active translation <placeholder-5/>, or languages.
pt: A pasta <placeholder-1/> contém os ficheiros 'Portable Object' ou <placeholder-2/> especialmente formatados, criados e usados pelos tradutores. As ferramentas de compilação do Projecto de Documentação do Fedora usam estes ficheiros para criar versões traduzidas dos documentos. Os documentos traduzidos não são guardados no CVS; são criados à medida das necessidades a partir destes ficheiros PO. A pasta <placeholder-3/> também contém o ficheiro <placeholder-4/>, que contém os <placeholder-5/> activos nas traduções ou línguas.

en: The <placeholder-1/> controls the build process. Its content is discussed in <xref linkend="ex-makefile"/>.
pt: A <placeholder-1/> controla o processo de compilação. O seu conteúdo é discutido em <xref linkend="ex-makefile"/>.

en: The <placeholder-1/> file contains document specific metadata
pt: O ficheiro <placeholder-1/> contém os metadados específicos do documento

en: Common Build Tools
pt: Ferramentas de Compilação Comuns

en: Never add the <systemitem>docs-common</systemitem> build tools directory to an individual module. Special formatting in the module list downloads these tools when a user checks out a document module. For more information, refer to <xref linkend="ch-getting-files-naming-modules"/>.
pt: Nunca adicione a pasta de ferramentas de compilação <systemitem>docs-common</systemitem> a um módulo individual. A formatação especial na lista de módulos transfere estas ferramentas, sempre que um utilizador obtém um módulo de um documento. Para mais informações, consulte em <xref linkend="ch-getting-files-naming-modules"/>.

en: The Document Build System
pt: O Sistema de Compilação dos Documentos

en: In Linux and Fedora documentation, references to commands often include a number inside parentheses. This number represents the section of <firstterm>manpages</firstterm> that includes documentation for that command. To read the manpage for <command>make(1)</command>, use the command <command>man 1 make</command>.
pt: No Linux e na documentação do Fedora, as referências aos comandos normalmente incluem um número entre parêntesis. Este número representa a secção das <firstterm>páginas de manual</firstterm> que incluem a documentação para esse comando. Para ler a página de manual para o <command>make(1)</command>, use o comando <command>man 1 make</command>.

en: The build system can render the document into another format such as <abbrev>HTML</abbrev> or <abbrev>PDF</abbrev>, using <command>make(1)</command><placeholder-1/> and shell scripts. Authors need <emphasis>no</emphasis> prior experience with either shell scripts or a <command>make(1)</command>.
pt: O sistema de compilação poderá representar o documento noutro formato, como o <abbrev>HTML</abbrev> ou <abbrev>PDF</abbrev>, utilizando <command>make(1)</command><footnote><placeholder-1/></footnote> e os programas da linha de comandos. Os autores <emphasis>não</emphasis> precisam de qualquer experiência anterior com os programas da linha de comandos ou o <command>make(1)</command>.

en: The Document <filename>Makefile</filename>
pt: A <filename>Makefile</filename> do Documento

en: Each individual document has its own <filename>Makefile</filename>, which only needs to be a few lines long. The document <filename>Makefile</filename> content is designed for cut and paste operations.
pt: Cada documento individual tem a sua própria <filename>Makefile</filename>, que só necessita de ter algumas linhas. O conteúdo da <filename>Makefile</filename> do documento está desenhado para  operações de corte e colagem.

en: <xref linkend="ex-makefile"/> below shows the whole <filename>Makefile</filename> for a simple document with two files and two translations.
pt: A <xref linkend="ex-makefile"/> abaixo mostra a <filename>Makefile</filename> completa de um documento simples com dois ficheiros e duas traduções.

en: Sample Document Makefile
pt: Makefile do Documento de Exemplo

en: Do not be concerned with some of the more complicated syntax such as the <command>XMLFILES_template</command> stanza. An explanation for this template appears a few paragraphs below.
pt: Não se preocupe com alguma da sintaxe mais complicada, como o <command>XMLFILES_template</command>. Aparecerá em baixo uma explicação para este modelo.

en: Makefile Variables
pt: Variáveis da Makefile

en: Variable
pt: Variável

en: Explanation
pt: Explicação

en: This variable contains the name for the main (parent) XML document. Follow convention by naming your document after the module name.
pt: Esta variável contém o nome do documento-pai principal em XML. Siga a convenção, nomeando o seu documento com o nome do módulo.

en: This variable contains the ISO code for the original version of the document, such as <placeholder-1/>.
pt: Esta variável contém o código ISO da versão original do documento, como em <placeholder-1/>.

en: This variable contains a listing of any files containing entity definitions. The Fedora Documentation Project uses a special XML format to record document-specific entities, so they can be translated and built on the fly like any other XML document. An example is shown later in this guide.
pt: Esta variável contém uma listagem de todos os ficheiros que contêm definições de entidades. O Projecto de Documentação do Fedora usa um formato em XML especial para guardar as entidades específicas do documento, de modo que possam ser traduzidas e geradas na altura, como se fosse outro documento em XML qualquer. Aparecerá então um exemplo mais tarde neste guia.

en: This template allows the build tools to work with the document in multiple languages once it is translated. The <placeholder-1/> marking is a variable used to substitute the appropriate language. This template is not terribly complicated. For a new module, duplicate this section exactly except for the actual filenames. Prepend the text <placeholder-2/>, in place of the language code directory name, to each filename in your document.
pt: Este modelo permite às ferramentas de compilação funcionarem com o documento em várias línguas, logo que esteja traduzido. A marcação <placeholder-1/> é uma variável que é usada para substituir a língua apropriada. Este modelo não é terrivelmente complicado. Para um módulo novo, duplique esta secção exactamente, excepto os nomes dos ficheiros em si. Coloque antes o texto <placeholder-2/>, no lugar do nome da pasta do código da língua, para cada nome de ficheiro no seu documento.

en: Files Exempt From Listing
pt: Ficheiros Isentos da Listagem

en: Do not include the document-specific entities XML file or the <filename>rpm-info.xml</filename> file, which will be discussed later in this guide.
pt: Não inclua o ficheiro XML de entidades específicas do documento nem o ficheiro <filename>rpm-info.xml</filename>, os quais serão descritos posteriormente neste guia.

en: The final section, beginning with <literal>define</literal>, locates the main <filename>Makefile.common</filename> for the build system. This <filename>Makefile.common</filename> file contains all the <application>make(1)</application> targets and rules to actually build the document and the various archives.
pt: A secção final, que começa por <literal>define</literal>, localiza o ficheiro <filename>Makefile.common</filename> principal para o sistema de compilação. Este ficheiro <filename>Makefile.common</filename> contém todos os alvos e regras do <application>make(1)</application> para criar de facto o documento e os vários pacotes.

en: The Document <filename>rpm-info.xml</filename>
pt: O <filename>rpm-info.xml</filename> do Documento

en: Each document module's primary language directory contains a file called <filename>rpm-info.xml</filename>. This file contains document-specific metadata used to generate revision history, copyright, and contributor information. It follows a DTD specification included with the rest of the build system tools.
pt: Cada pasta da língua primária do módulo do documento contém um ficheiro chamado  filename>rpm-info.xml</filename>. Este ficheiro contém os metadados específicos do documento que são usados para gerir o histórico de revisões, direitos de cópia e a informação de contribuintes. Esta segue uma especificação em DTD que vem incluída com o resto das ferramentas do sistema de compilação.

en: Build System Actions
pt: Acções do Sistema de Compilação

en: To render the <abbrev>XML</abbrev> document into another format, use one of the following <command>make</command> targets:
pt: Para representar o documento em <abbrev>XML</abbrev> noutro formato, use um dos seguintes alvos do <command>make</command>:

en: Build Targets
pt: Alvos de Compilação

en: Target
pt: Alvo

en: help
pt: ajuda

en: This target prints a list of available targets and their descriptions.
pt: Este alvo imprime uma listagem dos alvos disponíveis e das suas descrições.

en: validates
pt: valida

en: This target <placeholder-1/> the XML files to make sure they are not only well-formed, but follow the DTD. Some viewers of XML documents may not work correctly until you run this target. This target includes copying required entity files so that validating XML viewers work properly
pt: Este target <placeholder-1/> os ficheiros XML não só para garantir que estes estão bem formados, mas seguem o DTD. Algumas ferramentas utilizadas para a visualização de ficheiros XML podem não funcionar correctamente até que seja corrido o target. Este target inclui a cópia de entity files de modo a que as ferramentas utilizadas para a validação do XML funcione correctamente.

en: This target builds the "chunked" <placeholder-1/> document for each defined translation. Output is placed in a separate directory named <placeholder-2/>. Each document section is a separate file within that directory.
pt: Este alvo compila o documento <placeholder-1/> "em blocos" para cada tradução definida. O resultado é colocado numa pasta separada, chamada <placeholder-2/>. Cada secção do documento fica num ficheiro separado, dentro dessa pasta.

en: This target builds the "non-chunked" <placeholder-1/> document for each defined translation. Output is placed in a single file: <placeholder-2/>; no other files are created.
pt: Este alvo gera o documento <placeholder-1/> "inteiro" para cada tradução definida. O resultado é colocado num único ficheiro: <placeholder-2/>; não são criados outros ficheiros.

en: This target builds only the <placeholder-1/> document for all document languages. <placeholder-2/> production is currently erratic and may not work for your document.
pt: Este alvo constrói apenas o documento <placeholder-1/> para todas as línguas do documento. A produção em <placeholder-2/> tem alguns problemas e poderá não funcionar para o seu documento.

en: This target builds only the <placeholder-1/> archive for all document languages.
pt: Este alvo constrói apenas o pacote <placeholder-1/> para todas as línguas do documento.

en: This target builds all targets listed above.
pt: Este alvo constrói todos os alvos apresentados em cima.

en: not
pt: não

en: This target deletes any temporary, or generated files, but does <placeholder-1/> erase any <placeholder-2/>, <placeholder-3/>, or archive files.
pt: Este alvo apaga todos os ficheiros temporários ou gerados, mas <placeholder-1/> apaga os ficheiros <placeholder-2/>, <placeholder-3/> ou pacotes.

en: This target erases all <placeholder-1/>, <placeholder-2/>, and archive files. This target automatically invokes the <placeholder-3/> target as well.
pt: Este alvo apaga todos os ficheiros <placeholder-1/>, <placeholder-2/> e de pacotes. Este alvo também invoca automaticamente o alvo <placeholder-3/>.

en: PDF Generation is Erratic
pt: A Geração de PDFs tem Problemas

en: <abbrev>PDF</abbrev> production is currently erratic and may not work for your document.
pt: A produção de <abbrev>PDF</abbrev> tem alguns problemas e poderá não funcionar para o seu documento.

en: Adding or Changing Targets
pt: Adicionar ou Modificar os Alvos

en: To add a new target and rules, place them at the bottom of the document <filename>Makefile</filename>, below the <literal>include</literal> line. Follow your target definitions with a double colon, not a single colon. The double colon allows you to specify additional rules for existing targets, or to write rules for a new target.
pt: Para adicionar um novo alvo e regras, coloque-as no fundo da <filename>Makefile</filename> do documento, por baixo da linha <literal>include</literal>. Siga as definições do seu alvo com dois-pontos duplos, não apenas um. Os dois-pontos duplos permitem-lhe definir regras adicionais para os alvos existentes ou escrever regras para um novo alvo.

en: For more information on using <command>make(1)</command>, consult the online documentation with the command <command>info make</command> in a terminal.
pt: Para mais informações sobre a utilização do <command>make(1)</command>, consulte a documentação 'online' com o comando <command>info make</command> num terminal.

en: Using Document Image Files
pt: Usar os Ficheiros de Imagens do Documento

en: Tutorial documents often make use of images such as <filename class="extension">.PNG</filename> files. Store image files in a <filename class="directory">figs/</filename> folder in the main module directory, as shown in <xref linkend="ex-module-structure"/>.
pt: Os documentos de tutoriais normalmente utilizam imagens como os ficheiros <filename class="extension">.PNG</filename>. Guarde os ficheiros de imagens numa pasta <filename class="directory">figs/</filename> da pasta do módulo principal, como aparece em <xref linkend="ex-module-structure"/>.

en: Depending on the output media, sometimes images may be scaled, streteched, or squashed. To minimize any distortions, we recommend that you use only <filename class="extension">.PNG</filename> images. Avoid <filename class="extension">.JPG</filename> files. The <command>convert(1)</command> program, from the <package role="rpm">ImageMagick</package><abbrev>RPM</abbrev> package, provides a convenient way to reformat <filename class="extension">.JPG</filename> images into <filename class="extension">.PNG</filename> format. For more information on formatting images such as screenshots, refer to <xref linkend="sn-screenshots"/>.
pt: Dependendo do formato de saída, algumas das imagens poderão ser esticadas, encolhidas ou desfeitas. Para minimizar as distorções, recomenda-se que use apenas as imagens <filename class="extension">.PNG</filename>. Evite os ficheiros <filename class="extension">.JPG</filename>. O programa <command>convert(1)</command>, do pacote <abbrev>RPM</abbrev> <package role="rpm">ImageMagick</package>, oferece uma forma conveniente de formatar de novo as <filename class="extension">.JPG</filename> no formato <filename class="extension">.PNG</filename>. Para mais informações sobre a formatação das imagens, veja em <xref linkend="sn-screenshots"/>.

en: Image files may be organized into subdirectories under <filename>figs/</filename> if necessary. The document building system recreates the image subdirectory structure in the output documents.
pt: Os ficheiros de imagens poderão estar organizados em sub-pastas da <filename>figs/</filename>, se necessário. O sistema de compilação de documentos irá criar de novo a estrutura de sub-pastas das imagens nos documentos resultantes.

en: Images often contain labels or other text which may need to be localized. A screenshot of a program, for example, may require a version for each translated language. Name language-dependent image files such as program screenshots by adding the language code to the filename, such as <filename>menu-en_US.png</filename>. Language-independent images, such as <filename>icon.png</filename>, do not need language codes.
pt: As imagens contêm normalmente legendas ou outros textos que possam ter de ser traduzidos. Uma imagem de um programa, por exemplo, poderá necessitar de uma versão para cada língua traduzida. Dê um nome dependente da língua aos ficheiros de imagens, adicionando o código da língua ao nome do ficheiro, como acontece em <filename>menu-pt.png</filename>. As imagens independentes da língua, como o <filename>icon.png</filename>, não precisam de códigos de línguas.

en: Sometimes, a document may require images that do not follow the naming convention. To use these images with the document building system, create an ordinary text file containing the image filenames. This file must be named <filename>figs/Manifest-</filename><systemitem class="macro">${LANG}</systemitem> so the build system finds it when searching for image filenames.
pt: Em alguns casos, um documento poderá necessitar de imagens que não sigam a nomenclatura. Para usar estas imagens com o sistema de compilação do documento, crie um ficheiro de texto normal que contém os nomes dos ficheiros de imagens. Este ficheiro dever-se-á chamar <filename>figs/Manifest-</filename><systemitem class="macro">${LANG}</systemitem>, de modo que o sistema de compilação o descubra quando procurar pelos nomes dos ficheiros de imagens.

en: <xref linkend="ch-getting-files-build-system-manifest"/> demonstrates one way to create this <filename>Manifest</filename> file.
pt: O <xref linkend="ch-getting-files-build-system-manifest"/> demonstra uma forma de criar este ficheiro <filename>Manifest</filename>.

en: Building A Manifest
pt: Criar um Manifest

en: Adding a New DocBook XML File
pt: Adicionar um Novo Ficheiro de DocBook em XML

en: To add a new DocBook XML file to an existing document, follow these steps:
pt: Para adicionar um novo ficheiro de DocBook em XML a um documento existente, siga estes passos:

en: Place the new DocBook XML file in the primary language directory.
pt: Coloque o novo ficheiro de DocBook em XML na pasta da língua primária.

en: Edit the <filename>Makefile</filename> and add the filename to the <varname>XMLFILES-${1}</varname> listing. Append a <keycap>\</keycap> to the last existing line, and on the next line add an entry for the new file. Remember to add the <literal>${1}/</literal> prefix as a substitute for the language directory name.
pt: Edite a <filename>Makefile</filename> e adicione o nome do ficheiro à listagem <varname>XMLFILES-${1}</varname>. Adicione uma <keycap>\</keycap> à última linha existente e, na linha seguinte, adicione um item para o novo ficheiro. Lembre-se de adicionar o prefixo <literal>${1}/</literal> como substituto para o nome da pasta da língua.

en: Adding a Translation
pt: Adicionar uma Tradução

en: Translations are stored as PO (portable object) files, which the toolchain transforms into translated documents. Each PO file is based on the POT (PO template) for the document and translated by the Fedora Translation Project. To add a translation, follow these steps:
pt: As traduções são guardadas como ficheiros PO (portable object - objecto portável), que o conjunto de ferramentas irá transformar em documentos traduzidos. Cada um dos ficheiros PO baseia-se no POT (modelo de PO) do documento e é traduzido pelo Projecto de Traduções do Fedora. Para adicionar uma tradução, siga estes passos:

en: If the <filename class="directory">po/</filename> directory does not exist, create it and add it to CVS:
pt: Se a pasta <filename class="directory">po/</filename> não existir, crie-a e adicione-a ao CVS:

en: If it does not exist, create the POT file:
pt: Se este não existir, crie o ficheiro POT:

en: Add the new translation language to the <varname>OTHERS</varname> listing in the <filename>Makefile</filename>.
pt: Adicione a nova língua da tradução à listagem do <varname>OTHERS</varname> na <filename>Makefile</filename>.

en: Although translators often copy the POT manually to create the new PO file, the following command also works:
pt: Ainda que os tradutores copiem normalmente de forma manual o ficheiro POT para criar o novo ficheiro PO, o seguinte comando também funciona:

en: lang
pt: língua

en: Introduction
pt: Introdução

en: The goal of the Fedora Documentation Project is to create easy-to-follow, task-based documentation for Fedora users and developers. The Fedora Documentation Project uses the following tools:
pt: O objectivo do Projecto de Documentação do Fedora é criar documentação simples de usar, baseada em tarefas, para os utilizadores e programadores do Fedora. O Projecto de Documentação do Fedora usa as seguintes ferramentas:

en: Custom XSLT stylesheets for both print and HTML versions
pt: Folhas de estilo XSLT personalizadas para as versões impressas e em HTML

en: Custom scripts to generate HTML output (use <command>xmlto</command>)
pt: Programas personalizados para gerar o resultado em HTML (use o <command>xmlto</command>)

en: Emacs with PSGML mode (optional, but recommended)
pt: Emacs com o modo PSGML (opcional, mas recomendado)

en: This document explains the tools used by the Fedora Documentation Project. It provides writing and tagging guidelines to ensure Fedora documentation is consistent and easy-to-follow.
pt: Este documento explica as ferramentas usadas pelo Projecto de Documentação do Fedora e oferece algumas recomendações de escrita e marcação que tornam a documentação do Fedora consistente e fácil de seguir.

en: Prerequisites
pt: Pré-requisitos

en: To work on official Fedora documentation you need to install the required tools. Follow the directions below to configure your system.
pt: Para lidar com a documentação oficial do Fedora, terá de instalar as seguintes ferramentas. Siga as instruções abaixo para configurar o seu sistema.

en: System Packages
pt: Pacotes do Sistema

en: Install the "Authoring and Publishing" package group, which contains required DocBook XML files, stylesheets and scripts:
pt: Instale o grupo de pacotes "Authoring and Publishing" (Autoria e Publicações), que contém os ficheiros de DocBook em XML necessários, as folhas de estilo e os programas:

en: Next, install the <filename>cvs</filename> package, which is used to handle revision control on files in the official repository:
pt: De seguida, instale o pacote <filename>cvs</filename>, que é usado para lidar com o controlo de versões nos ficheiros do repositório oficial:

en: If you plan to use <application>Emacs</application> to edit DocBook XML documentation, install <package>psgml</package>, which adds helpful and time-saving functionality to maximize editing efficiency:
pt: Se pensar em usar o <application>Emacs</application> para editar a documentação DocBook em XML, instale o pacote <package>psgml</package>, que adiciona funcionalidades úteis e de poupança de tempo, de modo a maximizar a eficiência na edição:

en: Fedora Documentation Tools
pt: Ferramentas de Documentação do Fedora

en: The Fedora Documentation Project's custom scripts and stylesheets are stored in CVS on the <systemitem class="fqdomainname">cvs.fedoraproject.org</systemitem> CVS server. When you check out a document module from CVS, the tools are included in the module inside the <filename class="directory">docs-common/</filename> directory. To work on existing documents in CVS, refer to <xref linkend="ch-cvs"/>.
pt: Os programas e folhas de estilo personalizados do Projecto de Documentação do Fedora estão guardados em CVS, no servidor <systemitem class="fqdomainname">cvs.fedoraproject.org</systemitem>. Quando transfere um módulo de documentos do CVS, s ferramentas vão incluídas no módulo, dentro da pasta <filename class="directory">docs-common/</filename>. Para trabalhar sobre documentos existentes no CVS, consulte a secção <xref linkend="ch-cvs"/>.

en: The most powerful component in the Fedora Documentation Project toolbox is <firstterm>DocBook XML</firstterm>. DocBook XML is a specific scheme for authoring technical documentation using <firstterm>Extensible Markup Language</firstterm>, or <acronym>XML</acronym>. XML allows authors to mark pieces of content with descriptive tags. The following output is an example of DocBook XML:
pt: O componente mais poderoso no pacote de ferramentas do Projecto de Documentação do Fedora é o <firstterm>DocBook XML</firstterm>. O DocBook XML é um esquema específico para gerar documentação técnica, usando a <firstterm>Extensible Markup Language</firstterm> ou <acronym>XML</acronym>. O XML permite aos autores marcarem certas partes de conteúdo com marcas descritivas. Segue-se um exemplo de DocBook XML:

en: This example article, entitled <citetitle>A Very Short Article</citetitle>, consists of only a single paragraph. The tags, or markup, surround elements of content to define the sense in which they are used. A paragraph, for example, is marked with <sgmltag>para</sgmltag> tags. Text that requires emphasis is marked with <sgmltag>emphasis</sgmltag> tags. The author does not worry about the visual formatting such as italics or font size. Fedora Documentation Project build tools automatically perform all formatting tasks.
pt: Este artigo de exemplo, chamado <citetitle>Um Artigo Muito Curto</citetitle>, consiste apenas num único parágrafo. As marcas de formatação reúnem os elementos de conteúdo para definirem o sentido em que são usadas. Um parágrafo, por exemplo, é rodeado com marcas <sgmltag>para</sgmltag>. O texto que necessite de ênfase está marcado com <sgmltag>emphasis</sgmltag>. O autor não se irá preocupar com a formatação visual, como os itálicos ou o tamanho da letra. As ferramentas de compilação do Projecto de Documentação do Fedora efectuam todas as tarefas de formatação.

en: The custom tools built by the Fedora Documentation Project render DocBook source into a variety of formats for publication and distribution. They also allow translators to create localized versions of the XML documents for Fedora users around the world. The flexibility of XML allows for a single document to be used many times for many purposes, like reusable code for a programmer.
pt: As ferramentas personalizadas, criadas pelo Projecto de Documentação do Fedora, representam o código em DocBook numa variedade de formatos para publicação e distribuição. Também permitem aos tradutores criarem versões locais dos documentos de XML, para os utilizadores de Fedora em todo o mundo. A flexibilidade do XML permite a um único documento ser usado várias vezes para diversos fins, como a reutilização de código para um programador.

en: DocBook is itself very well documented. For more information about DocBook, visit <ulink url="http://www.docbook.org/"/>. The DocBook site also features complete copies of <citetitle>DocBook: The Definitive Guide</citetitle> to browse and download, the canonical source for DocBook information.
pt: O DocBook está em si muito bem documentado. Para mais informações acerca do DocBook, visite a página <ulink url="http://www.docbook.org/"/>. A página do DocBook também contém cópias completas do livro <citetitle>DocBook: The Definitive Guide</citetitle> para navegar e transferir, sendo esta a fonte canónica de informação sobre o DocBook.

en: DocBook XML Versions
pt: Versões do DocBook XML

en: DocBook XML, like a computer program, has version numbers. The version used by Fedora Documentation Project right now is 4.4. The DocBook web site may document a slightly newer version, but the majority of the schema still applies.
pt: O DocBook XML, como um programa de computador, tem números de versões. A versão usada no Projecto de Documentação do Fedora neste momento é a 4.4. A página Web do DocBook poderá conter uma versão ligeiramente mais recente, mas a maioria do esquema aplica-se à mesma.

en: Contributors who use the Microsoft Windows operating system can still make use of DocBook tools. For more information, refer to <ulink url="http://www.codeproject.com/winhelp/docbook_howto.asp"/>.
pt: Colaboradores que utilizem o sistema operativo Microsoft Windows podem usar as ferramentas DocBook. Para mais informações consulte <ulink url="http://www.codeproject.com/winhelp/docbook_howto.asp"/>.

en: Naming Conventions
pt: Convenções dos Nomes

en: The Fedora Documentation Project provides the tools, scripts, and stylesheets to transform your <abbrev>XML</abbrev> documents into other output formats such as <abbrev>HTML</abbrev>. In addition, these tools can build your document into a <abbrev>RPM</abbrev> package. To take advantage of these services, follow the conventions in this section to name your files.
pt: O Projecto de Documentação do Fedora oferece as ferramentas, programas e folhas de estilo que transformam os seus documentos em <abbrev>XML</abbrev> noutros formatos resultantes, como o <abbrev>HTML</abbrev>. Para além disso, estas ferramentas podem transformar o seu documento num pacote <abbrev>RPM</abbrev>. Para tirar partido destes serviços, deverá seguir as convenções de nomenclatura dos seus ficheiros.

en: On the CVS server, directories that contain document files are called <firstterm>modules</firstterm>. Each module represents a single document. Each document may consist of several <firstterm>branches</firstterm> if that document changes with each release of Fedora. Contributors can check out single branches of these modules or the entire module. Each document or branch may contain multiple XML source files.
pt: No servidor de CVS, as pastas que contêm os ficheiros de documentos chamam-se <firstterm>módulos</firstterm>. Cada módulo representa um único documento. Cada documento poderá consistir em várias <firstterm>ramificações</firstterm>, se esse documento for alterado em cada versão do Fedora. Os contribuintes poderão obter ramificações únicas desses módulos ou então o módulo inteiro. Cada documento ou ramificação poderá conter vários ficheiros em XML.

en: Use the <command>cvs co -c</command> command to view existing module names.
pt: Use sempre o comando <command>cvs co -c</command> para ver os nomes dos módulos existentes.

en: Partial List of CVS Modules
pt: Lista Parcial dos Módulos do CVS

en: cd ~/localrepo/fedora-docs/
pt: cd ~/repositorio-local/fedora-docs/

en: The leftmost entry in each line is the name of a module you can check out from CVS. The rest of the line ensures that checkouts include the proper branch of a document and the common build tools. For more information on CVS, refer to <xref linkend="ch-cvs"/>.
pt: O item mais à esquerda de cada linha é o nome de um módulo que poderá transferir do CVS. O restante da linha garante que as transferências incluem a ramificação correcta de um documento, assim como as ferramentas de compilação comuns. Para mais informações sobre o CVS, consulte em <xref linkend="ch-cvs"/>.

en: Note in the listing above that the <systemitem>about-fedora</systemitem> module has two branches available. One branch is for Fedora 7 and one is for forward development to match the current work of developers. On the other hand, the <systemitem>documentation-guide</systemitem> module is not branched.
pt: Repare na listagem acima que o módulo <systemitem>about-fedora</systemitem> tem duas ramificações disponíveis. Uma é para o Fedora 7 e outra é para a versão em desenvolvimento posterior, reflectindo o trabalho actual dos programadores. Por outro lado, o módulo <systemitem>documentation-guide</systemitem> não tem ramificações.

en: Modules Labeled <filename>-dir</filename>
pt: Módulos Chamados <filename>-dir</filename>

en: Modules ending with the suffix <filename>-dir</filename> are not usually helpful to checkout directly. These modules do not include the common build tools and thus do not provide many of the functions contributors require.
pt: Os módulos que terminam com o sufixo <filename>-dir</filename> não são normalmente úteis para transferir directamente. Estes módulos não incluem as ferramentas de compilação comuns e, deste modo, não oferecem muitas das funções que os contribuintes necessitam.

en: Module Names
pt: Nomes dos Módulos

en: Choose a module name that accurately reflects your document's subject, but avoid any name already taken. The document title without any use of the word <wordasword>fedora</wordasword> is a reasonable choice in most cases. Use the length descriptors <wordasword>tutorial</wordasword> or <wordasword>guide</wordasword> in the module name where appropriate.
pt: Escolha um nome de módulo que reflicta com precisão o assunto do seu documento, mas evite um nome que já tenha sido usado. O título do documento sem usar a palavra <wordasword>fedora</wordasword> é normalmente uma escolha razoável na maioria dos casos. Use as descrições da dimensão <wordasword>tutorial</wordasword> ou <wordasword>guide</wordasword> (guia) no nome do módulo, se for apropriado.

en: Avoid Redundancy
pt: Evite Redundâncias

en: Do not use the word <wordasword>fedora</wordasword> to name modules in the Fedora Documentation Project CVS repository.
pt: Não use a palavra <wordasword>fedora</wordasword> no nome dos módulos do repositório de CVS do Projecto de Documentação do Fedora.

en: Correct Module Naming
pt: Nomenclatura de Módulos Correcta

en: Document Name
pt: Nome do Documento

en: CVS Module Name
pt: Nome do Módulo de CVS

en: Desktop User Guide
pt: Guia do Utilizador do Ambiente de Trabalho

en: Software Management with <placeholder-1/>
pt: Gestão de Software com o <placeholder-1/>

en: Using <placeholder-1/>
pt: A utilizar<placeholder-1/>

en: File Names
pt: Nomes dos Ficheiros

en: Follow these guidelines for naming files to make collaboration and document reuse easy:
pt: Siga estas convenções para nomear os ficheiros, de modo a tornar a colaboração e a reutilização de documentos mais simples:

en: As with module names, avoid using the word <wordasword>fedora</wordasword> in file names since it is redundant.
pt: Como no nome dos módulos, evite usar a palavra <wordasword>fedora</wordasword> nos nomes dos ficheiros, dado que é redundante.

en: If the document is comprised of many XML files, avoid repeating the name of the document when naming the constituent files.
pt: Se o documento for composto por muitos ficheiros XML, evite repetir o nome do documento ao criar os ficheiros constituintes.

en: Avoid numbering files to show order, since editors and authors often rearrange documents or reuse their files in other documents.
pt: Evite numerar os ficheiros para demonstrar a ordem, dado que os editores e autores normalmente reorganizam os documentos ou reutilizam os seus ficheiros noutros documentos.

en: Emacs and PSGML Mode
pt: O Emacs e o Modo PSGML

en: PSGML mode
pt: Modo PSGML

en: You can use the PSGML mode available for Emacs to make it easier to write in XML format. PSGML mode provides syntax-highlighting, tag completion, and more.
pt: Poderá usar o modo PSGML, que está disponível para o Emacs, de modo a ser mais fácil de escrever no formato XML. O modo PSGML oferece o realce de sintaxe, a completação de marcas, etc.

en: Installing PSGML
pt: Instalar o PSGML

en: To install PSGML, use the <command>yum</command> command:
pt: Para instalar o PSGML, use o comando <command>yum</command>:

en: Setting Up Your <filename>.emacs</filename> File
pt: Configurar o seu Ficheiro <filename>.emacs</filename>

en: For Emacs to parse your DocBook documents correctly, you must have a <filename>.emacs</filename> file. Cut and paste the following into your existing <filename>.emacs</filename> file or create a new one that contains the following lines:
pt: Para o Emacs processar correctamente os seus documentos em DocBook, deverá ter um ficheiro <filename>.emacs</filename>. Corte e cole o seguinte no seu ficheiro  <filename>.emacs</filename> existente ou crie um novo que contenha as seguintes linhas:

en: If you have a wheel mouse and are using Emacs version 21, you can add the following to your <filename>.emacs</filename> file so your wheel will work in <application>Emacs</application>:
pt: Se tiver um rato com roda e estiver a usar o Emacs versão 21, poderá adicionar o seguinte ao seu ficheiro <filename>.emacs</filename>, para que a roda do seu rato funcione no <application>Emacs</application>:

en: If you are using the older version 20 of <application>Emacs</application>, add the following instead:
pt: Se estiver a usar a versão anterior - a 20 - do <application>Emacs</application>, adicione o seguinte comando:

en: Customizing Emacs
pt: Personalizar o Emacs

en: customizing
pt: personalização

en: colors
pt: cores

en: font
pt: tipo de letra

en: geometry
pt: geometria

en: The colors, font, and geometry (default size of window) for Emacs in your <filename>~/.Xresources</filename> file. The format for the settings is <userinput>emacs.keyword:value</userinput>.
pt: As cores, tipos de letra e geometria (tamanho predefinido da janela) do Emacs no seu ficheiro <filename>~/.Xresources</filename>. O formato da configuração é <computeroutput>emacs.palavra-chave:valor</computeroutput>.

en: The following is a sample <filename>~/.Xresources</filename> file.
pt: Segue-se um exemplo de um ficheiro <filename>~/.Xresources</filename>.

en: If you have other settings in your <filename>~/.Xresources</filename>, add the following to the end of the file.
pt: Se tiver outras configurações no seu ficheiro <filename>~/.Xresources</filename>, adicione o seguinte ao fim do ficheiro.

en: After modifying this file, execute the following command:
pt: Depois de modificar este ficheiro, execute o seguinte comando:

en: Then restart <application>Emacs</application> to apply the changes.
pt: Depois reinicie o <application>Emacs</application> para as alterações fazerem efeito.

en: Basic Emacs Commands
pt: Comandos Básicos do Emacs

en: The <keycap>Meta</keycap> key is usually the <keycap>Alt</keycap> key.
pt: A tecla <keycap>Meta</keycap> normalmente é a tecla <keycap>Alt</keycap>.

en: Emacs Commands
pt: Comandos do Emacs

en: Shortcut
pt: Atalho

en: Description
pt: Descrição

en: Parse DTD
pt: Processar a DTD

en: Display list of valid tags
pt: Mostra uma lista com as marcas válidas

en: <keycombo><placeholder-1/><placeholder-2/></keycombo>, <keycombo><placeholder-3/><placeholder-4/></keycombo>, type beginning of tag, <placeholder-5/>
pt: <keycombo><placeholder-1/><placeholder-2/></keycombo>, <keycombo><placeholder-3/><placeholder-4/></keycombo>, escrever o início da marca, <placeholder-5/>

en: Complete the tag
pt: Complete a etiqueta

en: g
pt: G

en: Cancel a command in the minibuffer
pt: Cancela um comando na mini-linha de comandos

en: Close tag
pt: Fecha a marca

en: a
pt: A

en: Move cursor to beginning of line
pt: Move o cursor para o início da linha

en: e
pt: E

en: Move cursor to the end of the line
pt: Move o cursor para o fim da linha

en: Move cursor to the beginning of the file
pt: Move o cursor para o início do ficheiro

en: Move cursor to the end of the file
pt: Move o cursor para o fim do ficheiro

en: k
pt: K

en: Cut line
pt: Corta a linha

en: y
pt: Y

en: Paste line
pt: Cola a linha

en: s
pt: S

en: Search forward in the file
pt: Procura para a frente no ficheiro

en: r
pt: R

en: Search backwards in the file
pt: Procura para trás no ficheiro

en: Check spelling of current word
pt: Verifica a ortografia da palavra actual

en: Check spelling of current buffer
pt: Verifica a ortografia da página actual

en: Open file
pt: Abrir um ficheiro

en: Save file
pt: Gravar um ficheiro

en: Exit <placeholder-1/> and prompt to save files if necessary
pt: Sai do <placeholder-1/> e pede para gravar os ficheiros, se necessário

en: q
pt: Q

en: Fill paragraph
pt: Preenche o parágrafo

en: Edit attributes for a tag (for example, you can edit the <placeholder-1/> attribute of the <placeholder-2/> tag)
pt: Edita os atributos de uma marca (por exemplo, poderá editar o atributo <placeholder-1/> da marca <placeholder-2/>)

en: Exit edit attributes
pt: Sair da edição de atributos

en: Examples
pt: Exemplos

en: The table or reference card of Emacs and PSGML commands can be confusing for beginners. This section provides some examples of how to use them.
pt: A tabela ou cartão de referência dos comandos do Emacs e do PSGML poderão ser confusos para os principiantes. Esta secção oferece alguns exemplos de utilização dos mesmos.

en: Tag Completion
pt: Completação de Marcas

en: This section assumes that you have already parsed the DTD file.
pt: Esta secção assume que você já carregou o ficheiro da DTD.

en: To avoid having to type a tag repeatedly, use the key combination <keycap>Ctrl</keycap>-<keycap>c</keycap>, followed by <keycap>&lt;</keycap>. At the bottom of the <application>Emacs</application> window, the following prompt appears:
pt: Em vez de escrever uma marca sempre que necessitar de a usar, use a combinação de teclas <keycap>Ctrl</keycap>-<keycap>C</keycap>, seguida do <keycap>&lt;</keycap>. No fundo da janela do <application>Emacs</application>, irá ver:

en: Tag: &lt;
pt: Marca: &lt;

en: To view a list of available tags, use either the <keycap>Tab</keycap> or <keycap>?</keycap>. If you know the first few letters of a tag, enter them, followed by <keycap>Tab</keycap>. If the letters uniquely identify a tag, that tag appears. If more than one completion exists, a complete list of possible tags appears.
pt: Para ver uma lista com as marcas disponíveis, use as teclas <keycap>Tab</keycap> ou <keycap>?</keycap>. Por outro lado, se souber as primeiras letras de uma marca, podê-las-á introduzir e carregar de seguida em <keycap>Tab</keycap> para obter uma lista completa das marcas disponíveis que começam por essas letras ou para completar a marca.

en: If you hit <keycombo><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>, <keycap>&lt;</keycap>, <keycap>k</keycap>, a prompt appears similar to the example below:
pt: Se carregar em <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>, <keycap>&lt;</keycap>, <keycap>K</keycap>, irá aparecer uma linha de comandos semelhante ao exemplo abaixo:

en: Tag Closure
pt: Fecho de Marcas

en: After you open a tag, you must close it. The easiest way to close an open tag is to use the key sequence <keycombo><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>, <keycap>/</keycap>. This sequence closes the most recently opened tag.
pt: Logo que tenha iniciado a marca que escolheu, terá de a fechar. A forma mais simples de fechar uma marca é usar a combinação de teclas <keycap>Ctrl</keycap>-<keycap>C</keycap>, seguida de <keycap>/</keycap>. Esta irá fechar a marca aberta mais próxima que tiver.

en: Other Emacs Tasks
pt: Outras Tarefas do Emacs

en: Working with One Window
pt: Lidar com uma Janela

en: Sometimes in <application>Emacs</application>, the window becomes split, with tags completions or other text in an alternate window. To return to a single window, use the key sequence <keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>, <keycap>1</keycap>.
pt: Algumas vezes no <application>Emacs</application>, a janela vai ficando dividida (com as completações de marcas ou outro texto na janela inferior). A forma mais simples de voltar atrás, para que apenas o seu XML e o texto apareçam num ecrã, é usar a combinação de teclas <keycap>Ctrl</keycap>-<keycap>X</keycap>, seguida de <keycap>1</keycap>.

en: Saving Work
pt: Gravar o Trabalho

en: To save your work, use the key sequence <keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>, <keycombo><keycap>Ctrl</keycap><keycap>s</keycap></keycombo>.
pt: Para gravar o seu trabalho, use a seguinte combinação de teclas, <keycap>Ctrl</keycap>-<keycap>X</keycap>, seguida de <keycap>Ctrl</keycap>-<keycap>S</keycap>.

en: The "Clear/Quit" Command
pt: O Comando "Limpar/Sair"

en: If the tag completion process becomes unwieldy or confusing, use the keysequence <keycombo><keycap>Ctrl</keycap><keycap>g</keycap></keycombo> to exit back to the text. <application>Emacs</application> clears any prompts and returns to the buffer text.
pt: Se o processo de completação de marcas se tornar incomportável ou confuso, use a sequência de teclas <keycombo><keycap>Ctrl</keycap><keycap>g</keycap></keycombo> para voltar para o texto. O <application>Emacs</application> limpa todas as linhas de comando e volta para o texto.

en: Opening a new file
pt: Abrir um ficheiro novo

en: To open a new file, use the key sequence <keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>, <keycombo><keycap>Ctrl</keycap><keycap>f</keycap></keycombo>. A prompt appears at the bottom of the <application>Emacs</application> window. Enter the file name, using <keycap>Tab</keycap> completion if desired, of the file you wish to open.
pt: Para abrir um novo ficheiro, use a combinação de teclas <keycap>Ctrl</keycap>-<keycap>X</keycap>, seguida de <keycap>Ctrl</keycap>-<keycap>F</keycap>. No fundo da janela do Emacs, será capaz de indicar o nome do ficheiro (usando a completação do <keycap>Tab</keycap> se necessário) do ficheiro que deseja abrir.

en: Closing <application>Emacs</application>
pt: Fechar o <application>Emacs</application>

en: To close <application>Emacs</application> use the key sequence <keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>, <keycombo><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>. If you have not saved your work, <application>Emacs</application> prompts you to save any changed files.
pt: Para fechar o <application>emacs</application>, use a combinação de teclas <keycap>Ctrl</keycap>-<keycap>X</keycap> seguida de <keycap>Ctrl</keycap>-<keycap>C</keycap>. Se não tiver gravado o seu trabalho, será questionado pelo <application>Emacs</application> para gravar os ficheiros alterados.

en: Additional Resources
pt: Recursos Adicionais

en: Additional Emacs and PSGML references are available at the following locations:
pt: As referências adicionais ao Emacs e ao PSGML estão disponíveis nas seguintes localizações:

en: Emacs Quick Reference Guide
pt: Guia de Referência Rápido do Emacs

en: Emacs reference card that comes with the <filename>emacs</filename> package. You can print it out as a reference. &mdash;<filename>/usr/share/emacs/<replaceable>version</replaceable>/etc/refcard.ps</filename>
pt: Um cartão de referência do Emacs que vem com o pacote <filename>emacs</filename>. Poderá imprimi-lo como referência. &mdash;<filename>/usr/share/emacs/<replaceable>versão</replaceable>/etc/refcard.ps</filename>

en: Read <citetitle>Editing XML with Emacs and PSGML</citetitle> in <filename>/usr/share/doc/psgml-<replaceable>version</replaceable>/psgml.ps</filename>.
pt: Leia o <citetitle>Editing XML with Emacs and PSGML</citetitle> no ficheiro <filename>/usr/share/doc/psgml-<replaceable>versão</replaceable>/psgml.ps</filename>.

en: <ulink url="http://www.snee.com/bob/sgmlfree/psgmqref.html"/>&mdash;<citetitle>Emacs/PSGML Quick Reference</citetitle> is a reference table of Emacs commands for PSGML mode.
pt: O <ulink url="http://www.snee.com/bob/sgmlfree/psgmqref.html"/>&mdash;<citetitle>Emacs/PSGML Quick Reference</citetitle> é uma tabela de referência dos comandos do Emacs para o modo do PSGML.

en: PSGML Tricks
pt: Truques do PSGML

en: Emacs and nXML Mode
pt: O Emacs e o Modo nXML

en: nXML mode
pt: modo nXML

en: You can also use the nXML mode available for <application>Emacs</application> to make it even easier to write in DocBook XML format. nXML mode provides context-sensitive editing using completion, real time validity error checking, syntax highlighting and indentation. All you need to do is install an RPM!!
pt: Também poderá usar o modo nXML que está disponível para o <application>Emacs</application>, de modo a ser ainda mais simples escrever no formato DocBook em XML. O modo nXML oferece uma edição sensível ao contexto com a completação, validação dos erros em tempo-real, realce de sintaxe e indentação. Tudo o que necessita é instalar um RPM!!

en: Early stages
pt: Etapas iniciais

en: Please be aware the nxml-mode for <application>Emacs</application> is quite new, so there are a few things that the advanced user might notice when using it with other documents types. If you keep an eye on the mailing-list, you can keep up to date with these, as well as ask questions. For more details, check out <xref linkend="sn-emacs-nxml-readme"/>.
pt: Tenha em atenção que o 'nxml-mode' do <application>Emacs</application> é relativamente novo, pelo que existem algumas coisas que o utilizador mais avançado poderá notar ao usá-lo com outros tipos de documentos. Se mantiver uma vista de olhos na lista de correio, poder-se-á manter actualizado com as mesmas, assim como poderá fazer perguntas. Para mais detalhes, veja a secção <xref linkend="sn-emacs-nxml-readme"/>.

en: Getting the nXML RPM
pt: Obter o RPM do nXML

en: nXML RPM
pt: RPM do nXML

en: To use nXML mode with emacs, you will need to install the nXML RPM available from <ulink url="http://people.redhat.com/twaugh/ftp/docbook/nxml-mode/">Tim Waugh's</ulink> website or the source from <ulink url="http://www.thaiopensource.com/download/">http://www.thaiopensource.com/download/</ulink>. The source requires a lot more work to setup, therefore we will only be concentrating on the RPM version.
pt: Para usar o modo nXML com o emacs, terá de instalar o pacote RPM nXML na <ulink url="http://people.redhat.com/twaugh/ftp/docbook/nxml-mode/">página do Tim Waugh</ulink> ou o código-fonte de <ulink url="http://www.thaiopensource.com/download/">http://www.thaiopensource.com/download/</ulink>. O código necessita de bastante mais trabalho de configuração; como tal, concentrar-nos-emos na versão em RPM.

en: Information on where to get the source is available in <xref linkend="sn-emacs-additional-resources"/>.
pt: As informações de disponibilização do código estão disponíveis em <xref linkend="sn-emacs-additional-resources"/>.

en: Compared to PSGML mode there are only couple of commands that you need. This speeds up writing with <application>Emacs</application> considerably, which means you can concentrate more on the content of your article.
pt: Em comparação com o modo PSGML, só existem alguns comandos que você necessita. Isto acelera a escrita no <application>Emacs</application> consideravelmente, o que significa que se poderá concentrar mais no conteúdo do seu artigo.

en: To create a tag, type <userinput>&lt;</userinput> and then type the keyword. To complete the keyword, press <command>Ctrl-Ret</command>, then add the last <userinput>&gt;</userinput>. To close a tag, type <userinput>&lt;/</userinput>.
pt: Para criar uma marca, escreva <userinput>&lt;</userinput> e escreva depois a palavra-chave. Para completar a mesma, carregue em <command>Ctrl-Ret</command>, adicionando depois a última <userinput>&gt;</userinput>. Para fechar uma marca, escreva <userinput>&lt;/</userinput>.

en: When you open a document that doesn't have a DOCTYPE declaration at the top of the file, you will get this message and tag completion won't work because nXML will not know what format you are writing.
pt: Quando abrir um documento que não tenha uma declaração DOCTYPE no topo do ficheiro, irá obter esta mensagem e a completação de marcas não irá funcionar, porque o nXML não irá saber em que formato está a escrever.

en: To load the schema, type <command>Ctrl-c</command>, then <command>Ctrl-s</command> and navigate to <filename>/usr/share/emacs/site-lisp/nxml-mode/schema/</filename> and load <filename>docbook.rnc</filename>. <application>Emacs</application> will then prompt you to save it in the current working directory.
pt: Para carregar o esquema, escreva <command>Ctrl-C</command> e <command>Ctrl-S</command>, indo depois à pasta <filename>/usr/share/emacs/site-lisp/nxml-mode/schema/</filename> e carregando o <filename>docbook.rnc</filename>. O <application>Emacs</application> perguntar-lhe-á então para gravar a pasta de trabalho actual.

en: The commands already discussed are the only differences between using <application>Emacs</application> with PSGML mode and <application>Emacs</application> with nXML mode. You will still need to use all the same commands as discussed in <xref linkend="sn-emacs-basic-commands"/>.
pt: Os comandos já discutidos são as únicas diferenças entre a utilização do <application>Emacs</application> com o modo PSGML e o <application>Emacs</application> com o modo nXML. Terá à mesma de usar todos os mesmos comandos que foram discutidos em <xref linkend="sn-emacs-basic-commands"/>.

en: Additional Emacs and nXML references are available at the following locations:
pt: As referências adicionais do Emacs e do nXML estão disponíveis nos seguintes locais:

en: Author's download area
pt: Área de transferências do autor

en: Emacs reference card that comes with the <filename>emacs</filename> package. You can print it out as a reference. &mdash;<filename>/usr/share/emacs/<replaceable>&lt;version&gt;</replaceable>/etc/refcard.ps</filename>
pt: Um cartão de referência do Emacs que vem com o pacote <filename>emacs</filename>. Poderá imprimi-lo como referência. &mdash;<filename>/usr/share/emacs/<replaceable>&lt;versão&gt;</replaceable>/etc/refcard.ps</filename>

en: nXML README File
pt: Ficheiro README do nXML

en: This file can be found in the directory you extracted the source into, or in <filename>/usr/share/doc/nxml-mode-<replaceable>&lt;version&gt;</replaceable>/</filename> if you installed the RPM.
pt: Este ficheiro poderá ser encontrado na pasta para onde extraiu o código ou em <filename>/usr/share/doc/nxml-mode-<replaceable>&lt;versão&gt;</replaceable>/</filename>, se instalou o RPM.

en: README file:
pt: Ficheiro README:

en: This is a new major mode for GNU Emacs for editing XML documents. It supports editing well-formed XML documents and also provides schema-sensitive editing of XML documents using RELAX NG Compact Syntax.
pt: Este é um novo modo principal para o GNU Emacs editar documentos em XML. Este suporta a edição de documentos válidos em XML, oferecendo também a edição sensível ao esquema dos documentos em XML, usando a Sintaxe Compacta do RELAX NG.

en: To use this, you need GNU Emacs version 21.x, preferably 21.3. GNU Emacs version 20 will not work properly, nor will XEmacs. To get started, do the following:
pt: Para usar isto, terá de ter o GNU Emacs versão 21.x, de preferência a 21.3. O GNU Emacs versão 20 não irá funcionar correctamente, assim como o XEmacs. Para começar, faça o seguinte:

en: This defines the necessary autoloads. Now, visit a file containing an XML document, and do the following:
pt: Isto define todos os carregamentos automáticos necessários. Depois, vá a um ficheiro que contenha um documento em XML, fazendo o seguinte:

en: Now do
pt: Agora faça

en: C-h m
pt: C-H m

en: For information on how to use nxml-mode. The beginnings of a manual are in nxml-mode.info. You can read this using:
pt: Para mais informações sobre a utilização do nxml-mode. As introduções do manual estão no ficheiro 'nxml-mode.info'. Podê-lo-á ler com:

en: It's also installed as an entry at the end of the top-level info directory. So you can read it with <command>C-h i</command> as usual.
pt: Também está instalado como um elemento no fim da pasta de topo do 'info'. Como tal, poderá lê-la com o <command>C-H I</command>, como de costume.

en: You can use <filename>test.valid.xml</filename> and <filename>test.invalid.xml</filename> as examples of valid and invalid XML documents.
pt: Poderá usar os ficheiros <filename>test.valid.xml</filename> e <filename>test.invalid.xml</filename> como exemplos de documentos em XML válidos e inválidos.

en: To get things automatically loaded each time you start Emacs, add:
pt: Para que as coisas sejam carregadas automaticamente de cada vez que iniciar o Emacs, adicione:

en: to your <filename>.emacs</filename>, where <computeroutput>~/nxml-mode-200YMMDD</computeroutput> is the directory containing the <filename>.elc</filename> files. Note that <filename>rng-auto.el</filename> does not load all of the nxml-mode code; it merely sets things up so that all the features of nxml-mode will be autoloaded properly. You should not try to autoload <filename>rng-auto.el</filename> itself.
pt: ao seu ficheiro <filename>.emacs</filename>, onde o <computeroutput>~/nxml-mode-200AMMDD</computeroutput> é a pasta que contém os ficheiros <filename>.elc</filename>. Lembre-se que o <filename>rng-auto.el</filename> não carrega tudo do modo 'nxml-mode'; simplesmente configura as coisas, para que as funcionalidades do 'nxml-mode' sejam carregadas automaticamente. Não deverá tentar carregar automaticamente o <filename>rng-auto.el</filename> propriamente dito.

en: To use nxml-mode automatically for files with an extension of <filename>xml</filename>, <filename>xsl</filename>, <filename>rng</filename> or <filename>xhtml</filename>, add the following to your <filename>.emacs</filename> file:
pt: Para usar o 'nxml-mode' automaticamente para os ficheiros com as extensões <filename>xml</filename>, <filename>xsl</filename>, <filename>rng</filename> ou <filename>xhtml</filename>, adicione o seguinte ao seu ficheiro <filename>.emacs</filename>:

en: If you edit XML using iso-8859-N encodings other than iso-8859-1 and you are running Emacs 21.3 or later, then I recommend enabling unify-8859-on-decoding-mode, by adding the following to your <filename>.emacs</filename> file:
pt: Se editar o XML com as codificações iso-8859-N em vez da iso-8859-1 e estiver a usar o Emacs 21.3 ou posterior, recomenda-se que active o 'unify-8859-on-decoding-mode', adicionando a seguinte sequência ao seu ficheiro <filename>.emacs</filename>:

en: To get validation and schema-sensitive editing, you need a RELAX NG Compact Syntax (RNC) schema for you document. The schema directory includes some schemas for popular document types.
pt: Para ter uma validação e edição sensível ao esquema, precisa de um esquema de Sintaxe Compacta do Relax NG (RNC) do seu documento. A pasta do esquema inclui alguns esquemas para os tipos de documentos mais conhecidos.

en: For more on RELAX NG, refer to <ulink url="http://relaxng.org/">http://relaxng.org/</ulink>.
pt: Para mais informações sobre o RELAX NG, consulte a página <ulink url="http://relaxng.org/">http://relaxng.org/</ulink>.

en: For a tutorial on RELAX NG Compact Syntax, refer to <ulink url="http://relaxng.org/compact-tutorial.html">http://relaxng.org/compact-tutorial.html</ulink>
pt: Para um tutorial sobre a Sintaxe Compacta do RELAX NG, veja a página <ulink url="http://relaxng.org/compact-tutorial.html">http://relaxng.org/compact-tutorial.html</ulink>

en: For automatically creating RNC schemas, I recommend my Trang program: <ulink url="http://www.thaiopensource.com/relaxng/trang.html">http://eee.thaiopensource.com/relaxng/trang.html"</ulink>
pt: Para criar automaticamente os esquemas RNG, recomenda-se o programa Trang: <ulink url="http://www.thaiopensource.com/relaxng/trang.html">http://eee.thaiopensource.com/relaxng/trang.html"</ulink>

en: Infer an RNC schema from an instance document
pt: Inferir um esquema de RNC a partir do documento de uma instância

en: Convert a DTD to an RNC schema
pt: Converter uma DTD para um esquema RNC

en: Convert a RELAX NG XML syntax schema to an RNC schema
pt: Converter um esquema de sintaxe do XML em Relax NG para um esquema RNC

en: You can use this to <placeholder-1/>
pt: Poderá usar isto para <placeholder-1/>

en: To convert a RELAX NG XML syntax (.rng) schema to a RNC schema, you can also use the XSLT stylesheet from <ulink url="http://www.pantor.com/download.html">http://www.pantor.com/download.html"</ulink>.
pt: Para converter um esquema de sintaxe em XML do RELAX NG (.rng) para um esquema RNC, poderá também usar a folha de estilo XSLT em <ulink url="http://www.pantor.com/download.html">http://www.pantor.com/download.html"</ulink>.

en: To convert a W3C XML Schema to an RNC schema, you need first to convert it to RELAX NG XML syntax using Sun's RELAX NG converter tool rngconv (built on top of MSV). Refer to <ulink url="https://msv.dev.java.net/">https://www.dev.java.net/</ulink>.
pt: Para converter um Esquema de XML da W3C num esquema RNC, terá primeiro de o converter para a sintaxe XML do RELAX NG, usando a ferramenta de conversão para RELAX NG da Sun, a 'rngconv' (assente sobre o MSV). Veja em <ulink url="https://msv.dev.java.net/">https://www.dev.java.net/</ulink>.

en: The file <filename>NEWS</filename> describes recent changes.
pt: O ficheiro <filename>NEWS</filename> descreve as alterações recentes.

en: Please use the list <ulink url="http://groups.yahoo.com/group/emacs-nxml-mode/">http://groups.yahoo.com/group/emacs-nxml-mode</ulink> for bug reports, discussion. I will announce all new versions there.
pt: Use por favor a lista <ulink url="http://groups.yahoo.com/group/emacs-nxml-mode/">http://groups.yahoo.com/group/emacs-nxml-mode</ulink> para os relatórios de erros, discussão, etc. Serão aí anunciadas todas as versões novas.

en: Acknowledgments
pt: Agradecimentos

en: This document is based on a document started by Tammy Fox (tfox at redhat.com) and contributed to by Sandra Moore (smoore at redhat.com) and Johnray Fuller (jrfuller at redhat.com).
pt: Este documento baseia-se num documento iniciado por Tammy Fox (tfox at redhat.com) e com contribuições de Sandra Moore (smoore at redhat.com) e Johnray Fuller (jrfuller at redhat.com).

en: A patch from Roozbeh Pournader (roozbeh at sharif.edu) has been applied to fix a few typos and explain that anonymous CVS access does not allow commits.
pt: Uma correcção do Roozbeh Pournader (roozbeh at sharif.edu) foi aplicada para corrigir alguns erros ortográficos e explicar que o CVS anónimo não permite o envio de novas versões.

en: Patches from Gavin Henry (ghenry at suretecsystems.com) have been applied to add the trailing slashes to the <command>figure</command> tag example in <filename>docs-xml-tags.xml</filename>.
pt: Foram aplicadas correcções de Gavin Henry (ghenry at suretecsystems.com) par adicionar as barras finais ao exemplo da marca <command>figure</command>, como aparece em <filename>docs-xml-tags.xml</filename>.

en: A patch from Joshua Daniel Franklin (joshuadfranklin at yahoo.com) has been applied to add <xref linkend="ch-vim"/>.
pt: Uma actualização do Joshua Daniel Franklin (joshuadfranklin at yahoo.com) para adicionar o <xref linkend="ch-vim"/>.

en: A patch from Karsten Wade (kwade at redhat.com) has been applied to add <xref linkend="sn-screenshots"/>. It was edited by Paul W. Frields (stickster at gmail.com).
pt: Uma correcção de Karsten Wade (kwade at redhat.com) foi aplicada para adicionar o <xref linkend="sn-screenshots"/>. Foi editada por Paul W. Frields (stickster at gmail.com).

note: This section has been removed. <para> A patch from Paul W. Frields (stickster at gmail.com) has been applied to add more explanation of the <command>screen</command> tag set to <xref linkend="sn-xml-tags-screen"></xref>. </para>
en: A patch from Tommy Reynolds (Tommy.Reynolds at MegaCoder.com) has been applied to more fully explaing the document building system.
pt: Uma correcção de Tommy Reynolds (Tommy.Reynolds at MegaCoder.com) foi aplicada para descrever com maior pormenor o sistema de compilação de documentos.
