Este Livro de Estilo (também chamado de Folha de Estilo) deve ser utilizado como referência para uniformizar os artigos da Ocultura: é um guia de estilo. As regras propostas não são obrigatórias. Há várias boas formas de se fazer algo, mas se todos fizerem da mesma forma a Ocultura tornar-se-á muito mais fácil de consultar, manter e expandir. Em vista disso, a seguinte citação do Manual de Estilo de Chicago merece atenção:

Regras e regulamentos como estes, no assunto em questão, não podem ser dados com a rigidez de uma lei talhada em pedra. São adequadas para o caso médio, e devem ser aplicadas com certo grau de elasticidade.

A redação clara, informativa e imparcial é sempre mais importante que a apresentação e a forma. Não se requer que os autores sigam todas ou alguma destas regras: a graça da edição wiki é que não se requer perfeição. Os editores que fazem copy-edit vão se encaminhar a este manual e gradualmente serão feitas páginas que se ajustam a este guia, ou este guia será mudado para o mesmo efeito.

Contribuidores, notem que, por ser este documento considerado política, mudanças significantes ou substantivas devem ser discutidas antes na página de discussão, ou serão removidas.

Título dos artigos

A escolha do título para um artigo é o primeiro passo na criação de um novo conteúdo da Ocultura. Preferencialmente, o título deve descrever o assunto a tratar de forma sintética e sem ambigüidade. O uso de maiúsculas e minúsculas num título deve conformar-se à norma em vigor.

Quando o texto de um artigo tem uma ligação interna para outro (por exemplo, O leão é um [[mamífero]]), tenha em consideração que, caso o artigo ligado não exista ainda, esse nome será usado para criá-lo. Se necessitar, consulte também o artigo que explica como começar uma página.

Parágrafo introdutório

Todos os artigos devem ter um parágrafo introdutório no qual se define brevemente e se contextualiza o assunto a ser tratado. Este parágrafo pode ser dividido em dois ou mais quando necessário. Neste parágrafo introdutório deve estar indicado o título do artigo em negrito, de preferência no início da primeira linha e o contexto deve ficar claro logo nas primeiras palavras. Veja o exemplo do artigo Deserto:

Se o título do artigo tiver outra denominação possível e as duas podem ser utilizadas uma no lugar da outra sem perda de sentido para ninguém, então cada um das formas deve aparecer em negrito, preferencialmente ligadas pelo termo ou:

Exemplo: O Reino Protista ou Protoctista é um dos reinos biológicos comumente reconhecidos ...

Se o título do artigo deveria mudar conforme a variante do português empregada, a forma correta para cada variante deve ser indicada e deve ficar claro o que é aceito em cada variante.

Exemplo 1: O Escotismo (termo usado no Brasil; em Portugal, é Escutismo) é um movimento ...

Exemplo 2: O Escotismo, como é conhecido no Brasil, ou Escutismo, em Portugal, é um movimento ...

Exemplo 3: O Desporto (termo usado em Portugal; no Brasil também é aceito, mas Esporte é preferido) ...

Por fim, se o termo que é usado como título do artigo tem uma variante que não esteja relacionada com o português falado em alguma região do mundo, esta pode ser mencionada, não necessariamente no parágrafo introdutório. É elucidadora a explicação do porquê desta variante.

Ligações internas

Ao escrever sobre qualquer assunto para o Ocultura os nomes, palavras, ou frases que você considera que devam ser referidos como informação adicional deverão ser colocados entre dois colchetes retos (antes e depois do nome, palavra ou frase) de maneira que se criem ligações internas desse nome, palavra ou frase no artigo que está a editar para um outro artigo com esse título.

Exemplo: A base do sistema mágico desenvolvido por [[Aleister Crowley]], após o recebimento do [[Livro da Lei]], em 1904.

Resultado: A base do sistema mágico desenvolvido por Aleister Crowley, após o recebimento do Livro da Lei, em 1904.

O uso das ligações internas para outros artigos é encorajado. Use-as em todas as palavras e termos em que a consulta do artigo ligado ajude na compreensão ou aprofunde o artigo que está a editar. No entanto, um excesso de ligações internas numa página tem um efeito inestético, por isso não abuse delas. Nomeadamente, não coloque uma ligação em todas as ocorrências de uma palavra: basta ligar a primeira.

