3. Dicas

Para uma melhor padronização dos documentos escritos pelas diversas pessoas de uma equipe é sempre bom definir algumas regras de formatação. Alguns editores de texto permitem a configuração para que automaticamente insiram algum texto quando é iniciado um novo documento. O uso de um desses editores pode evitar a digitação de todas as tags do documento, deixando para o autor apenas a preocupação com o conteúdo do mesmo.

Para uma melhor otimização da saída, sempre que se for gerar, a partir do fonte SGML, um documento num formato qualquer, deve-se usar o seguinte comando:

   sgml2{formato} --charset=latin --language=portuguese arquivo.sgml

caso o formato destino seja o HTML, recomenda-se, ainda, o uso da opção --imagebuttons que fará a inserção de setas indicadoras ao invés do texto "Próxima Página", "Página Anterior" e "Índice". Pode-se mudar a imagem mudando-se os arquivos next.gif, prev.gif e toc.gif, respectivamente.

Outra dica que melhora a estética é o uso da tag <file> para se escrever o nome de arquivos. Usando-se esta tag, o programa insere marcações que dizem que pode ser feita a separação silábica após a "/".

Recomenda-se a colocação dos códigos fonte de programas entre as tags <code> e <code>/ para que seja usado o estilo correto nas formatações do texto. A tag <code> insere uma linha horizontal antes e depois do código, destacando-o em relação à saída obtida com a tag <verb>.

Para se obter uma saída mais agradável de se ler, recomenda-se o uso das tags <tscreen> ou <quote>. A tag <tscreen> faz a identação do texto que segue e muda o tipo de letra para typewriter, enquanto a tag <quote> apenas faz a identação, mantendo o tipo de letra.

Nós, como autores de língua portuguesa, temos mais um problema: a acentuação. É fortemente recomendado o uso de indicadores para a geração de letras acentuadas: &eacute, por exemplo, gera a letra é. Usando-se esse método de acentuação garante-se a legibilidade total do documento após a formatação, sem a perda de nenhum caractere não visível naquele formato (se o caractere não for visível, é substituído por uma letra correspondente - no caso do exemplo a letra 'e' - quando escrita dessa forma, caso contrário, o caractere é retirado do texto).