Wiki con provisioning e codice pubblicato come wiki

Azure DevOps Services | Azure DevOps Server 2020 | 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, aggiorna e gestisce il contenuto del 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 della 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 di un wiki di cui è stato effettuato il provisioning si verificano 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ò vedere, diverse opzioni non sono supportate per la pubblicazione come pagine wiki di codice.

Wiki con provisioning

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

Pubblicare il codice come wiki

Opzioni del menu Pubblica tabella codici

Ad esempio, l'opzione Repos per il codice di pubblicazione come wiki consente di accedere alla pagina del repo 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

I wiki di cui è stato effettuato il 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 di wiki.

Aggiungere pagine

Per un wiki di cui è stato effettuato il provisioning o pubblicare il codice come wiki, selezionare Nuova pagina o Aggiungi pagina secondaria. 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 che contiene 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 pagine.

Per altre informazioni sull'uso dei file con estensione order, vedere Wiki Git repository files and file structure (File del repository Git wiki e struttura dei file).

Revisioni di pagina 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 di cui è stato effettuato il provisioning, selezionare Ripristina, come descritto in Ripristinare un commit a una pagina wiki di cui è stato effettuato il provisioning
  • Per una pagina wiki pubblica 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 versione 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 i wiki creati pubblicando il codice in un wiki.

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

Eliminare il wiki del progetto

L'eliminazione di un wiki del progetto non è supportata con le API wiki, ma è possibile eliminare il repository wiki seguendo questa procedura.

  1. Clonare il repository wiki per eseguire un backup di tutto il contenuto. Selezionare il menu di scelta rapida e quindi selezionare Clone wiki (Clona wiki) e copiare l'URL clone.

    Clonare il repository wiki

  2. Ottenere l'ID del repository Git che supporta questo wiki. Usare questa API REST per ottenere tutti i wiki nel progetto.

    Ad esempio: GET https://dev.azure.com/fabrikam/_apis/wiki/wikis?api-version=4.1 Restituisce tutti i wiki nel progetto, "sampleProject". Qui è possibile ottenere l'ID repository del wiki che si vuole eliminare.

    Clonare il repository wiki e copiare l'URL

  3. Usare l'API REST seguente per eliminare il repository Git.

    Ad esempio: DELETE https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}?api-version=4.1 Usare l'ID repository del wiki del progetto trovato nel passaggio precedente. Assicurarsi che l'ID del repository corrisponda al wiki del progetto che si vuole rimuovere.

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.