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.
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:
- Formato Markdown
- Tag HTML
- Inserire e ridimensionare immagini
- Notazione matematica e caratteri
- Collegamento a elementi di lavoro tramite #
- Allega file
- Filtrare il contenuto wiki
- Stampare una pagina Wiki
- Aggiornare il contenuto offline
- Aggiungere o modificare pagine dal wiki
La tabella seguente riepiloga le operazioni o le funzionalità che potrebbero essere diverse, a seconda del tipo di wiki.
| Operazione | Wiki con provisioning | Pubblicato come wiki del codice |
|---|---|---|
| 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 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.
- Per una pagina wiki con provisioning, selezionare Ripristina, come descritto in Ripristinare un commit in una pagina wiki con provisioning
- Per una pagina wiki pubblicata 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. È 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.
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.
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.1tutti i wiki del progetto, quindi è possibile scegliere quale eliminare.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.