Wikilapok hozzáadása és szerkesztése

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

Miután kiépítette a wiki Git-adattárat a csapatprojekthez, címet és tartalmat adhat hozzá egy laphoz. Van egy egymás melletti szerkesztési és előnézeti felület, ahol szerkesztheti a lapot, és útközben megtekintheti a tartalmat.

Miközben markdown formátumú lapokat hoz létre, a formázási panelen rich-text formázást és képek, mellékletek és hivatkozások beszúrását is használhatja.

A lap szerkesztésekor mentse a Ctrl+S billentyűkombinációt. Ha egyéni korrektúraüzenettel szeretne menteni, válassza a Mentés gombot. További billentyűparancsokért tekintse meg a wikilapok kezeléséhez használható billentyűparancsokat.

Wiki parancssori eszközök

Parancsok	Leírás
az devops wiki show	Wiki megnyitása
az devops wikioldal megjelenítése	Lap tartalmának lekérése vagy lap megnyitása
az devops wikilap létrehozása	Új lap hozzáadása
az devops wikilap frissítése	Lap szerkesztése
az devops wikioldal törlése	Oldal törlése

Feljegyzés

Ha egy Git-adattárból közzétett wikilapokat szeretne hozzáadni vagy szerkeszteni, olvassa el a Git-adattár wikiben való közzétételét ismertető témakört. Ez a cikk azt ismerteti, hogyan adhat hozzá és szerkeszthet egy csapatprojekthez kiépített wikilapokat.

Előfeltételek

• Kiépített wikivel kell rendelkeznie.
• Wikilapok hozzáadásához vagy frissítéséhez közreműködőként a csapatprojekt tagjának kell lennie.
• A projekt wikijének szerkesztéséhez alapszintű hozzáférési szinttel kell rendelkeznie.

A wiki megnyitása

Böngésző

Csatlakozás 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 DevOpsot az összes csapatprojekt és csapat tallózásához.

Azure DevOps parancssori felület

A parancs használatával megtekintheti és megnyithatja a az devops wiki show projekthez definiált wikilapot. Első lépésként tekintse meg az Azure DevOps parancssori felület használatának első lépéseit.

az devops wiki show --wiki
                      [--open]
                      [--project]
                      [--subscription]

Paraméterek

• --wiki: Kötelező. A wiki neve vagy azonosítója.
• --open: Nem kötelező. Nyissa meg a wikilapot a webböngészőben.
• --project -p: Nem kötelező. A projekt neve vagy azonosítója.
• --előfizetés: Nem kötelező. Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

Példa

Nyisson meg egy "myprojectwiki" nevű wikit.

az devops wiki show --wiki myprojectwiki --open

Wikilap megtekintése

Ha egy oldal tartalmát az Azure DevOps CLI-vel szeretné lekérni, írja be a az devops wiki show parancsot.

az devops wiki page show --path
                         --wiki
                         [--include-content]
                         [--open]
                         [--project]
                         [--subscription]
                         [--version]

Paraméterek

• --path: Kötelező. A wikilap elérési útja.
• --wiki: Kötelező. A wiki neve vagy azonosítója.
• --include-content: Nem kötelező. Adja meg a lap tartalmát.
• --open: Nem kötelező. Nyissa meg a wikilapot a webböngészőben.
• --project -p: Nem kötelező. A projekt neve vagy azonosítója.
• --version -v: Nem kötelező. A wikilap verziója (ETag).

Példa

A "myprojectwiki" nevű wikiben lekérheti a "saját wiki" elérési utat tartalmazó wikilap tartalmát.

az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"

Wikilap hozzáadása

Böngésző

Másik lap hozzáadásához válassza az Új lap lehetőséget. Aloldal hozzáadásához nyissa meg egy meglévő lap helyi menüjét, és válassza az Add subpage (Allap hozzáadása) lehetőséget.

Adjon meg legfeljebb 235 karakterből álló egyedi címet. A lapcímek megkülönböztetik a kis- és nagybetűket. További címkorlátozások : Wiki Git-adattárfájlok és fájlstruktúra, Fájlelnevezési konvenciók.

Billentyűparancsokkal új lapot is hozzáadhat az n billentyű lenyomásával, vagy hozzáadhat egy allapot a c billentyű lenyomásával. A billentyűparancsok teljes listájáért tekintse meg a wikilapok kezeléséhez használható billentyűparancsokat.

