Ajuda:Livro de estilo

De Enciclopedia do Teatro

Este livro de estilo deve ser utilizado como referência para uniformizar os artigos da Teatropédia - Enciclopédia Virtual das Artes do Palco. As regras propostas não são obrigatórias. Há várias boas formas de se fazer algo, mas nossas sugestões visam facilitar a pesquisa/consulta e a constante ampliação da Teatropédia. Assim, 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 do que a apresentação e a forma. Não se exige que os autores sigam todas estas regras: a graça da edição wiki é que não se requer perfeição. Editores visitarão este manual quando estiverem formatando os artigos. Gradualmente serão feitas páginas que se ajustem a este guia ou este guia será mudado para o mesmo efeito.

Como este documento considerado é uma recomendação da Teatropédia, antes de fazer mudanças significantes ou substantivas ao documento, por favor apresente-as primeiro na página de discussão.

Tabela de conteúdo 1 Título dos artigos 1.1 Sobre a utilização de caixa alta nos títulos de obras 2 Parágrafo introdutório 3 Ligações internas 4 Títulos das seções do artigo 5 Seção Ver também 6 Seção Ligações externas 6.1 URLs como notas de rodapé 6.2 Localização dentro do artigo 6.3 Sites estrangeiros 6.4 Tipos de arquivos

Título dos artigos

A escolha do título para um artigo é o primeiro passo na criação de um novo conteúdo da Teatropédia. Preferencialmente, o título deve descrever o assunto a tratar de forma sintética e sem ambiguidade. 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, "Clóvis Graciano lecionou [[cenografia]]."), tenha em consideração que, caso o artigo ligado não exista ainda, esse nome será usado para criá-lo. Veja a página sobre títulos de artigos para mais detalhes sobre a escolha do nome para um artigo.

Sobre a utilização de caixa alta nos títulos de obras

A Teatropédia adota a norma recomendada pelo Manual de Redação da Pontifícia Universidade Católica do Rio Grande do Sul. Segundo ela, são escritos com inicial em caixa alta todas as palavras do título de uma obra, com excepção dos artigos, das preposições, das conjunções e dos advérbios.

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 Teatro de Arena:

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 uma das formas deve aparecer em negrito, preferencialmente ligadas pelo termo ou:

Exemplo: O Teatro de Arena de São Paulo (ou somente Teatro de Arena) foi um dos mais importantes grupos teatrais brasileiros das décadas de 50 e 60.

Ligações internas

Ao escrever sobre qualquer assunto para a Teatropédia os termos que você considera que devam ser referidos como informação adicional deverão ser colocados entre dois parênteses retos ou colchetes, de forma a ter dois antes e dois depois do termo. Desta forma, será feita uma ligação interna entre esse termo, que pode ser um nome, uma ou mais palavras ou mesmo uma frase, no artigo que está a editar e um outro artigo com esse título.

Exemplo: '''Império''' é uma [[comédia]] [[musical]] criada e dirigida por [[Miguel Falabella]].

Resultado: Império é uma comédia musical criada e dirigida por Miguel Falabella.

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 antiesté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 recomendaçã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: A peça é uma remontagem da obra do [[William Shakespeare|dramaturgo inglês]].

Resultado: A peça é uma remontagem da obra do dramaturgo inglês.

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 dramaturgos.

Errado: Para ver mais dramaturgos, 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 [[diretor]]es compareceram ao festival.

Resultado: Os diretores compareceram ao festival.

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 seçõ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 seção em vez de subtítulos.

Seção Ver também

Esta seção deve aparecer antes da seção "Ligações externas", caso essa seção exista. Devem ser evitadas na seção "Ver também" as ligações já incluídas no texto do artigo.

Exemplo de como digitar:

=={{Ver também}}==
* ''[[As Mãos de Eurídice]]''
* ''[[Macário]]''

O resultado será:

Ver também

---

• As Mãos de Eurídice
• Eu Odeio Hamlet

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: {{Artigo principal|[[Macário]]}}

Resultado:

Ver artigo principal: Macário

Seção Ligações externas

Ver artigo principal: Ajuda:Ligações externas

A Teatropédia não é uma coleçã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 internet.

Use sempre: == Ligações externas ==

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://www.spescoladeteatro.org.br/enciclopedia

   Resultado: http://www.spescoladeteatro.org.br/enciclopedia

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.spescoladeteatro.org.br/enciclopedia A Enciclopédia do Teatro]

   Resultado: A Enciclopédia do Teatro

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.baraoemfoco.com.br/barao/portal/cultura/teatro/historico.htm Breve histórico do Teatro brasileiro] é mais legível que http://www.baraoemfoco.com.br/barao/portal/cultura/teatro/historico.htm

Resultado: Breve histórico do Teatro brasileiro é mais legível que http://www.baraoemfoco.com.br/barao/portal/cultura/teatro/historico.htm

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. Por exemplo, remova o index.html, quando houver.

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

URLs como notas de rodapé

Sem o texto opcional, uma ligação externa aparece como uma nota de rodapé.

Exemplo: Bem-vindo à Enciclopédia do Teatro [http://www.spescoladeteatro.org.br/enciclopedia]

Resultado: Bem-vindo à Enciclopédia Virtual do Teatro Brasileiro [1]

Localização dentro do artigo

Este formato pode ser usado para incluir uma ligação externa dentro do texto em páginas de discussão ou no fim dos artigos, depois da seção "Ver também", quando esta existir. E mesmo que você tenha apenas um link para indicar, ainda assim use a chamada da seção no plural: "Ligações externas".

Exemplo de como digitar em artigos:

== Ligações externas ==
* [http://www.filologia.org.br/abf/volume3/numero1/04.htm Momentos decisivos do teatro brasileiro]
* [http://terramagazine.terra.com.br/interna/0,,OI3342278-EI11348,00-A+mulher+e+o+teatro+brasileiro+do+seculo+XX.html A mulher e o teatro brasileiro do século XX]

O resultado será:

Ligações externas

---

• Momentos decisivos do teatro brasileiro
• A mulher e o teatro brasileiro do século XX

Exemplo de uso em páginas de discussão: Um bom exemplo de uma comunidade colaborativa na Internet é a [http://www.spescoladeteatro.org.br/enciclopedia Enciclopédia do Teatro].

Resultado: Um bom exemplo de uma comunidade colaborativa na Internet é a Enciclopédia Virtual do Teatro Brasileiro.

Lembre de usar, nos artigos, o formato que agrupa todas as ligações externas no fim, em uma seção própria com o título == Ligações externas ==

Sites estrangeiros

É preferível que as páginas externas referenciadas sejam em língua portuguesa. No entanto, quando achar conveniente incluir ligações para páginas em outras línguas, tenha o cuidado de referir após a ligação qual a linguagem em que a página está escrita.

Exemplo: {{link|en|2=http://www.bris.ac.uk/theatrecollection/|3=Coleção de teatro da Universidade de Bristol}}

O resultado será:

Predefinição:Link

Tipos de arquivos

Se o link não for para um arquivo/ficheiro HTML, mas para um ficheiro (por exemplo um *.pdf ou *.jpg, deve colocar-se essa informação para que o utilizador decida se quer abrir ou fazer o download em primeiro lugar.