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.
Kommentar
Wiki-funktionen publicerad som kod ä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 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.
| Åtgärd | Etablerad wiki | Publicerad som kod-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 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
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.
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.
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.1returnerar alla wikis i projektet, så att du kan välja vilken som ska tas bort.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.