> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/cs/znalostni-baze/044-github-synchronization.md). # Synchronizace s GitHubem **Synchronizace s GitHubem** je [prémiová funkce](/latex/cs/znalostni-baze/120-overleaf-premium-features.md). Prémiové funkce Overleaf jsou k dispozici účastníkům v [Overleaf Commons](https://www.overleaf.com/for/universities), členům skupiny [předplatných](https://www.overleaf.com/for/groups), a vlastníkům individuálních [předplatných](https://www.overleaf.com/user/subscription/plans). Shrnutí Funkce synchronizace s GitHubem umožňuje propojit vaše projekty v Overleafu přímo s repozitářem na GitHubu, který funguje jako vzdálený repozitář pro váš projekt v Overleafu, a poskytuje způsob, jak mezi nimi odesílat a stahovat změny. Synchronizaci s GitHubem lze používat pouze na [GitHub.com](https://www.github.com) a nelze ji použít k připojení k jiným instalacím GitHub Enterprise. Projekt v Overleafu můžete synchronizovat s repozitářem na GitHubu buď vytvořením nového projektu v Overleafu z existujícího repozitáře na GitHubu, nebo vytvořením nového repozitáře na GitHubu z existujícího projektu v Overleafu. Není možné synchronizovat existující projekt v Overleafu s existujícím repozitářem na GitHubu. * Synchronizace s GitHubem je umožněna propojením vašeho účtu GitHub s účtem Overleaf * Nové projekty lze vytvářet z existujících repozitářů na GitHubu * V GitHubu lze vytvářet repozitáře na základě existujících projektů v Overleafu * Propojené projekty a repozitáře se udržují v synchronizaci pomocí **GitHub** možnosti v projektu **Menu** ### Propojení vašeho účtu Overleaf s vaším účtem GitHub Abyste mohli používat funkci synchronizace s GitHubem, musíte propojit svůj účet Overleaf s účtem GitHub. To můžete provést ve svém Overleafu [Nastavení účtu](https://www.overleaf.com/user/settings). Vezměte prosím na vědomí, že schopnost Overleafu připojit se k určitým repozitářům nebo organizacím spojeným s vaším účtem může záviset na nastaveních oprávnění nakonfigurovaných na GitHubu. ### Vytváření nového projektu v Overleafu z repozitáře na GitHubu V nabídce Nový projekt můžete vybrat možnost GitHub. Zobrazí se vám seznam repozitářů, které jsou pro Overleaf viditelné prostřednictvím vašeho účtu GitHub na základě vašich nastavení oprávnění na GitHubu. ![Vytvořit nové github.png](/files/1bec370ca24f9af0afcd26b326f895a31983ffc5) Některé věci, které je třeba mít na paměti při vytváření nového projektu v Overleafu z existujícího repozitáře na GitHubu. * Na projekty v Overleafu se vztahují omezení velikosti, která mohou zabránit použití větších repozitářů GitHubu k vytvoření projektu. Podívejte se prosím na [této stránce](/latex/cs/znalostni-baze/119-overleaf-plan-limits.md) pro přehled omezení týkajících se velikosti a počtu souborů v projektu v Overleafu. * Projekty v Overleafu nepodporují Git submoduly ani Git LFS. ### Vytváření nového repozitáře na GitHubu z projektu v Overleafu V nabídce projektu Overleaf můžete jako jednu z možností synchronizace vybrat GitHub. Zobrazí se dialog, ve kterém můžete zadat název nového repozitáře GitHubu, který se má synchronizovat s vaším projektem v Overleafu. ![Nabídka projektu github.png](/files/84ed77873155a2b9c49563661eaf05a77cf7abe1) ### Synchronizace s GitHubem Synchronizace mezi GitHubem a Overleafem neprobíhá automaticky, možnosti synchronizace se zobrazí kliknutím **GitHub** možnosti v projektu **Menu**. V té chvíli dialogové okno GitHubu oznámí, zda jsou k dispozici nové změny ke stažení z GitHubu. Vždy se vám zobrazí možnost odeslat změny na GitHub (pozn.: tato možnost se zobrazí i tehdy, pokud jsou Overleaf a GitHub aktuální). ![obrázek dialogového okna GitHubu](/files/1f8d57f6cfddaff0722ee3335b7cdfee196cec9f) Commity do GitHubu se vytvářejí po kliknutí na tlačítko Odeslat změny z Overleafu na GitHub. V této chvíli lze zadat volitelnou zprávu commitu. * Změny v historii Overleafu z GitHubu se zobrazí jako vytvořené anonymně. * Změny v historii GitHubu z Overleafu se zobrazí jako vytvořené vlastníkem připojeného účtu GitHub. ### Řešení konfliktů při sloučení Může se stát, že když jsou změny provedeny jak v Overleafu, tak v GitHubu, Git nedokáže automaticky zjistit, jak je sloučit. Pokud například váš spolupracovník změnil řádek v Overleafu a vy jste změnili stejný řádek v repozitáři GitHubu, Overleaf nemusí být schopen vybrat, kterou verzi ponechat. Když se to stane, místo sloučení do vaší hlavní větve odešleme do vašeho repozitáře novou větev. Tato větev bude mít popisný název (včetně data a času vytvoření větve) a bude obsahovat verzi dokumentu v Overleafu. Při pokusu o synchronizaci s GitHubem se zobrazí zpráva, že je třeba vyřešit konflikt při sloučení. ![Dialog konfliktu při sloučení na GitHubu](/files/112a97ba3e4c2c9288c0b1320769f37a4bf97705) Abyste se znovu dostali do synchronizace, musíte sloučit větev Overleafu do své hlavní (výchozí) větve. Můžete to udělat na svém počítači stažením obou větví a sloučením pomocí git nebo jiného nástroje, a poté odeslat výsledek zpět na GitHub. Případně můžete sloučení provést přímo na GitHubu vytvořením pull requestu z větve Overleafu a použitím jejich funkce řešení konfliktů. Oba přístupy jsou popsány v [dokumentaci GitHubu](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). ### Přístup k repozitářům ve vašich organizacích na GitHubu Projekty v Overleafu můžete synchronizovat s repozitáři přidruženými k vašemu propojenému účtu GitHub a můžete také synchronizovat s projekty v organizacích na GitHubu, jejichž jste členem. Aby bylo možné synchronizovat s repozitáři ve vašich přidružených organizacích na GitHubu, musí tyto organizace udělit oprávnění k přístupu aplikaci Overleaf OAuth. * Pokud jste členem organizace, můžete postupovat podle kroků popsaných [zde](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) k vyžádání přístupu, aby aplikace Overleaf mohla přistupovat k vaší organizaci. * Pokud jste vlastníkem organizace, můžete postupovat podle kroků popsaných [zde](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) k schválení aplikace Overleaf pro organizaci. ### Omezení souborů pro synchronizaci s GitHubem Na projekty v Overleafu se vztahují individuální omezení velikosti i omezení celkového počtu souborů v projektu, jak je uvedeno [zde](/latex/cs/znalostni-baze/119-overleaf-plan-limits.md). Zatímco samotný Git zvládne jeden commit měnící tisíce souborů, rozhraní GitHub API používané funkcí synchronizace s GitHubem v Overleafu také ukládá omezení počtu souborů, které lze odeslat nebo stáhnout. Doporučuje se omezit počet souborů v jednom commitu na méně než 100 a celkovou velikost projektu na méně než 100 MB, pokud používáte synchronizaci s GitHubem. Projekty nad tyto velikosti mohou fungovat, ale doporučujeme zůstat v těchto limitech, aby se předešlo možným problémům se synchronizací. ### Odpojení projektu od repozitáře Ačkoli je možné vytvořit více projektů z jednoho existujícího repozitáře GitHub, **není možné změnit repozitář přiřazený danému projektu**. Jakmile je projekt propojen s repozitářem, nelze jej odpojit a použít k vytvoření nového repozitáře. Pokud potřebujete vytvořit nový repozitář z konkrétního projektu, musíte vytvořit novou kopii projektu a poté z této kopie vytvořit nový repozitář. ### Známá omezení **Větve**: Gitový systém Overleafu nepodporuje větvení. **Symlinky**: Systém Git v Overleafu nezpracovává symbolické odkazy. Symbolický odkaz lze odeslat do projektu v Overleafu, ale bude převeden na běžný soubor a při příštím stažení projektu přepíše místní symbolický odkaz. **Oprávnění souborů**: Systém Git v Overleafu nezachovává spustitelná oprávnění. Při práci se synchronizací s GitHubem, pokud jsou do Overleafu synchronizovány nějaké soubory se spustitelným bitem v GitHubu, Overleaf spustí automatický commit, aby oprávnění souborů obnovil. **Git LFS**: Projekty v Overleafu nepodporují Git Large File Storage. **Git submoduly**: Projekty v Overleafu mohou fungovat jako Git submoduly v rámci jiných repozitářů, ale nemohou obsahovat další Git submoduly. Pro odkazování na soubory z jiných projektů se doporučuje použít funkci přidání z jiného projektu. **Sledované změny a komentáře**: Bohužel stažení z GitHubu do Overleafu může vést ke ztrátě nebo přesunutí sledovaných změn a komentářů; proto nedoporučujeme kombinovat aktivní práci na GitHubu s používáním sledovaných změn a/nebo komentářů. **Přímá synchronizace s GitHub Enterprise nebo GitLabem:** Rozhraní GitHub API používané Overleafem se může připojit pouze k repozitářům hostovaným na github.com. Nepřímo můžete synchronizovat s projekty hostovanými u jiných poskytovatelů pomocí [integrace Git v Overleafu](/latex/cs/znalostni-baze/040-git-integration.md) . **Připojení existujícího projektu k existujícímu repozitáři**: Není možné synchronizovat existující projekt v Overleafu s existujícím repozitářem GitHubu. **Autorství odeslání na GitHub**: Jediný uživatel GitHubu, o kterém Overleaf ví, je uživatel, jehož účet GitHub je propojen s účtem Overleaf a který vlastní daný projekt. Všechny commity jsou vytvářeny pomocí rozhraní GitHub API, které tyto commity výslovně vytváří pod identitou daného uživatele. Všechny commity se tedy v historii GitHubu zobrazí jako pocházející z propojeného uživatele. V historii Overleafu se změny zobrazují jako "Anonymní (přes GitHub)". **Historie Gitu a historie Overleafu:** Změny na straně Overleafu nemají vztah jedna ku jedné s commity na GitHubu. Více uživatelů může provádět změny na straně Overleafu, ale tyto změny budou při spuštění synchronizace sloučeny do jediného commitu pod připojeným uživatelem GitHubu. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/cs/znalostni-baze/044-github-synchronization.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.