Azure DevOps parancssori felület

Wikilap hozzáadásához írja be a az devops wiki page create parancsot.

az devops wiki page create --path
                           --wiki
                           [--comment]
                           [--content]
                           [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                           [--file-path]
                           [--project]
                           [--subscription]

Paraméterek

• --path: Kötelező. A wikilap elérési útja.
• --wiki: Kötelező. A wiki neve vagy azonosítója.
• --comment: Nem kötelező. Megjegyzés a fájl hozzáadása művelet véglegesítési üzenetében. Alapértelmezett érték: Új lap hozzáadása az Azure DevOps parancssori felületével.
• --content: Nem kötelező. A wikilap tartalma. --file-path Ha meg van adva, figyelmen kívül hagyja.
• --kódolás: Nem kötelező. A fájl kódolása. Paraméterrel együtt --file-path használva. elfogadott értékek: ascii, utf-16be, , utf-16leutf-8
• --file-path: Nem kötelező. A fájlbemenet elérési útja, ha a tartalom meg van adva a fájlban.
• --project -p: Kötelező, ha nem alapértelmezettként van konfigurálva, vagy git-konfiguráción keresztül veszi fel. A projekt neve vagy azonosítója. Az alapértelmezett projektet az az devops configure használatával konfigurálhatja -d project=NAME_OR_ID.

Példák

Hozzon létre egy új lapot a "my page" elérési úttal egy "myprojectwiki" nevű wikiben beágyazott tartalommal.

az devops wiki page update --path 'my page' --wiki myprojectwiki --content "Hello World"

Frissítse a lap tartalmát a "saját lap" elérési úttal egy wikiben egy fájlból származó tartalommal.

az devops wiki page update --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8

Wikilap címelnevezési korlátozásai

Minden wikilap egy-egy fájlnak felel meg a wiki Git-adattárában. A wikilapokhoz rendelt neveknek az alábbi korlátozásoknak kell megfelelniük.

Korlátozás típusa	Korlátozás
Fájlnév	A teljes lapútvonal nem haladhatja meg a 235 karakter hosszúságot.
Egyediség	A lapcímek megkülönböztetik a kis- és nagybetűket, és egyedinek kell lenniük a wikihierarchiában.
Speciális karakterek	– Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek. - Nem tartalmazhat a következő nyomtatható karaktereket: / \ #. - Nem kezdődhet és nem végződhet ponttal ..
Fájlméret	Nem lépheti túl a 18 MB-os maximális méretet.
Mellékletfájl mérete	Nem lépheti túl a 19 MB-os maximális méretet.

Speciális karakterek a Wikilap címeiben

Megadhatja azokat a lapcímeket, amelyek egy vagy több speciális karaktert : < > * ? | -tartalmaznak. A Markdown-fájlokat például "GYIK" vagy "Beállítási útmutató" néven is elnevezheti. A karakterek a következő URI-kódolt sztringekkel rendelkeznek:

Karakter	Kódolt sztring
:	%3A
<	%3C
>	%3E
*	%2A
?	%3F
|	%7C
-	%2D
"	22%

Wikilapok szerkesztése és törlése

Böngésző

Meglévő wikilap szerkesztéséhez nyissa meg a lapot, és válassza a Szerkesztés lehetőséget, vagy nyissa meg a helyi menüt, és válassza a Szerkesztés lehetőséget. Az e billentyűparancsot is használhatja az aktuális lap gyors szerkesztéséhez.

Kód wikik esetén szerkesztheti a lapokat az egymás melletti szerkesztőben a Markdown eszköztár használatával a tartalom létrehozásához. Ez a felület megegyezik a projekt wikijének folyamatával. A Repos hub wikilapjait a Szerkesztés a Tárakban lehetőséggel is szerkesztheti.

Ha a kód wikije ágszabályzatokkal rendelkezik, válassza a Szerkesztés a Tárakban lehetőséget egy ág létrehozásához és a szerkesztés folytatásához. A Szerkesztés a tárakban lehetőség kifejezetten a kód wikikhöz érhető el.

Ha törölni szeretne egy lapot, nyissa meg a helyi menüt a fáról vagy a lapon belülről, és válassza a Törlés lehetőséget. Erősítse meg a törlést a megnyíló párbeszédpanelen.

Feljegyzés

Amikor töröl egy lapot, a hierarchiában lévő összes metaadatot és annak összes aloldalát (ha van ilyen) is törli.

Azure DevOps parancssori felület

Wikilap szerkesztése

Wikilap szerkesztéséhez írja be a az devops wiki page update parancsot.

az devops wiki page update --path
                           --version
                           --wiki
                           [--comment]
                           [--content]
                           [--file-path]
                           [--project]
                           [--subscription]

Paraméterek

• --path: Kötelező. A wikilap elérési útja.
• --version -v: Kötelező. A szerkeszteni kívánt fájl verziója (ETag).
• --wiki: Kötelező. A wiki azonosítójának neve.
• --comment: Nem kötelező. Megjegyzés a törlési művelet véglegesítési üzenetében.
• --file-path: Nem kötelező. A fájlbemenet elérési útja, ha a tartalom meg van adva a fájlban.
• --project -p: Nem kötelező. A projekt neve vagy azonosítója.
• --előfizetés: Nem kötelező. Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

Példák

Frissítse a lap tartalmát a "my page" elérési úttal egy "myprojectwiki" nevű wikiben beágyazott tartalommal.

az devops wiki page update --path 'my page' --wiki myprojectwiki --content "Hello World" --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b

Frissítse a lap tartalmát a "saját lap" elérési úttal a wikiben egy fájlból származó tartalommal.

az devops wiki page update --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8 --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b

Wikilap törlése

Wikilap törléséhez írja be a az devops wiki page delete parancsot.

az devops wiki page delete --path
                           --wiki
                           [--comment]
                           [--project]
                           [--subscription]
                           [--yes]

Paraméterek

• --path: Kötelező. A wikilap elérési útja.
• --wiki: Kötelező. A wiki neve vagy azonosítója.
• --comment: Nem kötelező. Megjegyzés a törlési művelet véglegesítési üzenetében.
• --project -p: Nem kötelező. A projekt neve vagy azonosítója. Az alapértelmezett projektet az az devops configure -d project=NAME_OR_ID használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel.
• --előfizetés: Nem kötelező. Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .
• --yes -y: Nem kötelező. Ne kérje a megerősítést.

Példa

A "myprojectwiki" nevű wikiben törölje a "saját wiki" elérési utat tartalmazó wikilapot.

az devops wiki page delete --path 'my wiki' --wiki 'myprojectwiki'

Wikilap átrendezés

A wikifa nézetben átrendezheti a lapokat, hogy a lapok a kívánt sorrendben és hierarchiában jelenjenek meg. A következő műveletek végrehajtásához húzza a lap címét a fa nézetben:

• Egy oldal szülő-gyermek kapcsolatának módosítása.
• Módosítsa a lap sorrendjét a hierarchiában.

Feljegyzés

Ha áthelyez egy lapot a hierarchiában, az megszakíthatja a más oldalakra mutató hivatkozásokat. Az áthelyezés után bármikor manuálisan is kijavíthatja a hivatkozásokat. A hierarchián belüli lapok átrendezése nincs hatással a laphivatkozásokra.

A lapok átrendezéséhez billentyűparancsokat is használhat. Jelöljön ki egy lapot, és nyomja le a CTRL+ FEL vagya CTRL +LE billentyűkombinációt az oldalrendek módosításához. Egy lap szülő-gyermek kapcsolatának módosításához nyissa meg a helyi menüt, és válassza az Áthelyezés lehetőséget. Megnyílik az Áthelyezés lap párbeszédpanel. Jelölje ki azt a szülőlapot, amely alá áthelyezheti az aktuális lapot.

A billentyűparancsok teljes listájáért tekintse meg a wikilapok kezeléséhez használható billentyűparancsokat.

Lap készítése a wiki kezdőlapjára

Alapértelmezés szerint a wiki létrehozásakor hozzáadott első oldal lesz a wiki kezdőlapja. A wiki kezdőlapját módosíthatja, ha egy másik oldal relevánsabbá válik, ha a lapot a fa tetejére húzza.

Következő lépések

A wikilap előzményeinek megtekintése és visszaállítása

Kapcsolódó cikkek

• Wikilap követése és értesítések lekérése
• Kiépített és közzétett wiki
• Wiki offline frissítése
• Markdown-útmutató wikikhez