Wiki Community/pt-br

From Xen
Jump to: navigation, search

Antes que você leia este artigo, acesse o wiki registrando-se como usuário. Nós não exigimos que somente usuários registrados acessem o wiki mas, te encorajamos a registrar-se.

Por que nós precisamos de VOCÊ?

O Wiki Xen.org já existe a um bom tempo e, como diversos Wiki's contem muitos conteúdos que estão desatualizados ou não são mais relevantes. Nós decidimos migrar para o MediaWiki o que nos permite um novo inicio. Esperamos ser capazes de mobilizar os membros da comunidade Xen e estamos planejando realizar um número de atividades regulares e abordagens como:

UncleSamSmall.png

Convenções Wiki

Nós gostariamos de tornar o gerenciamento e uso tão fácil quanto possível para que os usuários utilizem e encontrem conteúdos no novo Wiki garantindo sua atualização.

Páginas Wiki internas úteis

Estas páginas auxiliam editores que precisam trabalhar.

Changes Missing Content Manage Pages
Alterações Recentes (inglês) Criar uma Página (inglês) »» Criar uma página Páginas sem categoria (inglês) »» Categorizar
Alterações Relacionadas (inglês) Upload de arquivos (inglês) »» Upload de arquivo Ações Necessárias (inglês) »» Precisa ser deletada, refeita, revisada, ...
Criar uma Categoria (inglês) »» Create category Necessidade de formatação (ingês) »» Reparo fácil para iniciantes
Criar um Template (ingês) »» Criar template TODO (ingês) »» Para fazer (TODO)

Gerenciando Páginas via Templates

Templates para ajudar a gerenciar conteúdos
Template Quando usar
Template:Needs_Archive Indica que esta página precisa ser arquivada. Favor, especificar um motivo.
Template:Needs_Additions Indica que esta página está incompleta e pode se beneficiar de adições e melhorias. Por favor, especifique o que deve ser adicionado.
Template:Needs_Delete Indica que esta página precisa ser eliminada. Por favor, especificar um motivo.
Template:Needs_Formatting Indica que esta página tem alguns problemas na formatação. Por favor, detalhe o problema.
Template:Needs_Refactor Indica que esta página precisa ser reformulada, como a fusão ou cisão. Por favor, seja concreto sobre a razão e ação proposta.
Template:Needs_Review Indica que esta página precisa ser revisada. Se partes específicas da página precisam ser revistas ou estão incorretas, indique na macro.
Template:Needs_Rewrite Indica que esta página precisa ser reescrita; em outras palavras, a página é útil mas, contém muitos erros. Por favor, forneça mais informações na macro.
Template:Needs_Recategorize Indica que esta página precisa ser categorizada. Por favor, especifique um motivo.
Template:TODO Este é um modelo genérico que indica que algo precisa ser feito para esta página. Só deve ser utilizado se os modelos mais específicos não são aplicáveis.
Outros templates mais genéricos
Template Quando usar
Template:Info Este é um box de informação generica, que destaca algumas informações sobre esta página.
Template:InfoLeft O mesmo que Info mas não centralizada.
Template:Warning Este é um box genérico de aviso, que destaca algumas informações sobre esta página que normalmente avisa o usuário sobre alguma coisa.

Veja também:

  • Ajuda com Templates (inglês)
  • Exemplo de como utilizar qualquer um dos templates acima:
    {{Info|Este é um infobox com este texto na caixa}}
  • Outro exemplo:
    {{Needs_Archive|Esta página está desatualizada: este projeto foi concluído em 2009.}}

Melhor navegação através de Categorias

Categorias Comuns

Categorias por audiência
Categoria Quando usar
Category:Users Este documento é para usuários do Xen ou qualquer projeto hospedado no Xen.org
Category:Beginners Este documento é dirigido principalmente para iniciantes. Note que esta categoria poderá ser principalmente utilizada em conjunto com Category:Users.
Category:Developers Este documento é dirigido para desenvolvedores do Xen ou para qualquer projeto hospedado no Xen.org
Category:Project Este documento é dirigido principalmente para projetos de documentação com um ROADMAP, TODO list, etc. para projetos hospedados no Xen.org
Category:Community Este documento é um documento para a comunidade que não se encaixa em outro lugar. Destina-se a informações gerais do Xen e da comunidade em geral
Categorias por tempo determinado
Categoria Quando usar
Category:Transient Este documento tem uma duração limitada (por exemplo, ele descreve um evento ou uma atividade de curta duração). Páginas nesta categoria devem ser revistas pelo menos anualmente e arquivadas de forma adequada.
Category:Archived Este documento foi arquivado.
Categorias por tipo de documento (note que estes documentos devem ser utilizados ​​em conjunto com as categorias por audiência)
Categoria Quando usar
Category:Overview Este documento contém um documento de visão global para um tópico específico. Visões Globais são tipicamente introduções e contém definições,

