Správa obsahu přes GitHub

Úvod

Tento krátký návod popisuje, jak můžete upravovat dokumentaci klobouku přímo přes webové rozhraní GitHubu. Postup je vhodný jak pro členy týmu s právem zapisovat do repozitáře, tak pro externí přispěvatele.

Přímé úpravy s oprávněním zápisu

Pokud máte do repozitáře přístup s oprávněním zapisovat, můžete změny provádět přímo v jeho větvích.

1. Otevřete příslušný soubor v GitHubu a klikněte na Edit.
2. Proveďte požadované změny v obsahu.
3. V dolní části stránky vyplňte zprávu commitu a klikněte na Commit changes.
4. Přímo na main větvi volte pouze drobné opravy. Větší změny je vhodné provádět v nové větvi pomocí Create a new branch a přes pull request je sloučit zpět.

Úpravy pomocí forku

Pokud právo zápisu nemáte, můžete využít fork repozitáře.

1. Na stránce projektu klikněte na tlačítko Fork a vytvořte si vlastní kopii repozitáře.
2. V této kopii proveďte potřebné úpravy.
3. Změny uložte commitem a přes tlačítko Contribute otevřete Pull Request zpět do původního repozitáře.

Tip

Před odesláním pull requestu zkontrolujte náhled změn pomocí záložky Preview.

Jak najít a upravit soubor

1. V levém panelu repozitáře otevřete složku src/content/docs a přejděte k požadovanému dokumentu.
2. Po kliknutí na soubor zvolte Edit this file a proveďte změny v editoru.
3. Uložte je commitem nebo v rámci nové větve pro pozdější pull request.

Takto můžete jednoduše rozšiřovat obsah klobouku i bez lokální instalace nástrojů.