Etablerade wikis jämfört med publicerad kod som en wiki

  • Artikel

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

I Azure DevOps kan du underhålla ditt wiki-innehåll i en wiki för ett teamprojekt 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.

Kommentar

Publiceringskoden som wiki-funktion är för närvarande tillgänglig på Azure DevOps Server 2018 och senare versioner. För äldre versioner kan du bara etablera en wiki för ditt teamprojekt.

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 publiceringskod som 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 wiki-sidor för publicering som kod .

Skärmbild av menyalternativ för etablerad wiki-sida.

Till exempel tar alternativet Redigera i lagringsplatser för publiceringskoden som wiki 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:

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

Åtgärd Etablerad wiki Publicera kod som wiki
Stöd för flera wikis, namn wiki ✔️
Lägga till eller redigera sidor från lagringsfiler> eller kodfiler> ✔️
Återgå till en tidigare revision från Wiki ✔️
Återgå till en tidigare revision från lagringsplatser eller kod ✔️ ✔️
Underhålla versionshanterade wikis ✔️
Välj en wiki-version ✔️
Avpublicera en kod-wiki ✔️

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 publiceringskod som 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 publiceringskoden som wiki 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 wiki-sida för publicering som kod arbetar du från en lokal gren och skickar en pull-begäran om 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. Versionshantering och avpublicering av en wiki stöds endast för wikis som du har skapat genom att publicera kod på en wiki. Mer information finns i Publicera en kod-wiki/Avpublicera en kod-wiki.

Ta bort en projekt-wiki

Kommentar

Wiki REST API:er stöder inte borttagning av en projekt-wiki. Därför måste du ta bort wiki-lagringsplatsen i stället.

  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.