This document contains an Overview document for a specific topic. Overviews are typically introductory and contain definitions, trade-offs, conceitos básicos, etc.

Category:FAQ Este documento contém uma ou mais perguntas frequentes incluindo respostas
Category:HowTo Este documento contém um artigo HOWTO (como fazer), que é geralmente um pequeno tutorial
Category:Tutorial Este documento contém um tutorial passo-a-passo para um caso de uso complexo
Category:Example Este documento contém principalmente exemplos de arquivos de configuração, configurações, scripts, etc.
Category:Compatibility Este documento contém informações de compatibilidade de um determinado software com outro, de um determinado software com um hardware e outras compatibilidades.
Category:Index Este documento é em grande parte index de outras páginas.
Category:Glossary Este documento é uma definição de termos utilizados na comunidade Xen ou termos genéricos
Categorias por projetos ou tecnologia
Categoria Quando usar
Category:Xen Este documento está relacionado à tecnologia ou projeto Xen Hypervisor. Esta categoria pode ser utilizada por usuários, desenvolvedores bem como categorias do projeto.
Category:XCP Este documento está relacionado à tecnologia ou projeto XCP. Esta categoria pode ser utilizada por usuários, desenvolvedores bem como categorias do projeto.
Category:PVOPS Este documento está relacionado à tecnologia ou projeto PVOPS, o qual se refere ao suporte no upstream e mainstream ao Xen no Linux. Esta categoria pode ser utilizada por usuários, desenvolvedores bem como categorias do projeto.
Category:XenARM Este documento está relacionado à tecnologia ou projeto XenARM. Esta categoria pode ser utilizada por usuários, desenvolvedores bem como categorias do projeto.

Outras Categorias

Estas categorias são categorias mais especializadas. Por favor, certifique-se que estas categorias sejam utilizadas em conjunto com

Tipo de projeto: Categorias que se relacionam com um projeto específico.
Categoria Quando usar
Category:OCaml Este projeto está relacionado com a linguagem OCaml, que é muito utilizada na implementação do projeto XCP.
Tipo de documento: Categorias que são relevantes principalmente para desenvolvedores
Categoria Quando usar
Category:Development Process Este documento descreve um processo ou uma técnica que diz respeito a projetos do Xen.org. Documentos nesta categoria são relevantes principalmente para desenvolvedores.
Category:Design Document Esta categoria contém documentos de projeto, descrições de arquitetura, e assim por diante: em suma, contém documentos que descrevem partes do trabalho de codificação. Documentos nesta categoria são relevantes principalmente para desenvolvedores.
Tipo de documento: Categorias que são relevantes principalmente para usuários
Categoria Quando usar
Category:Release Notes Este documento descreve notas de lançamento para um projeto específico ou produtos hospedados no Xen.org.

Melhorando Acessibilidade de topicos com Trails

Trails são seqüências de documentos (ou mesmo seções de documentos) que são sugeridos para ser lido em uma determinada ordem. Note-se que trails são automaticamente adicionados ao Category:Trail.

Utilização de Trails

Arquivando Páginas

Páginas são arquivadas da seguinte forma:

  • Adicionando [[Category:Archived]] à página
  • Renomeando a página de <nomedapagina> para Archived/<nomedapagina>
  • Certifique-se de fazer o mesmo com todas as sub-páginas e traduções
  • Mantendo todas as categorias como estão
  • Se você não puder renomear a página, então marque-a com {{Needs_Archive | razão}}, de forma que o administrador do wiki possa renomear a página

Ajuda com multi-linguagens e Convenções

Icon Info.png Veja também Category:Languages!


Template de linguagens

Páginas existentes em diversas línguas devem ter {{Languages}} template na parte inferior da página. Isto habilita os usuários visualizar as traduções que estão disponíveis para a página. Existem dois casos: Páginas em Inglês tem:

{{Languages}}
Por exemplo, [[Main Page]] tem
{{Languages}}

Páginas traduzidas tem:

{{Languages|<nome da página em Inglês>}}
Por exemplo [[Main Page/pt]] tem
{{Languages|Main Page}}

