Como criar artigos na Wiki

De Wiki.bireme.org/pt
Ir para: navegação, pesquisa

Criar e editar textos no Wiki é uma atividade simples e não requer perfeição na forma e apresentação, mas a clareza na informação e grafia correta são imprescindíveis. Além disso, a identidade visual na construção do texto, seguindo uma uniformidade, facilita a consulta e manutenção das páginas.


Sendo assim, o objetivo deste guia é servir de referência para a padronização na produção de textos no Wiki BIREME. As regras propostas não são obrigatórias. Há diversos bons métodos de formatação. Inclusive a construção deste guia está aberta a todos para sugerir melhorias e ajustes, conforme a necessidade e desenvolvimento de criação.


Título dos artigos

A escolha do título para um artigo é o primeiro passo na criação de um novo conteúdo.

Dicas

  • O título deve descrever o assunto de forma objetiva e sem ambiguidade;
  • Siga regras gramaticais. Não há restrições quanto acentuação ou uso de espaço;
  • Evite o uso de letras maiúsculas, priorize usá-las se for extremamente necessário;
  • Evite pontuar o título com ponto de exclamação (!) ou interrogação (?) isso dificulta a pesquisa;
  • Evite duplicidade de títulos. Pesquise antes de criar o titulo.

Aspectos importantes na construção do título

a) Título longo cansa quem está procurando algo objetivo. Se o artigo é sobre a solução de um erro, procure colocar o código deste erro no título e os pontos principais da mensagem.

b) Se o nome for mal formulado, poderá ser mais difícil encontrá-lo e maior a probabilidade de serem criados artigos diferentes sobre o mesmo assunto.

c) A Wiki não é somente uma base de FAQ (Frequently Asked Question). Logo, os títulos dos artigos não precisam necessariamente ser uma pergunta.

d) Seguir convenções coerentes de nomenclatura dos artigo é essencial para que as links internos sejam simples e eficientes.

Exemplos de títulos bem sucedidos

http://wiki.bireme.org/pt/index.php/Pacote_de_troca_de_dados

http://wiki.bireme.org/pt/index.php/Perguntas_mais_frequentes

Parágrafo introdutório

Todos os artigos demandam um parágrafo com uma breve apresentação do assunto a ser tratado, introduzindo o leitor no tema que será apresentado.

Índice e títulos das seções do artigo

Para dividir um artigo em seções, coloque o título da seção entre sinais de igual, como em:

=Esta é a primeira seção=

Para fazer uma subseção de segundo nível:

==Texto==

Para fazer uma subseção de terceiro nível:

===Texto===

E assim por diante. A cada nível adicionado, acrescenta-se um sinal de igual (=) antes e depois do título escolhido. Então o nível de sessão mais alto está associado a um (01) sinal de igual ladeando o título da sessão, a seguir temos o nível dois com dois sinais de igual, depois três e assim por diante até o nível seis (06) de profundidade, que é o nível mais profundo que surte efeito na Tabela de Conteúdos (TOC), depois disso os sinais excedentes passam a ser exibidos junto ao texto.

Com os títulos formatados desta forma, o índice do artigo/sumário/tabela de conteúdos é 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). Além disso cada sessão permite ser editada separadamente, facilitando a manutenção da página Wiki.

Dicas de formatação de seções

  • Usar maiúsculas apenas na primeira letra da primeira palavra ou em nomes próprios;
  • Evitar fazer links dentro dos títulos das seções;
  • Evitar criar muitos subtítulos, pois faz o artigo parecer desordenado. Parágrafos curtos e frases soltas geralmente não garantem o seu próprio subtítulo;
  • 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.

Links internos

O uso dos links internos são bem-vindos porque eles ajudam na compreensão ou aprofundam o artigo que está sendo produzido.

Ao escrever sobre um determinado assunto para o Wiki da BIREME os Nomes, Palavras, ou Frases considerados 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 Nome, Palavra ou Frase.

Desta forma, será feito um link interno entre esse nome, palavra ou frase no artigo que está sendo editado e um outro artigo com este título.


Exemplo: Um grupo de colaboradores da BIREME está discutindo a proposta de política para [[Wikis Institucionais]].

Resultado: Um grupo de colaboradores da BIREME está discutindo a proposta de política para Wikis Institucionais.

Dicas

  • Os links internos que seguem esta sugestã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;
  • Se o artigo para o qual você quer criar um link 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. Neste caso vale a pela corrigir o link;
  • Nunca use frases como "clique aqui" para o texto de um link interno — isto não fornece informação alguma.
    • Correto: Consulte os países que fazem parte da Rede BVS no Mapa.
    • Errado: As instâncias BVS estão representadas no mapa, clique aqui para ver o mapa.
  • É possível também indicar um texto alternativo que será apresentado no artigo, mantendo o link o mesmo destino. Isso se faz escrevendo o texto alternativo após o título do link interno, separado por uma barra vertical (|);
  • Criar link interno (usando a sintaxe: [[nome do artigo]] ), verifique se o nome que usou para o link corresponde ao artigo pretendido;
  • Todo link interno demanda acesso a um artigo.


Seção Links externos

O Wiki não é uma coleção de referências para páginas externas. No entanto, os artigos devem ser complementados, sempre que possível, com links para outras páginas da Internet.

Use sempre: [ ] para indicar um link externo.


Um link para uma página externa pode ser composta de duas formas:

1) Simplesmente escrevendo a URL:


2) Utilizando um texto mais adequado para substituir a URL. Escreve-se a URL e o texto que se deseja apresentar, acrescenta-se um espaço entre a URL e o texto que será utilizado, tudo isso entre colchetes.


