Klona och uppdatera wiki-innehåll offline

2025-06-06

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Processen för att uppdatera wiki offline är densamma som att utveckla kod på en Git-lagringsplats. Du kan använda de klient- och git-kommandoradsverktyg som du föredrar för att uppdatera dina wiki-sidor offline. Mer information om hur du arbetar med Git-lagringsplatser och verktyg som stöds finns i Git-dokumentationen för Azure Repos.

De grundläggande stegen för att uppdatera wiki-innehåll offline är:

Klona din Wiki Git-lagringsplats till din lokala interaktiva utvecklingsmiljö (IDE) eller arbetsyta.
Lägg till filer eller mappar i din lokala Git-lagringsplatsgren.
Uppdatera .order-filerna så att de återspeglar sekvensändringarna för sidor och undersidor.
Commit:a och pusha uppdateringarna till din lokala Git-gren.

Förutsättningar

Kategori	Krav
Projektåtkomst	Medlem i projektet där wiki-filerna finns. Du kan begära åtkomst från projektadministratören efter behov.
behörigheter	- Medlem i -gruppen bidragsgivare. – Om du vill publicera kod som wiki skapar du behörigheten Skapa lagringsplats . Som standard anges den här behörigheten för medlemmar i gruppen projektadministratörer.
Åtkomstnivåer	Minst grundläggande åtkomst.
Uppgifter	- Förstå den underliggande strukturen för din Wiki Git-lagringsplats. – Förstå skillnaderna mellan en etablerad wiki och en publicerad kod som wiki.

Klona din wiki

Wiki-lagringsplatsen lagrar sidor, bilder, bifogade filer och sekvensen med sidor och undersidor. Klona wikin för att börja.

Logga in på projektet (https://dev.azure.com/<Organization>/<Project>).
Välj din wiki och välj sedan Fler åtgärder (...) >Klona wiki:
I dialogrutan Klona lagringsplats väljer du ikonen Kopiera klonings-URL till Urklipp :
Klistra in URL:en i webbläsaren. Sidan Git-lagringsplats öppnas där du kan visa de filer som definierats under wikiMain-grenen. I följande exempel visas filerna i Git-lagringsplatsen för CanaryBuilds-projektet:

Viktig

Funktionen Generera Git-autentiseringsuppgifter planeras att tas bort. Läs dokumentationen för Git-autentisering för alla autentiseringsmetoder som är tillgängliga för git-kloningsåtgärder.
Använd den URL som du kopierade för att klona lagringsplatsen i önskad IDE. Mer information finns i följande artiklar:

Lägga till sidor i din lokala Git-lagringsplats

Git-lagringsplatsens sidor formateras som Markdown-filer (.md). För varje sida som du vill lägga till i din wiki skapar du en Markdown-fil i din lokala gren. När du har lagt till sidor uppdaterar du .order-filen för att justera sidsekvensen så att den innehåller de nya sidorna.

Lägg till sidor

Du kan lägga till sidor överst i wiki-strukturen i rotmappen (\) och även i andra mappar.

Skapa Markdown-filen (.md) med innehållet för den nya sidan. I de flesta fall matchar filnamnet sidrubriken. I filnamnet ersätter du alla blanksteg i rubriken med bindestreck (-). Mer information om hur du skapar sidinnehåll finns i Lägg till en wiki-sida.
Placera filen i önskad mapp i wiki-strukturen i din lokala gren, till exempel rotmappen. Rotmappen för CanaryBuilds-projektet är C:\Users\UserName\Source\Repos\CanaryBuilds.wiki:
Uppdatera .order-filen i samma mapp där du placerade den nya sidfilen. Starttexten för sidan är filnamnet utan Markdown-tillägget (.md). I projektexemplet CanaryBuilds läggs den nya sidan "How to contribute" till, vilket motsvarar posttexten How-to-contribute:
```
Welcome
Roadmap  
How-to-contribute  
Home  
Reference  
```
Mer information om .order-filen finns i Sidsekvens och .order-filen.

Lägg till undersidor

Du kan också skapa undersidor för en sida i wikin:

Skapa en mapp som ska fungera som överordnad sida. Mer information finns i Lagringsplatsfiler och mappstruktur.
Skapa Markdown-filen för varje undersida och placera filen i den överordnade sidmappen. Projektexemplet CanaryBuilds lägger till mappen How-to-contribute som överordnad sida:
Skapa en .order-fil i den överordnade sidmappen för att definiera sekvensen för undersidorna som de ska visas i wikin. Exemplet visar en möjlig ordning på undersidor:
```
Request-extensions  
Licensing  
Smoke-test  
Coding-guidelines  
```