Sdílet prostřednictvím

Klonování a aktualizace obsahu wikiwebu offline

  • Článek

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

Stránky wikiwebu můžete aktualizovat offline stejným způsobem, jakým vyvíjíte kód v úložišti Git.

K aktualizaci wikiwebu offline můžete použít libovolného klienta, kterého chcete, nebo nástroje příkazového řádku Git. Podrobnosti o práci s úložišti Git a podporovanými nástroji najdete v tématu Úložiště Git.

Základní kroky pro offline aktualizaci obsahu wikiwebu jsou následující:

  1. Naklonujte úložiště Git wikiwebu do místního prostředí IDE nebo pracovního prostoru.
  2. Přidejte soubory nebo složky do místní větve Git.
  3. Aktualizujte soubory .order tak, aby odrážely vaše stránky a podstránky.
  4. Potvrďte a nasdílejte aktualizace, které jste provedli v místní větvi Git.

Požadavky

Při migraci stránek Markdownu z jiného wikiwebu na wikiweb týmového projektu nebo na obsah, který publikujete jako kód na wikiweb, proveďte následující kroky.

Klonování wikiwebu

Vaše úložiště wikiwebu ukládá stránky, obrázky, přílohy a posloupnost stránek a podstránek. Naklonujte wikiweb, abyste mohli začít.

  1. Přihlaste se ke svému projektu (https://dev.azure.com/{Your_Organization/Your_Project}) a vyberte wikiweb.

  2. Otevřete místní nabídku Další akce a vyberte Klonovat wikiweb.

    Klonování úložiště Git wikiwebu

  3. V dialogovém okně Klonovat úložiště vyberte Kopírovat adresu URL klonování do schránky.

    Zkopírování adresy URL wikiwebu

    Pokud chcete zobrazit soubory definované ve větvi wikiMaster, zadejte ho do prohlížeče.

    Hlavní soubory wikiwebu

  4. Pomocí adresy URL, kterou jste zkopírovali, naklonujte úložiště v prostředí IDE, které používáte. Další informace najdete v jednom z následujících článků:

Přidání stránek do místního úložiště Git

Stránky vytvoříme ve formátu Markdownu. Přidejte do místní větve soubor Markdownu pro každou stránku a podstránku, kterou chcete přidat na wikiweb.

Přidat stránky

Pokud chcete přidat stránky v kořenovém adresáři stromu wikiwebu, přidejte do kořenového adresáře úložiště Git soubor Markdownu.

  1. Pro každou stránku, kterou chcete přidat, vytvořte soubor Markdownu s obsahem stránky a pak ho přidejte do kořenové složky úložiště.

    Pro týmový projekt CanaryBuilds je ve složce:

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

  2. Pokud chcete přidat stránky v kořenovém adresáři stromu wikiwebu, přidejte soubor Markdownu pro každou stránku v kořenovém adresáři úložiště Git.

    Úložiště Git wikiwebu místní větve

  3. Po přidání všech stránek, které chcete přidat v kořenovém adresáři, aktualizujte soubor .order v kořenovém adresáři. Pro každý soubor Markdownu, který je definovaný v kořenovém adresáři, by měl mít jednu položku. Každá položka by měla odpovídat názvu souboru s mezerami nahrazenými pomlčkou.

    Příklad:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Přidání podstránek

  1. Vytvořte složku pro nadřazenou stránku a pak přidejte soubory Markdownu pro každou podstránku ve složce.

    Do složky How-to-Contribute jsme například přidali následující soubory. Tyto podstránky se zobrazí pod stránkou Jak přispívat na wikiwebu.

    Snímek obrazovky s podstránkami

  2. Do složky přidejte soubor .order s pořadím podstránek tak, jak by se měly zobrazovat na wikiwebu. Informace o použití souboru .order k sekvenčním stránkám najdete v tématu Soubory a struktura souborů úložiště Wiki Git.

    Soubor má například následující podstránky:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Nasdílení změn

Až budete hotovi se všemi aktualizacemi, nasdílejte soubory do úložiště Git.

Přidané stránky a podstránky se na wikiwebu zobrazí okamžitě.

Aktualizovaný strom wikiwebu

Pokud v procesu dojde k nějakým chybám, zobrazí se na wikiwebu znaménko upozornění.

Upozornění, když se soubor .order neaktualizuje správně.