Přeskočit obsah

Testovací prostředí sdíleného obsahu

Tato sekce je zahrnuta za účelem ověření sdíleného obsahu poskytovaného z tohoto repozitáře pro použití v ostatních částech dokumentace BeeWare. „Sdílený obsah“ označuje dokumenty nebo části dokumentů, které jsou společné pro více jiných repozitářů. Jsou zde uloženy pro zařazení do těchto repozitářů. To znamená, že v případě nutnosti aktualizace existuje jediný zdroj a že změna se promítne do všech repozitářů, které tento sdílený obsah používají.

Pokud aktualizujete stávající obsah, následující kroky nejsou nutné. Stačí vytvořit testovací web a podívat se, jak se aktualizace projeví.

Pokud vytváříte nový sdílený dokumentační soubor v adresáři shared-content, který NENÍ určen k zařazení do adresáře how-to, proveďte následující kroky:

  1. Vytvořte soubor v content_test_bed se stejným názvem jako váš nový obsahový soubor, s příponou „_include“ na konci.
    • Pro style_guide.md byste přidali style_guide_include.md.
  2. Pomocí syntaxe Snippets přidejte název souboru do filename_include.md. Syntaxe Snippets pro vložení obsahu je -8<- "filename.md".
    • Pro style_guide.md byste přidali -8<- "style_guide.md" do style_guide_include.md.
  3. Aktualizujte sekci Shared content test bed v /docs/SUMMARY.md tak, aby obsahovala nový soubor _include a cestu, na stejné úrovni odsazení jako ostatní položky v této sekci.
    • Pro style_guide_include.md byste přidali - [Style guide](content_test_bed/style_guide_include.md).

Po dokončení těchto kroků můžete vytvořit testovací web a zobrazit novou dokumentaci.