Publicar um repositório Git em um wiki

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode publicar conteúdo que já mantém em um repositório Git em um wiki. Por exemplo, esse conteúdo pode ser suporte a kit de desenvolvimento de software (SDK), documentação do produto ou um arquivo LEIA-ME. Você também pode publicar vários wikis em um único projeto de equipe.

Ao publicar seus arquivos de Markdown em um wiki, você obtém os seguintes benefícios:

• Organizar o conteúdo em uma estrutura de página hierárquica
• Procurar e filtrar o sumário
• Publicar novas versões do conteúdo
• Gerencie o conteúdo da mesma forma que você gerencia sua base de código
• Pesquise o wiki facilmente usando o recurso de pesquisa wiki

Para obter mais informações, consulte Código provisionado versus publicado como wiki.

Dica

Você pode adicionar e editar o conteúdo publicado em um wiki usando as etapas deste artigo. Você também pode trabalhar offline e atualizar o conteúdo wiki da mesma forma que colabora no código por meio de um repositório Git. Para obter mais informações, consulte Atualizar páginas wiki offline.

Pré-requisitos

• Tenha um projeto de equipe. Se você não tiver um, crie um projeto agora.
• Habilite o serviço Azure Repos para seu projeto.
• Tenha um repositório Git definido em seu projeto de equipe. Idealmente, este repositório contém pelo menos um arquivo Markdown, que você deseja publicar em seu wiki. Para obter mais informações, consulte Criar um novo repositório Git em seu projeto.
• Tenha a permissão Contribute para publicar código como wiki. Por padrão, essa permissão é definida para membros do grupo Colaboradores. Qualquer pessoa que tenha permissões para contribuir com o repositório Git pode adicionar ou editar páginas wiki.

Abrir wiki

1. Entre na sua organização (https://dev.azure.com/{yourorganization}), abra o projeto e selecione Wiki de visão geral>.

   

Se você precisar alternar projetos, selecione Azure DevOps para procurar todos os projetos.

Publicar um repositório Git em um wiki

Navegador

Execute as etapas a seguir ao manter arquivos Markdown em um repositório Git existente e quiser publicá-los em um wiki.

1. Selecione Publicar código como wiki.

   

   Observação

   A opção Publicar código como wiki não aparecerá se seu projeto não tiver um repositório Git definido. Crie um novo repositório Git e, em seguida, retorne e atualize esta página.

2. Se você já provisionou um wiki de projeto de equipe, selecione Publicar wiki de código.

   

3. Escolha o repositório, a ramificação e a pasta que contêm os arquivos Markdown e insira um nome para o repositório wiki. O repositório Git deve estar dentro do projeto de equipe.

   

   Especifique a raiz do repositório quando quiser publicar todos os arquivos Markdown no repositório em seu wiki.

4. Selecione Publicar. O repositório wiki é preenchido com os arquivos e pastas Markdown incluídos no repositório selecionado.

   Por exemplo, a imagem a seguir mostra o repositório publicado para os arquivos contidos no repositório azure-docs-sdk-node que você selecionou na Etapa 2.

   

   O sumário wiki (TOC) contém os seguintes arquivos:

   • Cada arquivo Markdown (tipo de arquivo = .md) definido no repositório / ramificação / pasta é listado em ordem alfabética, o título do sumário é derivado do nome do arquivo Markdown.

   • Uma página pai para cada subpasta definida dentro da pasta publicada, mesmo que ela não contenha nenhum arquivo de Markdown.

     A imagem a seguir mostra o conteúdo do repositório azure-docs-sdk-node.

     

O chefe do ramo de repositório do Git é mapeado para a wiki. Quaisquer alterações feitas na ramificação e pasta(s) selecionada(s) são automaticamente refletidas no wiki. Não há outros fluxos de trabalho envolvidos.

Observação

Você pode publicar até 10 ramificações por wiki de código publicado.

Para o wiki provisionado com os arquivos Markdown extras, você pode adicionar ou editar páginas da mesma forma que mantém o código em seu repositório Git.

CLI do Azure DevOps

Você pode publicar um repositório Git em um wiki com o comando az devops wiki create . Para começar, confira Introdução à CLI do Azure DevOps. Execute este comando quando você mantiver arquivos Markdown em um repositório Git existente e quiser publicá-los em um wiki.

Observação

Você não pode publicar código como wiki se seu projeto não tiver um repositório Git já definido. Se necessário, crie um novo repositório Git e retorne a esta página.

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {codewiki, projectwiki}]
                      [--version]

Parâmetros

