VRCWiki: Manual de Estilo
Este Manual de Estilo (MdE ou MDE) é um manual de estilo sugerido para a VRChat Wiki.
Em geral:
- Todo o conteúdo na VRChat Wiki deve ser verdadeiro e preciso.
- Os colaboradores devem escrever artigos usando uma linguagem direta, sucinta e de fácil compreensão, e estruturar os artigos com layouts e formatação consistentes e amigáveis ao leitor.
- Se você tiver alguma dúvida sobre estilo, layout ou formatação da VRChat Wiki, entre em contato com um dos [https://wiki.vrchat.com/wiki/Special
?username=&group=community-mod&wpsubmit=&wpFormIdentifier=mw-listusers-form&limit=50 Moderadores da Comunidade] para obter ajuda.
Algumas diretrizes específicas para o estilo são detalhadas abaixo:
Tíulos de Artigos
Um título deve ser um nome ou descrição reconhecível do tópico, equilibrando os critérios de ser natural, suficientemente preciso, conciso e consistente com os de artigos relacionados.
Para guias de formatação veja a seção de formatação de título do Artigo, observando o seguinte:
- Capitalize a letra inicial, caso contrário siga as letras maiúsculas e minúsculas. VRChat usa letras maiúsculas para sentenças, títulos de artigos, títulos de seções, cabeçalhos em tabelas, legendas em imagens, entradas em listas(em alguns casos), e entradas em caixas de informações e templates similares, além de outras coisas.
- Não utilize artigos (a, as, o, os, ou uma, umas, um, uns) como primeira letra (Economia do Criador VRChat, não A Economia do Criador VRChat), ao menos que seja uma parte inseparável de um nome (O Gato Preto) ou um título de um trabalho (The VRChat Times).
- Normalmente use substantivos ou frases nominais: Início da vida, não No início da vida. Frases como No início da vida são aceitáveis (embora não obrigatórias) nos cabeçalhos de seção. Esta também pode ser usada frequentemente como parte de um título de artigo longo tal como Eventos VRChat, especialmente quando uma construção de frase curta (Eventos) podem ter problemas com ambiguidade.
- O último caractere não deve conter pontuação final ao menos que seja uma parte inseparável de um nome (tal como Será que Androides sonham com Carneiros Elétricos?), ou uma abreviação (VRChat Inc.), ou requerido ao fechar parêntesis/aspas (Avatares Fantásticos (e onde encontra-los)).
- Em qualquer momento que aspas ou apóstrofos aparecerem, adicione um redirecionamento para o mesmo título usando apóstrofos. Evite o uso de aspas duplas ("vírgulas dobradas") porque aspas simples e apóstrofos são fáceis de digitar e exibir corretamente na maioria das plataformas.
Cabeçalhos de seção
Cabeçalhos de Seção no geral devem seguir as guias para títulos de artigos (acima), e devem ser apresentadas com a primeira letra maiúscula (Como alimentar seu VRCat), e não em letras maiúsculas por todo o título (Como Alimentar Seu VRCat).
O cabeçalho deve estar em sua própria linha, com uma linha em branco antes dele; uma linha depois é opcional e ignorada (mas não utilize duas linhas em branco, antes ou depois, pois isso irá adicionar um espaço visível indesejado).
Por razões técnicas, cabeçalhos de seção devem:
- Be unique within a page, so that section links lead to the right place.
- Not contain links, especially where only part of a heading is linked.
- Not contain images, emoji or icons.
- Not contain citations or footnotes.
- Not misuse description list markup (";") to create pseudo-headings.
- Not contain template transclusions.
As a matter of consistent style, section headings should:
- Not redundantly refer back to the subject of the article, e.g., Early life, not Smith's early life or His early life.
- Not refer to a higher-level heading, unless doing so is shorter or clearer.
- Not be numbered or lettered as an outline.
- Not be phrased as a question, e.g., Languages, not What languages are spoken in Mexico?.
- Not use color or unusual fonts that might cause accessibility problems.
- Not be wrapped in markup, which may break their display and cause other accessibility issues
English word choice and capitalization
In order to make localization of the wiki content easier in the long run, consider a few style choices such as these:
- Quotations, titles of works (books, films, etc.)' should be capitalized as given in the source (but see Typographic conformity, below);
- Proper names use the subject's own spelling and capitalization, e.g., "...joint project of VRChat Inc. and VRChat Community Labs..."; "International Avatar Federation"
- Generally, do not capitalize the word the in mid-sentence: throughout the United Kingdom, not throughout The United Kingdom.
- Use universally accepted terms rather than those less widely distributed, especially in titles. For example, "glasses" is preferred to the national varieties spectacles (British English) and eyeglasses (American English); "Ten million" is preferable to "one crore" (Indian English).
- If a variant spelling appears in a title, make a redirect page to accommodate the others, as with "artefact" and "artifact", so that all variants can be used in searches and linking.
- Use a commonly understood word or phrase in preference to one that has a different meaning because of national differences (rather than "alternate", use "alternative" or "alternating", as appropriate), except in technical contexts where such substitution would be inappropriate ("alternate reality"; "alternate universe").