Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Depois de configurar um repositório Git wiki para seu projeto de equipe, você pode adicionar um título para o conteúdo wiki e de página. A interface do usuário do Azure DevOps fornece uma experiência lado a lado em que você pode editar páginas e visualizar suas alterações enquanto trabalha.
No painel Editar , insira o conteúdo da página usando a sintaxe de formato Markdown. Você também pode inserir imagens, anexos e links. À medida que você faz alterações, o conteúdo é atualizado no painel Visualização . Conteúdo com formatação especial como títulos, listas, links e imagens são exibidos como rich-text no painel Visualização .
Ao editar a página, use o atalho de teclado Ctrl+S para salvar rapidamente seu trabalho. Você também pode salvar seu trabalho com uma mensagem de revisão personalizada, como "Adicionados links de página". Essa opção está disponível no menu suspenso Salvar
.
Outros atalhos de teclado estão disponíveis. Para obter mais informações, consulte atalhos de teclado para gerenciar páginas wiki.
Observação
Este artigo descreve como adicionar e editar páginas em um wiki criado para um projeto de equipe. Se você quiser adicionar ou editar páginas a um wiki publicado de um repositório Git, consulte Publicar um repositório Git em um wiki.
Ferramentas de linha de comando wiki
Você pode usar comandos da CLI do Azure DevOps para gerenciar seu conteúdo wiki. A tabela a seguir fornece links para seções neste artigo que descrevem como trabalhar com comandos específicos.
| Comando | Descrição |
|---|---|
| az devops wiki show | Abra o wiki e mostre a página inicial do wiki. |
| az devops wiki page show (mostrar página do wiki no az devops) | Mostrar uma página específica no wiki. |
| az devops wiki página criar | Adicione uma nova página ao wiki. |
| az devops atualização de página wiki | Edite uma página existente no wiki. |
| az devops wiki página excluir | Exclua uma página no wiki. |
Pré-requisitos
| Categoria | Requisitos |
|---|---|
| Acesso ao Projeto | Membro do projeto em que o wiki está localizado. Você pode solicitar acesso do administrador do projeto, conforme necessário. |
| Permissões | Membro do grupo Colaboradores. |
| Níveis de Acesso | No mínimo, acesso Básico. |
| Tarefas | Prepare um wiki provisionado para seu projeto. |
Abrir o Wiki
Você pode abrir e exibir a página wiki do projeto de equipe do Azure DevOps no navegador ou usar a CLI do Azure DevOps.
Conecte-se ao seu projeto usando um navegador da Web com suporte e selecione Wiki:
Se você precisar mudar seu projeto de equipe, selecione 
Azure DevOps para navegar por todos os projetos e equipes da equipe.
Adicionar uma página wiki
Esta seção descreve como adicionar uma página ao wiki. Você pode trabalhar diretamente com a interface do usuário do Azure DevOps no navegador ou usar a CLI do Azure DevOps.
Para adicionar uma nova página ao wiki, você tem duas opções. Comece selecionando uma página na lista, como a home page.
Para adicionar uma página no mesmo nível da página atual, selecione Nova página na parte inferior da interface do usuário do Azure DevOps.
Para adicionar uma subpágina à página atual, selecione Mais opções (...) >Adicionar subpágina.
Você também pode usar atalhos de teclado para adicionar páginas. Selecione a página atual e adicione uma nova página selecionando n ou adicione uma subpágina selecionando c. Para obter mais informações, consulte atalhos de teclado para gerenciar páginas wiki.
Nome do arquivo e título da página
Insira um título exclusivo para a página. O valor é sensível a maiúsculas e minúsculas. O título é usado como o nome do arquivo para a página. No nome do arquivo, os espaços no título da página são substituídos por hifens (-). Por exemplo, o título da página "Como contribuir" corresponde ao nome do arquivo How-to-contribute.md. O caminho totalmente qualificado para o arquivo deve ter 235 caracteres ou menos.
Para obter outras restrições de nome de arquivo, consulte arquivos de repositório Git wiki e estrutura de arquivos, convenções de nomenclatura de arquivo.
Restrições de nome de arquivo e título de página
Cada página wiki corresponde a um arquivo no repositório Git wiki. As seguintes restrições se aplicam aos nomes de arquivo de página e ao tamanho do arquivo:
Nome do arquivo: ao escolher um nome para o arquivo de página, tenha em mente que o caminho totalmente qualificado para o arquivo deve ter 235 caracteres ou menos. O caminho completo para a página consiste na URL do repositório, no caminho da pasta para o arquivo de página e no nome do arquivo de página. Por exemplo,
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.Exclusividade: o nome do arquivo de página deve ser exclusivo em seu local de pasta na hierarquia de repositório wiki. O nome diferencia maiúsculas de minúsculas.
Caracteres especiais: o nome do arquivo de página tem restrições sobre os seguintes caracteres especiais:
- Sem caracteres de controle Unicode ou caracteres alternativos
- Sem caracteres imprimíveis: barra
/para frente, barra traseira\, hash# - Nenhum símbolo de ponto
.no início ou no final do nome
Tamanho do arquivo: o tamanho máximo do arquivo de página é de 18 MB.
Tamanho do arquivo de anexo: o tamanho máximo de qualquer anexo a um arquivo de página é de 19 MB.
Caracteres especiais permitidos
Vários caracteres especiais são permitidos no nome de arquivo de uma página, como dois-pontos : e hífen -. Por exemplo, você pode nomear um arquivo Markdown como Perguntas Frequentes:0525 ou Guia de Instalação.
Importante
Para evitar erros na sintaxe da página e na navegação do navegador, não use o caractere de espaço ( ) em nomes de arquivo de página. Se você nomear seus arquivos de página com base no título da página, substitua todos os espaços no título da página por um hífen (-) no nome do arquivo.
A tabela a seguir lista os caracteres especiais permitidos em nomes de arquivo de página wiki e a cadeia de caracteres codificada em URI correspondente:
| Caractere | Símbolo | Cadeia de caracteres de URI |
|---|---|---|
| Cólon | : |
%3A |
| Colchete de ângulo esquerdo | < |
%3C |
| Colchete de ângulo reto | > |
%3E |
| Asterisco (curinga) | * |
%2A |
| Ponto de interrogação | ? |
%3F |
| Tubo | | |
%7C |
| Hífen (traço) | - |
%2D |
| Aspas duplas | " |
%22 |
Por exemplo, o nome do arquivo FAQ:0525 é codificado como FAQ%3A0525.
Definir a página inicial do wiki
Por padrão, a primeira página que você adiciona ao criar um wiki é definida como a home page wiki. Você poderá alterar sua home page wiki se outra página se tornar mais relevante. Para obter mais informações, consulte Reordenar ou mover páginas wiki.
Editar e excluir páginas wiki
Esta seção descreve como editar ou excluir uma página no wiki. Você pode trabalhar diretamente com a interface do usuário do Azure DevOps no navegador ou usar a CLI do Azure DevOps.
Há várias maneiras de editar uma página wiki existente no navegador:
- Abra a página wiki e selecione Editar.
- Abra a página wiki e use o atalho de teclado e.
- Selecione a página wiki na lista de páginas e selecione Mais opções (...) >Editar.
Para obter mais informações sobre funções de edição específicas, consulte Usar diretrizes de Markdown.
Editar em Repos para wikis de código
Ao publicar o código como wiki, você pode editar as páginas wiki no hub Repos. A mesma experiência de editor lado a lado está disponível com as opções de formatação da barra de ferramentas Markdown. Selecione Editar>Editar em Repos para criar um branch e continuar a editar:
A opção Editar no Repos está disponível apenas para wikis de código que têm políticas de branch habilitadas. Se você não vir a opção, pode ser porque o wiki não é um wiki de código ou as políticas de branch não estão habilitadas. Para saber mais, confira Políticas e configurações de branch.
Excluir página wiki no navegador
Para excluir uma página wiki, selecione a página wiki na lista de páginas e selecione Mais opções (...) >Excluir. Você também pode selecionar Excluir no menu de contexto ao clicar com o botão direito na página.
Depois de selecionar Excluir, confirme a exclusão na caixa de diálogo.
Observação
Ao excluir uma página wiki, você também exclui todos os metadados da página e todas as subpáginas anexadas à página.
Reordenar ou mover páginas wiki
No navegador, você pode reordenar páginas no modo de exibição de árvore wiki para que as páginas sejam exibidas em sua sequência preferida. A sequência padrão é alfabética pelo nome do arquivo. Você pode alterar a sequência para reordenar páginas por artigo, categoria ou público-alvo pretendido.
Você pode usar a ação arrastar e soltar em títulos de página na visualização em árvore para realizar as seguintes tarefas:
Mover: Mudar a relação de página/subpágina de uma página. Se você mover uma página dentro da sequência wiki, os links para a página de outras páginas wiki poderão ser interrompidos. Você pode corrigir manualmente esses links depois de mover a página.
Reordenar: altere a ordem de uma página dentro da sequência wiki. A reordenação de páginas na sequência wiki não afeta links de página.
Corrigir links quebrados após movimentações de página
Para corrigir um link quebrado depois de mover uma página na sequência wiki, siga estas etapas:
Teste as outras páginas no wiki e procure links para a página movida.
Verifique se há mensagens de erro na página ou conteúdo ausente.
Abra a página que tem um link desfeito, selecione Editar e vá para o link quebrado no conteúdo da página.
Para localizar o link quebrado no conteúdo, você pode pesquisar o nome da página movida, o caminho do arquivo original da página movida ou o texto do link para o link interrompido.
Atualize o link desfeito. A correção típica é alterar a URL ou o caminho no link para direcionar o novo local para a página movida.
Salve suas alterações na página para que o link seja atualizado.
Abra a página atualizada no navegador e teste o link. Confirme que a página movida é aberta com sucesso.
Alterar a ordem das páginas de nível superior
Você pode usar atalhos de teclado para reordenar páginas de nível superior na sequência wiki. Essa ação não funciona para subpáginas.
Selecione uma página na lista de páginas wiki e use o atalho CTRL + SETA PARA CIMA ou CTRL + SETA PARA BAIXO para mover a página dentro da sequência. A alteração se aplica imediatamente.
Alterar a ordem de página/subpágina
Você também pode alterar a ordem de página/subpágina para qualquer página na sequência wiki.
Selecione a página que você deseja mover na lista de páginas wiki.
Selecione Mais opções (...) >Mover, que abre a caixa de diálogo Mover página .
Na caixa de diálogo Mover página, selecione a página que servirá como a nova página pai.
Depois de selecionar a nova página pai, o sistema verifica se há possíveis links interrompidos com base na movimentação da página. Ele relata os links que precisam ser ajustados:
Selecione a opção Atualizar links afetados em páginas e itens de trabalho (recomendado) e selecione Mover para concluir a movimentação da página.
Para obter uma lista completa de atalhos de teclado, consulte Atalhos de teclado para gerenciar páginas wiki.