Wikilapok hozzáadása és szerkesztése

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.

Az Azure DevOps Wiki kezdőlapjának képernyőképe, amelyen az egymás melletti felület látható, ahol egyszerre szerkesztheti a lap tartalmát, és megtekintheti a módosításokat.

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:

Képernyőkép arról, hogyan választhatja ki a Mentés korrektúraüzenettel lehetőséget az Azure DevOpsban.

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:

Képernyőkép a böngészőben megnyíló wikiről és a wiki áttekintési oldaláról.

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.

Képernyőkép arról, hogyan adhat hozzá új lapot vagy új allapot egy wikihöz az Azure DevOpsban.

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:

Képernyőkép arról, hogyan választhatja ki a Szerkesztés az Adattárban lehetőséget az Azure DevOpsban.

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.

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:

  1. 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.

  2. 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.

  3. 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.

  4. Mentse a módosításokat a lapon, hogy a hivatkozás frissüljön.

  5. 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:

  1. A wikilap listában keresse meg a szülőlap alatt átrendezni kívánt allapokat.

  2. Jelöljön ki egy allapot, és húzza az új helyre ugyanazon szülőlap allaplistáján belül.

  3. 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.

  1. Jelölje ki a wikilap listában áthelyezni kívánt lapot.

  2. További lehetőségek kiválasztása (...) >Mozgás. Megnyílik az Lap áthelyezése párbeszédpanel.

  3. A Lap áthelyezése párbeszédpanelen válassza ki azt a lapot, amely új szülőlapként szolgál.

    Képernyőkép egy wikilap áthelyezéséről, hogy az a sorozat egy másik oldalának aloldalává váljon.

  4. 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.

  5. 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.