Wikis provisionados versus código publicado como wiki
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018
No Azure DevOps, você tem as seguintes opções para manter o conteúdo wiki.
- Provisione um wiki para seu projeto de equipe. Essa opção dá suporte a apenas um wiki para o projeto de equipe.
- Publicar arquivos markdown definidos em um repositório Git em um wiki. Com essa opção, você pode manter vários wikis com versões para dar suporte às suas necessidades de conteúdo, embora esteja disponível somente se Azure Repos estiver habilitado.
Embora ambas as opções mantenham o conteúdo wiki em repositórios Git, a maneira como você adiciona, atualiza e gerencia o conteúdo wiki difere.
Observação
O código de publicação como recurso wiki está disponível no momento em Azure DevOps Server 2018 e versões posteriores. Para versões mais antigas, você só pode provisionar um wiki para seu projeto de equipe.
Opções de menu de página wiki
Com um wiki provisionado, você adiciona e edita páginas diretamente no Wiki. Todas as atualizações de conteúdo para um wiki provisionado ocorrem dentro do Wiki.
Com um código de publicação como wiki, você adiciona, edita e atualiza o conteúdo de Repos ou Code.
As opções de menu indisponíveis para as páginas wiki são mostradas na ilustração a seguir. Como você pode ver, várias opções não têm suporte para a publicação como páginas wiki de código .
Wiki provisionado
Publicar código como wiki
Por exemplo, a opção Editar em Repos para o código de publicação como wiki leva você para a página Repositório para editar essa página específica. Atualizações você fizer em uma página no branch selecionado para o wiki ser publicado automaticamente no wiki.
Recursos com suporte e diferenças operacionais
Wikis provisionados e publicar como wikis de código dão suporte aos seguintes recursos:
- Formatação Markdown
- Marcas HTML
- Inserir e redimensionar imagens
- Notação matemática e caracteres
- Vincular a itens de trabalho usando #
- Anexar arquivos
- Filtrar conteúdo do Wiki
- Imprimir uma página wiki
- Atualizar conteúdo offline
- Adicionar ou editar páginas do Wiki
A tabela a seguir resume essas operações ou recursos que podem ser diferentes, dependendo do tipo wiki.
| Operação | Wiki provisionado | Publicar código como wiki |
|---|---|---|
| Suporte a vários wikis, nome wiki | ✔️ | |
| Adicionar ou editar páginas dearquivosrepos> ouarquivos de código> | ✔️ | |
| Reverter para uma revisão anterior do Wiki | ✔️ | |
| Reverter para uma revisão anterior de Repos ou Code | ✔️ | ✔️ |
| Manter wikis com versão | ✔️ | |
| Selecionar uma versão wiki | ✔️ | |
| Cancelar a publicação de um wiki | ✔️ |
Adicionar páginas
Para um wiki provisionado ou código de publicação como wiki, selecione Nova página ou Adicionar subpágina. Para saber mais, 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 código de publicação como wiki, defina o arquivo .order na raiz e para cada subpasta ou página pai que contém subpáginas.
Ambos os tipos de wikis seguem a mesma estrutura de arquivos, é apenas que o código de publicação como wiki exige que você mantenha a sequência de páginas manualmente.
Para saber mais sobre como trabalhar com arquivos .order , consulte arquivos de repositório Git wiki e estrutura de arquivos.
Revisões de página e reversão para uma versão anterior
No Wiki, você pode exibir as revisões de qualquer página wiki escolhendo Revisões ou selecionando a opção Exibir menu revisões .
No entanto, o processo de reversão é diferente 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 de wiki de publicação como código , trabalhe em uma ramificação local e envie uma solicitação de pull para atualizar a ramificação da qual você está trabalhando.
Controle de versão e não publicação de um wiki
Com o controle de versão, você pode publicar diferentes versões de conteúdo em wikis distintos, com base em um branch com versão de um repositório Git. O controle de versão e a publicação de conteúdo que você publicou anteriormente em um wiki têm suporte apenas para wikis que você criou publicando código em um wiki.
Para saber mais, consulte Versão, selecione ou desppublique um wiki publicado.
Excluir wiki do projeto
- Obtenha o wiki correspondente à ID wiki ou ao nome wiki fornecido. Para obter mais informações, consulte Wikis – Obter API REST.
GET https://dev.azure.com/{organization}/{projec``t}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0
Você também pode obter todos os wikis em um projeto ou coleção. Para obter mais informações, consulte Wikis – Listar API REST
- Exclua o wiki correspondente à ID wiki ou ao nome wiki fornecido. Para obter mais informações, consulte Wikis – Excluir API REST.
DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0
Atualizar um wiki trabalhando 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 saber mais, consulte Clonar e atualizar páginas wiki offline.