Kiépített wiki és kód wikiként közzétéve
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
A wikitartalmat 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ódként közzétett wikifunkció 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.
Kód wikiként közzétett tartalommal tartalmakat adhat hozzá, szerkeszthet és frissíthet az adattárakból vagy a Kódból.
Az alábbi képen egy kiépített wiki beállításai láthatók. Ezek közül a lehetőségek közül több nem támogatott a kódként közzétett wikioldalak esetében.
A kódként közzétett wiki Szerkesztés a Tárakban lehetőségével például az Adattár lapra léphet az adott lap szerkesztéséhez. A wikihez kiválasztott ág egyik lapjára tett frissítések automatikusan közzé lesznek 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:
- Markdown formátum
- HTML-címkék
- Képek beszúrása és átméretezése
- Matematikai jelölés és karakterek
- Hivatkozás munkaelemekre a következő használatával: #
- Fájlok csatolása
- Wikitartalmak szűrése
- Wikilap nyomtatása
- Tartalom frissítése offline állapotban
- Lapok hozzáadása vagy szerkesztése a wikiből
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.
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.
A kódként közzétett wikiként közzétett lapok listájának strukturálásához adja meg a fájlt a *.order*
gyökérkönyvtárban, valamint az aloldalakat tartalmazó almappákhoz vagy szülőoldalakhoz.
Mindkét wikitípus ugyanazt a fájlstruktúrát követi, csak a kódként közzétett wiki megköveteli az oldalütemezés manuális karbantartását.
A fájlok használatával .order
kapcsolatos további információkért tekintse meg 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 közzétett lap esetén 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 wikiket csak akkor lehet verziószámozni és közzétenni, ha ön hozta létre a wikiben lévő kód közzétételével. További információt a kód wiki közzétételének megszüntetése című témakörben talál.
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.
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ó.
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.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.