Wiki con provisioning e codice pubblicato come wiki

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

In Azure DevOps sono disponibili le opzioni seguenti per la gestione del contenuto wiki.

Sebbene entrambe le opzioni mantengano il contenuto wiki nei repository Git, il modo in cui si aggiunge, si aggiorna e si gestisce il contenuto wiki è diverso.

Nota

La funzionalità pubblica codice come wiki è attualmente disponibile in Azure DevOps Server 2018 e versioni successive. Per le versioni precedenti, è possibile effettuare il provisioning di un wiki solo per il progetto team.

Opzioni di menu pagina wiki

Con un wiki di cui è stato effettuato il provisioning, è possibile aggiungere e modificare le pagine direttamente all'interno del Wiki. Tutti gli aggiornamenti del contenuto a un wiki di cui è stato effettuato il provisioning vengono eseguiti all'interno del Wiki.

Con un codice di pubblicazione come wiki, è possibile aggiungere, modificare e aggiornare il contenuto da Repos o Code.

Le opzioni di menu non disponibili per le pagine wiki sono illustrate nella figura seguente. Come si può notare, diverse opzioni non sono supportate per la pubblicazione come pagine wiki del codice .

Wiki con provisioning

Opzioni di menu pagina wiki di cui è stato effettuato il provisioning.

Pubblicare codice come wiki

Opzioni di menu pubblica tabella codici.

Ad esempio, l'opzione Modifica in Repository per il codice di pubblicazione come wiki consente di accedere alla pagina Repository per modificare tale pagina specifica. Aggiornamenti creare una pagina nel ramo selezionato per il wiki viene pubblicata automaticamente nel wiki.

Funzionalità supportate e differenze operative

I wiki con provisioning e la pubblicazione come wiki di codice supportano le funzionalità seguenti:

La tabella seguente riepiloga le operazioni o le funzionalità che possono variare, a seconda del tipo wiki.

Aggiungere pagine

Per un wiki di cui è stato effettuato il provisioning o pubblicare codice come wiki, selezionare Nuova pagina o Aggiungi sottopagina. Per altre informazioni, vedere Aggiungere e modificare pagine wiki.

Sequenza di pagine ed elenco di pagine nel riquadro di spostamento

Il wiki di cui è stato effettuato il provisioning gestisce automaticamente la sequenza di pagine e l'elenco di pagine quando si aggiungono o si spostano pagine all'interno del riquadro di spostamento.

Per strutturare l'elenco di pagine nel riquadro di spostamento per un codice di pubblicazione come wiki, definire il file con estensione order nella radice e per ogni sottocartella o pagina padre contenente pagine secondarie.

Entrambi i tipi di wiki seguono la stessa struttura di file, è solo che il codice di pubblicazione come wiki richiede di mantenere manualmente la sequenza di pagina.

Per altre informazioni sull'uso dei file con estensione order , vedere File e struttura di file del repository Git wiki.

Revisioni delle pagine e ripristino di una versione precedente

Dal Wiki è possibile visualizzare le revisioni di qualsiasi pagina wiki scegliendo Revisioni o selezionando l'opzione di menu Visualizza revisioni .

Tuttavia, il processo di ripristino varia a seconda del tipo di pagina wiki.

  • Per una pagina wiki con provisioning , selezionare Ripristina, come descritto in Ripristinare un commit in una pagina wiki con provisioning
  • Per una pagina di pubblicazione come code wiki , lavorare da un ramo locale e inviare una richiesta pull per aggiornare il ramo da cui si sta lavorando.

Controllo delle versioni e annullamento della pubblicazione di un wiki

Con il controllo delle versioni è possibile pubblicare versioni di contenuto diverse in wiki distinti, in base a un ramo con controllo delle versioni di un repository Git. Il controllo delle versioni e l'annullamento della pubblicazione del contenuto pubblicato in precedenza in un wiki sono supportati solo per wiki creati pubblicando codice in un wiki.

Per altre informazioni, vedere Versione, selezione o annullamento della pubblicazione di un wiki pubblicato.

Eliminare il wiki del progetto

  1. Ottenere il wiki corrispondente all'ID wiki o al nome wiki specificato. Per altre informazioni, vedere Wiki - Ottenere l'API REST.

GET https://dev.azure.com/{organization}/{projec``t}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0

È anche possibile ottenere tutti i wiki in un progetto o in una raccolta. Per altre informazioni, vedere Wiki - Elencare l'API REST

  1. Eliminare il wiki corrispondente all'ID wiki o al nome wiki specificato. Per altre informazioni, vedere Wiki - Eliminare l'API REST.
DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0

Aggiornare un wiki lavorando offline

È possibile lavorare offline o in un ramo locale per aggiornare il contenuto per un wiki di cui è stato effettuato il provisioning e pubblicare come wiki di codice. Per altre informazioni, vedere Clonare e aggiornare le pagine wiki offline.