Guia de Tutoriais · 3 min read · Oct 07, 2025
Guia de Formatação de Tutoriais
Guia de Formatação de Tutoriais
Versão 1.3
Se você deseja publicar um tutorial no HowtoForge, por favor, leia este guia para aprender como formatar seu tutorial para que ele se encaixe na aparência do HowtoForge e pareça atraente para o maior número possível de leitores. Essas diretrizes também ajudam a minimizar o tamanho do seu documento.
1 Que Programa Eu Uso Para Escrever Meu HowTo?
Use um editor HTML como Dreamweaver ou a alternativa gratuita Bluegriffon http://www.bluegriffon.org/ ou qualquer outro editor HTML que crie HTML válido. Não use o MS Word para produzir conteúdo HTML porque o Word produz HTML “estranho”…
2 Como Eu Começo?
Ok, você está sentado em frente ao seu editor HTML, pronto para começar, mas o que vem a seguir? Por favor, copie este esqueleto HTML para o seu editor:
| |
Agora você escreve seu tutorial entre as tags
e .3 Formatação
3.1 Texto Normal
Sempre use a fonte padrão para texto normal e títulos! Não use tags , e não defina suas próprias classes CSS. Toda a formatação será feita pelas classes CSS do HowtoForge depois que você publicar seu tutorial no HowtoForge.
Por exemplo, algo como
Esta é uma frase.
deve ser evitado. Simplesmente use
Esta é uma frase.
em vez disso. No HowtoForge, parecerá assim:
Esta é uma frase.
3.2 Títulos
Por favor, use
…
,…
,…
,…
, ou…
para formatar títulos. Novamente, não use tags ou classes CSS para formatá-los.O título
Este É Um Título
parecerá assim no HowtoForge:
Este É Um Título
3.3 Comandos
Por favor, use a classe CSS .command (definida na seção
… no esqueleto HTML) para formatar comandos de shell para que o leitor saiba que é algo que ele deve executar no shell. Por exemplo,chmod 755 /path/to/file
parecerá assim no HowtoForge:
chmod 755 /path/to/file3.4 Conteúdo de Arquivos
Conteúdos de arquivos devem ser encerrados com
…. Por exemplo, se você quiser mostrar aos seus leitores o conteúdo de /etc/resolv.conf, você faz assim:
search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.60
Isso parecerá assim no HowtoForge:
search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.603.5 Nomes de Arquivos, Nomes de Protocolos, Especificações de Sistema, Especificações Técnicas, Etc.
Se você estiver escrevendo sobre itens relacionados ao sistema Linux que não são comandos, mas que você deseja que sejam formatados de uma maneira especial, você pode usar a classe CSS .system. Por exemplo, se você mencionar um nome de arquivo dentro do texto normal, é uma boa ideia formatá-lo assim:
Em seguida, editamos /etc/network/interfaces para que fique assim:...
No HowtoForge, parecerá assim:
Em seguida, editamos /etc/network/interfaces para que fique assim:…
3.6 Destaques
Se você quiser destacar algo, pode usar a classe CSS .highlight. Por exemplo,
server1:
parece assim:
server1:
5 Imagens
Por favor, não use imagens que excedam 550 pixels de largura!
4 Publique Seu Tutorial
Por favor, compacte seu tutorial (arquivo HTML criado de acordo com os capítulos 1 - 3) junto com as imagens e envie o arquivo zip para [email protected]. Por favor, inclua seu nome de usuário do HowtoForge no e-mail para que possamos publicar o tutorial em seu nome.
6 Aprovação do Administrador
Seu novo tutorial não estará disponível ao público imediatamente. Um de nossos administradores irá verificá-lo (formatação, conteúdo, etc.), e provavelmente seu tutorial será aprovado. Depois disso, estará disponível no HowtoForge.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.