Adicionar e editar páginas de wiki
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Você pode adicionar um título e um conteúdo a uma página, depois que o repositório Git wiki for provisionado para o projeto de equipe. Há uma experiência de edição e visualização lado a lado em que você pode editar a página e visualizar o conteúdo conforme o uso.
Ao criar páginas usando o formato Markdown, você também pode usar o painel de formato para formatação rich text e inserção de imagens, anexos e links.
Ao editar a página, salve-a inserindo Ctrl+S. Para salvar com uma mensagem de revisão personalizada, selecione ao lado de Salvar. Para obter mais atalhos, consulte Atalhos de teclado para gerenciar páginas wiki.
Ferramentas de linha de comando wiki
Comandos | Descrição |
---|---|
az devops wiki show | Abrir um wiki |
az devops wiki page show | Obter o conteúdo de uma página ou abrir uma página |
az devops wiki page create | Adicionar uma nova página |
az devops wiki page update | Editar uma página |
az devops wiki page delete | Excluir uma página |
Observação
Para adicionar ou editar páginas a um wiki que você publicou de um repositório Git, consulte Publicar um repositório Git em um wiki. Este artigo aborda como adicionar e editar páginas de um wiki que você provisionou para um projeto de equipe.
Pré-requisitos
- Você deve ter um wiki provisionado.
- Você deve ser um membro do projeto de equipe como um contribuidor para adicionar ou atualizar páginas wiki.
- Você deve ter o nível de acesso Básico para editar o wiki do projeto.
Abrir o Wiki
Você pode abrir e visualizar uma página wiki para o seu projeto.
Conecte-se ao seu projeto usando um navegador da Web com suporte e escolha Wiki.
Se você precisar mudar seu projeto de equipe, escolha Azure DevOps para navegar por todos os projetos e equipes da equipe.
Adicionar uma página wiki
Para adicionar outra página, escolha Nova página. Ou, para adicionar uma subpágina, abra o menu de contexto de uma página existente e selecione Adicionar subpágina.
Especifique um título exclusivo de 235 caracteres ou menos. Os títulos de página diferenciam maiúsculas de minúsculas. Para outras restrições de título, consulte Arquivos de repositório Git wiki e estrutura de arquivos, Convenções de nomenclatura de arquivo.
Você também pode usar atalhos de teclado para adicionar uma nova página pressionando n ou adicionar uma subpágina pressionando c. Para obter uma lista completa de atalhos de teclado, consulte Atalhos de teclado para gerenciar páginas wiki.
Restrições de nomenclatura de título de página wiki
Cada página wiki corresponde a um arquivo no repositório Git wiki. Os nomes atribuídos a um título de página wiki devem estar em conformidade com as restrições a seguir.
Tipo de restrição | Restrição |
---|---|
Nome do arquivo | O caminho de página totalmente qualificado não deve exceder 235 caracteres. |
Exclusividade | Os títulos de página diferenciam maiúsculas de minúsculas e devem ser exclusivos dentro da hierarquia wiki. |
Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: / \ # .- Não deve iniciar ou terminar com um período . . |
Tamanho do arquivo | – Não deve exceder o máximo de 18 MB. |
– Tamanho do arquivo de anexo | Não deve exceder o máximo de 19 MB. |
Caracteres especiais em títulos de página wiki
Você pode especificar títulos de página que contêm um ou mais desses caracteres : < > * ? | -
especiais. Por exemplo, você pode nomear um arquivo Markdown como "Perguntas frequentes?" ou "Guia de configuração". Os caracteres têm as seguintes cadeias de caracteres codificadas em URI:
Caractere | Cadeia de caracteres codificada |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
%22 |
Editar e excluir páginas wiki
Para editar uma página wiki existente, abra a página e selecione Editar ou abra o menu de contexto e selecione Editar. Você também pode usar o atalho de teclado e para ir para a edição da página atual rapidamente.
Para wikis de código, você pode editar uma página no editor lado a lado, usando a barra de ferramentas markdown para criar seu conteúdo. Essa experiência é idêntica ao processo em um wiki de projeto. Você também pode editar páginas wiki no hub repos também usando a opção Editar em Repos.
Se o wiki de código tiver políticas de ramificação, selecione Editar em Repositórios para criar uma ramificação e continuar editando. A opção Editar em repositórios está disponível especificamente para wikis de código.
Para excluir uma página, abra o menu de contexto da árvore ou da página e selecione Excluir. Confirme a exclusão na caixa de diálogo aberta.
Observação
Ao excluir uma página, você também exclui todos os metadados e todas as suas subpáginas (se houver) na hierarquia.
Reordenar uma página wiki
Você pode reordenar páginas no modo de exibição de árvore wiki para que as páginas apareçam na ordem e na hierarquia desejadas. Você pode arrastar e soltar um título de página no modo de exibição de árvore para executar as seguintes operações:
- Altere a relação pai-filho de uma página.
- Altere a ordem da página dentro da hierarquia.
Observação
Mover uma página na hierarquia pode interromper links para ela de outras páginas. Você sempre pode corrigir os links manualmente depois de mover. Reordenar uma página dentro de uma hierarquia não afeta os links de página.
Você também pode usar atalhos de teclado para reordenar páginas. Selecione uma página e pressione CTRL + SETA PARA CIMA ou CTRL + SETA PARA BAIXO para alterar os pedidos de página. Para alterar a relação pai-filho de uma página, abra seu menu de contexto e selecione Mover. A caixa de diálogo Mover página é aberta. Selecione uma página pai na qual você pode mover a página atual.
Para obter uma lista completa de atalhos de teclado, consulte Atalhos de teclado para gerenciar páginas wiki.
Criar uma página na home page 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 arrastando e soltando a página na parte superior da árvore.