Kiépített wikik és közzétett kód wikiként

  • Cikk

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

Az Azure DevOpsban a wikitartalmakat egy csapatprojekt wikijében vagy egy kód wikiként közzétett wikiben tarthatja fenn. Kód wikiként közzétett wikiként több verziójú wikit is fenntarthat, hogy támogassa a tartalomigényeket, bár csak akkor érhető el, ha az Azure Repos engedélyezve van.

Bár mindkét lehetőséggel Git-adattárakban kezelhetők a wikitartalmak, a hozzáadásuk, frissítésük és felügyeletük módja eltér.

Feljegyzés

A közzétételi kód wikiként funkció jelenleg az Azure DevOps Server 2018-as és újabb verzióiban érhető el. Régebbi verziók esetén csak wikit hozhat létre a csapatprojekthez.

Wikilap menübeállításai

Kiépített wikivel közvetlenül a wikin belül adhat hozzá és szerkeszthet lapokat. A kiépített wiki összes tartalomfrissítése a wikin belül történik.

Ha egy közzétételi kódot wikiként hoz létre, hozzáadhat, szerkeszthet és frissíthet tartalmakat a Tárakból vagy a Kódból.

Az alábbi képen egy kiépített wiki beállításai láthatók. Ezen lehetőségek közül számos nem támogatott a kód wikilapként való közzétételéhez.

Képernyőkép a kiépített wikilap menüjének beállításairól.

Például a közzétételi kód Szerkesztés a tárakban beállításával wikiként a Tár lapra lépve szerkesztheti az adott lapot. Frissítések, amelyet a wiki számára kijelölt ág egyik lapjára készít, automatikusan közzé lesz téve a wikiben.

Támogatott funkciók és működési különbségek

Mindkét wikitípus támogatja a következő funkciókat:

Az alábbi táblázat összefoglalja azokat a műveleteket vagy funkciókat, amelyek a wiki típusától függően eltérhetnek.

Művelet Kiépített wiki Kód közzététele wikiként
Több wiki támogatása, wiki elnevezése ✔️
Lapok hozzáadása vagy szerkesztése a tárfájlokból> vagy a kódfájlokból > ✔️
Visszaállítás a wiki egy korábbi változatára ✔️
Visszaállítás korábbi változatra az adattárakból vagy a kódból ✔️ ✔️
Verziószámozott wikik karbantartása ✔️
Wikiverzió kiválasztása ✔️
Kód wiki közzétételének megszüntetése ✔️

Lapok hozzáadása

Mindkét wikitípus esetében válassza az Új lap vagy az Allap hozzáadása lehetőséget. További információ: Wikilapok hozzáadása és szerkesztése.

Oldalütemezés és oldallista a navigációs ablakban

A kiépített wiki automatikusan kezeli az oldalütemezést és a laplistát, amikor oldalakat ad hozzá vagy helyez át a navigációs panelen.

Ha wikiként szeretné strukturálni a közzétételi kód lapjainak listáját a navigációs ablakban, adja meg a .order fájlt a gyökérwebhelyen, valamint az aloldalakat tartalmazó almappákhoz vagy szülőoldalakhoz.

Mindkét wikitípus ugyanazt a fájlstruktúrát követi, csak a wikiként megadott közzétételi kód megköveteli a lapütemezés manuális karbantartását.

A .order fájlok használatával kapcsolatos további információkért lásd a Wiki Git-adattár fájljait és fájlstruktúráját.

Lapváltozatok és visszaállítás egy korábbi verzióra

A wikiben bármely wikilap korrektúráit megtekintheti. Válassza a Korrektúra vagy a Változatok megtekintése menüt.

A visszaállítási folyamat azonban a wikilap típusától függően eltérő.

  • Kiépített wikioldalak esetén válassza a Visszaállítás lehetőséget a véglegesítés visszaállítása kiépített wikilapra című cikkben leírtak szerint.
  • Kód wikilapként való közzétételhez dolgozzon egy helyi ágból, és küldjön lekéréses kérelmet a használt ág frissítéséhez.

Wiki verziószámozása és közzétételének megszüntetése

A verziószámozással különböző tartalomverziókat tehet közzé különböző wikikben a Git-adattár egy verziószámozott ága alapján. A wikik verziószámozása és közzétételének megszüntetése csak a kód wikiben való közzétételével létrehozott wikik esetében támogatott. További információ: Kód wiki közzététele/Kód wiki közzétételének megszüntetése.

Projekt wiki törlése

Feljegyzés

A Wiki REST API-k nem támogatják a projekt wikijének törlését. Ezért ehelyett törölnie kell a wikiadattárat.

  1. Klónozza a wikiadattárat az összes tartalom biztonsági mentéséhez. A További lehetőségek a wiki klónozási URL-címével rendelkezik, amely a wiki klónozására használható.

  2. Szerezze be a wikit tartalmazó Git-adattár azonosítóját. A REST API-val lekérheti a projekt összes wikijét.

    Például GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 a projekt összes wikijét visszaadja, így kiválaszthatja, hogy melyiket törölje.

  3. A REST API használatával törölje a háttérbeli Git-adattárat. Használja az előző lépésben talált projekt wiki adattárazonosítóját, és ellenőrizze duplán az adattár azonosítóját, hogy ne távolítsa el a rosszat.

    Például: DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Wiki offline frissítése

Offline vagy helyi ágon is dolgozhat a kiépített wiki tartalmának frissítéséhez és kód wikiként való közzétételéhez. További információ: Wikilapok klónozása és frissítése offline állapotban.