- Esta página fornece instruções para pessoas que querem editar o conteúdo do wiki.debian.org.
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
Seu nome de usuário(a) do wiki deve estar no formato "NomeSobrenome" ("ApelidoIrc" ou seu login de desenvolvedor(a) Debian também são boas opções).
Ajuste seu fuso horário em sua página userprefs.
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.
- Seu nome completo.
- Sua página web pessoal fora deste wiki.
- Seu endereço de e-mail.
Sua localização (cidade e país) útil para considerações de fuso horário e outros.
- Se você usa IRC, seu servidor usual, canal e apelido.
Se você é um(a) Desenvolvedor(a) Debian (DD), seu nome de login (com um link para https://qa.debian.org/developer.php?login=foobar@debian.org).
Não DDs podem ter um link para https://bugs.debian.org/from:foo@bar.com.
- Seus assuntos de interesse (não limitados ao Debian).
- Sua lista de tarefas a fazer/já feitas (!ToDo/Done).
- Suas contribuições (ou algumas delas) para a comunidade software livre (relatórios de bug; documentação/tradução; desenvolvimento/manutenção...)
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
- Você pode acompanhar as páginas relevantes sobre seus assuntos de interesse.
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
TreeMode (modo árvore)
DocumentMode (modo documento)
ThreadMode (modo discussão)
NewsMode (modo notícias)
CategoryHomepage (categoria página principal)
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.
Não torne QualquerCoisa em um NomeWikiInútil. Saber quando criar uma nova página é uma das partes mais difíceis do EstiloWiki.
RecicleImpiedosamente. Não existe página no UniversoWiki que esteja terminada. Todo conteúdo pode ser refinado. Veja RefactoringWikiPages para mais ideias úteis.
Se o tópico do wiki é muito longo, então, em termos de estilo, seria bom oferecer uma breve visão geral do que foi discutido naquele tópico na forma de um parágrafo conclusivo. Se um parágrafo conclusivo não pode ser facilmente escrito, talvez o escopo do tópico não estava correto e ele deveria ser ou separado em subtópicos, ou combinado com outros em um tópico maior. Isto é comum quando o ThreadMode (modo de discussão) divaga para tópicos alheios.
Veja também esta página 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: ?Algumacoisa (em francês)
Veja também a página HelpOnLinking do moinmoin.
Links internos
Links internos (dentro deste wiki)
[[PaginaFoo]] é geralmente a sintaxe preferida.
[[UmaPaginaSuperiorde/PaginaFoo|PaginaFoo]] é frequentemente usado para encurtar subpáginas.
[[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.
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).
Links para sites externos
O modo preferido para fazer links para recursos externos é:
https://www.debian.org/doc/ - Repositório de documentação oficial do Debian.
(Evite a notação [[https://www.foo.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.")
- Junte os links externos na última seção da página.
Chame esta seção de Links externos.
Qualquer link para "página principal de projeto" pode ficar nesta seção, ou (se não houver outros links externos) uma seção Veja também.
Use o formato InterWiki para criar links com os pacotes Debian, bugs, RFCs e artigos da Wikipedia.
Links partindo de sites externos
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:
- Links para versões traduzidas (verifique se realmente existe!):
Traduções: [[de/DebianWiki/EditorGuide|Deutsch]] - [[fr/DebianWiki/EditorGuide|Français]]
Um link Discussão, para materiais controversos: (!) [[/Discussion|Discussão]]
Compare com o DefaultTemplate
Não use a macro <<Include()>> para traduções. Por quê? Porque pode sobrecarregar este servidor wiki se for utilizado em todas as páginas. A página Frontpage (PáginaPrincipal) é a única exceção.
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. |
Amostra:
||<tablestyle="width:65%;margin-left:35%;padding-left:30pt" style="border:1pt solid #b48;border-left:5pt solid #d4a">'''Desambiguação :''' Esta página é sobre as ''Conferências Debian''.<<BR>> 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.
https://www.debian.org/algumlugar - Amostra de tópico
Amostra:
{{{#!wiki debian https://www.debian.org/algumlugar - Amostra de tópico }}}
A licença do logotipo é Portal/IDB#debian-official-doc-modif-fpiat.
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!
Amostra (note como a tabela é indentada com um espaço):
<<TableOfContents(2)>>
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:
- Seções "Veja também"
Link para a "Página anterior : ?NomedaPáginaAnterior" (se a página é uma SubPágina).
Categorias para marcar conexões com outras páginas
Créditos para anexos
Compare com o DefaultTemplate
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 página que deva ser incluída em outra deve ser chamada */!PageFragment/*
Adicione um comentário escondido (##) no topo da página para que as pessoas entendam o porquê está "incompleta" (um fragmento!)
Veja também o macro <<Include()>> em HelpOnMacros
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.)
- É difícil de entender e de manter, seja você ou outros(as) editores(as) do wiki.
É difícil de ler o diff de formatações complexas.
- O editor GUI pode quebrar seu layout.
Imagens, mídia e anexos
Veja também: a página HelpOnLinking do moinmoin.
Créditos e copyright
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:
[[https://screenshots.debian.net/screenshot/amide|{{https://screenshots.debian.net/thumbnail/amide|Captura de tela|width=160}}]]
Note que o nome do pacote aparece duas vezes neste bloco.
Exemplo:
Posição da imagem
|
É 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}} ||
Nota: ajuste width:100px para adaptar as suas necessidades.
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
Use somente a formatação CamelCase (ao contrário de Separado_Por_Sublinha).
- A primeira letra da primeira palavra deve estar em maiúscula.
- Caracteres especiais devem ser evitados em nomes de páginas.
Barras funcionam para criar grupos (estilo diretório) de subpáginas relacionadas. Se sua página claramente pertence a uma coleção, você poderia considerar criá-la como uma subpágina - veja, por exemplo, a documentação do Moinmoin sobre SubPáginas.
Para páginas traduzidas, veja a seção de tradução.
- A seleção de um nome apropriado é importante. Ele deve claramente mostrar sobre o que é a página e deve conter as palavras que aparecerão nas pesquisas de visitantes.
- Evite nomes ambíguos - não use, por exemplo:
- "Sobre"... sobre o quê? Sobre o sistema operacional Debian, sobre a comunidade, sobre o wiki...?
- "Lançamento"... isto significa lançamentos anteriores, a atual versão estável, o ciclo de lançamentos, o estado de futuros lançamentos, o processo de lançamento, o time de lançamento, etc...
Criando uma página
Antes de criar uma página, pergunte-se:
- Uma nova página é realmente necessária? Poderia ela já existir com um nome diferente? Poderia o conteúdo ser adicionado a uma página existente?
Ela está em conformidade com as diretrizes para conteúdo do wiki.debian.org?
link Se você decidir continuar:
Escolha um nome exclusivo para a página - veja as convenções para nomeação de URL/página.
Pesquise na página CategoryPortal para uma página de portal apropriada (você pode encontrar mais de uma - escolha a melhor) e clique nela
- Na página do portal, clique no link Editar e adicione o nome da nova página que você quer criar (com formatação de "link") para a lista existente de links de páginas
- Salve a página de portal editada e então clique no link "?" na frente da nova página que está para ser criada; isto levará você a uma página onde você terá a opção de criar uma nova página
Aí você pode criar uma página vazia, mas a opção recomendada é selecionar um modelo apropriado - DefaultTemplate (ModeloPadrão) é o recomendado
Se sua página está relacionada a um assunto já coberto por alguma documentação oficial do Debian, crie um link para ela no topo (veja material oficial do Debian)
- Uma vez que a página esteja completa, crie links para ela a partir de páginas relevantes (geralmente um link é suficiente).
- Mais dicas:
- Releia-a dois dias depois (ela ainda está boa?)
- Acompanhe a página.
- Esta página não é "sua", então não ofenda-se quando outras pessoas a fizerem "melhor".
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:
Verifique que esta página não está marcada com a tag CategoryPermalink.
Use o Google (ou equivalente) para verificar se a página tem links para fora deste wiki. Procure por link:wiki.debian.org/FooBar. Se ela está referenciada, pense duas vezes antes de renomear a página. Se você renomear a página, considere criar uma página de redirecionamento e contate o(a) proprietário(a) da página referenciada para que os links sejam atualizados.
- Verifique se esta página está referenciada dentro deste wiki (abra a página e clique no título para obter uma lista páginas que têm links com esta página).
Se você realmente decide renomear a página:
Escolha um nome para a página. Veja convenções para nomeação de URL/página.
- Certifique-se de que atualizou todas as páginas que apontavam para o nome antigo (digite o nome anterior da página na caixa de busca e clique em "Texto"!).
- Também cuide das versões traduzidas da 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!
Apagando uma página
Leia as dicas em Renomeando uma página, já que elas também se aplicam aqui.
Se você acha que uma página deve ser removida, você pode:
- Apagar a página você mesmo (escreva a justificativa no campo de comentário).
ou marcar a página com uma tag "CategoryProposedDeletion" de modo que outros(as) editores(as) possam ficar cientes (ou seja, coloque a tag e a explicação na parte inferior da página).
Não seja rude: não copie e cole o conteúdo de uma página existente para uma nova, apagando a página antiga - isto perde o histórico da página. Em vez disso, combine e divida as páginas.
Novamente, se houver versões traduzidas, cuide delas também!
Combinando e dividindo páginas
Reorganizar páginas é uma boa ideia. Encorajamos você a:
- Combinar páginas "duplicadas" que cobrem o mesmo assunto.
- Combinar páginas similares, se ambas são "muito curtas".
Separar páginas longas que cobrem mais de um tópico (mas considere adicionar um <<TableOfContents>> também.).
Tente preservar o histórico da página:
- Use o campo de comentários para registrar o "antes" e o "depois" dos nomes das páginas quando dividir ou combinar.
- Combine páginas em uma das páginas existentes, não em uma página nova.
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!
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.
Categorias
Ajuda do wiki moinmoin: usando categorias.
A lista de categorias usadas neste wiki: CategoryCategory.
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 dos Estados Unidos.
Páginas traduzidas usam o esquema de nomes "códigodeidioma" + "/" + "NomeEmInglês" - por exemplo:
Versão base: Hardware
Tradução francesa: fr/Hardware
- 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.
ReFactor (recicle) tudo que puder.
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).