A versão em Inglês da página será sempre a versão principal, com todas as outras linguagens como sub-páginas, nomeadas utilizando o código apropriado do idioma (veja abaixo).

Convenções de nomenclatura para páginas traduzidas

Páginas traduzidas precisam seguir as seguintes convenções de nomenclatura.

<Nome da Minha Página>/<2 Letras do Código da Linguagem>

As letras do código da linguagem precisam ser um dos códigos mostrados na tabela de liguas suportadas , por exemplo

Page Name Language
Main Page English
Main Page/de German
Main Page/es Spanish
Main Page/fr French
Main Page/ja Japanese
Main Page/ko Korean
Main Page/pt Portuguese
Main Page/pt-br Brazilian Portuguese
Main Page/zh Chinese

Exemplos

Exemplos de nomes de páginas válidas são:

[[Category:Xen/ja]]
[[Frontend_Driver/de]]
[[Archived/XCI Getting Started/pt]]
[[Template:Fmbox/doc/zh]]

Categoria de Linguagens

Paginas traduzidas devem ser Categorizadas: elas devem conter uma categoria na seguinte forma

[[Category:Languages/<Código da Linguagem>]]

de maneira que seja possível encontrar todas as páginas de uma linguagem específica.

Exemplos

Exemplos de nomes de uma categoria válida são:

[[Category:Languages/ja]]
[[Category:Languages/pt]]


Links para páginas traduzidas

Você deverá tomar cuidado ao linkar para outras páginas. Digamos que você deseje linkar para

[[DomU_Install_with_Virt-Manager]]

Utilizando o link acima, você será direcionado para a página em Inglês. Se deseja ir para a página traduzida, o link deverá ser como segue

[[DomU_Install_with_Virt-Manager/<código da linguagem>]]

Ex.

[[DomU_Install_with_Virt-Manager/es]]

Se você manter links para documentos em ingês em uma página traduzida, seria uma boa idéia utilizar a seguinte convenção

[[DomU_Install_with_Virt-Manager]] (English)

de maneira que as pessoas saibam que o documento esteja em outra linguagem, neste caso, ingles.

Política de Linguagens

Languages

This page describes the current multi-lingual policy on wiki.xen.org.


The main page

The English version of our front page is located at Main Page. Translated versions are located at MediaWiki/code, where code is the language code (e.g. Main Page/fr).

Importantly, the rules about language codes (see below) should be followed here as well.

Other namespaces

Apart from the Main Page, no policy has yet been decided about other namespaces. For the time being, if you would like to create translations for pages in other namespaces then please do so as described for the Help: namespace, however content may be moved or deleted depending on the policy that is eventually adopted.

Note that the rule that English content should not be placed in sub-pages does not apply to other namespaces. This is one of the issues that needs resolving.

Language codes

Throughout wiki.xen.org you should use the language codes specified by the MediaWiki software when creating language-specific content (see Names.php for the full and up-to-date list).

Please also bear the following in mind:

  • If the language code is not found in Names.php then we should not host pages in that language.
  • If MediaWiki uses the 'incorrect' code for a language then you should also (for consistency) use that incorrect code here. If you think a code is incorrect you should discuss it on MediaWiki Bugzilla, and if this results in it being changed we will move the pages to match.
  • Note that some language codes in Names.php are now deprecated (e.g. zh-yue has been replaced with yue). In these cases only the most recent code should be used.
Languages Language: English  • Deutsch • español • français • 日本語 • 한국어 • português do Brasil • русский • 中文

Use of Discussions: Talk pages

Every wiki page has an associated talk page which can be used for discussion and communicating with other users. Talk pages can be accessed by clicking the “discussion” tab at the top of the page. Simply edit the page as normal to add your comment.

We encourage the use of talk pages. However, it would be good if you followed these Guidelines What to discuss:

  • Keep focused on the task of building a wiki article: remember that editing the article itself is often a more effective means of communicating.
  • Use discussion pages only to support this process: the topic of conversation should generally revolve around what needs to be done to make the associated article better.
  • Talk pages are good in particular, if you suspect something is wrong with the content, but you do not quite know how to fix the page.

Conventions:

  • Start a new discussion with a ==level 2 heading== at the bottom of the page (or use the “+” tab)
  • Always sign your name after your comments. Use the four tildes “~~~~” wiki syntax (or the signature button signature button in the toolbar above the editing textbox). For more information see Help:Signatures.
  • Indent replies with colons (:) at the beginning of the line.


Also See: