Soubory wikiwebu a struktura souborů
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Přečtěte si o souborech a struktuře souborů pro wikiweby projektu a wikiweby kódu. Následující doprovodné materiály mohou určovat wikiweby kódu, ale platí pro oba typy wikiwebu.
Když vytvoříte týmový projekt, wikiweb se ve výchozím nastavení nevytvoří. Další informace najdete v tématu Vytvoření wikiwebu, vytvoření souboru README nebo zřízeného wikiwebu vs . publikovaného kódu jako wikiwebu.
Každý wikiweb kódu využívá úložiště Git v back-endu. Toto úložiště ukládá stránky Markdownu, obrázky, přílohy a posloupnost stránek a podstránek. Wikiweb vytvoříte prostřednictvím uživatelského rozhraní Azure DevOps a pak můžete wikiweb upravit prostřednictvím cesty URL úložiště Git. Další informace o publikování wikiwebů kódu najdete v tématu Publikování úložiště Git na wikiwebu.
Struktura souborů a složek wikiwebu
Úložiště Git wikiwebu týmového projektu jsou přiřazená následujícím popiskům.
- Úložiště wikiwebu pro týmový projekt:
ProjectName.wiki - Hlavní větev:
wikiMain
Spravujte úložiště wikiwebu stejným způsobem, jakým spravujete jakékoli jiné úložiště Git, a to definováním zásad větví ve větvi wikiMain. Můžete ale provádět změny místní větve wikiMain a odesílat je přímo do vzdálené větve bez definování zásad.
Úložiště wikiwebu má následující soubory a složky:
- Soubor pro každou stránku Markdownu zadaná na kořenové úrovni
- Soubor označený
.orderv kořenovém adresáři a pod každou složkou - Složka pro každou stránku, která obsahuje podstránky
.attachmentsuložení všech příloh wikiwebu
Zásady vytváření názvů souborů
Všechny soubory vyžadují použití pomlček místo mezer v nadpisu stránky. Například název stránky Jak přispívat odpovídá How-to-contribute.md názvu souboru. Název stránky se přidá do adresy URL, čímž se zajistí, že odkazy, které sdílíte, zůstanou nedotčené i v případě, že se wikiweb v průběhu času změní.
Každá stránka wikiwebu odpovídá souboru v úložišti Git wikiwebu. Názvy, které přiřadíte k nadpisům stránek wikiwebu, musí splňovat následující omezení.
| Typ omezení | Omezení |
|---|---|
| Název souboru | Plně kvalifikovaná cesta ke stránce by neměla být delší než 235 znaků. |
| Jedinečnost | V nadpisech stránek se rozlišují malá a velká písmena a musí být v hierarchii wikiwebu jedinečné. |
| Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: / \ #.- Nesmí začínat ani končit tečkou .. |
| Velikost souboru | Nesmí překročit maximální velikost 18 MB. |
| Velikost souboru přílohy | Nesmí překročit maximální velikost 19 MB. |
Speciální znaky v názvech stránek wikiwebu
Můžete zadat názvy stránek, které obsahují jeden nebo více těchto speciálních znaků : < > * ? | -. Například soubor Markdownu můžete pojmenovat jako "FAQ?" nebo "Set-up guide". Znaky mají následující řetězce kódované identifikátorem URI:
| Znak | Kódovaný řetězec |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22 % |
Soubor .order
Soubor .order definuje posloupnost stránek v rámci wikiwebu. Následující vizuál ukazuje příklad obsahu wikiwebu a odpovídající soubor .order.
| Obsah wikiwebu | Soubor .order |
|---|---|
|
|
Výchozí hierarchie je v abecedním pořadí, ale tuto hierarchii můžete změnit v souboru .order . Další informace o tom, jak změnit pořadí stránek wikiwebu, naleznete v tématu Přidání a úprava stránek wikiwebu, změna pořadí stránky wikiwebu.
Odstraněním souboru .order se vrátíte k abecednímu řazení.
Pokud neexistuje žádný soubor .order , stránky se seřadí abecedně. Pokud se chcete vrátit k abecednímu řazení, postupujte takto:
- Zkopírujte adresu URL klonu wikiwebu a otevřete ji v prohlížeči. Tím se otevře úložiště Git (centrum souborů), které wikiweb zálohuje.
- Přejděte do souboru .order a odstraňte ho. Soubor se automaticky vytvoří (znovu) po odstranění, například v akci přetažení u článku.