Etablerad wiki jämfört med publicerad som kod-wiki

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

Du kan underhålla ditt wiki-innehåll i en gruppprojekt-wiki eller en publicerad som kod-wiki. Med en publicerad som kod-wiki kan du underhålla flera versions-wikis för att stödja dina innehållsbehov, även om den endast är tillgänglig om Azure Repos är aktiverat.

Wiki-innehållet behålls i Git-lagringsplatser med båda alternativen, men det är olika sätt att lägga till, uppdatera och hantera wiki-innehållet.

Menyalternativ för Wiki-sida

Med en etablerad wiki kan du lägga till och redigera sidor direkt i wikin. Alla innehållsuppdateringar till en etablerad wiki sker inom wikin.

Med en publicerad som kod-wiki kan du lägga till, redigera och uppdatera innehåll från lagringsplatser eller kod.

Följande bild visar alternativ för en etablerad wiki. Flera av dessa alternativ stöds inte för publicerade wiki-sidor med kod .

Alternativet Redigera i lagringsplatser för den publicerade kod-wikin tar dig till sidan Lagringsplats för att redigera den specifika sidan. Uppdateringar som du gör på en sida i den gren som du valde för wikin publiceras automatiskt på wikin.

Funktioner som stöds och driftsskillnader

Båda typerna av wiki stöder följande funktioner:

• Markdown-format
• HTML-taggar
• Infoga och ändra storlek på bilder
• Matematisk notation och tecken
• Länka till arbetsobjekt med hjälp av #
• Bifoga filer
• Filtrera Wiki-innehåll
• Skriva ut en Wiki-sida
• Uppdatera innehåll offline
• Lägga till eller redigera sidor från Wiki

I följande tabell sammanfattas de åtgärder eller funktioner som kan skilja sig åt beroende på wiki-typ.

Lägg till sidor

För båda typerna av wiki väljer du Ny sida eller Lägg till undersida. Mer information finns i Lägga till och redigera wiki-sidor.

Sidsekvens och sidlista i navigeringsfönstret

Den etablerade wikin hanterar sidsekvensen och sidlistan automatiskt när du lägger till eller flyttar sidor i navigeringsfönstret.

Om du vill strukturera listan över sidor i navigeringsfönstret för en publicerad som kod-wiki definierar du *.order* filen i roten och för varje undermapp eller överordnad sida som innehåller undersidor.

Båda typerna av wikis följer samma filstruktur, det är bara det att den publicerade som kod-wikin kräver att du underhåller sidsekvensen manuellt.

Mer information om hur du arbetar med .order filer finns i Wiki Git-lagringsplatsfiler och filstruktur.

Sidrevisioner och återgå till en tidigare version

Från wikin kan du visa revisioner av alla wiki-sidor. Välj Revisioner eller menyalternativet Visa revisioner .

Men återställningsprocessen skiljer sig beroende på wiki-sidtypen.

• För en etablerad wiki-sida väljer du Återställ enligt beskrivningen i Återställ en incheckning till en etablerad wiki-sida
• För en publicerad som kod-wiki-sida arbetar du från en lokal gren och skickar en pull-begäran för att uppdatera den gren som du arbetar från.

Versionshantering och avpublicering av en wiki

Med versionshantering kan du publicera olika innehållsversioner till olika wikis, baserat på en versionsgren av en Git-lagringsplats. Du kan endast version och avpublicera en wiki om det var du som skapade den genom att publicera kod på en wiki. Mer information finns i Avpublicera en kod-wiki.

Ta bort en projekt-wiki

1. Klona wiki-lagringsplatsen för att säkerhetskopiera allt dess innehåll. Alternativen Fler har wiki-URL:en för kloning, som kan användas för att klona wikin.

2. Hämta git-lagringsplatsens ID som stöder din wiki. Du kan använda REST-API:et för att hämta alla wikis i projektet.

   Till exempel GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 returnerar alla wikis i projektet, så att du kan välja vilken som ska tas bort.

3. Använd REST-API:et för att ta bort den säkerhetskopierade Git-lagringsplatsen. Använd lagringsplats-ID:t för den projekt-wiki som du hittade i föregående steg och dubbelkolla lagringsplatsens ID, så att du inte tar bort fel.

   Till exempel: DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Uppdatera en wiki offline

Du kan arbeta offline eller i en lokal gren för att uppdatera innehåll för en etablerad wiki och publicera som kod-wiki. Mer information finns i Klona och uppdatera wiki-sidor offline.

Relaterade artiklar

• Skapa en wiki för ditt teamprojekt
• Wiki Git-lagringsplatsfiler och filstruktur
• Publicera en Git-lagringsplats till en wiki
• Kom igång med Git