Wiki provisionado vs. publicado como wiki de código

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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, embora ele esteja disponível apenas se o Azure Repos estiver habilitado.

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.

Opções do menu da página Wiki

Com um wiki provisionado, você pode adicionar e editar páginas diretamente no wiki. Todas as atualizações de conteúdo para um wiki provisionado ocorrem dentro do wiki.

Com um wiki publicado como código, você pode adicionar, editar e atualizar conteúdo de Repos ou Código.

A imagem a seguir mostra opções para um wiki provisionado. Várias dessas opções não são suportadas para as páginas wiki publicadas como código.

Por exemplo, a opção Editar no repositório para o wiki publicado como código leva você à página do repositório para editar essa página específica. As atualizações que você faz em uma página na ramificação que você selecionou para o wiki são publicadas automaticamente no wiki.

Recursos suportados e diferenças operacionais

Ambos os tipos de wiki suportam os seguintes recursos:

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

A tabela a seguir resume as operações ou recursos que podem diferir, dependendo do tipo wiki.

Adicionar páginas

Para ambos os tipos de wiki, selecione Nova página ou Adicionar subpágina. Para obter mais informações, consulte Adicionar e editar páginas wiki.

Sequência de páginas e lista de páginas no painel de navegação

O wiki provisionado gerencia a sequência de páginas e a lista de páginas automaticamente à medida que você adiciona ou move páginas dentro do painel de navegação.

Para estruturar a lista de páginas no painel de navegação para um wiki publicado como código, defina o *.order* arquivo na raiz e para cada subpasta ou página pai que contenha subpáginas.

Ambos os tipos de wikis seguem a mesma estrutura de arquivos, só que o wiki publicado como código exige que você mantenha a sequência de páginas manualmente.

Para obter mais informações sobre como trabalhar com .order arquivos, consulte Arquivos de repositório Wiki Git e estrutura de arquivos.

Revisões de página e reversão para uma versão anterior

A partir do wiki, você pode ver as revisões de qualquer página wiki. Selecione Revisões ou a opção do menu Exibir revisões .

Mas, o processo de reversão difere dependendo do tipo de página wiki.

• Para uma página wiki provisionada, selecione Reverter, conforme descrito em Reverter uma confirmação para uma página wiki provisionada
• Para uma página wiki publicada como código, trabalhe a partir de uma ramificação local e envie uma solicitação pull para atualizar a ramificação a partir da qual você está trabalhando.

Controle de versão e cancelamento de publicação de um wiki

Com o versionamento, você pode 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 quem o criou, publicando código em um wiki. Para obter mais informações, consulte Cancelar publicação de um wiki de código.

Excluir um wiki de projeto

1. Clone o repositório wiki para fazer backup de todo o seu conteúdo. As opções Mais tem o URL do wiki clone, que pode ser usado para clonar o wiki.

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

   Por exemplo, GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 retorna todas as wikis do projeto, para que você possa escolher qual excluir.

3. Use a API REST para excluir o repositório Git de backup. Use o ID do repositório do wiki do projeto que você encontrou na etapa anterior e verifique novamente o ID do repositório, para não remover o errado.

   Por exemplo, DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Atualizar um wiki offline

Você pode trabalhar offline ou em uma ramificação local para atualizar o conteúdo de um wiki provisionado e publicar como wiki de código. Para obter mais informações, consulte Clonar e atualizar páginas wiki offline.

Artigos relacionados

• 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
• Introdução ao Git