Manual de Estilo
/File/en/Wiki/StyleGuide.png

Contents

Regras Gerais

Pastas

Todas as páginas da wiki são organizadas em pastas. Imagens, templates e categorias que só são referenciadas pelas páginas em uma certa pasta, vão na mesma pasta.

Manual Manual do Jogo, informações para os jogadores.
Manual/Mecanicas de Jogo Páginas detalhadas com as mecânicas do jogo
Manual/Tutorial Tutorial, primeiro contato com o jogo.
Comunidade Conteúdo da comunidade que não se encaixa em outro lugar. Por favor, prefira usar o seu próprio GitHub pages/repositórios/wikis para seu conteúdo pessoal.
Desenvolvimento Desenvolvimento do OpenTTD e seu conteúdo.
Desenvolvimento/Script Informação para o desenvolvimento de IAs e Scripts de Jogo
Desenvolvimento/NewGRF Informação para o desenvolvimento de NewGRFs
Desenvolvimento/Esbocos de Desenhos Esboços de documentos para mudanças de maior escopo. Por favor, prefira usar o seu próprio GitHub pages/repositórios/wikis para seu conteúdo pessoal.
Basesets Páginas para base sets como o OpenGFX, OpenMSX e OpenSFX.
Wiki Páginas sobre a própria wiki.
Arquivos Coisas que são interessantes apenas para pessoas velhas.
Arquivos/OpenTTD História do OpenTTD, TTDPatch e amigos.
Arquivos/Manual/Configuracoes Páginas de esboço antigas. Por favor melhore as dicas de dentro do jogo ao invés de escrever páginas na wiki sobre as configurações.

Artigos

Títulos

Quando estiver criando um artigo, pense no que será pesquisado.
ex.: Um jogador querendo saber sobre Industrias provavelmente vai pesquisar por "indústrias", e não indústria.

Quando estiver em dúvida (o que não deveria acontecer frequentemente), use o singular.

Imagens

Use qualquer formato que funcione melhor. Arquivos PNG são a melhor escolha para a maioria dos gráficos do OpenTTD. Isso é típico:

Código Resultado
[[File:en/Archive/Manual/Settings/Longerbridges.png|frame|Legenda da Imagem]]
Legenda da Imagem

Capturas de Tela (prints) com anotações

Formato para anotações em capturas de Tela

Se você está colocando capturas de tela para explicar os conceitos de jogo você deve manter a quantidade de texto explicatório na imagem o mínimo possível e então referenciar as anotações no texto principal. As anotações devem ser feitas em uma cor contrastante (para o clima temperado, branco está bom) usando uma fonte sans-serif em negrito com anti-aliasing em um fundo transparente. Setas podem ser usadas caso necessário, mas é melhor posicionar a anotação perto do item à ser explicado. A imagem à direita é um exemplo desse formato (mas lembre que as anotações não necessariamente devem ser letras ou números, desde que eles não baguncem a captura de tela e deixem o trabalho de explicar o que está acontecendo para o texto principal.

Capturas de Janelas

Se você precisar incluir uma captura de uma janela do jogo, certifique-se que você corte exatamente as bordas da janela para que tenha uma aparência mais profissional. As janelas do OpenTTD são retângulos perfeitos, então isso será fácil o suficiente - dê zoom se necessário

Walkthroughs

Use listas ordenadas ou não ordenadas para separar os passos:

Código Resultado
#passo 1
#passo 2
#* anotação passo 2
#* anotação passo 2

  1. passo 1
  2. passo 2
    • anotação passo 2
    • anotação passo 2

Versão do Jogo

Foque em escrever páginas de manual para as últimas versões de lançamento, não a Nightly Build ou pacotes de correção. Se você realmente quer incluir uma funcionalidade que ainda não foi lançada, marque a seção com o Template:pt/S ou template similar

Botões, Itens de Menu, entre outros

Quando mencionar um botão do jogo, item de menu, comando etc. itálicos devem ser usados, sem áspas. Por exemplo: Para ajustar as configurações de correção clique Configurar Patches.

Uso de "meta-palavras"

Evite usar a palavra wiki e outras palavras descrevendo as mecânicas a não ser que seja absolutamente necessário. O nome do que você está editando é documentação, manual, tutorial etc. - a wiki é apenas o meio de entrega, então idealmente não deve ser mencionada.

A mesma coisa para palavras como "página", "seção" ou "link" quando estiver linkando outras páginas - você deve usar o mesmo título da página como link do texto. Uma boa maneira de decidir nesse tipo de coisa é imaginar como um documento impresso e ver se faz sentido - obviamente a palavra "click" não faz sentido nesse contexto.

Nossa meta é informação que não dependa de outras medias, que é útil em qualquer formato que seja. Claro que meta-palavras podem ser apropriadas se for em um artigo como esse sobre como usar a wiki.

Templates

Formato de Templatest

Use o mesmo formato de Template:pt/S. Inclua instruções para outros usuários!

Pegue o esquema de cores que melhor represente a mensagem que você quer comunicar - vermelho para coisas que precisam de atenção extra, amarelo para avisos, verde para tarefas atuais e azul para informações.

Templates Comuns

Veja aqui para uma lista de templates que são comumente usados.

Veja também