As ligações internas que seguem a convenção de nomenclatura têm maior probabilidade de ligarem a artigos já existentes, mas se ainda não existir um artigo sobre esse assunto, torna mais provável a criação de um artigo com nome correto por futuros editores. Tente criar as ligações com precisão. Se o artigo para o qual você quer criar a ligação ainda não existe, faça uma pequena busca para verificar: pode ocorrer que o nome do artigo seja ligeiramente diferente do que o que você digitou.

Muitas vezes o título do artigo não é o mais adequado para incluir como ligação interna. Nesses casos, é possível indicar um texto alternativo que será apresentado no artigo, mantendo a ligação o mesmo destino. Isso se faz escrevendo o texto alternativo após o título da ligação interna, separado por uma barra vertical (|).

Exemplo: O [[Zelator]] estaria na [[Sephiroth|Sephirah]] de [[Malkuth]].

Resultado: O Zelator estaria na Sephirah de Malkuth.

Tenha em atenção que o nome usado para a ligação interna deve ser suficientemente claro para que o leitor perceba do que trata sem ter que seguir a ligação. Nunca use coisas como "clique aqui" para o texto de uma ligação interna — isto não fornece informação nenhuma. O texto da ligação deve evidenciar ser o assunto tratado no artigo ligado.

Correto: Consulte a lista de desportos olímpicos.

Errado: Para ver mais desportos olímpicos clique aqui.

Um "truque" que pode ser usado para poupar trabalho na escrita de artigos é compor a ligação acrescentando um sufixo, o que é útil para a maioria dos plurais (e não só).

Exemplo: Os [[índio]]s [[brasil]]eiros estão ameaçados pelo avanço da civilização.

Resultado: Os índios brasileiros estão ameaçados pelo avanço da civilização.

Títulos das seções do artigo

Para dividir um artigo em seções, coloque o título da seção entre dois sinais de igual, como em: ==Esta é a primeira seção==.

Para fazer uma subseção, use ===Texto=== para o segundo nível e ====Texto==== para o terceiro.

Com os títulos formatados desta forma, o índice do artigo é gerado automaticamente. As secções são automaticamente numeradas para os utilizadores com essa definição ativada, e as palavras usadas nos títulos das seções têm maior relevância nas pesquisas (buscas). Os títulos também ajudam os leitores, partindo o texto e delineando o artigo.

Seguem-se algumas normas para a formatação de seções.

1. À semelhança dos nomes dos artigos, use maiúsculas apenas na primeira letra da primeira palavra ou em nomes próprios.
2. Evite fazer ligações dentro dos títulos das seções.

Dependendo das definições, alguns utilizadores podem não lê-los claramente. Recomenda-se antes colocar a ligação na primeira frase imediatamente a seguir ao cabeçalho.

1. O abuso de subtítulos deve ser evitado, pois faz o artigo parecer desordenado.

Parágrafos curtos e frases soltas geralmente não garantem o seu próprio subtítulo.

Apenas nestas circunstâncias, quando não houver texto suficiente para justificar uma seção ou subseção, é preferível usar texto em negrito ou outras marcas dentro de uma secção em vez de subtítulos.

Legendas

Por regra, as fotografias e os gráficos devem ter legendas. No entanto, a legenda pode ser omitida se a própria imagem contiver uma legenda ou se for uma óbvia representação do tema do artigo.

Seção Ver também

No final de subseção

Conforme foi dito acima, quando um artigo é curto e não tem seções, referências a outros artigos que não tenham sido incluídas no texto como ligações internas devem ser apresentadas no fim do artigo, precedidas pela introdução "Ver também:" Esta norma deve ser também usada quando o artigo tiver várias seções e a chamada de atenção se aplica apenas a uma seção específica. Neste caso deve ser colocado no final da seção a que diz respeito.

Exemplo de como digitar:

'''Ver também''': [[processador de texto]], [[folha de cálculo]]

Resultado:

Ver também: processador de texto, folha de cálculo