Dicas

  • A URL deve começar com http:// ou outro protocolo, como ftp:// sempre entre [ ] .
  • 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.
  • Caso pretenda-se que apareça a URL, deve-se apresentá-la o mais simples possível, de forma a ligar à página pretendida. Para isso, remova o index.html no exemplo acima.

Observações

  • Impressão

A versão para impressão da página apresenta todas as URLs por completo, incluindo aquelas às quais foram acrescentados títulos, por isso nenhuma informação se perde.

  • URLs como notas de pé de página

Sem o texto opcional, uma referência externa aparece como uma nota de pé de página.

  • Exemplo Página Inicial da Wiki BIREME [http://wiki.bireme.org/pt/index.php/Página_principal]
  • Resultado Página Inicial da Wiki BIREME [1]
Na Wiki BIREME não recomendamos a utilização desse formato

Localização dentro do artigo

Este formato pode ser usado para incluir uma referência URL inline dentro do texto quando necessário e deve estar sempre no final do arquivo, depois da seção "Veja também". E mesmo que você tenha apenas um link para indicar, ainda assim use a chamada da seção no plural: "Links externos".

  • Exemplo: Como digitar para ficar como uma seção no final do artigo


==Links externos==
* [http://www.paho.org/bireme ''Site da BIREME'']
* [http://www.bvsalud.org Portal regional da BVS]


  • O resultado será:


Links externos



  • Exemplo de como digitar dentro do artigo:
Tire suas dúvidas em nossa área de [http://regional.bvsalud.org/php/contact.php?lang=pt contato]
  • Resultado:
Tire suas dúvidas em nossa área de  [http://regional.bvsalud.org/php/contact.php?lang=pt contato]


No entanto, na maior parte dos casos é preferível agrupar todos os links externos no fim do artigo sob o título ==Links externos==

Tipos de arquivos

Se o link não for para um arquivo HTML, mas para, 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.

Exemplo

  • Matriz da BVS Saúde Pública em pdf

Tamanho dos arquivos

Para links com arquivos grandes (por exemplo, um HTML com imagens embutidas), é útil assinalá-lo com uma nota, permitindo desse modo a quem tenha uma conexão lenta a opção de usar ou não.

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.

Primeiramente é necessário subir a imagem em "Carregar arquivo", copiar a sua extensão e incluir o link conforme o exemplo abaixo.

Exemplo

 [[Arquivo:Nome da imagem.jpg]]

Dicas

  • 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;
  • 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;
  • 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;
  • Evite amontoar muitas imagens;
  • Não exagere no tamanho da imagem, prefira utilizar o tamanho padrão do modo thumb, isto é, omitir o tamanho. Em casos de mapas ou diagramas relacionados ao texto é recomendado o uso do thumb;
  • Por regra, as fotografias e os gráficos devem ter legendas. No entanto, a legenda pode ser omitida se a própria imagem tiver uma legenda ou se for uma óbvia representação do tema do artigo.


Categorias

O uso de Categorias ao final de cada artigo criado é de suma importância para a "indexação" automática dos artigos e criação de um sumário também automático.

  • Exemplo: [[Category:BVS-Site]]

SubCategorias

Para que não se crie muitas categorias, pode-se utilizar também as subcategorias.

Exemplo: Categoria Manual a Subcategoria pode ser Manual de gestão da... Para se criar uma subcategoria, precisa primeiro adicioná-la como categoria ao final do texto, após editá-la e acrescentar a Categoria principal, conforme exemplo:

Categoria.JPG

se clicarmos na Categoria Manual vamos ver a subcategoria que seria Manual de Gestão da Lilacs


Referências

Referência bibliográfica é um conjunto de elementos de uma obra escrita (como título, autor, editora, local de publicação e outras) que permite a sua identificação.

A tag utilizada é a <ref> </ref> entre o texto que vai indicar como referência. E para que esse mesmo texto apareça no rodapé deve se utilizar a tag <references/> também, como exemplo abaixo:


<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>
The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 
46 (April 1978): 44-6.</ref>


<ref>Segundo os cientistas o Sol é muito grande.E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>

According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>
The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>

==Notes==
<references/>


According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref> The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>

Notes

<references />

Seção Veja também

Nos artigos Wiki da BIREME

Para todos os artigos da Wiki, sugere-se listar no final do artigo numa seção intitulada "Veja também" as referências a outros artigos relacionados ao assunto.

Esta seção deve aparecer antes da seção "Links externos", no fim do artigo. Não devem ser incluídas na seção "Veja também" links que já tenham sido incluídos no texto do artigo nem referências externas.


Exemplo de como editar o Veja também

==Veja também==
* [[Políticas da Wiki BIREME| Artigo De Políticas de uso de Wiki na BIREME]]


O resultado:

Veja também



Boas práticas

Ortografia

Escreva as palavras corretamente, não utilize expressões idiomáticas ou gírias. Se tiver dúvidas, consulte um dicionário.
Obs.: O dicionário Houaiss está disponível na BIREME, caso você não tenha acesso a ele solicite ao ITI sua instalação.

Termos em outras línguas

Dê preferência para termos no idioma da página que está sendo criada. Para palavras em outras línguas, utilize a formatação itálica. Assim:

"Sempre faça backup."

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 (links — internos ou externos, 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.

  • Padronize. Não personalize.
  • Lembre-se que todos devem achar fácil participar.

Não se ofenda

O Wiki é uma espaço de produção de texto de forma colaborativa, respeite as alterações caso elas estejam corretas. Se a informação está correta e só foi melhor formatada, não seja melindroso. A Wiki não é só sua. Ela é de todos. E quem ganha com isso somos todos nós.

Veja também

Fonte

LocaWeb