<chapt id="inline">
  <heading>Texto marcado inline e marcação do estilo de caracteres</heading>

  <p>
    Texto ordinário (chamado "texto inline" neste documento) pode
    conter elementos para formação especial e referência cruzada.  Texto
    inline aparece em capítulo, apêndice e títulos de seções, em aviso
    de copyright, dentro de parágrafos e em outros lugares parecidos.
  </p>

  <sect>
    <heading>Estilo do Caracter</heading>

    <p>
      Há vários elementos para determinar um significado especial de certas
      partes do texto.  Para todos eles o fim do texto especial deve ser
      marcado explicitamente, usando uma tag final
      <tt>&lt;<var>element</var>&gt;</tt>, a tag final para fechamento
      de elementos <tt>&lt;/&gt;</tt> ou barra <tt>/</tt> que
      finaliza a forma mais abreviada de marcação de elementos (veja
      <ref id="markup">).
    </p>

    <p>
      <taglist>

	<tag>
	  <tt>&lt;em&gt;</tt> - ênfase
	</tag>
	<item>
	  <p>
	    Indica que o texto contido é mais importante ou mais
	    significante que o resto.
	  </p>
	  <p>
	    Normalmente isto será representado por itálicos se
	    disponível, ou texto em negrito ou sublinhado, ou em
	    formato de texto puro colocando o texto entre
	    asteriscos como *este*.
	  </p>
	</item>

	<tag>
	  <tt>&lt;strong&gt;</tt> - mais ênfase
	</tag>
	<item>
	  <p>
	    Indica que o texto contido é ainda mais importante ou
	    ainda mais significante que o resto.
	  </p>
	  <p>
	    Tipicamente isto será representado por negrito se
	    disponível ou em formato texto plano com texto entre
	    asterisco como *este*.
	  </p>
	</item>

	<tag>
	  <tt>&lt;var&gt;</tt> - variável metasintática
	</tag>
	<item>
	  <p>
	    Indica que o texto contido é uma variável metasintática.
	    Ou seja, ele é uma peça de objeto da sintaxe que é usado
	    para ter um valor real substituido.
	  </p>
	  <p>
	    Normalmente isto será representado por itálicos, em
	    formato texto plano com sinais de maior e menor como
	    &lt;este&gt;.  Se muitas variáveis metasintáticas são
	    mostradas uma após as outras elas devem ser, cada uma,
	    seguida de seu próprio elemento <tt>&lt;var&gt;</tt>.
	  </p>
	</item>

	<tag>
	  <tt>&lt;package&gt;</tt> - nome do pacote
	</tag>
	<item>
	  <p>
	    Indica que o texto contido é o nome de um pacote Debian.
	  </p>
	  <p>
	    Isto é normalmente feito usando uma fonte com largura
            fixa; em formato texto plano, aspas são usadas em torno
            do elemento.
	  </p>
	</item>

	<tag>
	  <tt>&lt;prgn&gt;</tt> - nome do programa ou arquivo conhecido
	</tag>
	<item>
	  <p>
	    Indica que o texto contido é o nome de um programa,
            um arquivo conhecido (normalmente sem o caminho), 
            uma função ou alguma coisa parecida que tem um nome
            no computador.
	  </p>
	  <p>
            Em formatos de saída onde o sublinhado de caracter
            e vários estilos de fontes estão disponíveis este é
            normalmente representado com uma fonte de largura
            fixa. Em texto plano, estes nomes não são especialmente
            marcados, ocorre a introdução de aspas no fluxo do texto.
	  </p>
	</item>

	<tag>
	  <tt>&lt;file&gt;</tt> - arquivo completo ou nome de diretório
	</tag>
	<item>
	  <p>
            Indica que o texto contido é o caminho completo de um
            arquivo, buffer, diretório, etc.
	  </p>
	  <p>
            Isto é normalmente feito usando uma fonte com largura
            fixa; em formato texto plano, aspas podem ser usadas
            em torno do elemento.
	  </p>
	</item>

	<tag>
	  <tt>&lt;tt&gt;</tt> - código ou fragmento de saída, comando
	  string
	</tag>
	<item>
	  <p>
            Indica que o texto contido é um string geral que 
            vem de fora do computador. Ele deve ser usado para
            comandos ou fragmentos de código que devem ser 
            mostrados na linha de comando ou palavras (veja
            <ref id="examples"> para uma alternativa), e assim 
            por diante. Ele é frequentemente necessário para 
            introduzir variáveis metasintáticas nestas strings,
            em que elas devem fazer parte do elemento <tt>&lt;tt&gt;</tt> 
            ao invés de elementos dentro dela.
	  </p>
	  <p>
            Isto é normalmente feito usando uma fonte com largura
            fixa; em formatos texto plano aspas podem ser usadas
            ao redor do elemento.
	  </p>
	</item>

	<tag>
	  <tt>&lt;qref id="<var>refid</var>"&gt;</tt> - Referência discreta
	</tag>
	<item>
	  <p>
            Produz uma "referência discreta" para identificação de 
            referência nomeada (see <ref id="xref">). Isto deve ser
            usada onde uma referência cruzada pode ser útil mas não
            intrusiva, mas onde não é essencial.
	  </p>
	  <p>
            Em formatos onde referências cruzadas podem ser feitas
            não intrusivamente fazendo uma região do texto um
            hyperlink sem introduzir textos inline este elemento
            causará seu texto contido se tornar um hyperlink para
            o alvo da referência cruzada. Em outros formatos
            este elemento não tem nenhum efeito.
	  </p>
	</item>

      </taglist>
    </p>

  </sect>

  <sect id="xref">
    <heading>Referências Cruzadas</heading>

    <p>
      Há vários elementos para se introduzir
      referências cruzadas para outras partes do mesmo
      documento ou para outros documentos.
    </p>

    <p>
      As referências cruzadas para documentos internos são baseadas
      no esquema de identificação de referências. Cada capítulo,
      apêndice, seção, subseção etc. Pode ter um atributo <tt>id</tt> 
      passando sua referência de identificação - por exemplo 
      <tt>&lt;chapt id="spong"&gt;</tt> especifica que o capítulo ou
      apêndice iniciado tem a referência de identificação <tt>spong</tt>. 
      Esta referência de identificação pode então ser referida em outras
      partes do documento usando elementos especiais de referência cruzada.      
    </p>

    <p>
      O identificador de referência poderá também ser usado para
      gerar nomes de arquivos e referências para formatos tal
      como HTML que produzem diversos arquivos de saída; se nenhuma
      identificação de referência é especificada então o capítulo,
      apêndice ou números das seções serão usados. É uma boa idéia
      identificar no mínimo suas referências de apêndice ou 
      capítulos assim aqueles nomes de arquivos não serão alterados
      se você alterar a ordem daqueles capítulos, seções ou
      apêndices em seu documento.
    </p>

    <p>
      <taglist>

	<tag>
	  <tt>&lt;ref id="<var>refid</var>"&gt;</tt> -
	  referências cruzadas no documento completo
	</tag>
	<item>
	  <p>
            Isto gera uma referência cruzada dentro do mesmo documento
            para o capítulo, apêndice ou seção com id <var>refid</var>.
	  </p>
	  <p>
            O elemento <tt>&lt;ref&gt;</tt> não tem nenhum conteúdo;
            o capítulo, apêndice ou número de seção e titulo e seu
            número de página ou tudo que é apropriado para o formato
            de saída será inserido no texto no ponto onde a tag
            aparece.  
	  </p>
	  <p>
            Sintaticamente a referência cruzada é um substantivo de frase,
            satisfatório para usuários como <tt>(veja &lt;ref
	      id="<var>...</var>"&gt;)</tt> ou <tt>informações mais
	      adiante em &lt;ref id="<var>...</var>"&gt;.</tt>.
	  </p>
	</item>

	<tag>
	  <tt>&lt;manref name="<var>name</var>"
	    section="<var>section</var>"&gt;</tt> - manpage 
	</tag>
	<item>
	  <p>
            Gera uma referência cruzada para uma manpage para
            <var>name</var> na seção <var>seção</var>. Esta tag
            não possui nenhum conteúdo; texto descrevendo a página,
            tipicamente <tt><var>name</var>(<var>section</var>)</tt>, 
            será inserido no ponto onde <tt>&lt;manref&gt;</tt>
            aparece.
	  </p>
	</item>

	<tag>
	  <tt>&lt;email&gt;</tt> - endereço de email
	</tag>
	<item>
	  <p>
            Indica que o texto contido é um endereço de email.
            O conteúdo da tag deve ser simplesmente o texto do 
            endereço de email; marcação de estilo de caracteres e
            referências cruzadas são proibidas. Normalmente a tag
            final <tt>&lt;/email&gt;</tt> não pode ser omitida, mas
            ele pode ser deixado fora quando aparece em uma
	    <tt>&lt;author&gt;</tt> como o final de
	    <tt>&lt;author&gt;</tt>, implicado pelo inicio do próximo
            elemento, implicando no final do endereço de email.
	  </p>
	  <p>
            Em muitos formatos isto gerará uma referência cruzada
            que pode (por exemplo) ser usada para enviar 
            endereço de e-mail para o endereço citado. Em outros
            será simplesmente uma marcação para um texto especial,
            incluindo sinais de maior e menor <tt>&lt;</tt> 
            <tt>&gt;</tt> em torno dele.
	  </p>
	</item>

	<tag>
	  <tt>&lt;ftpsite&gt;</tt> - nome de site FTP anônimo
	</tag>
	<tag>
	  <tt>&lt;ftppath&gt;</tt> - caminho dos arquivos
	  FTP site
	</tag>
	<item>
	  <p>
	    <tt>&lt;ftpsite&gt;</tt> indica que o conteúdo do 
            elemento é um nome DNS de uma site FTP anônimo, e
	    <tt>&lt;ftppath&gt;</tt> que é um caminho no site.
            Ambos elementos não podem conter qualquer marcação
            de estilo de caracteres ou referência cruzada.
	  </p>
	  <p>
            Tipicamente ambos elementos serão feitos em fonte fixa;
            se possível, o <tt>&lt;ftppath&gt;</tt> será feito em um
            hyperlink funcional para o site <tt>&lt;ftpsite&gt;</tt>.
	  </p>
	  <p>
	    <tt>&lt;ftppath&gt;</tt> deve sempre ser 
            precedido por um <tt>&lt;ftpsite&gt;</tt> no mesmo capítulo,
            ou apêndice, mas uma vez que um site foi nomeado
            vários caminhos podem ser definidos.
	  </p>
	</item>

	<tag>
	  <tt>&lt;httpsite&gt;</tt> - Nome de site HTTP
	</tag>
	<tag>
	  <tt>&lt;httppath&gt;</tt> - caminho para o site HTTP
	</tag>
	<item>
	  <p>
	    <tt>&lt;httpsite&gt;</tt> indica que o conteúdo
            do elemento é um nome DNS de um site HTTP, e 
	    <tt>&lt;httppath&gt;</tt> que é o caminho naquele
            site. Ambos elementos não podem conter qualquer
            estilo de caracter ou referência cruzada.
	  </p>
	  <p>
            Normalmente ambos elementos serão feitos em fonte fixa;
            Se possível, <tt>&lt;httppath&gt;</tt> será feita em
            um hyperlink funcional para os arquivos nomeados
            no diretório mais recente.
	    <tt>&lt;httpsite&gt;</tt>.
	  </p>
	  <p>
	    <tt>&lt;httppath&gt;</tt> deve sempre ser procedida
            de um <tt>&lt;httpsite&gt;</tt> no mesmo capítulo
            ou apêndice, mas uma vez que o site foi nomeado 
            varios caminhos podem aparecer.
	  </p>
	</item>

	<tag>
	  <tt>&lt;url id="<var>id</var>"
	    name="<var>name</var>"&gt;</tt> - URL
	</tag>
	<item>
	  <p>
            Gera uma referência cruzada para a URL com a 
            identificação <var>id</var> e usa o <var>name</var> 
            para ser mostrado no documento ao invés da id.  
            Esta tag não contém qualquer conteúdo.
	  </p>
	  <p>
            Normalmente este elemento será criado em fonte fixa;
            Se possível, <var>id</var> será feito em um hyperlink
            funcional usando <var>name</var> como identificação.
	  </p>
	</item>

      </taglist>
    </p>

  </sect>

  <sect id="footnotes">
    <heading>Footnotes</heading>

    <p>
      Footnotes pode aparecer em muitos textos inline, e são
      indicados por <tt>&lt;footnote&gt;<var>...
        </var>&lt;/footnote&gt</tt>.
      O texto de footnote será removido e colocado em outro 
      lugar (onde depende do formato), e troca com uma referência 
      ou hyperlink para footnote.
    </p>

    <p>
      O conteúdo do footnote deve conter um ou mais parágrafos;
      o início do primeiro parágrafo não precisa ser marcado
      explicitamente. Elementos de marcação inline como
      um estilo de caracter não fazem efeito no conteúdo do
      footnotes definido dentro dele - o footnote é um
      trecho limpo.
    </p>

    <p>
      Footnote pode ser aninhado, mas é raramente uma boa idéia.
    </p>

  </sect>

</chapt>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("../debiandoc-sgml.pt_BR.sgml" "book" "chapt")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
