Arch Linux
 

Aprenda a criar e editar páginas

De Wiki do Arch Linux Brasil


Este é um pequeno tutorial que ensina editar wikis.
Para treinar o que se aprende neste tutorial por favor use a Caixa de Areia

Tabela de conteúdo

Registrando-se e Logando-se

As páginas do Wiki Arch Linux Brasil podem ser lidas sem necessariamente 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 "Entrar" que se localiza na barra esquerda (abaixo do nome Download, na barra superior a direita). É necessária somente uma conta para editar todos os documentos do Wiki Arch Linux Brasil.

Editando

Como todos os wikis, pode-se editar qualquer página não-protegida. Para editar clique em " editar " no menu lateral ou no link editar ao lado de cada título da página (caso faça isso somente este cápitulo será editado).

É importante dizer o que está se adicionando ou alterando no campo "Sumário" que fica entre a janela de edição e os botões "Salvar página" e "Mostrar Pré-Visualização".

Ex.: "Adicionei a informação XYZ".

Isso é importante para a organização do histórico de edições.

Use o botão "Mostrar Pré-Visualização" 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 estará embaixo da pré-visualização se você fizer uma nova alteração e quiser visualizá-la terá que clicar no botão "Mostrar Pré-Visualização" novamente. Lembre de salvar antes de sair da pré-visualização.

Adicionando uma Nova Página

Para adicionar uma nova página em 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-br.org/Minha nova página" (pode utilizar espaços e caracteres especiais no campo Title)
  2. Adicione na primeira linha da página: [[Categoria:Alguma Categoria]]. Lembre-se de usar seguir o Modelo de Documentação para que o wiki se mantenha organizado e funcional.

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ítulos é 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 Caixa de Areia 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

Adicionando o conteúdo de um arquivo

Para adicionar uma informação que merece mais atenção (notas e observações, por exemplo), basta fazer o seguinte: 

{{Box Arquivo| nome do arquivo|
<pre>
conteúdo do arquivo
</pre>
}}

Um exemplo de como ficaria o código acima:

Arquivo: pacman.conf 
[options]
# The following paths are commented out with their default values listed.
# If you wish to use different paths, uncomment and update the paths.
#RootDir     = /
#DBPath      = /var/lib/pacman/
#CacheDir    = /var/cache/pacman/pkg/
#LogFile     = /var/log/pacman.log
HoldPkg     = pacman glibc
#ILoveCandy
TotalDownload
ShowSiz

Adicionando uma nota, observação ou informação importante

Para adicionar uma informação que merece mais atenção (notas e observações, por exemplo), basta fazer o seguinte: 

{{Box Nota | Texto ao qual você deseja dar destaque. Geralmente é uma nota ou observação }}

Um exemplo de como ficaria o código acima:

Nota: Texto ao qual você deseja dar destaque. Geralmente é uma nota ou observação

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 do Wiki Arch Linux Brasil mas que apareça como "página principal": 

Vá para [[Wiki Arch Linux 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 Externos

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

http://www.archlinux-br.org/

Aparecerá::

http://www.archlinux-br.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-br.org/ Arch Linux Brasil]

Aparecerá:

Arch Linux Brasil

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]]

Variáveis e Modelos Wiki

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

{{SITENAME}}

Mostrará:

Wiki do Arch Linux Brasil

Predefinições

Quando se precisa adicionar uma mesmo conteúdo em várias páginas criar predefiniçoes é uma boa alternativa.

Para criar uma predefinição:

  • 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 Predefinição: seguido do nome após a barra depois do index.php?title=. Depois de editar a página da predefinição e adicionar o conteúdo desejado é só salvar e adicionar o comando{{Nome dado}} na página desejada.

Página de Discussão

As páginas de discussão servem para a comunicação com outros usuário do wiki. Para discutir qualquer página primeiramente vá até ela e na clique na aba "Discussão" 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 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.

Para entrar em sua pagina de discussão, clique em "Minha Discussão" no menu superior (você deve estar logado para fazer isso.

Obtido em "http://wiki.archlinux-br.org/Aprenda_a_criar_e_editar_p%C3%A1ginas"
Ferramentas pessoais
TOOLBOX
LANGUAGES