Condividi tramite


Wiki con provisioning e pubblicato come wiki di codice

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

È 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

La funzionalità pubblicata come wiki del codice è 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 wiki pubblicato come codice, è 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 wiki pubblicato come codice consente di accedere alla pagina Repository per modificare la pagina specifica. Gli aggiornamenti apportati a una pagina nel ramo selezionato per il wiki vengono pubblicati 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.

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 wiki pubblicato come codice, definire il *.order* file 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 wiki pubblicato come codice richiede di mantenere manualmente la sequenza di pagine.

Per altre informazioni sull'uso dei .order file, 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.

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. È possibile eseguire la versione e annullare la pubblicazione di un wiki solo se si è quelli che lo hanno creato pubblicando il codice in un wiki. Per altre informazioni, vedere 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.