Clonar e atualizar conteúdo wiki offline

  • Artigo

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

Você pode atualizar suas páginas wiki offline da mesma forma que desenvolve código em um repositório Git.

Você pode usar qualquer cliente que desejar ou ferramentas de linha de comando git para atualizar seu wiki offline. Para obter detalhes sobre como trabalhar com repositórios Git e ferramentas com suporte, consulte Repositórios Git.

As etapas básicas para atualizar o conteúdo wiki offline são as seguintes:

  1. Clone seu repositório Git wiki para seu IDE local ou espaço de trabalho.
  2. Adicione arquivos ou pastas à sua ramificação git local.
  3. Atualize os arquivos .order para refletir suas páginas e subpáginas.
  4. Confirme e envie por push as atualizações feitas para sua ramificação git local.

Pré-requisitos

Execute as etapas a seguir para migrar páginas de Markdown de outro wiki para o wiki do projeto de equipe ou para o conteúdo que você publica como código em um wiki.

Clone seu wiki

Seu repositório wiki armazena páginas, imagens, anexos e a sequência de páginas e subpáginas. Clone seu wiki para começar.

  1. Inicie sessão no seu projeto (https://dev.azure.com/{Your_Organization/Your_Project}) e, em seguida, selecione o seu wiki.

  2. Abra o menu de contexto Mais ações e selecione Clonar wiki.

    Repositório Git wiki Clone

  3. Na caixa de diálogo Clonar repositório , selecione Copiar URL de clone para a área de transferência.

    Copie a url wiki

    Insira-o em seu navegador para visualizar os arquivos definidos na ramificação wikiMaster.

    Arquivos principais do Wiki

  4. Use a URL que você copiou para clonar o repositório no IDE que você usa. Para saber mais, confira um dos seguintes artigos:

Adicionar páginas ao repositório Git local

Nós criamos páginas usando o formato Markdown. Adicione um arquivo Markdown à ramificação local para cada página e subpágina que você deseja adicionar ao seu wiki.

Adicionar páginas

Para adicionar páginas na raiz da árvore wiki, adicione um arquivo Markdown na raiz do repositório Git.

  1. Para cada página que você deseja adicionar, crie um arquivo Markdown com o conteúdo da página e adicione-o na pasta raiz do repositório.

    Para o projeto de equipe CanaryBuilds, ele está na seguinte pasta:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Para adicionar páginas na raiz da árvore wiki, adicione um arquivo Markdown para cada página na raiz do repositório Git.

    Wiki da filial local Git repo

  3. Depois de adicionar todas as páginas que deseja adicionar na raiz, atualize o arquivo .order na raiz. Ele deve ter uma entrada para cada arquivo Markdown definido na raiz. Cada entrada deve corresponder ao título do arquivo com espaços substituídos por um traço.

    Por exemplo:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Adicionar subpáginas

  1. Crie uma pasta para a página pai e, em seguida, adicione arquivos Markdown para cada subpágina na pasta.

    Por exemplo, adicionamos os seguintes arquivos à pasta How-to-contribute. Essas subpáginas aparecem na página Como contribuir na wiki.

    Captura de tela das subpáginas.

  2. Adicione um arquivo .order na pasta com a ordem das subpáginas como elas devem aparecer no wiki. Para entender o uso do arquivo .order para sequenciar páginas, consulte Arquivos de repositório Wiki Git e estrutura de arquivos.

    Por exemplo, o arquivo tem as seguintes subpáginas:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Salve suas alterações

Quando terminar todas as atualizações, envie os arquivos para o repositório Git.

As páginas e subpáginas adicionadas aparecem imediatamente em seu wiki.

Árvore Wiki atualizada

Se houver algum erro no processo, as páginas aparecem em sua wiki com um sinal de aviso.

Aviso quando o arquivo .order não é atualizado corretamente.