Help:Editing (Português)

From ArchWiki
Revision as of 18:26, 17 January 2008 by Diogo.urb (Talk | contribs)

Jump to: navigation, search
Este é um pequeno tutorial que ensina editar wikis como o ArchWiki. Caso precise de mais detalhes acesse Editando
Para treinar o que aprendeu neste tutorial por favor use a CaixadeAreia

Template:I18n links start Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n links end

Registrando-se e Logando-se

As páginas do ArchWiki podem ser lidas sem se criar uma conta ou iniciar uma sessão (logar-se), porém para editar ou publicar algum artigo será necessário uma conta. Para criar uma conta (que é gratuita) clique em "create an account or log in" que fica no canto superior direito de qualquer página. É necessária somente uma conta para todos os documentos wikis daqui do ArchWiki.

Editando

Como todos os wikis, pode-se editar qualquer página não-protegida. Para editar clique na aba " edit " no topo da página.

Explique o que está editando no campo "Summary" que fica entre a janela de edição e os botões save e preview. Ex.: "Adicionei a informação XYXZ". Isso é importante para a organização do histórico de edições.

Use o botão show preview para checar sua edição e a formatação certa antes de salvar. Isso previne o salvamento excessivo de alterações. O campo de edição se encontra logo abaixo do preview se você fizer uma alteração e quiser visualizá-la terá que clicar no botão show preview novamente. Lembre de salvar antes de sair do preview.

Caso esteja logado, poderá marcas a edição como minor marcando a caixa This is a minor edit faça isso para os visitante saber que sua edição não é algo substantivo.

Para tentar editar, abra uma nova janela e vá para CaixadeAreia, uma área de teste, e então clique em "edit" . Adicione alguma coisa e depois clique em salvar a página. Pronto sua alteração foi gravada e imediatamente suas mudanças serão visíveis por todos.

Adicionando uma Nova Página

Para adicionar uma nova página a alguma categoria é necessário: (Exemplo: título da página "Minha Nova Página" e a categoria "Alguma Categoria")

  1. Na barra de endereço do navegador escreva:"http://wiki.archlinux.org/index.php/Minha_Nova_Pagina"
  2. Adicione na primeira linha da página: [[Category:Alguma Categoria]]

Formatando

A maioria da formatação de texto é feita com marcadores wiki, portanto não é necessário aprender HTML.

Negrito e Itálico

