Help:Editing (Português)
ArchWiki funciona com MediaWiki, um pacote software livre de wiki escrito em PHP, originalmente desenhado para usar no Wikipédia. Ajuda mais profunda pode ser localizada em Help:Conteúdo no MediaWiki e Ajuda:Página principal no Wikipédia.
Esse é um pequeno tutoria sobre edição do ArchWiki. Antes de editar ou criar páginas, usuários são encorajados a se familiarizar com o tom geral, layout e estilo dos artigos existentes. Um esforço deve ser feito para manter um nível de consistência por todo o wiki. Veja ArchWiki:Contribuindo, Help:Estilo e Help:Leitura para uma visão geral das convenções comuns. Para experimentar com edição, por favor use o sandbox. Para uma visão geral de marcação wiki, veja Help:Folha de dicas.
Contents
Criando uma conta
Você deve criar uma conta antes de ser capaz de editar os artigos do ArchWiki; responder a pergunta de captcha exige um ambiente Arch Linux atualizado: usuários que não sejam do Arch são bem-vindos para contribuir para o wiki e para responder a pergunta eles podem, por exemplo, inicializar em um sistema Arch live com a imagem de instalação mais recente.
Uma vez que você tenha uma conta, autentique em Special:UserLogin.
Editando
Para começar a editar uma página, clique na aba editar no topo da página. Alternativamente, usuários podem editar uma seção específica de um artigo clicando no link editar à direita do título da seção. O página Editando será exibida, que consiste nos seguintes elementos:
- Barra de ferramentas de edição (opcional)
- Caixa de edição
- Caixa de resumo da edição
- Links Salvar alterações, Mostrar previsão, Mostrar alterações e Cancelar
A caixa de edição conterá o wikitext (o código-fonte editável a partir do qual o servidor produz a página web) para a revisão atual da página ou seção. Para realizar uma edição:
- Modifique o wikitext conforme necessário (veja #Formatando abaixo para detalhes).
- Explique, em inglês, a edição na caixa de Resumo (ex.: "fixed typo" ou "added info on xyz"). Nota: Todas as edições devem estar acompanhadas por um resumo descritivo para facilitar revisão por outros usuários. Veja ArchWiki:Contributing (Português)#As 3 regras fundamentais para mais informações.
- Use o botão Mostrar previsão para facilitar revisão e verificar a formatação antes de salvar.
- Marque a edição como menor marcando a caixa Essa é uma edição menor se a edição for superficial e indiscutível.
- Salve as alterações clicando Salvar alterações. Se não estiver satisfeito, clique Cancelar em vez disso (ou repita o processo até ficar satisfeito).
Revertendo edições
Se uma página foi editada incorretamente, os procedimentos a seguir descrevem como fazer para reverter um artigo para uma versão anterior. Para reverter uma única edição:
- Clique na aba histórico no topo da página a ser modificada (ao lado da aba editar). Uma lista de revisões é exibida.
- Clique no link desfazer à direita da edição indesejada. Uma previsão da edição é exibida, mostrar a revisão atual na esquerda e o texto a ser salvo à direita.
- Escreva o motivo pelo qual você está desfazendo essa edição no campo de resumo de edição.
- Se estiver satisfeito, clique no botão Salvar alterações embaixo da página.
A página wiki deve agora estar de volta em seu estado original.
Ocasionalmente, é necessário reverter diversas últimas edições de uma só vez. Para reverter um artigo para uma versão anterior:
- Clique na aba histórico no topo da página a ser modificada (ao lado da aba editar). Uma lista de revisões é exibida.
- Veja a revisão desejada (i.e. a última versão boa) clicando na marca de tempo apropriada. Aquela revisão será exibida.
- Clique na aba editar no topo da página. Um aviso é exibido: CUIDADO: Você está editando uma revisão desatualizada desta página.
- Escreva a marca de tempo da revisão (exibida no topo da página) e um motivo pelo qual você está revertendo o estado de uma página no campo de resumo de edição.
- Se estiver satisfeito, simplesmente clique no botão Salvar alterações para reverter para essa versão.
Criando páginas
Antes de criar uma nova página, por favor considere o seguinte:
- Seu tópico é relevante para o Arch Linux? Artigos irrelevantes ou inúteis serão excluídos.
- Seu tópico é de interesse de outros? Considere não apenas o que você deseja escrever sobre, mas também o que outros podem querer ler. Notas pessoais pertencem a sua página de usuário.
- Seu tópico compensa uma nova página? Pesquise no wiki por artigos similares. Se eles existirem, considere melhorar ou adicionar uma seção a um artigo existente.
- Sua contribuição será significante? Evite criar esboços a menos que planeje expandi-los em pouco depois.
Criar uma nova página exige seleção de um título descritivo e uma categoria apropriada.
Por favor, leia Help:Diretrizes para nomenclatura de artigos e Help:Estilo#Título para recomendação de nomenclatura de artigo. Não inclua "Arch Linux" ou variações nos títulos de páginas. Esse é o wiki do Arch Linux; presume-se que os artigos estarão relacionados para o Arch Linux (ex.: "Installing Openbox"; não "Installing Openbox in Arch Linux").
Visite a Tabela de conteúdos para ajudar a escolher uma categoria apropriada. Artigos podem pertencer a múltiplas categorias.
Para adicionar uma nova página a algumas categorias (digamos "My new page" a "Some category") você precisaria:
- Crie uma página com seu novo título navegando para https://wiki.archlinux.org/index.php/Minha_nova_página (lembre-se de substituir "Minha_nova_página" com o título desejado!)
- Adicione
[[Category:Alguma categoria]]
no topo de sua página
Neste estágio, o novo artigo ainda é considerado um órfão. Para completar o trabalho, gaste um tempo extra para vincular ao novo artigo de outros: isso vai melhorar sua visibilidade e encorajar mais usuários a contribuir para ela. Candidatos prováveis são artigos sobre software relacionado, páginas de visão mais genéricas ou até mesmo listas mais simples como Lista de aplicativos.
Formatando
Formatação de texto é acompanhado com marcação wiki sempre que possível; aprender HTML não é necessário. Vários modelos também estão disponíveis para tarefas comuns de formatação; veja Help:Modelo para informações sobre modelos. O Help:Folha de dicas resume a maior das opções de formatação comum.
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. Veja Help:Estilo#Títulos de seção e Help:Uso efetivo de cabeçalhos para informações de estilo.
Títulos devem iniciar do segundo nível e podem ser criados assim:
== Título de segundo nível == === Título de terceiro nível === ==== Título de quarto nível ==== ===== Título de quinto nível ===== ====== Título de sexto nível ======
Se um artigo possuir mais de três títulos será gerado automaticamente uma tabela de conteúdo (TOC). Se isso não for desejado, coloque __NOTOC__ no artigo. Tente criar alguns títulos em Sandbox e veja o que acontece na TOC.
Quebras de linha
Uma linha vazia é usada para iniciar um novo parágrafo enquanto uma quebra de linha tem nenhum efeito em parágrafos regulares.
A tag HTML <br>
pode ser usada para inserir manualmente quebras de linha, mas devem ser evitadas. Uma quebra manual deve estar justificada com outros elementos de formatação, tais como listas.
wikitext | renderização |
---|---|
Essa sentença está quebrada em três linhas. |
Essa sentença está quebrada em três linhas. |
Esse é o parágrafo número um. Esse é o parágrafo número dois. |
Esse é o parágrafo número um. Esse é o parágrafo número dois. |
* Esse ponto <br> expande múltiplas linhas * Esse ponto termina a lista |
termina a lista |
Veja Help:Estilo/Espaço em branco para informações sobre uso adequado de caracteres de espaço em branco.
Negrito e itálico
Negrito e itálicos são adicionados ao cercar a palavra ou frase com dois, três ou cinco apóstrofes ('
):
wikitext | renderização |
---|---|
|
itálico |
|
negrito |
|
negrito e itálico |
Tachado
Use texto tachado para mostrar que o texto já foi resolvido ou não mais possui relevância.
wikitext | renderização |
---|---|
<s>Texto tachado</s> |
|
Listas
Lembre-se de que a sintaxe wiki não oferece suoprte a itens de lista multilinha; toda caractere de nova linha termina a definição do item de lista. Para iniciar uma nova linha dentro de um item de lista, use a tag <br>
. Para inserir um bloco de código multilinha dentro de um item de lista, use Template:bc e escape o conteúdo usando tags <nowiki>
. Veja também Help:Estilo/Espaço em branco e Help:Modelo.
Lista de marcadores
Marcadores não possuem uma ordem aparente de itens.
Para inserir um marcador, use um asterisco (*
). Múltiplos *
s vão aumentar o nível de recuo.
wikitext | renderização |
---|---|
* Primeiro Item * Segundo Item ** Uma sublista no segundo item * Isso não é divertido? |
|
Listas numeradas
Listas numeradas introduzem numeração e, portanto, ordenam os itens de lista. Em geral, você deve usar listas não ordenadas desde que a ordem na qual os itens aparecem não é a preocupação principal.
Para criar listas numeradas, use o símbolo de cerquilha (#
). Múltiplos #
s vão aumentar o nível de recuo.
wikitext | renderização |
---|---|
# Primeiro Item # Segundo Item ## Subitem # Terceiro Item |
|
# Primeiro Item # Segundo Item ## Subitem # Terceiro Item |
|
Listas de definição
Listas de definição são definidas iniciando com um ponto e vírgula (;
) e por dois pontos (:
) após o termo.
wikitext | renderização |
---|---|
Listas de definição: ; Teclado: Dispositivo com botões ou teclas ; Mouse: Dispositivo de apontamento para entrada bidimensional ou ; Teclado : Dispositivo com botões ou teclas ; Mouse : Dispositivo de apontamento para entrada bidimensional |
Listas de definição:
ou
|
Use dois pontos adicionais se uma definição possuir múltiplas definições: ; Termo : Primeira definição : Segunda definição |
Use dois pontos adicionais se uma definição possuir múltiplas definições:
|
Listas de definição não devem ser simplesmente usadas para formatação, veja exemplos do W3.
Recuo
Para recuar um texto, coloque dois pontos (:
) no começo da linha. Quanto mais dois pontos se coloca maior será a distância da margem. Uma nova linha marca o fim do parágrafo recuado.
wikitext | renderização |
---|---|
Aqui está alinhado totalmente à esquerda
:Aqui está levemente identado ::Aqui está um pouco mais |
Aqui está alinhado totalmente à esquerda
|
Código
Para adicionar códigos ao wiki, use um dos modelos de formatação de código. Alternativamente, simplesmente inicie cada linha com um único caractere de espaço em branco. Por exemplo:
$ echo Olá Mundo
Veja também Help:Estilo#Formatação de código.
Tabelas
Usado com efetividade, tabelas podem ajudar a organizar e resumir conjuntos de dados. Para sintaxe e formatação avançada de tabelas, veja Ajuda:Guia de edição/Usar tabelas.
wikitext | renderização | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{| class="wikitable" |+ Dados tabulares ! Distro !! Cor |- | Arch || Azul |- | Gentoo || Roxo |- | Ubuntu || Laranja |} |
|
||||||||||||||||||
{| class="wikitable" ! Sistema de arquivos !! Tamanho !! Usado !! Disponível !! %Uso !! Montado em |- | rootfs || 922G || 463G || 413G || 53% || / |- | /dev || 1.9G || 0 || 1.9G || 0% || /dev |} |
|
Links
Os links são essenciais para ajudar os leitores a navegar pelo site. Em geral, editores devem se assegurar de que todos os artigos contenham links de saída para outros artigos (evite páginas sem saída e estejam referenciados por links de entrada de outros artigos (a página especial what links here pode ser usado para exibir páginas afluentes, ou seja, links para a página consultada). Veja também Help:Estilo/Formatação e pontuação#Primeiras instâncias.
Links internos
É possível fazer inúmeras referências recíprocas entre as páginas deste wiki. Para fazer um link para uma outra parte da página de um mesmo wiki, coloque o título envolto por dois colchetes.
Por exemplo, se você deseja fazer um link para, digamos, o artigo pacman (Português), use:
[[pacman (Português)]]
Se você quiser usar palavras diferentes do título do artigo como o texto do link, você pode usar um rótulo após o símbolo pipe ("|") para fornecer um texto alternativo.
Por exemplo:
O [[ArchWiki:Sobre|ArchWiki]] é a fonte de documentação principal do Arch Linux.
...é renderizada assim:
- O ArchWiki é a fonte de documentação principal do Arch Linux.
Shift+\
no layout de teclado americano e similares, inclusive no layout brasileiro.Quando você deseja usar o plural de um título de artigo (ou adicionar qualquer outro sufixo) para seu link, você pode adicionar as letras extras diretamente fora dos colchetes.
Por exemplo:
makepkg é usado em conjunto com os [[PKGBUILD (Português)|PKGBUILD]]s.
...é renderizado assim:
- makepkg é usado em conjunto com os PKGBUILDs.
Links para seções de um documento
Para criar um link para uma seção de um documento, basta adicionar um #
seguido pelo título da seção.
Por exemplo:
[[Help:Edição#Links para seções de um documento]]
...é renderizado assim:
[[#Links para seções de um documento]]
).Truque do pipe
Em alguns casos, é possível usar o truque de pipe para salvar escrevendo o rótulo dos links de wiki. Os casos mais importantes usáveis no ArchWiki são:
- Em títulos de artigo, ele permite ocultar o sufixo do idioma. Por exemplo,
[[Main page (Português)|]]
vira Main page. - Em links para espaços de nome diferentes ou wiki, o truque de pipe oculta o prefixo. Por exemplo,
[[ArchWiki:Sobre|]]
vira Sobre e[[wikipedia:Help:Pipe trick|]]
vira Help:Pipe trick.
Quando a página é salva, o truque de pipe criará automaticamente o rótulo para o link e alterará o wikitext conforme adequado.
Links interlíngua
Veja Help:i18n (Português)#Links interlíngua
Links interwiki
Os tão conhecidos links interwiki podem ser usados para facilmente fazer um link para artigos em outros Wikis externos, como, por exemplo, o Wikipédia. A sintaxe para esse tipo de link é o nome do wiki seguido por dois pontos e o artigo ao qual você deseja vincular envolto por duas duplas de colchetes.
Se você deseja criar um link para o artigo Wikipedia:Arch Linux, você pode usar o seguinte:
[[Wikipedia:Arch Linux]]
Ou você pode criar um link seguido por pipe com um rótulo de link para artigo do Wikipédia sobre o Arch Linux:
[[Wikipedia:Arch Linux|artigo do Wikipédia sobre o Arch Linux]]
Veja: Wikipedia:Interwiki links
A lista de todos os links interwiki disponíveis no ArchWiki pode ser vista em Special:Interwiki ou a API.
pt
:
[[Wikipedia:pt:Arch Linux]]
resulta em Wikipedia:pt:Arch Linux.
Note que isso depende da configuração interwiki para o wiki alvo, então isso pode não funcionar para todo wiki. Porém, funciona para o Wikipédia.Links externos
Se você deseja vincular a um site externo, apenas digite a URL completa para a página a qual você deseja.
https://www.google.com/
Geralmente é mais útil fornecer ao link um rótulo alternativo em vez de exibir a URL. Diferentemente de #Links internos, links externos com um rótulo uma única dupla de colchetes e a URL alvo são separadas por um espaço (e não um pipe). Por exemplo, para o link aparecer como Mecanismo de pesquisa do Google, basta digitar:
[https://www.google.com/ Mecanismo de pesquisa do Google]
Também é possível gerar um rótulo autonumerado simplesmente envolvendo a URL com uma única dupla de colchetes. Geralmente, é preferível usar frases como "veja aqui". Para produzir uma frase "veja [1]", no qual o número vai variar dependendo da ordem do link na página, basta digitar:
veja [https://www.google.com/]
Redirecionamentos
Para redirecionar automaticamente de uma página para outra, adicione #redirect
e um link interno (para a página, a qual deve ser redirecionada) no começo de uma página.
Por exemplo, pode poderia redirecionar "Pinguins" para "Pinguim":
#redirect [[Pinguim]]
Dessa forma, qualquer pessoa digitando qualquer uma das opções na caixa de pesquisa vai automaticamente acessar "Pinguim".
Redirecionamentos também permitem manter rastro do motivo pelo qual links são feitos (ex.: agrupá-los em páginas WhatLinksHere) e permitem rápida atualização de fragmentos de links em caso de renomeio de seções. Como uma desvantagem, redirecionamentos não mostram no navegador o link da página alvo.
Antes de criar um redirecionamento, você pode realizar uma pesquisa para verificar existentes compatíveis. Por exemplo, Xorg.
Veja também Help:Estilo#Páginas de redirecionamento e Help:Procedimentos#Lidar com páginas de discussão após redirecionar uma página para outra.
- Redirecionamentos não devem apontar para outros sites.
- Redirecionamentos não funcionam para páginas de categoria.
- Redirecionamentos são resolvidas internamento pelo servidor e não deixará mais lento para abrir um artigo.
- Redirecionar uma página existente para outra pode criar redirecionamentos duplos: veja Help:Procedimentos#Corrigir redirecionamentos duplos para corrigi-los.
Variáveis, palavras mágicas e modelos do Wiki
MediaWiki reconhece certas strings especiais dentro de um artigo que alteram comportamentos padrões. Por exemplo, adicionar a palavra __NOTOC__
em qualquer lugar em um artigo vai evitar a criação de uma tabela de conteúdos. De forma similar, a palavra __TOC__
pode ser usada para alterar a posição padrão da tabela de conteúdos. Veja Help:Magic words para detalhes.
Modelos e variáveis são porções predefinidas de wikitext que pode ser inserido para auxiliar na formatação de conteúdo.
Variáveis são definidas pelo sistema e podem ser usadas para exibir informações sobre a página atual, wiki ou data. Por exemplo, use {{SITENAME}}
para exibir o nome do site do wiki (aqui é exibido como "ArchWiki"). Para definir um cabeçalho de título alternativo para a página atual, outra variável wiki pode ser usada: {{DISPLAYTITLE:Novo título}}
. (Mas é muito restrita: você só pode alterar a primeira letra para minúsculo e substituir espaços com sublinhados — string de título normalizado deve corresponder ao nome real da página, do contrário não vai funcionar; use o modelo {{Lowercase title}}
para exibir a primeira letra de título em minúsculo).
Modelos (Templates), por outro lado, são definidos por usuário. O conteúdo de qualquer página pode ser incluída em outra página ao adicionar {{Espaço de Nome:Nome Página}}
para um artigo, mas isso raramente é usado com páginas foram do espaço de nome Template. (Se o espaço de nome é omitido, Template é presumido.) Por exemplo, Template:Note, que pode ser incluído em um artigo com o seguinte wikitext:
{{Note|Isso é uma nota.}}
...é renderizado como:
Para páginas em português, prefira usar modelos em português. Por exemplo, em vez de Template:Tip, use Template:Dica:
Veja Help:Modelo para mais informações.