1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
#use wml::debian::template title="Uso de HTML em páginas web do Debian" BARETITLE=true
#use wml::debian::common_tags
#use wml::debian::acronyms
#use wml::debian::toc
#use wml::debian::translation-check translation="648de6ad5bea60540e41a5733da0b761a34c7927"
<p>
Esta página ainda é um esboço.
</p>
<toc-display/>
<toc-add-entry name="preface">Prefácio</toc-add-entry>
<p>Esta página foi criada para ajudar editores(as) e tradutores(as) a criar
páginas com tags bem estruturadas. Há dicas sobre uso de tags e sobre como criar
novas páginas de forma que a tradução fique mais fácil.</p>
<toc-add-entry name="general">Algumas dicas gerais</toc-add-entry>
<p>Para novas páginas ou traduções, aqui está uma lista de conselhos gerais</p>
<dl>
<dt>não use linhas longas</dt>
<dd>
Os arquivos wml e outros devem conter linhas que caibam numa janela de terminal
normal. Desse modo fica mais fácil editar no vi, fazer pesquisas e traduzir.
Também é importante porque é mais difícil solucionar conflitos em linhas longas.
</dd>
<dt>mantenha tags em linhas separadas, se possível</dt>
<dd>
Grande parte das tags HTML podem ser mantidas em linhas separadas. Algumas delas
são <div>, <p>, <table>, <ul>. Para deixar as coisas
mais simples para tradutores(as), mantenha em linhas separadas todas as tags que
podem ser posicionadas assim. De outra forma, tradutores(as) podem apagar
tags acidentalmente e esquecer de restaurá-las após terminar a tradução.
</dd>
<dt>não use espaços ou quebras de linhas em tags de linha única</dt>
<dd>
Algumas tags produzem espaços se forem colocadas em linhas separadas. Uma
delas é a tag <q>, para pequenas citações ou menções. Você só pode
separar essas tags como um todo, com o conteúdo numa única linha. De outro modo,
pode ocorrer um espaço entre o conteúdo e a tag na página HTML final. Entre as
palavras dessas tags você pode ter quantas quebras de linhas ou espaços quiser.
</dd>
</dl>
<toc-add-entry name="abbreviations">Abreviaturas e Acrônimos</toc-add-entry>
<p>
Para abreviaturas e acrônimos, a tag HTML <acronym> deve ser usada.
Existem duas razões para que o uso da tag <abbr> não seja recomendada:
primeiro, nem todos os navegadores suportam essa tag; segundo, existem
definições inconsistentes sobre o que é um acrônimo e o que é uma abreviatura.
</p>
<p>
Um acrônimo é adicionado numa página pela seguinte sintaxe:
<code><acronym lang="código do idioma" title="Definição completa do
acrônimo">ACRÔNIMO</acronym></code>. O título contém todas as palavras
em extenso. Se o acrônimo é criado a partir das letras iniciais de palavras,
essas letras devem estar em maiúsculas no título. O atributo lang somente é
necessário se o acrônimo ou abreviatura está num idioma estrangeiro.
</p>
<p>
Já existe um conjunto de acrônimos comuns nos modelos wml, incluídos para serem
utilizados em sua página; você tem que adicionar uma linha para usar
<code>acrônimos</code> no arquivo wml. Por exemplo, a tag wml para DD é
<acronym_DD />.
</p>
<toc-add-entry name="citations">Citações e Menções</toc-add-entry>
<p>
Existem diversas regras sobre o que significa uma citação ou uma menção para
diferentes idiomas. Se você tem uma citação curta de uma linha, você tem que
usar a tag <q> .
O processamento do conteúdo é feito pela linguagem CSS. As tags <q> não
devem ter espaços ou quebras de linha entre a tag de abertura e fechamento, e o
conteúdo.
</p>
<p>
Para citações mais longas, a tag <blockquote> é usada. A tag
<blockquote> inclui um ou mais parágrafos de texto, que são marcados com
<p>. Por favor, não use tags <blockquote> para centralizar blocos de
texto que não sejam citações. Tags blockquote são exclusivas para citações e
serão processadas no futuro por código específico da linguagem CSS.
</p>
<p>
Também existe uma tag HTML <cite>. A tag <cite> não é usada para
citação de texto propriamente, mas para a fonte da citação. Pode ser o nome da
pessoa que originou a citação. A tag é adicionada como um atributo para um
<blockquote>, como uma URL.
</p>
<toc-add-entry name="code">Nome de programas e Código</toc-add-entry>
<p>
Para nomes de programas e códigos de computador existe uma tag chamada
<code>. Navegadores normalmente sabem como exibir código e nomes de
programas, mas o processamento também pode ser alterado por CSS. Não é uma boa
ideia usar <tt> no lugar, já que ela não diz nada sobre o conteúdo.
</p>
<toc-add-entry name="samp">Amostras de saídas de processamento</toc-add-entry>
<p>
Para saídas de processamento na tela, existe uma tag especial chamada
<samp>. Se você tem um bloco grande de saída de processamento, você também
deve dar uma olhada no arquivo CSS, caso exista uma classe especial para isto.
</p>
<toc-add-entry name="kbd">Entrada de teclado</toc-add-entry>
<p>Se existir exemplos em que o(a) usuário(a) tenha que digitar alguma coisa no
teclado, a tag <kbd> é usada para a entrada de usuário(a). Veja também o
capítulo sobre <a href="#var">variáveis</a> para saber como usar tags nas
entradas de variável.
</p>
<toc-add-entry name="var">Variáveis</toc-add-entry>
<p>
Algumas vezes é preciso enfatizar uma entrada de variável, como um endereço IP
especial ou o nome de usuário(a) que deve ser dado numa chamada de programa da
linha de comando. Para essas entradas de variável, a tag <var> é usada.
</p>
<toc-add-entry name="pre">Conteúdo pré-formatado</toc-add-entry>
<p>
A tag <pre> é usada somente para texto pré-formatado. Tamanho de linha,
espaços e outras coisas serão preservados. Naturalmente, esta tag não pode
conter a maioria das outras tags HTML.
</p>
<toc-add-entry name="img">Imagens</toc-add-entry>
<p>
Se há imagens adicionadas na página, não é preciso adicionar border=0 como um
atributo inválido. Mas, se possível, o tamanho da imagem e o atributo
<code>alt</code> deve ser adicionado. O tamanho é adicionado pelo wml se não
estiver presente, mas isso demanda tempo de compilação. O atributo
<code>alt</code> deve conter alguma coisa que diga o quê está na imagem para
usuários(as) que navegam via lynx e pessoas com deficiência visual.
</p>
# <toc-add-entry name=""></toc-add-entry>
|
