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

2025-05-28

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 wiki som publiceras som kod kan du underhålla flera versionswikis för att tillgodose dina innehållsbehov. Det här alternativet är tillgängligt när du aktiverar Azure Repos.

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.

Underhålla wiki-innehåll

För båda typerna av wiki kan du arbeta direkt i GitHub eller arbeta offline och sedan skicka ändringarna till lagringsplatsen.

För en etablerad wiki lägger du till och underhåller wiki-sidor direkt i avsnittet Wiki>Pages på lagringsplatsen. Alla innehållsuppdateringar till en etablerad wiki sker inom själva wikin.

För en publicerad som kod-wiki lägger du till och underhåller wiki-innehåll som kodfiler på lagringsplatsen. Du kommer åt filerna i avsnitten Repos eller Code på lagringsplatsen på GitHub.

Följande bild visar menyalternativ för en etablerad wiki:

Vissa menyalternativ stöds inte för publicerade wiki-sidor med kod . För en publicerad som kodwiki öppnar alternativet Redigera i repo den aktuella sidan, så att du kan redigera innehållet direkt. Uppdateringar som du gör på en sida i den valda grenen för wikin publiceras automatiskt på wikin.

Lägga till wiki-sidor

Menyalternativen Ny sida och Lägg till undersida är tillgängliga för båda typerna av wiki i GitHub. Mer information finns i Lägga till och redigera wiki-sidor.

Justera sidsekvens och sidlista

Båda typerna av wiki använder samma mapp och filstruktur på Git-lagringsplatsen. Skillnaden ligger i hur du behåller sidsekvensen.

För en etablerad wiki hanterar GitHub sidsekvensen och sidlistan automatiskt när du lägger till eller flyttar sidor i navigeringsfönstret.

För att publicera som en kod-wiki måste du underhålla sidsekvensen manuellt. Om du vill strukturera listan över sidor i navigeringsfönstret definierar du en .order-fil i roten och för varje undermapp eller överordnad sida som innehåller undersidor. Mer information finns i Wiki Git-lagringsplatsfiler och filstruktur.

Visa sidrevisioner och återgå till tidigare version

Från Wiki-sidan för Git-lagringsplatsen kan du visa revisionerna av alla sidor i wikin. Använd menyalternativen Revisioner eller Visa revisioner . Om du vill återställa det aktuella sidinnehållet till en tidigare version skiljer sig processen beroende på wiki-sidtypen.

För en etablerad wiki-sida väljer du menyalternativet Återställ . Mer information finns i Återställa en incheckning till en etablerad wiki-sida.

För en sida publicerad som en kodwiki, arbetar du från en lokal gren och skickar en pull-begäran för att uppdatera den gren du arbetar från.

Använda versionshantering och avpublicera wikin

Med stöd för versionshantering kan du publicera olika innehållsversioner till distinkta wikis, baserat på en versionsgren av en Git-lagringsplats.

Du kan bara version och avpublicera en wiki om du är den användare som publicerade koden för att skapa wiki. Mer information finns i Avpublicera en kod-wiki.

Ta bort projekt-wiki

Följande steg beskriver hur du tar bort en projekt-wiki.

Kommentar

Du kan inte använda REST-API:et för att ta bort en projekt-wiki. Ta i stället bort wiki-lagringsplatsen direkt.

Klona wiki-lagringsplatsen för att säkerhetskopiera allt innehåll. Du hittar wiki-URL:en på menyn Fler alternativ (...).
Hämta Git-lagringsplatsens ID som är associerat med din wiki. Du kan använda REST-API:et för att hämta alla wikis i projektet.

Till exempel returnerar kommandot GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 alla wikis i projektet. Kör kommandot och välj den wiki som ska tas bort.
Ta bort Git-lagringsplatsen som är associerad med din wiki med hjälp av REST-API:et. Använd lagringsplats-ID:t för projekt-wikin som du hittade tidigare. Dubbelkolla lagringsplatsens ID för att se till att du inte tar bort fel wiki.

Kommandot DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 tar bort wikin. Ersätt <repositoryId> med lagringsplats-ID:t för wikin som ska tas bort.

Uppdatera wiki när du är offline

Du kan arbeta offline eller i en lokal gren för att uppdatera innehåll för båda typerna av wiki. Mer information finns i Klona och uppdatera wiki-sidor offline.

Utforska andra funktioner och åtgärder

Båda typerna av wiki stöder flera andra funktioner och åtgärder:

Några åtgärder och funktioner är bara tillgängliga för en typ av wiki eller så skiljer sig användningsmetoden åt:

Åtgärd	Tillhandahållen	Publicerad som kod
Stöd för flera wikis, namnge wiki		✔️
Lägga till eller redigera sidor från lagringsplatser> eller från Code>Files		✔️
Återgå till tidigare revision från Wiki-sidan	✔️
Återgå till tidigare ändringar via alternativ för repositories eller från kodalternativ	✔️	✔️
Underhålla versionshanterade wikis		✔️
Välj wiki-version		✔️
Ta bort publicering av kodwiki		✔️