Zřízené wikiweby vs. publikovaný kód jako wikiweb

  • Článek

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

V Azure DevOps můžete udržovat obsah wikiwebu ve wikiwebu týmového projektu nebo publikovaném jako wikiweb kódu. Pomocí publikovaného wikiwebu s kódem můžete udržovat několik verzí wikiwebů, které podporují vaše potřeby obsahu, i když je k dispozici jenom v případě, že je povolená služba Azure Repos.

Obě možnosti udržují obsah wikiwebu v úložištích Git, liší se však způsobem přidávání, aktualizace a správy obsahu wikiwebu.

Poznámka:

Kód publikování jako funkce wikiwebu je aktuálně dostupný na Azure DevOps Serveru 2018 a novějších verzích. U starších verzí můžete pro týmový projekt zřídit jenom wikiweb.

Možnosti nabídky stránky wikiwebu

Pomocí zřízeného wikiwebu můžete přidávat a upravovat stránky přímo na wikiwebu. Všechny aktualizace obsahu zřízeného wikiwebuprobíhají v rámci wikiwebu.

Pomocí kódu pro publikování jako wikiwebu můžete přidávat, upravovat a aktualizovat obsah z úložišť nebo kódu.

Následující obrázek ukazuje možnosti zřízeného wikiwebu. Některé z těchto možností nejsou pro publikování podporované jako stránky wikiwebu kódu.

Snímek obrazovky s možnostmi nabídky zřízené stránky wikiwebu

Například možnost Upravit v úložišti pro publikační kód jako wikiweb vás přenese na stránku úložiště , aby se tato konkrétní stránka upravila. Aktualizace, že provedete na stránku ve větvi, kterou jste vybrali pro wikiweb, se automaticky publikuje na wikiwebu.

Podporované funkce a provozní rozdíly

Oba typy wikiwebu podporují následující funkce:

Následující tabulka shrnuje operace nebo funkce, které se můžou lišit v závislosti na typu wikiwebu.

Operace Zřízený wikiweb Publikování kódu jako wikiwebu
Podpora více wikiwebů, pojmenování wikiwebu ✔️
Přidání nebo úprava stránek ze souborů repos>nebo souborů kódu> ✔️
Návrat k dřívější revizi wikiwebu ✔️
Návrat k dřívější revizi z úložišť nebo kódu ✔️ ✔️
Údržba verzí wikiwebů ✔️
Výběr verze wikiwebu ✔️
Zrušení publikování wikiwebu kódu ✔️

Přidat stránky

U obou typů wikiwebu vyberte Možnost Nová stránka nebo Přidat podstránku. Další informace najdete v tématu Přidání a úprava stránek wikiwebu.

Pořadí stránek a seznam stránek v navigačním podokně

Zřízený wikiweb spravuje pořadí stránek a seznam stránek automaticky při přidávání nebo přesouvání stránek v navigačním podokně.

Chcete-li vytvořit strukturu seznamu stránek v navigačním podokně pro kód publikování jako wikiweb, definujte soubor .order v kořenovém adresáři a pro každou podsložku nebo nadřazenou stránku, která obsahuje podstránky.

Oba typy wikiwebů se řídí stejnou strukturou souborů, je to jen to, že publikovací kód jako wikiweb vyžaduje ruční údržbu pořadí stránek.

Další informace o práci se soubory .order naleznete v tématu Soubory úložiště Wiki Git a struktura souborů.

Revize stránek a návrat k předchozí verzi

Na wikiwebu můžete zobrazit revize libovolné stránky wikiwebu. Vyberte Revize nebo možnost Zobrazit revize .

Proces vrácení se ale liší v závislosti na typu stránky wikiwebu.

Správa verzí a zrušení publikování wikiwebu

Při správě verzí můžete publikovat různé verze obsahu na odlišné wikiweby na základě větve gitu s verzemi. Správa verzí a zrušení publikování wikiwebu se podporuje jenom pro wikiweby, které jste vytvořili publikováním kódu na wikiwebu. Další informace najdete v tématu Publikování wikiwebu s kódem nebo zrušení publikování wikiwebu kódu.

Odstranění wikiwebu projektu

Poznámka:

Rozhraní REST API wikiwebu nepodporují odstranění wikiwebu projektu. Takže místo toho musíte odstranit úložiště wikiwebu.

  1. Naklonujte úložiště wikiwebu a zazálohujte veškerý jeho obsah. Další možnosti mají adresu URL klonování wikiwebu, kterou lze použít ke klonování wikiwebu.

  2. Získejte ID úložiště Git, které zálohuje váš wikiweb. Pomocí rozhraní REST API můžete získat všechny wikiweby v projektu.

    Například GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 vrátí všechny wikiweby v projektu, takže můžete zvolit, který z nich chcete odstranit.

  3. Pomocí rozhraní REST API odstraňte záložní úložiště Git. Použijte ID úložiště wikiwebu projektu, který jste našli v předchozím kroku, a pečlivě zkontrolujte ID úložiště, abyste ho neodebrali.

    Například DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Aktualizace wikiwebu offline

Můžete pracovat offline nebo v místní větvi, abyste aktualizovali obsah zřízeného wikiwebu a publikovali ho jako wikiweb kódu. Další informace najdete v tématu Klonování a aktualizace stránek wikiwebu offline.