Wiki provisionado vs. publicado como wiki de código

Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020

Você pode manter seu conteúdo wiki em um wiki de projeto de equipe ou em um wiki publicado como código. Com um wiki publicado como código, você pode manter vários wikis versionados para dar suporte às suas necessidades de conteúdo. Essa opção está disponível quando você habilita o Azure Repos.

Embora ambas as opções mantenham o conteúdo do wiki nos repositórios Git, a forma como adiciona, atualiza e gere o conteúdo do wiki difere.

Manter o conteúdo wiki

Para ambos os tipos de wiki, você pode trabalhar diretamente no GitHub ou trabalhar offline e, em seguida, enviar suas alterações para o repositório.

Para um wiki provisionado, você adiciona e mantém páginas wiki diretamente na seção Páginas Wiki> do repositório. Todas as atualizações de conteúdo para um wiki provisionado ocorrem dentro do próprio wiki.

Para um wiki publicado como código, você adiciona e mantém o conteúdo do wiki como arquivos de código no repositório. Você acessa os arquivos dentro das seções Repos ou Code do repositório no GitHub.

A imagem a seguir mostra as opções de menu para um wiki provisionado:

Algumas opções de menu para páginas wiki publicadas como código não são suportadas. Para um wiki publicado como código, a opção Editar em repositórios abre a página atual, para que você possa editar o conteúdo no local. As atualizações que você faz em uma página na ramificação selecionada para o wiki são publicadas automaticamente no wiki.

Adicionar páginas wiki

As opções de menu Nova página e Adicionar subpágina estão disponíveis para ambos os tipos de wiki no GitHub. Para obter mais informações, consulte Adicionar e editar páginas wiki.

Ajustar a sequência e a lista de páginas

Ambos os tipos de wiki aplicam a mesma estrutura de pastas e arquivos dentro do repositório Git. A diferença está em como você mantém a sequência de páginas.

Para um wiki provisionado, o GitHub gerencia a sequência de páginas e a lista de páginas automaticamente à medida que você adiciona ou move páginas no painel de navegação.

Para um wiki publicado como código, você precisa manter a sequência de páginas manualmente. Para estruturar a lista de páginas no painel de navegação, defina um arquivo .order na raiz e para cada subpasta ou página pai que contenha subpáginas. Para obter mais informações, consulte Arquivos de repositório Wiki Git e estrutura de arquivos.

Ver revisões de página e reverter para a versão anterior

Na página Wiki para o repositório Git, você pode ver as revisões de qualquer página dentro do wiki. Utilize as opções do menu Revisões ou Exibir revisões. Para reverter o conteúdo da página atual para uma versão anterior, o processo difere dependendo do tipo de página wiki.

Para uma página wiki provisionada, selecione a opção de Reverter no menu. Para obter mais informações, consulte Reverter um commit numa página wiki provisionada.

Para uma página wiki publicada como código , você trabalha a partir de uma ramificação local e envia uma solicitação pull para atualizar a ramificação a partir da qual está trabalhando.

Use o controle de versão e cancele a publicação do wiki

O suporte a controle de versão permite publicar diferentes versões de conteúdo em wikis distintos, com base em uma ramificação versionada de um repositório Git.

Você pode fazer a versão e cancelar a publicação de um wiki somente se você for o usuário que publicou o código para criar o wiki. Para obter mais informações, consulte Cancelar publicação de um wiki de código.

Excluir wiki do projeto

As etapas a seguir descrevem como excluir um wiki de projeto.

1. Clone o repositório wiki para fazer backup de todo o conteúdo. Você pode encontrar o URL wiki no menu Mais opções (...).

2. Obtenha o ID do repositório Git associado ao seu wiki. Você pode usar a API REST para obter todos os wikis no projeto.

   Por exemplo, o GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 comando retorna todos os wikis no projeto. Execute o comando e escolha o wiki a ser excluído.

3. Exclua o repositório Git associado ao seu wiki usando a API REST. Use o ID do repositório do wiki do projeto que você encontrou anteriormente. Verifique novamente o ID do repositório para garantir que você não remova o wiki errado.

   Por exemplo, o DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 comando exclui o wiki. Substitua <repositoryId> pelo ID do repositório do wiki para excluir.

Atualizar wiki enquanto estiver offline

Você pode trabalhar offline ou em uma ramificação local para atualizar o conteúdo para ambos os tipos de wiki. Para obter mais informações, consulte Clonar e atualizar páginas wiki offline.

Explore outros recursos e operações

Ambos os tipos de wiki suportam vários outros recursos e operações:

• Formato Markdown
• Tags HTML
• Inserir e redimensionar imagens
• Notação matemática e caracteres
• Link para itens com hashtag (#)
• Anexar ficheiros
• Filtrar conteúdo Wiki
• Imprimir uma página Wiki
• Atualizar conteúdo offline
• Adicionar ou editar páginas do Wiki

Algumas operações e recursos estão disponíveis para apenas um tipo de wiki ou a abordagem de uso difere:

Conteúdo relacionado

• Criar um wiki para o seu projeto de equipa
• Arquivos de repositório Wiki Git e estrutura de arquivos
• Publicar um repositório Git em um wiki