Compartilhar via


Criar uma wiki para seu projeto

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

No Azure DevOps, cada projeto de equipe tem um wiki. Você pode usar o wiki para compartilhar informações com sua equipe e dar suporte à contribuição do projeto. O wiki é alimentado por um repositório Git no back-end. Este artigo descreve como abrir o wiki do projeto e criar o repositório Git.

Quando você cria um projeto de equipe, um repositório wiki do Git não é criado por padrão. Você pode criar o repositório para armazenar seus arquivos wiki Markdown ou publicar arquivos Markdown existentes de um repositório Git em um wiki.

Pré-requisitos

Categoria Requisitos
Acesso ao Projeto Membro do projeto em que o wiki está localizado. Se você não tiver acesso, solicite-o ao administrador do projeto. Qualquer pessoa com acesso ao projeto de equipe pode visualizar o wiki, incluindo partes interessadas.
Permissões – Para adicionar ou editar páginas wiki: Membro do grupo Colaboradores.
– Para publicar o código como wiki: permissão Criar Repositório. Por padrão, essa permissão é definida para membros do grupo Administradores do Projeto.
Níveis de Acesso No mínimo, acesso Básico.

Abrir o Wiki

Você pode abrir e exibir a página wiki do projeto de equipe do Azure DevOps no navegador ou usar a CLI do Azure DevOps.

Conecte-se ao seu projeto usando um navegador da Web com suporte e selecione Wiki:

Captura de tela de um wiki aberto no navegador e mostrando a página de visão geral do wiki.

Se você precisar mudar seu projeto de equipe, selecione Azure DevOps para navegar por todos os projetos e equipes da equipe.

Criar um repositório Git wiki

Esta seção descreve como criar o repositório Git para o wiki. Você pode trabalhar diretamente com a interface do usuário do Azure DevOps no navegador ou usar a CLI do Azure DevOps.

No navegador, você pode criar um novo repositório Git para armazenar suas páginas wiki e artefatos relacionados. Na página inicial do Wiki, selecione Criar wiki do projeto. Mesmo se você usar o TFVC (Controle de Versão do Team Foundation) para controle do código-fonte, poderá criar um wiki com um repositório Git.

Captura de tela que mostra como selecionar a opção Criar wiki do projeto ou Publicar código como wiki no Azure DevOps.

Se você não tiver as permissões necessárias para criar um repositório Wiki Git ou não puder acessar nenhum wiki existente, verá a seguinte mensagem:

Captura de tela da mensagem para usuários com permissões insuficientes para criar um repositório Git wiki.

Os usuários com acesso no nível do administrador do Project podem criar o repositório Git wiki. Os usuários com acesso ao Stakeholder não podem criar um wiki porque não têm permissões para trabalhar nas seções Repos ou Code do projeto.

O nome do repositório wiki baseia-se no nome do projeto. A convenção é <ProjectName>.wiki. Se o nome do projeto da equipe for Contoso , o nome do repositório wiki será Contoso.wiki.

Dica

Você pode criar vários wikis para um único projeto publicando seu código como wiki.

Acessar seu repositório wiki

O repositório Git para o wiki (ProjectName.wiki) não está incluído na lista suspensa de repositórios nas seções Repos ou Code do seu projeto. O repositório wiki também não está listado nos repositórios de Configurações do Projeto ou nas páginas >controle de versão. Em vez disso, você pode acessar o repositório wiki na página Repos>Arquivos do wiki.

  1. Crie a URL para a página Repos>Arquivos. Na URL a seguir, substitua o servidor, a organização, o projeto e o nome wiki por qualquer <Placeholder> parte:

    https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>

    https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>

  2. Cole a URL em um navegador e abra a página Arquivos do wiki.

  3. Na página Repos>, localize o nome do seu repositório wiki e selecione Mais opções (...) >.

    Captura de tela que mostra como abrir a página Arquivos de Repos para seu repositório wiki e, em seguida, selecionar a opção Clonar.

    A opção Clonar abre uma caixa de diálogo que inclui a URL do repositório wiki.

  4. Na caixa de diálogo, selecione HTTP e selecione o ícone Copiar (página dupla):

    Captura de tela que mostra como acessar a URL do repositório wiki selecionando a opção HTTP e o ícone Copiar.

    A URL é copiada para a área de transferência.

    Feche a caixa de diálogo.

  5. Para acessar o repositório wiki, cole a URL copiada no navegador.

Próxima etapa