Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Miután beállított egy wiki Git-adattárat a csapatprojekthez, hozzáadhat egy címet a wikihez és a lap tartalmához. Az Azure DevOps felhasználói felülete egy egymás melletti felületet biztosít, ahol szerkesztheti a lapokat, és munka közben megtekintheti a módosításokat.
A Szerkesztés panelen írja be a lap tartalmát Markdown formátumszintaxissal. Képeket, mellékleteket és hivatkozásokat is beszúrhat. A módosítások végrehajtásakor a tartalom az Előnézet panelen frissül. A speciális formázású tartalmak, például címsorok, listák, hivatkozások és képek rich text formátumban jelennek meg az Előnézet panelen.
A lap szerkesztése közben a Ctrl+S billentyűparanccsal gyorsan mentheti a munkáját.
A munkáját úgy is mentheti, hogy egy egyéni korrektúraüzenetet használ, például a "Hozzáadott oldalhivatkozásokat". Ez a lehetőség a Mentés
legördülő menüben érhető el:
Egyéb billentyűparancsok is elérhetők. További információ: Billentyűparancsok a wikilapok kezeléséhez.
Feljegyzés
Ez a cikk azt ismerteti, hogyan adhat hozzá és szerkeszthet lapokat egy csapatprojekthez létrehozott wikiben. Ha egy Git-adattárból közzétett wikihöz szeretne lapokat hozzáadni vagy szerkeszteni, olvassa el a Git-adattár wikiben való közzététele című témakört.
Wiki parancssori eszközök
Az Azure DevOps CLI parancsaival kezelheti a wikitartalmakat. Az alábbi táblázat a jelen cikk azon szakaszaira mutató hivatkozásokat tartalmaz, amelyek az adott parancsok használatát írják le.
| Parancs | Leírás |
|---|---|
| az devops wiki megjelenítése | Nyissa meg a wikit, és jelenítse meg a wiki kezdőlapját. |
| az devops wiki-oldal megjelenítése | Egy adott lap megjelenítése a wikiben. |
| az devops wiki lapot hozz létre | Új lap hozzáadása a wikihöz. |
| a DevOps wiki oldal frissítése | Meglévő lap szerkesztése a wikiben. |
| az devops wikioldal törlése | Töröljön egy lapot a wikiben. |
Előfeltételek
| Kategória | Követelmények |
|---|---|
| Projekt-hozzáférés | Annak a projektnek a tagja, amelyben a wiki található. Igény szerint kérhet hozzáférést a projekt rendszergazdájától. |
| engedélyek | A Közreműködők csoport tagja. |
| hozzáférési szintek | Legalább alapszintű hozzáférés. |
| Tevékenységek | Készíts elő egy előkészített wikikönyvtárat a projektedhez. |
A wiki megnyitása
Nyissa meg és tekintse meg a csapatprojekt wikilapját az Azure DevOps böngészőben vagy az Azure DevOps parancssori felületével.
Csatlakozzon a projekthez egy támogatott webböngésző használatával, és válassza a Wiki lehetőséget:
Ha át kell váltania a csapatprojektet, válassza az
Azure DevOps lehetőséget az összes csapatprojekt és csapat tallózásához.
Wikilap hozzáadása
Ez a szakasz bemutatja, hogyan adhat hozzá lapot a wikihöz. Közvetlenül az Azure DevOps felhasználói felületével dolgozhat a böngészőben, vagy használhatja az Azure DevOps parancssori felületét.
Ha új lapot szeretne hozzáadni a wikihöz, két lehetősége van. Először válasszon ki egy lapot a listában, például a kezdőlapot.
Ha az aktuális lap szinttel azonos szintű lapot szeretne hozzáadni, válassza az Új lap lehetőséget az Azure DevOps felhasználói felületének alján.
Ha melléklapot szeretne hozzáadni az aktuális laphoz, válassza a További beállítások (...) lehetőséget. >Melléklap hozzáadása.
A lapok hozzáadásához billentyűparancsokat is használhat. Jelölje ki az aktuális lapot, majd adjon hozzá egy új lapot az n billentyűvel, vagy adjon hozzá egy allapot a c gombra kattintva. További információ: Billentyűparancsok a wikilapok kezeléséhez.
Lap címe és fájlneve
Adjon meg egy egyedi címet a lapnak. Az érték kis- és nagybetűérzékeny. A cím a lap fájlneve. A fájlnévben a lap címének szóközeit kötőjelek (-) váltják fel. A lap címe például a "How to contribute" (Közreműködési útmutató) a How-to-contribute.md fájlnévnek felel meg. A fájl teljes elérési útja legfeljebb 235 karakter lehet.
További fájlnévkorlátozások: Wiki Git-adattárfájlok és fájlstruktúra, Fájlelnevezési konvenciók.
Oldalcím- és fájlnévkorlátozások
Minden wikilap egy-egy fájlnak felel meg a Wiki Git-adattárban. A lapfájlnevekre és a fájlméretre az alábbi korlátozások vonatkoznak:
Fájlnév: Amikor kiválasztja a lapfájl nevét, ne feledje, hogy a fájl teljes elérési útja legfeljebb 235 karakter lehet. A lap teljes elérési útja az adattár URL-címéből, a lapfájl mappaútvonalából és a lapfájl nevéből áll. Például:
https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.Egyediség: A lapfájl nevének egyedinek kell lennie a wiki-adattár hierarchiájában található mappahelyen belül. A név kis- és nagybetűérzékeny.
Speciális karakterek: A lapfájl nevének korlátozásai a következő speciális karakterekre vonatkoznak:
- Nincs Unicode-vezérlőkarakterek vagy helyettesítő karakterek
- Nincs nyomtatható karakter: perjel
/, fordított perjel\, kivonat# - Nincs pont
.szimbólum a név elején vagy végén
Fájlméret: A maximális oldalméret 18 MB.
Mellékletfájl mérete: Az oldalfájl mellékleteinek maximális mérete 19 MB.
Engedélyezett speciális karakterek
A lapfájl neve több speciális karaktert is tartalmazhat, például a kettőspontot : és a kötőjelet -. Egy Markdown-fájlt például gyik:0525-nek vagy beállítási útmutatónak is nevezhet.
Fontos
A lapszintaxis és a böngészőnavigáció hibáinak elkerülése érdekében ne használja a szóköz karaktert ( ) az oldalfájlnevekben. Ha a lapcím alapján adja meg a lap fájljait, cserélje le a lap címében lévő szóközöket a fájlnév kötőjelére (-).
Az alábbi táblázat a wikilap fájlneveiben engedélyezett speciális karaktereket és a megfelelő URI-kódolt sztringet sorolja fel:
| Karakter | Szimbólum | URI-karakterlánc |
|---|---|---|
| Kettőspont | : |
%3A |
| Bal háromszögletes zárójel | < |
%3C |
| Szögletes zárójel | > |
%3E |
| Csillagjel (helyettesítő karakter) | * |
%2A |
| Kérdőjel | ? |
%3F |
| cső | | |
%7C |
| Kötőjel (kötőjel) | - |
%2D |
| Dupla idézőjel | " |
22% |
A GYIK:0525 fájlnév például a következőképpen van kódolva FAQ%3A0525: .
A wiki kezdőlapjának beállítása
Alapértelmezés szerint a wiki létrehozásakor elsőként hozzáadott oldal a wiki kezdőlapja. Ha egy másik lap relevánsabbá válik, módosíthatja a wiki kezdőlapját. További információ: Wikilapok átrendezése vagy áthelyezése.
Wikilapok szerkesztése és törlése
Ez a szakasz azt ismerteti, hogyan szerkeszthet vagy törölhet egy lapot a wikiben. Közvetlenül az Azure DevOps felhasználói felületével dolgozhat a böngészőben, vagy használhatja az Azure DevOps parancssori felületét.
A böngészőben meglévő wikilapokat többféle módszerrel szerkesztheti:
- Nyissa meg a wikilapot, és válassza a Szerkesztés lehetőséget.
- Nyissa meg a wikilapot, és használja az e billentyűparancsot.
- Jelölje ki a wikilapot a laplistában, majd válassza a További beállítások (...) lehetőséget. >Szerkesztés.
Az egyes szerkesztési függvényekkel kapcsolatos további információkért lásd a Markdown-útmutatót.
Szerkesztés a kód wikik adattáraiban
Ha wikiként teszi közzé a kódot, szerkesztheti a wikilapokat a Repos Hubban. Ugyanaz az oldalsó szerkesztői élmény érhető el a Markdown-eszköztár formázási beállításaival. Válassza a Szerkesztés>Szerkesztés az Adattárakban lehetőséget az ág létrehozásához és a szerkesztés folytatásához:
A Tárakban való szerkesztés lehetőség csak olyan kód wikik esetén érhető el, amelyeken engedélyezve vannak az ágszabályzatok. Ha nem látja ezt a lehetőséget, annak az lehet az oka, hogy a wiki nem kód wiki, vagy az ágszabályzatok nincsenek engedélyezve. További információ: Ágszabályzatok és -beállítások.
Wikilap törlése a böngészőben
Wikilap törléséhez jelölje ki a wikilapot a laplistában, majd válassza a További beállítások (...) lehetőséget. >Törlés. A törlést a lap jobb gombbal kattintva elérhető menüjében is kiválaszthatja.
A Törlés lehetőség kiválasztása után erősítse meg a törlést a párbeszédpanelen.
Feljegyzés
Wikilap törlésekor a lap összes metaadatait és a laphoz csatolt aloldalakat is törli.
Wikilapok átrendezése vagy áthelyezése
A böngészőben átrendezheti az oldalakat a wikifa nézetben, hogy a lapok az ön által előnyben részesített sorrendben jelenjenek meg. Az alapértelmezett sorrend fájlnév szerint betűrendbe van kapcsolva. A sorrendet módosíthatja úgy, hogy a lapokat cikk, kategória vagy célközönség szerint rendezze át.
A fa nézetben a lapcímek húzásával végezze el a következő feladatokat:
Áthelyezés: Egy lap lap- és allapkapcsolatának módosítása. Ha egy lapot a wikisorozaton belül helyez át, előfordulhat, hogy a lapra mutató hivatkozások más wikilapokról megszakadnak. Ezeket a hivatkozásokat manuálisan is kijavíthatja a lap áthelyezése után.
Átrendezés: Egy lap sorrendjének módosítása a wikisorozaton belül. A wikisorozat lapjainak átrendezése nem befolyásolja a laphivatkozásokat.
Hibás hivatkozások kijavítása az oldal áthelyezése után
Ha meg szeretne javítani egy hibás hivatkozást, miután áthelyezett egy lapot a wikisorozatban, kövesse az alábbi lépéseket:
Tesztelje a wiki többi lapját, és keresse meg az áthelyezett lapra mutató hivatkozásokat.
Ellenőrizze, hogy találhatók-e hibaüzenetek a lapon, vagy hiányzik-e a tartalom.
Nyissa meg a hibás hivatkozást tartalmazó lapot, válassza a Szerkesztés lehetőséget, és lépjen a hibás hivatkozásra a lap tartalmában.
Ha meg szeretné keresni a hibás hivatkozást a tartalomban, megkeresheti az áthelyezett oldal nevét, az áthelyezett oldal eredeti fájlútvonalát vagy a hibás hivatkozás hivatkozásszövegét.
Frissítse a hibás hivatkozást. A szokásos javítás a hivatkozás URL-címének vagy elérési útjának módosítása az áthelyezett oldal új helyének megcélzásához.
Mentse a módosításokat a lapon, hogy a hivatkozás frissüljön.
Nyissa meg a frissített lapot a böngészőben, és tesztelje a hivatkozást. Ellenőrizze, hogy sikeresen megnyitja-e az áthelyezett lapot.
Felső szintű lapok sorrendjének módosítása
Billentyűparancsokkal átrendezhet felső szintű lapokat a wikiütemezésben. Ez a művelet nem működik aloldalak esetén.
Jelöljön ki egy oldalt a wiki oldal listájában, és a CTRL + FEL NYÍL vagy CTRL + LE NYÍL billentyűkombinációval mozgassa az oldalt a sorrendben. A módosítás azonnal érvényes.
Aloldalak átrendezése ugyanazon szülő alatt
Ha az allapokat ugyanazon szülőlap alá szeretné átrendezni, használja a húzással a wikifa nézetben:
A wikilap listában keresse meg a szülőlap alatt átrendezni kívánt allapokat.
Jelöljön ki egy allapot, és húzza az új helyre ugyanazon szülőlap allaplistáján belül.
Az aloldalt a kívánt helyre húzva átrendezheti azt más aloldalakhoz képest.
A melléklap sorrendje azonnal megváltozik, és nem befolyásolja az oldalhivatkozásokat, mivel a lapok ugyanazon szülő alatt maradnak.
Oldal- és melléklapsorrend módosítása
A wikisorozat bármely oldalának lap- és aloldalrendjét is módosíthatja.
Jelölje ki a wikilap listában áthelyezni kívánt lapot.
További lehetőségek kiválasztása (...) >Mozgás. Megnyílik az Lap áthelyezése párbeszédpanel.
A Lap áthelyezése párbeszédpanelen válassza ki azt a lapot, amely új szülőlapként szolgál.
Miután kiválasztotta az új szülőlapot, a rendszer megvizsgálja az esetleges hibás hivatkozásokat az oldal áthelyezése alapján. A módosítandó hivatkozásokat jelzi:
Képernyőkép arról, hogyan állíthatja be a rendszer az oldalhivatkozásokat, amelyeket egy oldalmozgatás okozott a wiki sorozatban.
Válassza az Érintett hivatkozások frissítése a lapokban és a munkaelemekben (ajánlott) lehetőséget, majd az Áthelyezés gombra kattintva végezze el a lap áthelyezését.
A billentyűparancsok teljes listájáért tekintse meg a wikilapok kezeléséhez használható billentyűparancsokat.