Clonare e aggiornare il contenuto wiki offline

2025-06-06

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

Il processo per l'aggiornamento offline del wiki equivale allo sviluppo di codice in un repository Git. È possibile usare gli strumenti da riga di comando git e client preferiti per aggiornare le pagine wiki offline. Per informazioni dettagliate sull'uso dei repository Git e degli strumenti supportati, vedere la documentazione git di Azure Repos.

I passaggi di base per aggiornare il contenuto wiki offline includono:

Clonare il repository Git wiki nell'ambiente di sviluppo interattivo locale (IDE) o nell'area di lavoro.
Aggiungere file o cartelle al ramo repository Git locale.
Aggiornare i file .order in modo da riflettere le modifiche della sequenza per le pagine e le pagine secondarie.
Eseguire il commit e il push degli aggiornamenti nel ramo Git locale.

Prerequisiti

Categoria	Requisiti
Accesso al progetto	Membro del progetto in cui si trovano i wiki. È possibile richiedere l'accesso dall'amministratore del progetto in base alle esigenze.
Autorizzazioni	- Membro del gruppo collaboratori. - Per pubblicare il codice come wiki, è necessaria l'autorizzazione Crea repository. Per impostazione predefinita, questa autorizzazione viene impostata per i membri del gruppo Amministratori progetto .
livelli di accesso	Almeno accesso Base .
Attività	- Comprendere la struttura sottostante del repository Git wiki. - Comprendere le differenze tra un wiki provisionato e un codice pubblicato come wiki.

Clonare il wiki

Il repository wiki archivia pagine, immagini, allegati e la sequenza di pagine e sottopagine. Clona il tuo wiki per iniziare.

Accedi al tuo progetto (https://dev.azure.com/<Organization>/<Project>).
Selezionare il wiki, quindi selezionare Altre azioni (...) >Clonare wiki:
Nella finestra di dialogo Clona repository selezionare l'icona Copia URL clone negli Appunti :
Incollare l'URL nel browser. Viene visualizzata la pagina del repository Git in cui è possibile visualizzare i file definiti nel ramo wikiMain. L'esempio seguente mostra i file nel repository Git per il progetto CanaryBuilds:

Importante

La funzionalità Genera credenziali Git è pianificata per la rimozione. Esaminare la documentazione di Autenticazione Git per tutti i metodi di autenticazione disponibili per le operazioni di clonazione Git.
Usare l'URL copiato per clonare il repository nell'IDE preferito. Per altre informazioni, vedere gli articoli seguenti:

Aggiungere pagine al repository Git locale

Le pagine del repository Git vengono formattate come file Markdown (md). Per ogni pagina da aggiungere al wiki, creare un file Markdown nel ramo locale. Dopo aver aggiunto le pagine, aggiornare il file .order per regolare la sequenza di pagine per includere le nuove pagine.

Aggiungere pagine

È possibile aggiungere pagine nella parte superiore della struttura wiki nella cartella radice (\) e anche in altre cartelle.

Creare il file Markdown (md) con il contenuto per la nuova pagina. Nella maggior parte dei casi, il nome del file corrisponde al titolo della pagina. Nel nome del file sostituire gli spazi nel titolo con trattini (-). Per altre informazioni sulla creazione di contenuto della pagina, vedere Aggiungere una pagina wiki.
Inserire il file nella cartella desiderata all'interno della struttura wiki nel ramo locale, ad esempio la cartella radice. La cartella radice dell'esempio di progetto CanaryBuilds è C:\Users\UserName\Source\Repos\CanaryBuilds.wiki:
Aggiornare il file con estensione order nella stessa cartella in cui è stato inserito il nuovo file di pagina. Il testo iniziale della voce per la pagina corrisponde al nome del file senza l'estensione Markdown (.md). L'esempio di progetto CanaryBuilds aggiunge la nuova pagina "Come contribuire", che corrisponde al testo della voce Come contribuire:
```
Welcome
Roadmap  
How-to-contribute  
Home  
Reference  
```
Per ulteriori informazioni sul file .order, vedere Sequenza di pagine e file .order.

Aggiungere pagine secondarie

È anche possibile creare pagine secondarie per una pagina nel wiki:

Creare una cartella da usare come pagina padre. Per altre informazioni, vedere File del repository e struttura di cartelle.
Creare il file Markdown per ogni pagina secondaria e posizionare il file nella cartella della pagina padre. L'esempio di progetto CanaryBuilds aggiunge la cartella How-to-contribute come pagina padre:
Creare un file con estensione order nella cartella della pagina padre per definire la sequenza per le pagine secondarie come devono essere visualizzate nel wiki. L'esempio mostra un possibile ordine di pagine secondarie:
```
Request-extensions  
Licensing  
Smoke-test  
Coding-guidelines  
```

Eseguire il push delle modifiche

Quando gli aggiornamenti locali sono pronti, eseguire il push dei file nel repository Git.

Le pagine aggiunte e le pagine secondarie vengono visualizzate immediatamente nel wiki. L'esempio seguente illustra gli aggiornamenti per il progetto CanaryBuilds:

Screenshot che mostra la struttura wiki aggiornata per il progetto CanaryBuilds.

Se si verificano errori nel processo, la pagina viene visualizzata nell'elenco dei file wiki con un simbolo di avviso :

Screenshot che mostra una pagina con un errore come indicato dal simbolo di avviso.

Condividi tramite