> 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/fi/tietopankki/044-github-synchronization.md). # GitHub-synkronointi **GitHub-synkronointi** on [premium-ominaisuus](/latex/fi/tietopankki/120-overleaf-premium-features.md). Overleafin premium-ominaisuudet ovat käytettävissä osallistujille [Overleaf Commonsissa](https://www.overleaf.com/for/universities), ryhmän [tilausten](https://www.overleaf.com/for/groups), ja yksittäisten [tilausten](https://www.overleaf.com/user/subscription/plans). Yhteenveto GitHub-synkronointiominaisuuden avulla voit linkittää Overleaf-projektisi suoraan GitHub-arkistoon, joka toimii Overleaf-projektisi etäarkistona ja tarjoaa tavan viedä ja tuoda muutoksia niiden välillä. GitHub-synkronointia voi käyttää vain [GitHub.com](https://www.github.com) eikä sitä voi käyttää yhteyden muodostamiseen muihin GitHub Enterprise -asennuksiin. Voit synkronoida Overleaf-projektin GitHub-arkiston kanssa joko luomalla uuden Overleaf-projektin olemassa olevasta GitHub-arkistosta tai luomalla uuden GitHub-arkiston olemassa olevasta Overleaf-projektista. Olemassa olevan Overleaf-projektin synkronointi olemassa olevan GitHub-arkiston kanssa ei ole mahdollista. * GitHub-synkronointi otetaan käyttöön yhdistämällä GitHub-tilisi Overleaf-tiliisi * Uusia projekteja voidaan luoda olemassa olevista GitHub-arkistoista * Arkistoja voidaan luoda GitHubissa olemassa olevien Overleaf-projektien perusteella * Linkitetyt projektit ja arkistot pidetään synkronissa käyttämällä **GitHub** vaihtoehtoa projektin **Valikko** ### Overleaf-tilisi linkittäminen GitHub-tiliisi Jotta voit käyttää GitHub-synkronointiominaisuutta, sinun on linkitettävä Overleaf-tilisi GitHub-tiliisi. Voit tehdä tämän Overleaf- [Tiliasetuksia](https://www.overleaf.com/user/settings). Huomaa, että Overleafin mahdollisuus yhdistää tiettyihin tiliisi liitettyihin arkistoihin tai organisaatioihin voi riippua GitHubissa määritetyistä käyttöoikeusasetuksista. ### Uuden Overleaf-projektin luominen GitHub-arkistosta Uusi projekti -valikosta voit valita GitHub-vaihtoehdon. Tämä näyttää sinulle luettelon arkistoista, jotka ovat näkyvissä Overleafille GitHub-tilisi kautta GitHubin käyttöoikeusasetustesi perusteella. ![Luo uusi github.png](/files/5a02358d7cc432ab2bd4bc1e36593f6d5b79e7c6) Muutama huomio, kun luot uuden Overleaf-projektin olemassa olevasta GitHub-arkistosta. * Overleaf-projekteihin sovelletaan kokorajoituksia, jotka voivat estää suurempien GitHub-arkistojen käytön projektin luomiseen. Katso [tältä sivulta](/latex/fi/tietopankki/119-overleaf-plan-limits.md) yleiskatsaus Overleaf-projektin tiedostojen kokoon ja määrään sovellettavista rajoituksista. * Overleaf-projektit eivät tue Git-alimoduuleja tai Git LFS:ää. ### Uuden GitHub-arkiston luominen Overleaf-projektista Overleaf-projektivalikosta voit valita synkronointivaihtoehdoista GitHubin. Tämä avaa valintaikkunan, jossa voit antaa uuden GitHub-arkiston nimen, jonka kanssa Overleaf-projektisi synkronoidaan. ![Projektivalikko github.png](/files/b032478fac24368e5072272fe3003b394c81c886) ### Synkronointi GitHubin kanssa GitHubin ja Overleafin välinen synkronointi ei tapahdu automaattisesti, synkronointivaihtoehdot näytetään napsauttamalla **GitHub** vaihtoehtoa projektin **Valikko**. Tällöin GitHub-valintaikkuna ilmoittaa, onko GitHubista tuotavia uusia muutoksia. Sinulle tarjotaan aina mahdollisuus viedä muutokset GitHubiin (huom: tämä vaihtoehto näytetään, vaikka Overleaf ja GitHub olisivat ajan tasalla). ![kuva GitHub-valintaikkunasta](/files/ea68b65378f64751f9ed39b9415a825ff0f25341) Commitit GitHubiin luodaan, kun Pushaa Overleafin muutokset GitHubiin -painiketta napsautetaan. Tällöin voidaan antaa valinnainen commit-viesti. * GitHubista Overleafiin tuodut muutokset näkyvät nimettömän tekijän tekemiksi. * Overleafista GitHubin historiaan viedyt muutokset näkyvät yhdistetyn GitHub-tilin omistajan tekemiksi. ### Yhdistämisristiriitojen ratkaiseminen Voi käydä niin, että kun muutoksia tehdään sekä Overleafissa että GitHubissa, Git ei pysty selvittämään, miten ne yhdistetään automaattisesti. Esimerkiksi jos yhteistyökumppanisi muutti rivin Overleafissa ja sinä muutit saman rivin GitHub-arkistossa, Overleaf ei ehkä pysty valitsemaan, kumpi versio säilytetään. Kun näin tapahtuu, emme yhdistä muutoksia päähaaraasi, vaan työnnämme uuden haaran arkistoosi. Tällä haaralla on kuvaava nimi (mukaan lukien haaran luomisen päivämäärä ja aika), ja se sisältää Overleafissa olevan asiakirjan version. Kun yrität synkronoida GitHubin kanssa, näytetään viesti, jossa kerrotaan, että yhdistämisristiriita on ratkaistava. ![GitHubin yhdistämisristiriita -valintaikkuna](/files/173f435958e0a7bd253cb36fa2ab4b7ffbbe4016) Jotta saat synkronoinnin takaisin, sinun on yhdistettävä Overleaf-haara pää-(oletus)haaraasi. Voit tehdä tämän tietokoneellasi vetämällä molemmat haarat ja yhdistämällä ne gitillä tai jollakin muulla työkalulla ja työntämällä sitten tuloksen takaisin GitHubiin. Vaihtoehtoisesti voit tehdä yhdistämisen suoraan GitHubissa luomalla vetopyynnön Overleaf-haarasta ja käyttämällä heidän ristiriitojenratkaisutoimintoaan. Molemmat lähestymistavat selitetään [GitHubin dokumentaatiossa](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). ### GitHub-arkistoihin pääsy organisaatioissasi Voit synkronoida Overleaf-projekteja yhdistettyyn GitHub-tiliisi liitettyjen arkistojen kanssa ja voit myös synkronoida projekteja GitHub-organisaatioissa, joiden jäsen olet. Jotta voit synkronoida arkistojen kanssa sinuun liitetyissä GitHub-organisaatioissa, näiden organisaatioiden on annettava Overleafin OAuth-sovellukselle lupa käyttää niitä. * Jos olet organisaation jäsen, voit seurata vaiheita, jotka on kuvattu [täällä](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) pyytääksesi Overleaf-sovellukselle pääsyä organisaatioosi. * Jos olet organisaation omistaja, voit seurata vaiheita, jotka on kuvattu [täällä](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) hyväksyäksesi Overleaf-sovelluksen organisaatiolle. ### GitHub-synkronoinnin tiedostorajat Overleaf-projekteihin sovelletaan yksittäisiä kokorajoituksia sekä rajoituksia projektin tiedostojen kokonaismäärälle, kuten on mainittu [täällä](/latex/fi/tietopankki/119-overleaf-plan-limits.md). Vaikka Git itse pystyy käsittelemään yhden commitin, joka muuttaa tuhansia tiedostoja, Overleafin GitHub-synkronointiominaisuudessa käytetty GitHub API asettaa myös rajoituksia niiden tiedostojen määrälle, joita voidaan viedä tai tuoda. On suositeltavaa rajoittaa yksittäisen commitin tiedostojen määrä alle 100 tiedostoon ja koko projektin koko alle 100 MB:iin, jos käytetään GitHub-synkronointia. Näitä suuremmat projektit voivat toimia, mutta suosittelemme pysymään näiden rajojen sisällä mahdollisten synkronointiongelmien välttämiseksi. ### Projektin irrottaminen arkistosta Vaikka on mahdollista luoda useita projekteja yhdestä olemassa olevasta GitHub-arkistosta, **ei ole mahdollista muuttaa tiettyyn projektiin liitettyä arkistoa**. Kun projekti on linkitetty arkistoon, sitä ei voi irrottaa ja käyttää uuden arkiston luomiseen. Jos sinun on luotava uusi arkisto tietystä projektista, sinun on tehtävä projektista uusi kopio ja sitten luotava uusi arkisto kopiosta. ### Tunnetut rajoitukset **Haarat**: Overleafin Git-järjestelmä ei tue haarautumista. **Symlinkit**: Overleafin Git-järjestelmä ei tue symbolisia linkkejä. Symbolinen linkki voidaan työntää Overleaf-projektiin, mutta se muunnetaan tavalliseksi tiedostoksi, ja se korvaa paikallisen symbolisen linkin seuraavan kerran, kun projekti vedetään. **Tiedostojen käyttöoikeudet**: Overleafin Git-järjestelmä ei säilytä suoritusoikeuksia. Kun työskentelet GitHub-synkronoinnin kanssa, jos GitHubissa olevia tiedostoja, joissa on suoritusbitti, synkronoidaan Overleafiin, Overleaf käynnistää automaattisen commitin nollatakseen tiedostojen käyttöoikeudet. **Git LFS**: Overleaf-projektit eivät tue Git Large File Storagea. **Git-alimoduulit**: Overleaf-projektit voivat toimia Git-alimoduuleina muissa arkistoissa, mutta ne eivät voi sisältää muita Git-alimoduuleja. Viitataksesi tiedostoihin muista projekteista, on suositeltavaa käyttää lisää toisesta projektista -ominaisuutta. **Seuratut muutokset ja kommentit**: Valitettavasti GitHubista Overleafiin tehdyt pullit voivat johtaa seurannan muutosten ja kommenttien katoamiseen tai siirtymiseen; siksi emme suosittele aktiivisen työn tekemisen GitHubissa ja seurannan muutosten ja/tai kommenttien käyttöä yhtä aikaa. **Suora synkronointi GitHub Enterpriseen tai GitLabiin:** Overleafin käyttämä GitHub API voi yhdistää vain github.comissa isännöityihin arkistoihin. Voit synkronoida epäsuorasti muiden tarjoajien isännöimien projektien kanssa käyttämällä [Overleafin Git-integraatiota](/latex/fi/tietopankki/040-git-integration.md) ominaisuutta. **Yhdistäminen olemassa oleva projekti olemassa olevaan arkistoon**: Olemassa olevan Overleaf-projektin synkronointi olemassa olevan GitHub-arkiston kanssa ei ole mahdollista. **GitHubiin tehtyjen lähetysten tekijyys**: Ainoa GitHub-käyttäjä, josta Overleaf tietää, on käyttäjä, jonka GitHub-tili on linkitetty Overleaf-tiliin ja joka omistaa kyseisen projektin. Kaikki commitit tehdään GitHub API:n avulla, joka nimenomaisesti tekee nämä commitit kyseisen käyttäjän identiteetillä. Siksi kaikki commitit näkyvät GitHubin Git-historiassa tulevan linkitetyltä käyttäjältä. Overleafin historiassa muutokset näkyvät muodossa "Nimetön (GitHubin kautta)". **Git-historia ja Overleaf-historia:** Overleaf-puolella tehdyillä muutoksilla ei ole yksi yhteen -vastaavuutta GitHubin commitien kanssa. Overleaf-puolella muutoksia voivat tehdä useat käyttäjät, mutta kun synkronointi käynnistetään, nämä muutokset niputetaan yhdeksi commitiksi yhdistetyn GitHub-käyttäjän alle. --- # 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/fi/tietopankki/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.