Wiki con provisioning e codice pubblicato come wiki

  • Articolo

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

In Azure DevOps è possibile gestire il contenuto wiki in un wiki del progetto team o in un wiki pubblicato come wiki del codice. Con un wiki pubblicato come codice, è possibile gestire diversi wiki con versione per supportare le esigenze di contenuto, anche se è disponibile solo se Azure Repos è abilitato.

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

Nota

Il codice di pubblicazione come funzionalità 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 del menu pagina Wiki

Con un wiki con provisioning, è possibile aggiungere e modificare pagine direttamente all'interno del wiki. Tutti gli aggiornamenti del contenuto a un wiki con provisioning vengono eseguiti all'interno del wiki.

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

L'immagine seguente mostra le opzioni per un wiki con provisioning. Molte di queste opzioni non sono supportate per la pubblicazione come tabelle wiki di codice.

Screenshot delle opzioni del menu pagina wiki con provisioning.

Ad esempio, l'opzione Modifica in Repository per il codice di pubblicazione come wiki consente di accedere alla pagina Repository per modificare la pagina specifica. Aggiornamenti che si crea in una pagina nel ramo selezionato per il wiki viene pubblicato automaticamente nel wiki.

Funzionalità supportate e differenze operative

Entrambi i tipi di wiki supportano le funzionalità seguenti:

La tabella seguente riepiloga le operazioni o le funzionalità che potrebbero essere diverse, a seconda del tipo di wiki.

Operazione Wiki con provisioning Pubblicare codice come wiki
Supporto di più wiki, nome wiki ✔️
Aggiungere o modificare pagine da File repos>o file di codice> ✔️
Ripristinare una revisione precedente dal Wiki ✔️
Ripristinare una revisione precedente da Repository o codice ✔️ ✔️
Gestire wiki con controllo delle versioni ✔️
Selezionare una versione wiki ✔️
Annullare la pubblicazione di un wiki di codice ✔️

Aggiungere pagine

Per entrambi i tipi di 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 con 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 gestire manualmente la sequenza di pagine.

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

Revisioni di pagina e ripristino di una versione precedente

Dal wiki è possibile visualizzare le revisioni di qualsiasi pagina wiki. Selezionare Revisioni o 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 wiki di pubblicazione come codice, 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 di un wiki sono supportati solo per i wiki creati pubblicando codice in un wiki. Per altre informazioni, vedere Pubblicare un wiki di codice/Annullare la pubblicazione di un wiki di codice.

Eliminare un wiki del progetto

Nota

Le API REST wiki non supportano l'eliminazione di un wiki del progetto. È quindi necessario eliminare il repository wiki.

  1. Clonare il repository wiki per eseguire il backup di tutto il contenuto. Altre opzioni hanno l'URL wiki clone, che può essere usato per clonare il wiki.

  2. Ottenere l'ID del repository Git che esegue il backup del wiki. È possibile usare l'API REST per ottenere tutti i wiki nel progetto.

    Ad esempio, restituisce GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 tutti i wiki del progetto, quindi è possibile scegliere quale eliminare.

  3. Usare l'API REST per eliminare il repository Git di backup. Usare l'ID repository del wiki del progetto trovato nel passaggio precedente e controllare l'ID del repository, in modo da non rimuovere quello errato.

    Ad esempio, DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Aggiornare un wiki offline

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