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.
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 <element>, a tag final para fechamento de elementos </> ou barra / que finaliza a forma mais abreviada de marcação de elementos (veja Marcação SGML e metacaracteres, Capítulo 1).
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*.
Tipicamente isto será representado por negrito se disponível ou em formato texto plano com texto entre asterisco como *este*.
Normalmente isto será representado por itálicos, em formato texto plano com sinais de maior e menor como <este>. 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 <var>.
Isto é normalmente feito usando uma fonte com largura fixa; em formato texto plano, aspas são usadas em torno do elemento.
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.
Isto é normalmente feito usando uma fonte com largura fixa; em formato texto plano, aspas podem ser usadas em torno do elemento.
Isto é normalmente feito usando uma fonte com largura fixa; em formatos texto plano aspas podem ser usadas ao redor do elemento.
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.
Há vários elementos para se introduzir referências cruzadas para outras partes do mesmo documento ou para outros documentos.
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 id passando sua referência de identificação - por exemplo <chapt id="spong"> especifica que o capítulo ou apêndice iniciado tem a referência de identificação spong. Esta referência de identificação pode então ser referida em outras partes do documento usando elementos especiais de referência cruzada.
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.
O elemento <ref> 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.
Sintaticamente a referência cruzada é um substantivo de frase, satisfatório para usuários como (veja <ref id="...">) ou informações mais adiante em <ref id="...">..
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 < > em torno dele.
Tipicamente ambos elementos serão feitos em fonte fixa; se possível, o <ftppath> será feito em um hyperlink funcional para o site <ftpsite>.
<ftppath> deve sempre ser precedido por um <ftpsite> no mesmo capítulo, ou apêndice, mas uma vez que um site foi nomeado vários caminhos podem ser definidos.
Normalmente ambos elementos serão feitos em fonte fixa; Se possível, <httppath> será feita em um hyperlink funcional para os arquivos nomeados no diretório mais recente. <httpsite>.
<httppath> deve sempre ser procedida de um <httpsite> no mesmo capítulo ou apêndice, mas uma vez que o site foi nomeado varios caminhos podem aparecer.
Normalmente este elemento será criado em fonte fixa; Se possível, id será feito em um hyperlink funcional usando name como identificação.
Footnotes pode aparecer em muitos textos inline, e são indicados por <footnote>...</footnote>. 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.
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.
Footnote pode ser aninhado, mas é raramente uma boa idéia.
Manual Debiandoc-SGML
Versão 1.1.6 14 April 2005ijackson@gnu.ai.mit.edu
ardo@debian.org