• mapped-path: Obrigatório para o codewiki tipo. Caminho mapeado da nova wiki. Por exemplo, você pode especificar '/' para publicar a partir da raiz do repositório.
• name: Nome da nova wiki.
• org: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando o az devops configure -d organization=ORG_URLcomando. Obrigatório se não estiver configurado como padrão ou selecionado usando o git config comando. Por exemplo, --org https://dev.azure.com/MyOrganizationName/.
• project: Nome ou ID do projeto. Você pode configurar o projeto padrão usando o az devops configure -d project=NAME_OR_ID comando. Obrigatório se não estiver configurado como padrão ou selecionado usando o git config comando.
• repository: Obrigatório para o codewiki tipo. Nome ou ID do repositório a partir do qual publicar o wiki.
• type: Tipo de wiki a ser criado. Os valores aceitos são projectwiki (padrão) e codewiki.
• version: Obrigatório para o codewiki tipo. Nome da ramificação do repositório a partir do qual publicar o wiki de código.

Exemplo

O comando a seguir cria um codewiki chamado "My New Wiki" publicado a MyRepo partir do repositório. O wiki é publicado na wikis pasta na main ramificação e o resultado é mostrado em formato de tabela.

az devops wiki create --name "My New Wiki" --type codewiki --repository MyRepo --mapped-path /wikis --version main --output table

ID                                    Name         Type
------------------------------------  -----------  --------
77abd847-31ec-45e9-8622-a190df8e5917  My New Wiki  codewiki

Editar, renomear ou excluir páginas

Execute as etapas a seguir para editar, renomear ou excluir uma página wiki.

1. Em seu projeto, abra Arquivos Repos>ou Arquivos de Código>.

2. Escolha a página desejada, selecione Ações e escolha a operação.

   

Observação

Gerencie seu repositório wiki da mesma forma que você gerencia qualquer outro repositório Git, definindo políticas de ramificação na ramificação que você selecionou para publicar em um wiki. Mas, sem nenhuma política definida, você pode fazer alterações e enviá-las diretamente para a filial do seu portal da Web ou de um cliente.

Editar uma página do

Use os links disponíveis no modo de edição para visualizar suas alterações ou realçar as alterações feitas a partir da versão anterior. Para descartar as alterações, selecione Cancelar. Para obter mais informações sobre os recursos de Markdown com suporte, consulte Orientação de sintaxe para uso de Markdown.

1. Quando terminar, adicione um comentário sobre suas atualizações e selecione Confirmar.

   

   O sistema apresenta automaticamente um link para criar uma solicitação pull. Você pode ignorar essa mensagem quando estiver editando diretamente a ramificação wiki.

   

Dica

Quando você alterar o nome ou maiúsculas e minúsculas de um arquivo, atualize o .order arquivo para refletir a alteração. Para obter mais informações, consulte Alterar a sequência de páginas, adicionar ou atualizar um arquivo .order.

Renomear uma página

Todas as páginas que você deseja que apareçam no sumário devem ser do tipo .mdde arquivo .

1. Selecione Renomear para renomear o arquivo de acordo.

Por exemplo, na imagem a seguir, renomeamos new-home-page.md para New-Home-Page.md. Esta página aparece no sumário com o rótulo "Nova Home Page".

Os títulos das páginas diferenciam maiúsculas de minúsculas e devem ser exclusivos dentro da pasta e ter 235 caracteres ou menos. Para obter mais informações sobre outras restrições de título, consulte Restrições de nomenclatura de título de página.

Excluir uma página

Você pode excluir todos os arquivos Markdown que não deseja que apareçam no wiki da pasta publicada. Se você incluiu o arquivo em um .order arquivo, exclua sua entrada do .order arquivo. Para obter mais informações, consulte Alterar a sequência de páginas, adicionar ou atualizar um arquivo .order.

Adicionar uma página ou páginas

Você pode adicionar as seguintes páginas ao seu wiki publicado:

• Adicionar um arquivo a uma pasta raiz ou subpasta do portal da Web
• Carregar arquivos para uma pasta raiz ou subpasta
• Adicionar ou atualizar um .order arquivo para especificar a sequência de páginas no sumário wiki

Cada atualização requer que você confirme suas alterações no repositório. Em seguida, você pode atualizar seu wiki para que seu repositório publicado revise as alterações.

Adicionar uma página a partir do portal da Web

1. Em Arquivos de Repositórios>ou Arquivos de Código>para o repositório publicado, selecione Ações e escolha Arquivo.

   