Como subseção própria

Por outro lado, se os artigos são longos e incluem seções e as referências dizem respeito ao artigo todo e não apenas a uma seção, devem ser listadas no final do artigo numa seção dedicada, intitulada "Ver também".

Esta seção deve aparecer antes da seção "Links externos", caso essa seção exista (se não existir deve, obviamente, ficar no fim do artigo). Não devem ser incluídas na seção "Ver também" ligações que já tenham sido incluídas no texto do artigo.

Exemplo de como digitar:

=={{Ver também}}==
* [[Processador de texto]]
* [[Folha de cálculo]]

O resultado será:

Ver também

• Processador de texto
• Folha de cálculo

Em certas situações pode ser preferível incluir uma referência a uma ligação num ponto específico do artigo, por exemplo em casos em que parte do texto foi movido para um novo artigo, ou quando outro artigo pode ser essencial para a compreensão do assunto. Nestes casos, deve ser incluído um texto, de preferência no início da seção, chamando a atenção para a ligação interna.

Exemplo: {{ver artigo principal|[[História do Brasil]]}}

Resultado:

Ver artigo principal: História do Brasil.

Seção Ligações externas

A Ocultura não é uma colecção de referências para páginas externas. Artigos só com links são muito mal vistos. No entanto, os artigos devem ser complementados, sempre que possível, com links para outras páginas da Web.

Uma ligação para uma página externa pode ser composta de duas formas:

1. Para apresentar por extenso o texto da ligação, basta escrever o URL.

   Exemplo: http://astrumargentum.org

   Resultado: http://astrumargentum.org

