Wiki con provisioning e pubblicato come wiki di codice

2025-05-28

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, puoi gestire diversi wiki con versione per supportare le tue esigenze di contenuto. Questa opzione è disponibile quando si abilita Azure Repos.

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.

Gestire il contenuto wiki

Per entrambi i tipi di wiki, è possibile lavorare direttamente in GitHub o lavorare offline e quindi eseguire il push delle modifiche nel repository.

Per un wiki di cui è stato effettuato il provisioning, è possibile aggiungere e gestire le pagine wiki direttamente all'interno della sezionePagine> del repository. Tutti gli aggiornamenti dei contenuti di un wiki fornito vengono eseguiti all'interno del wiki stesso.

Per un wiki pubblicato come codice, aggiungere e gestire il contenuto wiki come file di codice nel repository. È possibile accedere ai file all'interno delle sezioni Repos o Code del repository in GitHub.

L'immagine seguente mostra le opzioni di menu per un wiki configurato:

Alcune opzioni di menu non sono supportate per pagine wiki di codice pubblicate. Per un wiki pubblicato come codice, l'opzione Modifica in Repository apre la pagina corrente, in modo da poter modificare il contenuto sul posto. Gli aggiornamenti apportati a una pagina nel ramo selezionato per il wiki vengono pubblicati automaticamente nel wiki.

Aggiungere pagine wiki

Le opzioni di menu Nuova pagina e Aggiungi pagina secondaria sono disponibili per entrambi i tipi di wiki in GitHub. Per altre informazioni, vedere Aggiungere e modificare pagine wiki.

Regolare la sequenza di pagine e l'elenco di pagine

Entrambi i tipi di wiki applicano la stessa struttura di cartelle e file all'interno del repository Git. La differenza consiste nel modo in cui si gestisce la sequenza di pagine.

Per un wiki preconfigurato, GitHub gestisce automaticamente la sequenza e l'elenco delle pagine man mano che si aggiungono o si spostano pagine all'interno del riquadro di navigazione.

Per un wiki pubblicato come codice, è necessario gestire manualmente la sequenza di pagine. Per strutturare l'elenco di pagine nel riquadro di spostamento, definire un file con estensione order nella directory principale e per ogni sottocartella o pagina principale contenente pagine secondarie. Per altre informazioni, vedere File di repository Git wiki e struttura di file.

Visualizzare le revisioni della pagina e ripristinare la versione precedente

Dalla pagina Wiki per il repository Git è possibile visualizzare le revisioni di qualsiasi pagina all'interno del wiki. Usare le opzioni di menu Revisioni o Visualizza revisioni . Per ripristinare il contenuto della pagina corrente a una versione precedente, il processo varia a seconda del tipo di pagina wiki.

Per una pagina wiki configurata, selezionare l'opzione del menu Ripristina. Per ulteriori informazioni, vedere Annullare un commit in una pagina wiki provisionata.

Per una pagina wiki pubblicata come codice, si lavora da un ramo locale e si invia una pull request per aggiornare il ramo su cui stai lavorando.

Usare il controllo delle versioni e annullare la pubblicazione del wiki

Il supporto del controllo delle versioni consente di 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 è l'utente che ha pubblicato il codice per creare il wiki. Per altre informazioni, vedere Annullare la pubblicazione di un wiki di codice.

Eliminare il wiki del progetto

I passaggi seguenti descrivono come eliminare un wiki del progetto.

Nota

Non è possibile usare l'API REST per eliminare un wiki del progetto. Eliminare invece direttamente il repository wiki.

Clonare il repository wiki per eseguire il backup di tutto il contenuto. È possibile trovare l'URL wiki nel menu Altre opzioni (...).
Ottenere l'ID del repository Git associato al wiki. È possibile usare l'API REST per ottenere tutti i wiki nel progetto.

Ad esempio, il GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 comando restituisce tutti i wiki nel progetto. Eseguire il comando e scegliere il wiki da eliminare.
Eliminare il repository Git associato al wiki usando l'API REST. Usare l'ID repository del wiki del progetto che hai trovato in precedenza. Controllare l'ID del repository per assicurarsi di non rimuovere il wiki errato.

Ad esempio, il DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 comando elimina il wiki. Sostituire <repositoryId> con l'ID repository del wiki da eliminare.

Aggiornare wiki mentre è offline

È possibile lavorare offline o in un ramo locale per aggiornare il contenuto per entrambi i tipi di wiki. Per altre informazioni, vedere Clonare e aggiornare le pagine wiki offline.

Esplorare altre funzionalità e operazioni

Entrambi i tipi di wiki supportano diverse altre funzionalità e operazioni:

Alcune operazioni e funzionalità sono disponibili per un solo tipo di wiki o l'approccio di utilizzo è diverso:

Operazione	Sottoposto a provisioning	Pubblicato come codice
Supporto di più wiki, nome wiki		✔️
Aggiungere o modificare pagine da Repos>File o da Codice>file		✔️
Ripristinare la revisione precedente dalla pagina Wiki	✔️
Ripristina la revisione a una versione precedente dalle opzioni di Repos o dalle opzioni del codice	✔️	✔️
Gestire wiki con controllo delle versioni		✔️
Selezionare la versione wiki		✔️
Annullare la pubblicazione del wiki del codice		✔️