Negrito e itálicos são adicionados ao cercar a palavra ou frase desejada com apóstrofes ('):

  • ''Itálicos'' aparece como Itálico. (2 apóstrofes de cada lado).
  • '''Negrito''' aparece como Negrito. (3 apóstrofes de cada lado).
  • '''''Negrito e itálico''''' aparece como Negrito e itálico. (2 + 3 = 5 apóstrofes de cada lado).

Títulos e Subtítulos

Usar os Títulos e subtítulo é uma maneira fácil de melhorar a organização do artigo. Caso perceba que dois ou mais tópicos podem ser discutidos, é melhor dividi-los inserindo um título para cada sessão.

Títulos são criados assim:

=Título= (1 igual "=")
==Subtítulo== (2 iguais "=")
===Outro nível abaixo=== (3 iguais "=")
====Um outro nível abaixo==== (4 iguais "=")
=====E mais um outro nível abaixo===== (5 iguais "=")

Se um artigo possuir mais de três títulos será gerado automaticamente uma tabela com o conteúdo. Caso ache que não seja necessário uma tabela de conteúdos, coloque __NOTOC__ no artigo. Crie agora alguns títulos na CaixadeAreia e veja o que acontece na tabela de conteúdos.

Identação

Para identar (adicionar um parágrafo a) um texto coloque dois pontos (:) no começo da linha. Quanto mais dois pontos se coloca maior será a distância da margem. Ao passar para nova linha (ou seja, quando pressionado Enter) isso marcará o fim do parágrafo.

Por exemplo:

Aqui está alinhado totalmente à esquerda
:Aqui está levemente identado
::Aqui está um pouco mais

E aparecerá como: Aqui está alinhado totalmente à esquerda

Aqui está levemente identado
Aqui está um pouco mais

Listas

Para fazer um lista simplesmente adicione um asterisco (*) no início, como uma identação quanto mais asteriscos maior será a identação.

Um pequeno exemplo:

*Primeiro Item
*Segundo Item
**Uma sublista no segundo item
*Isso não é divertido?

Será visto assim:

  • Primeiro Item
  • Segundo Item
    • Uma sublista no segundo item
  • Isso não é divertido?

Listas Numeradas

Para criar uma lista numerada use o símbolo de jogo-da-velha (#), e novamente quanto mais #'s maior será a identação.

Exemplo:

#Primeiro Item
#Segundo Item
##Primeiro Subitem
##Segundo Subitem
#Terceiro Item

Ficará assim:

  1. Primeiro Item
  2. Segundo Item
    1. Primeiro Subitem
    2. Segundo Subitem
  3. Terceiro Item

Listas Mistas

Pode-se misturar os dois tipos de listas de acordo com o exemplo:

*Misturando as listas
*# Agora um item marcado
*#* Outro item
*#* Mais um item

Visualização do exemplo:

  • Misturando as listas
    1. Agora um item marcado
      • Outro item
      • Mais um item

Códigos

Para diferenciar códigos, linguagens de programação, exemplos de arquivos coloque um espaço no início da linha e ela ficará assim:

if 83 <= eax then

Links

Os links são importante no wiki para ajudar os visitantes a navegar pelo site , tirar suas possíveis dúvidas, e dar dinamismo ao conteúdo.

Links Internos

É possível fazer inúmeras referências recíprocas entre as páginas deste wiki e poderá ser adicionado títulos já existentes como também criar referências a títulos que você pense que deva existir no futuro.

Para fazer um link para uma outra parte da página de um mesmo wiki, coloque o título entre dois colchetes, ou seja, se quiser fazer uma referência a Listas, faça:

saiba mais sobre o [[Wiki]]

Ficará assim: saiba mais sobre o Wiki

Caso queira nomear o link com um nome diferente do título, insira uma barra vertical (|). Por exemplo, um link para a página ArchLinux (Português do Brasil) mas que apareça como "página principal":

Vá para [[ArchLinux (Português do Brasil)|página principal]]...

Aparecerá como: Vá para página principal...

Se quiser usar o plural do título do arquivo você poderá alternativamente adicionar as letras faltantes após os dois colchetes finais.

Por exemplo:

:Caso tenha dúvida sobre os diversos [[Wiki]]s

Será mostrado assim:

Caso tenha dúvida sobre os diversos Wikis

Caso deseje fazer um link para a mesma página wiki que está se editando, siga o exemplo:

Clique e vá para o capítulo [[#Editando|editando]]

Visualização do exemplo: Clique e vá para o capítulo editando

Links de Internacionalização

O ArchWiki permite que você escreva artigos em várias línguas. Como podem haver um mesmo assunto mas em línguas diferentes é de grande ajuda linkar estas páginas entre si. Se um artigo existir em mais de uma linguagem, o ArchWiki tem um "quadro-i18n" no qual poderá ser adicionado o link para o mesmo artigo mas em outra língua.

Para adicionar o quadro i18n, insira no início do artigo:

 {{i18n_links_start}}
 {{i18n_entry|Português do Brasil|Título em Alemão}}
 {{i18n_entry|Deutsch|Título em Alemão}}
 {{i18n_entry|Français|Título em Françes}}
 {{i18n_links_end}}

Caso o título numa língua não inglesa seja o mesmo, siga o seguinte padrão para o novo título:

Título (Língua)

Exemplo:

Gnome
Gnome (Deutsch)
Gnome (Français)

Links Externos

Para adicionar um link para fora do site do ArchWiki simplesmente escreva o nome completo do site:

http://www.archlinux.org/

Aparecerá: http://www.archlinux.org/

É mais freqüente usar outro título do que o próprio site para isso coloque o nome do site completo entre colchetes e separado por um "espaço" o nome alternativo, por exemplo:

[http://www.archlinux.org/ The Arch Linux]

Aparecerá: The Arch Linux

Redirecionamento

Para redirecionar automaticamente de uma página para outra, digite no início da página, #REDIRECT e ponha entre duplo colchetes o título da página para onde deverá ser redirecionado.

Um exemplo: se você quiser ser redirecionado de "Gatos" para "Gato", dessa forma toda vez que alguém procurar por Gatos será redirecionado para gato.

#REDIRECT [[Gato]]

Pedidos

Precisa de algum tutorial, howto para alguma coisa? Quer saber algo? Ponha um pedido na área de Pedidos!

Variáveis e Modelos Wiki

Usando um nome entre duas chaves ({{ }}). Por exemplo:

{{SITENAME}}

Mostrará:

ArchWiki

Perceba que o quadro I18n é um template. Para criar um template:

  • Na barra de endereço do navegador digite:
    "http://wiki.archlinux.org/index.php/Templates:XXX"
Note que da mesma forma que criar uma página, se acrescenta somente Template: seguido do nome após a barra depois do index.php. Depois de editar a página do template e adicionar o conteúdo desejado é só salvar e adicionar o modelo (template) na página desejada na forma explicada no início deste capítulo. Quando se você precisa adicionar uma mesma coisa em várias página essa opção é uma boa alternativa.

Página de Discussão

As páginas de discussçao ou "talk" (termo em inglês) são para a comunicação com outros usuário do ArchWiki. Para discutir qualquer página primeiramente vá até ela e na clique na aba "Discussion" que se encontra no topo da página do lado da aba "edit". Adiciona seu comentário no fim dá página ou uma opinião logo abaixo do comentário ao qual você está respondendo.

Assine seus comentários digitando <tt>~~~~</tt> para inserir seu nome de usuário, horário e data do comentário. Use a identação para formatar sua discussão, o padrão é identar sua resposta em um nível mais profundo do que a pessoa a qual você esta respondendo.

Experimente editando a página de discussão da caixa de areia.

Página de Discussão do Usuário

Todo usuário possui uma página de discussão, onde outras pessoas podem deixar mensagens públicas. Se alguém deixar uma mensagem você receber uma nota dizendo que você possui novas mensagens com um link para sua página de discussão.

Você pode responder a mensagem na página da pessoa que te mandou a mensagem ou em sua própria página abaixo da mensagem original. Se você responder na página da pessoa ela irá receber uma notificação disso.

Para entrar em sua pagina de discussão, clique em Minha Discussão no topo da página ao lado do seu nome de usuário, você deve estar logado para fazer isso.

Categorias Especiais

Existem categorias especiais que auxiliam o trabalho em grupo com o Archwiki.

Artigos Inacabados

No link Category Stub estão todos os artigos marcados com:

{{stub}}

As razões possíveis para isso podem ser:

  • O artigo é pequeno de mais.
  • Não explica o assunto suficientemente
  • Contém partes inacabadas

== Artigos que Faltam Traduzir == No link Category "Translation Requested" estão todos artigos que estão marcados com:

{{translateme}}

Alguns motivos para a página estar marcada:

  • Parte do artigo ainda não existem nessa língua
  • O conteúdo não foi todo traduzido mas simplesmente copiado de outra língua
  • Foi acrescentado conteúdo novo no artigo original e estes ainda não foram traduzidos

Artigos com Possíveis Erros ou Informação Confusa

No link Category "Accuracy Disputes" estão todos os artigos que estão marcados com:
{{accuracy}}
Os motivos podem ser:
  • Usuários observaram um possível erro ou informações confusas que estão sendo discutidas na sessão de discussão dessa página, um solução a esse problema.
  • A página possui conteúdo desatualizado que precisa ser modificado.

Confira mais detalhes no artigo Accuracy_dispute.

Pedidos

Relembrando: Caso queira algum "Howto"? Tem alguma dúvida? Faça seu pedido! É só clicar no link ao lado e salvar seu pedido: Pedidos