2. Para substituir o URL por um texto mais adequado, escreve-se o URL e o texto que se deseja apresentar, tudo entre parênteses retos.

   Exemplo: [http://www.collegium.org.br Collegium ad LVX et NOX]

   Resultado: Collegium ad LVX et NOX

O URL deve começar com http:// ou outro protocolo, como ftp:// ou news://.

Alguns URLs são pouco estéticos e dão pouca informação sobre o seu conteúdo. Nesse caso é preferível que apareça um título com maior significado.

Exemplo: [http://www.esa.int/export/esaCP/index.html site da Agência Espacial Europeia] é mais legível que http://www.esa.int/export/esaCP/index.html

Resultado: site da Agência Espacial Europeia é mais legível que http://www.esa.int/export/esaCP/index.html

E, caso se pretenda que apareça o URL, deve-se apresentá-lo o mais simples possível, de forma a ligar à página pretendida. Nomeadamente remova o index.html<code> no exemplo acima.

A "versão imprimível" da página apresenta todos os URL por completo, incluindo aqueles a que foi acresentado um título, por isso nenhuma informação se perde.

=={{Ligações externas}}==
* [http://www.elpais.es ''El País'']
* [http://www.ocultura.org.br Ocultura]

• Para garantir a consistência dos artigos, se num artigo for usada uma dada norma ortográfica, essa deve ser mantida em todo o artigo. Isso quer dizer que se num artigo se escrever "<code>projeto" deve ser essa a forma usada para todo o artigo.
• Sempre que palavras no título de um artigo possam ser escritas de duas ou mais variantes da norma do Português, devem ser criadas as remissões correspondentes.
• Cada artigo deve ter ortografia homogênea e não uma mistura fortuita de diferentes ortografias (poderia ser chocante para o leitor). Principalmente para palavras e sufixos particulares. Por exemplo, não use indiscriminadamente 'fila" (Brasil) e "bicha" (Portugal) num mesmo artigo, quando com o sentido de seqüência alinhada de pessoas ou objetos.
• Os nomes próprios podem manter sua grafia original.
• Artigos que enfocam um tópico específico de um país lusófono particular devem seguir a norma ortográfica em vigor naquele país.
• Se houver grafia dupla no nome de um artigo, deve haver uma página de remissão para acomodar a outra variante, como com Projecto e Projeto ou, se possível, deve ser escolhido em alternativa um sinônimo.
• Se um artigo é escrito predominantemente em uma variante do Português, procure se adaptar a este tipo em lugar de provocar conflito por mudar para outro. (Isto pode ocorrer inocentemente, portanto, por favor, não faça acusações tão rápido!).
• Se tudo mais falhar, pense em seguir a ortografia do autor do primeiro contributo para o artigo (mas não do esboço). Procure identificar a norma gráfica através duma palavra com grafias dupla no artigo ou no título.
• Se uma palavra ou frase é geralmente vista como correta e outra é geralmente vista como incorreta, prefira a primeira.

Posicionamento e tamanho das imagens

Quanto ao posicionamento e o tamanho das imagens, deve-se seguir o bom senso de estética para deixar o artigo claro e agradável ao leitor. Os critérios para isso ficam a gosto do autor original, apenas mude se o resultado final for relevante e se deixar o artigo evidentemente melhor (não mude para algo equivalente). Algumas recomendações:

1. Quando possível, isto é, quando o objeto da imagem tem um sentido claro, deixe os objetos voltados para dentro do artigo; por exemplo: se a foto é de alguém olhando para um lado, evite colocar a pessoa olhando para fora. Se a foto é de um carro, evite colocá-lo "saindo" do artigo.
2. Quando há imagens próximas verticalmente, intercale-as, colocando uma de um lado e outra de outro; isso dá um equilíbrio estético e evita parecer que o artigo está "pendendo" para um lado.
3. Quando as recomendações acima não forem aplicáveis, prefira utilizar o "thumb" padrão, isto é, sem especificar o lado, assim a configuração padrão de cada usuário se encarregará de colocar a imagem no lugar de preferência (geralmente à direita). Por exemplo: [[Imagem:Bota.jpg|thumb|Uma bota.]] a imagem ficará alinhada automaticamente à direita.
4. Evite amontoar muitas imagens, quando o número de imagens estiver afogando o texto.
5. Não exagere nos tamanhos (nem tão grande, nem tão pequeno), prefira utilizar o tamanho padrão do modo thumb, isto é, omitir o tamanho. Use um tamanho menor quando a imagem estiver chamando mais atenção do que deveria e um tamanho maior para alguns casos em que a leitura do texto direta é relevante, por exemplo, em casos de mapas ou diagramas diretamente relacionados ao texto.

Notas gerais

Quando tudo mais falha

Se você se depara com um ponto delicado, por favor use outros recursos, como o Manual de Redação da Folha de São Paulo. Onde esta página difere das outras fontes, deve-se preferir o uso desta página, mas por favor sinta-se à vontade para acrescentar a esta página ou para manter uma discussão em Wikipedia Discussão:Livro de estilo.

Mais simples ainda é simplesmente olhar para um artigo de que você gosta e abri-lo para editar, para ver como os autores e editores fizeram. Você pode então fechar a janela sem salvar as alterações se quiser, mas observe enquanto estiver lá. Quase todos os artigos podem ser melhorados. Quem sabe você pode acrescentar símbolos para adaptá-lo melhor a este estilo.

Não exagere

Torna-se mais fácil retomar o desenvolvimento de um artigo por si ou por quem lhe suceder se não optar por exagerar nas marcações (ligações — internas ou externas, formatação, etc). Mesmo com as sugestões apresentadas, o editor deve ter em conta que qualquer marcação irá resultar numa determinada aparência quando for visualizada.

É mais fácil visualizar o Ocultura, editar ou adicionar artigos, se não se complicar a marcação, mais do que o estritamente necessário para disponibilizar a informação de uma forma compreensiva e útil. O principal objectivo é conseguir uma enciclopédia de utilidade, embora a facilidade de edição e manutenção dessa enciclopédia sejam os sucessores imediatos.

Entre outras coisas, isto significa que o editor não deve usar a marcação excessivamente, e fazê-lo conscientemente.

Questões de formatação

Questões de formatação tais como tamanho da fonte, espaço em branco e cor são questões para todo o site e não devem ser lidadas em artigos exceto em casos especiais. Se por exemplo você sentir que a fonte do título é grande demais ou que deve haver espaço embaixo dos títulos, essas são questões para a folha de estilos, e não a composição do artigo.

Referências

• Wikipédia - Retirado no dia 10 de fevereiro de 2007 (editado)