Zřízený wikiweb vs. publikovaný jako wikiweb kódu
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Obsah wikiwebu můžete udržovat na 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:
Publikovaná funkce wikiwebu kódu 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 wikiwebu probíhají v rámci wikiwebu.
Pomocí publikovaného wikiwebu s kódem 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 u publikovaných stránek wikiwebu podporované.
Například možnost Upravit v úložištích pro publikovanou jako wikiweb s kódem vás přenese na stránku úložiště , kde můžete danou stránku upravit. Aktualizace provedené na stránce 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:
- Formát Markdownu
- Značky HTML
- Vložení a změna velikosti obrázků
- Matematická notace a znaky
- Propojení s pracovními položkami pomocí #
- Připojení souborů
- Filtrování obsahu wikiwebu
- Tisk wikistrány
- Aktualizace obsahu offline
- Přidání nebo úprava stránek z wikiwebu
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áno jako wikiweb kódu |
|---|---|---|
| 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ě publikovaného jako wikiwebu kódu, definujte *.order* soubor 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 publikovaná jako wikiweb kódu vyžaduje ruční údržbu pořadí stránek.
Další informace o práci se .order soubory najdete 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.
- Pro zřízenou stránku wikiwebu vyberte Vrátit, jak je popsáno v části Vrácení potvrzení na zřízenou stránku wikiwebu.
- Pokud chcete publikovat jako stránku wikiwebu s kódem, přejděte z místní větve a odešlete žádost o přijetí změn, abyste aktualizovali větev, ze které pracujete.
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. Publikovat a zrušit publikování wikiwebu můžete jenom v případě, že jste ten, kdo ho vytvořil publikováním kódu na wikiwebu. Další informace naleznete v tématu 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.
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.
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.1vrátí všechny wikiweby v projektu, takže můžete zvolit, který z nich chcete odstranit.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.