2. Digite um nome para a página, certifique-se de especificar o tipo de .md arquivo. O nome do arquivo deve corresponder ao título da página que você deseja que apareça no sumário, com traços no lugar de espaços. Especifique um título exclusivo de 235 caracteres ou menos. Os títulos de página diferenciam maiúsculas de minúsculas. Para obter mais informações sobre outras restrições de título, consulte Restrições de nomenclatura de título de página.

   Por exemplo, para adicionar uma página que aparece no sumário como Página 4, adicione um arquivo chamado Page-4.md.

   

3. Insira o conteúdo da página. Para obter mais informações, consulte Diretrizes de sintaxe para arquivos Markdown, widgets, wikis e comentários de solicitação pull.

4. Quando terminar, selecione Confirmar.

Carregar arquivos em uma pasta

1. Se você já tiver conteúdo definido, poderá carregá-lo em uma pasta. Selecione Ações e, em seguida, escolha Carregar arquivo(s).

   

2. Preencha o formulário de diálogo Confirmar , selecionando a pasta e os arquivos que deseja carregar.

   

Adicionar uma página pai e subpáginas

Para adicionar uma página pai, primeiro adicione um arquivo Markdown no nível da pasta raiz e, em seguida, adicione uma pasta com o mesmo rótulo.

1. Para adicionar uma pasta, selecione Pasta e preencha o formulário de diálogo Nova Pasta . Especifique pelo menos um arquivo para corresponder a uma subpágina na pasta.

   

2. Adicione todos os arquivos desejados como subpáginas à pasta.

Adicionar ou atualizar um arquivo .order

A última etapa quando você está adicionando arquivos ou pastas ao repositório wiki é adicionar ou atualizar o .order arquivo das pastas atualizadas. Essa ação reflete a sequência de páginas que você deseja mostrar no sumário. Para obter detalhes, consulte Alterar a sequência de páginas, adicionar ou atualizar um arquivo .order. Todos os arquivos que não estão listados no .order arquivo são adicionados ao final da lista alfabética, pois sua ordem é definida como int.MaxValue.

Alterar a sequência de páginas, adicionar ou atualizar um arquivo .order

Cada .order arquivo define a sequência de páginas contidas em uma pasta. O arquivo raiz .order especifica a sequência de páginas definidas no nível raiz. Para cada pasta, um .order arquivo define a sequência de subpáginas adicionadas a uma página pai.

1. Você pode adicionar um .order arquivo da mesma forma que adiciona qualquer arquivo da página Arquivos de Código>. Dê o nome .order para o arquivo.

2. Edite o conteúdo do arquivo para refletir a sequência de arquivos Markdown contidos na pasta. Cada entrada deve espelhar o nome do arquivo, mas sem o tipo de .md arquivo. Os títulos diferenciam maiúsculas de minúsculas, portanto, a entrada deve corresponder às maiúsculas e minúsculas usadas no nome do arquivo.

Por exemplo:

README
page-2
page-3
Page-4
Misc content

Definir uma home page

Por padrão, o primeiro arquivo que aparece na raiz dentro da ordem alfabética é definido como a home page wiki. Quando você seleciona Wiki no portal da Web, a home page é aberta.

1. Altere a home page definindo a sequência de páginas dentro do arquivo raiz .order .

Por exemplo, insira o nome da página na primeira linha.

New home page name here
page-2
page-3
Page-4
README
Misc content

Promover pasta a página

Para que uma pasta também seja uma página, você precisa de um arquivo Markdown com o mesmo nome da pasta, definido como um irmão para a pasta. Assim, tanto a pasta quanto o .md arquivo de mesmo nome devem estar um ao lado do outro.

Conforme exibido no exemplo a seguir, Test tem uma pasta e um .md arquivo, o que cria uma hierarquia dentro da árvore wiki.

Selecione uma versão wiki

Para selecionar uma versão wiki, escolha a versão nas opções de ramificação da página wiki.

Cancelar a publicação de um wiki de código

Se você não quiser mais que um repositório seja publicado como um wiki, você pode optar por cancelá-lo.

Aviso

Cancelar a publicação de um wiki cancela a publicação de todo o wiki de código, que inclui todas as versões do repositório que você publicou anteriormente.

1. Selecione o wiki que você deseja cancelar a publicação, abra o menu de contexto e selecione Cancelar publicação do wiki.

   

2. Confirme que você deseja cancelar a publicação do wiki escolhendo Cancelar publicação.

   

Artigos relacionados

• Siga uma página wiki e receba notificações
• Wiki provisionado x publicado
• Atualizar wiki offline
• Diretrizes básicas do Markdown