Aggiungere e modificare pagine wiki

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

È possibile aggiungere un titolo e un contenuto a una pagina dopo il provisioning del repository Git wiki per il progetto team. È disponibile un'esperienza di modifica e anteprima affiancata in cui è possibile modificare la pagina e visualizzare in anteprima il contenuto man mano che si procede.

Mentre si creano pagine usando il formato Markdown, è anche possibile usare il riquadro formato per la formattazione RTF e l'inserimento di immagini, allegati e collegamenti.

Home page wiki

Quando si modifica la pagina, salvarla immettendo CTRL+S. Per salvare con un messaggio di revisione personalizzato, selezionare accanto a Salva. Per altre scelte rapide, vedere Tasti di scelta rapida per gestire le pagine wiki.

Salva pagina con un messaggio personalizzato

Strumenti da riga di comando wiki

Comandi Descrizione
az devops wiki show Aprire un wiki
az devops wiki page show Ottenere il contenuto di una pagina o aprire una pagina
az devops wiki page create Aggiungere una nuova pagina
az devops wiki page update Modificare una pagina
az devops wiki page delete Elimina una pagina

Nota

Per aggiungere o modificare pagine in un wiki pubblicato da un repository Git, vedere Pubblicare un repository Git in un wiki. Questo articolo illustra come aggiungere e modificare pagine di un wiki di cui è stato effettuato il provisioning per un progetto team.

Prerequisiti

  • È necessario disporre di un wiki di cui è stato effettuato il provisioning.
  • Per aggiungere o aggiornare le pagine wiki, è necessario essere membri del progetto team.
  • Per modificare il wiki del progetto, è necessario disporre del livello di accesso Di base.

Aprire il wiki

Connessione al progetto usando un Web browser supportato e scegliere Wiki.

Screenshot che mostra la selezione del menu Wiki evidenziata.

Se è necessario cambiare il progetto team, scegliere Azure DevOps per esplorare tutti i progetti e i team del team.

Aggiungere una pagina wiki

Per aggiungere un'altra pagina, scegliere Nuova pagina. In alternativa, per aggiungere una sottopagina, aprire il menu di scelta rapida di una pagina esistente e selezionare Aggiungi sottopagina.

Specificare un titolo univoco di 235 caratteri o meno. I titoli delle pagine fanno distinzione tra maiuscole e minuscole. Per altre restrizioni relative al titolo, vedere Wiki Git repository files and file structure, File naming conventions (Convenzioni di denominazione dei file).

Screenshot della prima pagina wiki.

È anche possibile usare i tasti di scelta rapida per aggiungere una nuova pagina premendo n o aggiungendo una sottopagina premendo c. Per un elenco completo dei tasti di scelta rapida, vedere Tasti di scelta rapida per gestire le pagine wiki.

Restrizioni di denominazione del titolo della pagina wiki

Ogni pagina di wiki corrisponde a un file all'interno del repository Git di wiki. I nomi assegnati a un titolo di pagina di wiki devono essere conformi alle restrizioni seguenti.

Tipo di restrizione Restrizione
Nome file Il percorso completo della pagina non deve superare 235 caratteri.
Univocità I titoli delle pagine fanno distinzione tra maiuscole e minuscole e devono essere univoci all'interno della gerarchia di wiki.
Caratteri speciali - Non devono contenere caratteri di controllo Unicode o caratteri surrogati.
- Non deve contenere i caratteri stampabili seguenti: / \ #.
- Non deve iniziare o terminare con un punto ..
Dimensione del file Non deve superare il massimo di 18 MB.
Dimensione dei file allegati Non deve superare il massimo di 19 MB.

Caratteri speciali nei titoli delle pagine wiki

È possibile specificare i titoli di pagina che contengono uno o più di questi caratteri : < > * ? | -speciali. Ad esempio, è possibile denominare un file Markdown come "Domande frequenti?" o "Guida di configurazione". I caratteri hanno le stringhe con codifica URI seguenti:

Carattere Stringa codificata
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" 22%

Modificare ed eliminare pagine wiki

Per modificare una pagina wiki esistente, aprire la pagina e selezionare Modifica oppure aprire il menu di scelta rapida e selezionare Modifica. È anche possibile usare i tasti di scelta rapida e per passare rapidamente alla modifica della pagina corrente.

Per i wiki di codice, è possibile modificare una pagina nell'editor affiancato, usando la barra degli strumenti markdown per creare il contenuto. Questa esperienza è identica al processo in un wiki del progetto. È anche possibile modificare le pagine wiki nell'hub Repos usando l'opzione Modifica in Repository.

Screenshot della pagina Modifica wiki.

Se il wiki del codice include criteri di ramo, selezionare Modifica in Repository per creare un ramo e continuare la modifica. L'opzione Modifica in Repository è specificamente disponibile per i wiki di codice.

Per eliminare una pagina, aprire il menu di scelta rapida dall'albero o quello all'interno della pagina e selezionare Elimina. Confermare l'eliminazione nella finestra di dialogo visualizzata.

Nota

Quando si elimina una pagina, si eliminano anche tutti i metadati e tutte le relative pagine secondarie (se presenti) nella gerarchia.

Riordinare una pagina wiki

È possibile riordinare le pagine all'interno della visualizzazione albero wiki in modo che le pagine vengano visualizzate nell'ordine e nella gerarchia desiderate. È possibile trascinare e rilasciare un titolo di pagina nella visualizzazione albero per eseguire le operazioni seguenti:

  • Modificare la relazione padre-figlio di una pagina.
  • Modificare l'ordine della pagina all'interno della gerarchia.

Nota

Lo spostamento di una pagina nella gerarchia può interrompere i collegamenti da altre pagine. È sempre possibile correggere manualmente i collegamenti dopo lo spostamento. Il riordinamento di una pagina all'interno di una gerarchia non ha alcun impatto sui collegamenti di pagina.

È anche possibile usare i tasti di scelta rapida per riordinare le pagine. Selezionare una pagina e premere CTRL+FRECCIA SU o CTRL+FRECCIA GIÙ per modificare gli ordini di pagina. Per modificare la relazione padre-figlio di una pagina, aprire il relativo menu di scelta rapida e selezionare Sposta. Verrà visualizzata la finestra di dialogo Sposta pagina . Selezionare una pagina padre in cui è possibile spostare la pagina corrente.

Spostare la pagina wiki nella gerarchia

Per un elenco completo dei tasti di scelta rapida, vedere Tasti di scelta rapida per gestire le pagine wiki.

Creare una pagina nella home page del wiki

Per impostazione predefinita, la prima pagina aggiunta quando si crea un wiki viene impostata come home page wiki. È possibile modificare la home page wiki se un'altra pagina diventa più pertinente trascinando e rilasciando la pagina nella parte superiore dell'albero.

Passaggi successivi