Traduções: English - Español - Français - Indonesia - Português (Brasil) - Português (Portugal) - Русский - Українська - 简体中文

(!) Discussion

Guia de edição

Existe um guia rápido para novos(as) editores(as).

(!) Veja também: HelpOnSmileys :-) HelpOnMacros e HelpOnLinking e o curto HelpOnEditing

Para ajuda geral sobre formatação no wiki moinmoin, leia as páginas de ajuda do moinmoin (na barra lateral. A referência de sintaxe é útil. Você pode experimentar no WikiSandBox (área de rascunho).

Se você não concordar com qualquer declaração abaixo, comente-a e então inicie uma nova discussão na página discussões.

Sua conta

Sua página de apresentação no Wiki

Você pode usar o HomepageTemplate quando criar sua página inicial. Aqui estão algumas ideias para o conteúdo, retiradas de várias páginas existentes.

Certifique-se de manter a tag CategoryHomepage na parte inferior de sua página de apresentação (que está presente por padrão no HomepageTemplate).

Entrando em contato com você

Se você está editando este wiki com frequência, você pode incluir suas informações de contato em sua WikiHomePage (página de apresentação) e também pode se juntar à lista de discussão debian-www e ao canal IRC #debian-www (versão web).

Acompanhar as páginas

Perda de senha

Se você perder sua senha do wiki.debian.org, vá para a página recoverpass e siga as instruções (digite seu endereço de e-mail e clique em "Me envie no e-mail meus dados da conta").

Estilo de redação / WikiEtiquette (etiqueta wiki)

Existem ao menos cinco principais estilos de páginas Wiki

Os elementos para um bom estilo de redação para cada tipo são explicados com mais detalhes em suas páginas individuais.

Tente manter um equilíbrio ao escrever. Isto inclui equilíbrio visual, mas também tentar evitar parcialidade. Se achar que seus comentários são controversos, assine-os, de modo que outras pessoas sintam-se mais livres para discordar publicamente.

Veja também esta página Wiki:GoodStyle.

Links

Não faça uso exagerado de links. Se existem muitos, o(a) leitor(a) não saberá quais links são úteis. Você pode mover alguns dos links para uma seção "Veja também" na parte inferior da página (mas, novamente, não muitos).

Quando o link aponta para uma página em outro idioma, adicione "(in $language)", assim:  [[fr/Algumacoisa|Algumacoisa]]  (em francês)

Veja também a página HelpOnLinking do moinmoin.

Links internos (dentro deste wiki)

  1. [[PaginaFoo]] é geralmente a sintaxe preferida.

  2. [[UmaPaginaSuperiorde/PaginaFoo|PaginaFoo]] é frequentemente usado para encurtar subpáginas.

  3. [[EditorGuide|guia de edição]] pode ser usado para ajudar a inserir o nome do link em uma sentença como palavras normais e em minúsculas.

  4. Não "renomeie" o link usando [[NomePagina|Um outro título]] (se fizer isso, implica-se que a página está mal nomeada).

Em todos os casos, certifique-se que o rótulo do link é significativo para visitantes e que o link não leva a algum lugar inesperado (preferencialmente o rótulo do link deve ser o mesmo que o título da página).

Para fazer um link dentro da mesma página, você deve definir a âncora-alvo usando <<Anchor(bar)>> (veja HelpOnMacros) e então usar [[#bar|Capítulo Bar]] ou [[Foo#bar|Capítulo Bar]] (onde Capítulo Bar é o título do parágrafo).

O modo preferido para fazer links para recursos externos é:

(Evite a notação  [[https://www.exemplo.com|rótulo do link]] , pois esconde a URL de destino, a menos que o contexto deixe claro, como em "João forneceu um script com o nome teste.sh.")

Use o formato InterWiki para criar links com os pacotes Debian, bugs, RFCs e artigos da Wikipedia.

Se uma página (importante) está com um link fora do Debian, é uma boa ideia marcá-la com CategoryPermalink, assim ninguém a removerá inadvertidamente.

Formatação

Seções de cabeçalho

Materiais que naturalmente pertencem a uma área (opcional) de "cabeçalho", no topo da página, incluem:

Para facilitar a atualização e a sincronização dos cabeçalhos de tradução de todas as versões de idioma de uma página, a versão em inglês é a única que deve ser modificada e incluída em todas as versões de tradução através da macro Include. Para conseguir isso, o cabeçalho de tradução na versão em inglês deve estar contida por etiquetas (tags) especiais de comentário, que indicarão à macro Include o que deve ser incluído nas páginas traduzidas.

  1. Na página original em inglês

    1. Certifique-se de que o idioma inglês é um link (não somente texto) autorreferenciado para a própria página em inglês, desse modo: [[<PageName>|English]].

    2. Insira o texto a seguir antes da linha com a lista de traduções (lembre-se de substituir <PAGENAME> pelo nome real da página):

      ##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following (with the comment's character at the start of the line removed)
##<<Include(<PAGENAME>, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
##TAG:TRANSLATION-HEADER-START

    3. Insira esse texto a seguir após a linha com a lista de traduções:

      ##TAG:TRANSLATION-HEADER-END
  2. Na sua página traduzida

    1. Insira o texto a seguir em vez da linha de tradução (lembre-se de substituir <PAGENAME> pelo nome real da página):

      <<Include(<PAGE_NAME>, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>

Veja o ModeloPadrão e suas traduções para exemplos de como tudo isso funciona.

Aviso de desambiguação

Às vezes, um nome de página pode ser ambíguo. Se isto não pode ser evitado, você pode inserir algo como isso no topo da página:

Desambiguação : Esta página é sobre as Conferências Debian.
Para o sistema de gerenciamento de configuração do Debian, veja debconf.

Aviso de "material oficial" do Debian

Frequentemente, o conteúdo de uma página wiki do Debian também é coberto por alguma parte da documentação "oficial" do Debian (ou em alguma outra localização "de referência"). Esta página wiki ainda assim pode ser útil para colaboração. É uma boa ideia adicionar um link para a localização de referência no topo da página.

Amostra de apresentação de link para alguma página oficial, relacionada ao assunto em questão.

Seções de sumário

Se uma página fica longa, você pode adicionar um sumário (table of contents). Veja o exemplo no topo desta página!

Seções de FAQ

Uma seção típica de FAQ poderia ser formatada desta forma:

Q. Como eu faço XXXX?
A1) Você pode fazer XXXX executando X.
A2) Você pode fazer XXXX executando Y.

Amostra (note o espaço no começo das linhas): 

 Q. Como eu faço XXXX? :: A1) Você pode fazer XXXX executando X.
 :: A2) Você pode fazer XXXX executando Y.

Seções de rodapé

Materiais que naturalmente pertencem a uma área (opcional) de "rodapé", na parte inferior da página, incluem:

Fragmentos de páginas

Não é somente código que pode ser reutilizado - o conteúdo das páginas também! Se você notar que determinado parágrafo deve se repetir em muitas páginas, você pode reutilizar (macro "include") o fragmento da página que é recorrente (não abuse desta funcionalidade para duplicar conteúdos demasiadamente!).

Uma amostra está disponível em InstallingDebianOn e InstallingDebianOn/PageFragments/Philosophy. Observe também como a página é incluída dentro de uma tabela (mas não use esta gambiarra para contornar as limitações de formatação do moinmoin: veja Formatação complexa).

Formatação avançada/Formatação complexa

Evite usar formatação "avançada" (usando tabelas, macro include, etc.)

Imagens, mídia e anexos

Veja também: a página HelpOnLinking do moinmoin.

Adicione créditos e informações de direitos autorais na parte inferior da página, onde você anexa uma imagem, tipicamente: 

## anexos:
##  openlogo-100.jpg  Copyright 1999 "Software in the Public Interest" from https://www.debian.org/logos/openlogo-100.jpg

Localização do anexo

Geralmente é uma boa ideia anexar a imagem à página hierarquicamente superior (no caso da imagem ser reusada em outras subpáginas).

Para páginas traduzidas, anexe a imagem à versão em inglês (imagens internacionalizadas/localizadas devem ser anexadas às páginas internacionalizadas/localizadas).

Captura de tela

Se quiser incluir uma captura de tela, você pode armazená-la em https://screenshots.debian.net/ e então usar:

Exemplo:

Posição da imagem

https://www.debian.org/logos/openlogo-nd-75.jpg

É possível mudar as imagens para a direita da página, graças ao float:right do CSS: 

||<tablestyle="float:right; width:100px; background:transparent; margin: 0 0 1em 1em;" style="padding:0.5em; border-style:none;"> {{https://www.debian.org/logos/openlogo-nd-75.jpg}} ||

Tags de "Trabalho a ser feito"

Translation(s): English - español - Português (Brasil) - Українська

A tag is a WikiName that has special meaning to the community. It is used to group pages, by searching for the tag and seeing all the pages that have it. Under MoinMoin wiki, one should use Categories.

WikiTags related to ongoing work on the wiki can be found at DebianWiki/Administration#Current_tasks.

Nota: não use a instrução de processamento #deprecated, já que ela impede futuras edições da página (por exemplo, para corrigir links quebrados). Se desejar marcar uma página como precisando ser melhorada/removida, em vez disso use uma WikiTag apropriada.

Essas tags são direcionadas a editores(as) do wiki, não para visitantes, então não as faça muito intrusivas; em vez de colocar uma tag de aviso no topo da página, insira-a no rodapé da página.

Páginas

Convenções para nome de URL/página

Criando uma página

Antes de criar uma página, pergunte-se:

link Se você decidir continuar:

Veja também: a página HelpOnPageCreation do moinmoin.

Renomeando uma página

URIs legais não mudam (w3). Ainda assim, algumas vezes é uma boa ideia renomear uma página quando seu nome não descreve, de forma acurada, seu conteúdo.

Antes que você renomeie uma página:

Se você realmente decide renomear a página:

Nota: Se, ao renomear a página, demanda-se uma página de redirecionamento, isto pode significar que a página não deveria ser renomeada!

Combinando e dividindo páginas

Reorganizar páginas é uma boa ideia. Encorajamos você a:

Tente preservar o histórico da página:

Para traduções: se você não pode combinar/dividir páginas traduzidas, adicione orientações (comentários) na versão traduzida para que tradutores(as) possam acompanhar!

Incluindo conteúdo nas páginas

Quando apenas parte de uma página deve ser mesclada, considere usar o macro Include().

Se a parte compartilhada for igualmente válida em todas as páginas, crie uma nova página e inclua-a em todas as páginas: 

<<Include(PáginaFonte)>>

Por exemplo, Packaging/SpecificWorkflowAdmonition está incluída em muitas outras páginas.

Se a parte compartilhada pertence a uma página, mas é relevante em outra, adicione tags em torno da parte na página de origem: 

##TAG:UNIQUE-NAME-START

(Tudo entre as etiquetas será incluído)

##TAG:UNIQUE-NAME-END

A seguir, inclua o texto na página de destino: 

<<Include(PáginaFonte, ,from="^##TAG:UNIQUE-NAME-START",to="^##TAG:UNIQUE-NAME-END")>>

Por exemplo, a lista de traduções no topo desta página está incluída por todas as traduções da página.

Páginas de redirecionamento

Em algumas ocasiões, você pode desejar criar uma página de "redirecionamento" (que automaticamente redireciona o navegador para a página correta).

Não exagere no uso desta ferramenta.

amostra : 

#redirect PáginaDeDestino
go to [[PáginaDeDestino]]

Note que #refresh (atualizar) não está habilitado neste wiki.

Veja também: a página HelpOnProcessingInstructions do moinmoin.

Apagando uma página

Se você acha que uma página deva ser removida:

  1. Considere renomear a página em vez disso.

    • Copiar-e-colar uma página existente em uma nova perde o histórico da página.

  2. Considere combinar ou dividir a página em vez disso.

  3. Exclua a página você mesmo(a) ou adicione-a à CategoryProposedDeletion.

Se você apagar a página você mesmo(a):

  1. Verifique se a página é realmente proposta para exclusão, não apenas vinculada à página de categorias
  2. Verifique se as pessoas tiveram tempo suficiente para responder desde que a proposta foi adicionada.
  3. Verifique se você concorda com o motivo da exclusão.
    • Deve haver uma explicação na lista de categorias.

      • Verifique o texto bruto, caso a explicação tenha sido adicionada com um comentário ##.

    • Caso contrário, vá para a página "info" da página e encontre a edição que adicionou a proposta.
      • Pode ter um comentário útil ali.

  4. Procure por linkto:<nomedapágina> e remova quaisquer links que seriam quebrados pela exclusão.

    • Você pode fazer isso clicando no título da página no topo da página.
  5. Também exclua quaisquer versões traduzidas da página.
  6. Escreva sua justificativa para excluir a página no campo de comentários.
    • Se a página já foi proposta para exclusão, copie a fundamentação da proposta.

Justificativas comuns para remoção de páginas

Categorias

Para ajuda com as categorias do moinmoin, veja usando categorias. Para uma lista das categorias deste wiki, veja CategoryCategory.

Adicione uma página a uma categoria

Para adicionar uma página a uma categoria, use o menu suspenso "Adição de:" abaixo da caixa "Comentário:" na página de edição, ou adicione o nome da categoria no rodapé da página: 

----
CategoryFoo

Se futuros(as) editores(as) questionarem o motivo da página estar na categoria (por exemplo, porque indica uma tarefa atual), inclua uma explicação: 

----
CategoryFoo: <explicação>

Alternativamente, use um comentário: 

----
CategoryFoo /* <longa explicação que ficaria feia na lista de categorias */

Para ver os comentários, clique no link Comentários entre Editar e Info na parte superior da página.

Se você achar que essa adição pode ser uma escolha controversa, considere também colocar um aviso no topo da página: 

{{{#!wiki caution
'''Página adicionada à CategoryFoo'''

Esta página foi adicionada à [[CategoryFoo]] porque <motivo>.

Se você discorda, por favor explique a razão na [[/Discussion|página de discussões]].
}}}

[[/Discussion]] leva à página de discussões da página atual. Veja as páginas de discussões existentes.

Portais

Portais são páginas centrais que contêm links para artigos. Elas complementam a estrutura relacional oferecida por CategoryCategory e pelo motor de busca integrado.

Páginas de portal devem ser baseadas no PortalTemplate.

Transformando páginas em portais

Para fazer com que seu artigo vire uma página de portal, adicione a tag CategoryPortal no seu rodapé e encontre um portal adequado para anexá-la.

Não crie portais cheios de links mortos.

Base de dados de imagem

Ícones usados recorrentemente e logotipos de portal podem ser reunidos em Portal/IDB. Isto é útil para portais traduzidos e para fazer com que a arte fique consistente.

Traduções

O topo de cada página exibe links para a mesma página em outros idiomas - veja cabeçalhos e DefaultTemplate como exemplo.

Princípios:

  • Qualquer tópico com uma página wiki pode ter muitas traduções, mas existe sempre uma página "base".
  • Já que esta cópia principal tem que estar em algum idioma, nós padronizamos o uso da versão em inglês.

  • Páginas traduzidas usam o esquema de nomes "códigodeidioma" + "/" + "NomeEmInglês" - por exemplo:

  • Quando você modificar uma página traduzida, atualize ou notifique a versão em inglês também.
  • Tente manter a mesma diagramação em todos os idiomas, já que isto simplifica a sincronização (especialmente para editores(as) que não são fluentes em seu idioma e que ainda assim terão alguma possibilidade de encontrar e atualizar o elemento correto).

  • Se a página não existe em inglês, crie-a também. Se você não se sentir confortável escrevendo em inglês, somente crie a página com os cabeçalhos usuais e estabeleça o link para a página traduzida, certificando-se de que marcou sua página com a tag UpdateEnglish.

  • Se a página não existe em seu idioma, comece copiando/colando o conteúdo da versão em inglês e atualize o cabeçalho da página para se equiparar ao nome da página; e então leia abaixo.

Sincronizando traduções

Quando você está atualizando uma página para corresponder a outra em outro idioma (isto é, "sincronizando" as versões),

  • Todas as versões da página devem manter a mesma diagramação (formatação, ordem de parágrafos, etc.).
  • Deixe claro o estado da revisão da página:
    • (ou) atualize toda a página de uma vez e então altere o número da "revisão" correspondente no cabeçalho

    • (ou) adicione um comentário do tipo ## A ATUALIZAÇÃO DA TRADUÇÃO PAROU here onde você parou.

  • Se a página traduzida é mais nova do que aquela em inglês:
    • (ou) atualize a versão em inglês você mesmo(a) se puder (não se preocupe com pequenos erros gramaticais - alguém os corrigirá)

    • (ou) adicione uma tag "UpdateEnglish" na parte inferior da página e adicione "+ IMPROVEMENTS" no comentário English revision.

Tradutores(as) do Wiki

As pessoas envolvidas na tradução de páginas wiki do Debian devem adicionar a tag CategoryWikiTranslator em suas páginas de apresentação e devem considerar ajudar a traduzir outras partes do Debian.

Ajudando o wiki.debian.org

Qualquer pessoa pode ajudar a melhorar o wiki.debian.org:

  • Melhorar o conteúdo de qualquer página, onde conseguir.
  • Adicionar observações e questionamentos na parte inferior das páginas wiki que você visita.
  • Revisar gramaticalmente as páginas (muitas contribuições são feitas por pessoas não anglófonas).

  • Traduza páginas.

  • Busque por backlinks para FixMe (a corrigir) e ToDo (a fazer).

  • ReFactor (recicle) tudo que puder.

  • Atualize páginas contendo ?texto obsoleto

  • Limpe (veja ThreadMode)

  • Repasse seu conhecimento em como instalar ou usar o Debian
  • Se você não trabalha com TI, você pode criar uma página explicando como você usa o computador em seu dia a dia de trabalho. Explique seus problemas e necessidades.

O Debian também precisa de habilidades diferentes de TI: (jurídicas; marketing e publicidade; organização de eventos; arrecadação de fundos; relações públicas, e muito mais). Veja também https://www.debian.org/intro/help.

Promovendo o wiki.debian.org

A melhor e mais fácil maneira de promover este wiki é usá-lo você mesmo(a) e torná-lo útil para outras pessoas através da contribuição de materiais úteis (tenha em mente as diretrizes para conteúdo).

Quando você é questionado(a) em uma lista de discussão, fórum ou canal irc,

  • a primeira e melhor opção é direcionar a indagação para a documentação oficial do Debian (www.debian.org/* , páginas man, README, etc.), sugerindo um(a) autor(a) ou mantenedor(a), se necessário;
  • a segunda melhor opção é atualizar a página wiki apropriada para se certificar de que ela responde a questão, e direcionar para tal página.

Perguntas frequentes (FAQ)

Q) Eu consigo obter uma lista de todas as páginas deste wiki?

A) Sim, veja TitleIndex

Q) O wiki não seria mais útil se fosse melhor organizado?
A) Possivelmente, mas um wiki estruturado é uma contradição em termos. É mais importante fornecer a ele bons conteúdos.

Q) Existe um modo de exibir somente os artigos órfãos?

A) Não, (OrphanedPages está quebrado; links no formato [[NomeDaPágina|Rótulo do link]] não são contabilizados). Mas ser uma página órfã é somente um problema se existem páginas que devem estar ligadas a ela e não estão (então as corrija), ou se a página falha em ser exibida nas pesquisas (então certifique-se de ter incluído as palavras-chave apropriadas).

Q) Como eu acompanho as alterações?
A) Usando duas funcionalidades que estão acessíveis pelo menu da barra lateral:

  • o link para a página MudançasRecentes (limitado a uma semana para visitantes, 90 dias para usuários(as) autenticados(as));

  • a opção Acompanhar, que solicita notificações por e-mail quando a página é modificada.

Informação técnica

Este wiki está executando o software moinmoin, versão 1.9 (informação de configuração do wiki). Atualmente roda em uma máquina patrocinada por Dembach Goo Informatik GmbH & Co KG (incluindo hardware, instalações e banda de Internet).