Megosztás a következőn keresztül:

Wikitartalom klónozása és frissítése offline állapotban

  • Cikk

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

A wikilapokat ugyanúgy frissítheti offline, ahogyan kódot fejleszt egy Git-adattárban.

A wiki offline frissítéséhez bármilyen ügyfelet vagy git parancssori eszközt használhat. A Git-adattárak és a támogatott eszközök használatával kapcsolatos tudnivalókat a Git-adattárakat ismertető dokumentációban tekintheti meg.

A wikitartalom offline frissítésének alapvető lépései az alábbiak:

  1. Klónozza a wiki Git-adattárat a helyi IDE-be vagy munkaterületre.
  2. Fájlok vagy mappák hozzáadása a helyi Git-ághoz.
  3. Frissítse a .order fájlokat, hogy tükrözze a lapokat és az aloldalakat.
  4. Véglegesítse és küldje le a helyi Git-ágon végrehajtott frissítéseket.

Előfeltételek

Az alábbi lépéseket követve áttelepítheti a Markdown-lapokat egy másik wikiről a csapatprojekt wikijéhez vagy a wikibe kódként közzétett tartalmakhoz.

A wiki klónozása

A wikitárház tárolja a lapokat, képeket, mellékleteket, valamint a lapok és aloldalak sorrendjét. Először klónozza a wikit.

  1. Jelentkezzen be a projektbe (https://dev.azure.com/{Your_Organization/Your_Project}), majd válassza ki a wikit.

  2. Nyissa meg a További műveletek helyi menüt, és válassza a Wiki klónozása lehetőséget.

    Wiki Git-adattár klónozása

  3. A Klónozás adattár párbeszédpanelen válassza a Klónozás URL-cím másolása vágólapra lehetőséget.

    A wiki URL-címének másolása

    Írja be a böngészőbe a wikiMaster ágban definiált fájlok megtekintéséhez.

    Wiki fő fájljai

  4. A másolt URL-cím használatával klónozza az adattárat a használt IDE-ben. További információkért tekintse meg az alábbi cikkek egyikét:

Lapok hozzáadása a helyi Git-adattárhoz

Markdown formátumú oldalakat szerkesszünk. Adjon hozzá egy Markdown-fájlt a helyi ághoz minden olyan laphoz és aloldalhoz, amelyet fel szeretne venni a wikibe.

Lapok hozzáadása

Ha oldalakat szeretne hozzáadni a wikifa gyökeréhez, adjon hozzá egy Markdown-fájlt a Git-adattár gyökeréhez.

  1. Minden hozzáadni kívánt laphoz hozzon létre egy Markdown-fájlt a lap tartalmával, majd adja hozzá az adattár gyökérmappájához.

    A CanaryBuilds csapatprojekt esetében a következő mappában található:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Ha oldalakat szeretne hozzáadni a wikifa gyökeréhez, adjon hozzá egy Markdown-fájlt a Git-adattár gyökeréhez tartozó minden egyes laphoz.

    Helyi ág wiki Git-adattára

  3. Miután hozzáadta a gyökérhez hozzáadni kívánt összes lapot, frissítse a .order fájlt a gyökérnél. Minden olyan Markdown-fájlhoz, amely a gyökérnél van definiálva, egy bejegyzéssel kell rendelkeznie. Minden bejegyzésnek meg kell egyeznie a fájl címével egy kötőjelre cserélt szóközökkel.

    Példa:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Aloldalak hozzáadása

  1. Hozzon létre egy mappát a szülőlaphoz, majd adja hozzá a Markdown-fájlokat a mappában lévő összes aloldalhoz.

    A következő fájlokat például hozzáadtuk a How-to-contribute mappához. Ezek az aloldalak a Wiki közreműködői lapja alatt jelennek meg.

    Képernyőkép az aloldalakról.

  2. Vegyen fel egy .order fájlt a mappába a wikiben megjelenő allapok sorrendjével. A .order fájl lapsorrendezésre való használatának megismeréséhez tekintse meg a Wiki Git-adattár fájljait és fájlstruktúráját.

    A fájl például a következő aloldalakat tartalmazza:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Módosítások leküldése

Ha végzett az összes frissítéssel, küldje el a fájlokat a Git-adattárba.

A hozzáadott lapok és aloldalak azonnal megjelennek a wikiben.

Wikifa frissítve

Ha a folyamat során hibák lépnek fel, a lapok figyelmeztető jellel jelennek meg a wikiben.

Figyelmeztetés, ha a .order fájl nincs megfelelően frissítve.