Sdílet prostřednictvím

Soubory wikiwebu a struktura souborů

  • Článek

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ý .order v kořenovém adresáři a pod každou složkou
  • Složka pro každou stránku, která obsahuje podstránky
  • .attachments ulož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
Snímek obrazovky s příkladem obsahu wikiwebu Snímek obrazovky s ukázkovým souborem objednávky wikiwebu

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:

  1. 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.
  2. 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.