> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Git-integraatio

> Luo käyttötunnus, kloonaa projekti Gitillä ja tee sitten pull ja push.

Työskentele projektin parissa omalla tietokoneellasi Gitin avulla. Muutokset siirtyvät vain, kun suoritat `git pull`- tai `git push`-komennon.

> [!NOTE]
>
> Ylläpitäjän on ensin otettava [Git-integraatio](https://ayakaleaf-pro.mintlify.site/fi/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md) käyttöön.

## Tunnuksen luominen

Git kirjautuu Gitin todennustunnuksella, ei tilisi salasanalla.

**1. Avaa tilisi asetukset**

Valitse **Account** ja sitten **Account settings**. Valitse **Git integration** -kohdassa **Generate token**. Kun sinulla on tunnus, tämän painikkeen nimi on **Add another token**.

![Tilin asetusten Git integration -osio ja Generate token -painike](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-settings.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4ff1f16eb46266f7bf31956bf3b9d89)

Git-integraatio tilin asetuksissa

**2. Kopioi tunnus**

Valitse **Copy** ja säilytä tunnus turvallisessa paikassa. Näet sen vain kerran. Valitse sitten **Close**.

![Gitin todennustunnuksen valintaikkuna ja Copy-painike](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Uusi tunnuksesi

**3. Tarkista tunnus**

Luettelossa näkyy nyt tunnuksen alku, sen luontiaika ja viimeisin käyttöaika. Tunnus vanhenee vuoden kuluttua. Sinulla voi olla enintään 10 tunnusta.

![Tunnusluettelo, jossa on yksi tunnus](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Tunnuksesi

## Projektin kloonaaminen

**1. Avaa Git-integraatio editorissa**

Avaa projekti. Valitse vasemmasta palkista **Integrations** ja sitten **Git integration**.

![Integrations-paneeli ja Git integration -kortti](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-panel.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=3fb82c63ba8d205191eadb5015bdefb5)

Integrations-paneeli

**2. Kopioi komento**

**Clone with Git** -valintaikkuna näyttää komennon, jossa on sivustosi osoite ja projektin tunnus. Valitse **Copy**. Jos sinulla ei vielä ole tunnusta, **Go to settings** avaa tilisi asetukset uudessa välilehdessä.

![Clone with Git -valintaikkuna ja git clone -komento](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-clone.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f6d69046df7caf4cbee07f49e8dd6540)

Kloonauskomento

**3. Suorita komento**

Liitä komento päätteeseen. Kun Git pyytää salasanaa, liitä tunnuksesi.

```text theme={null}
$ git clone https://git@<your-site>/git/<project-id>
Cloning into '<project-id>'...
Password for 'https://git@<your-site>': <your-token>
```

Projektin tunnuksen mukaan nimetyssä kansiossa ovat nyt projektin tiedostot `main`-haarassa. Jos haluat valita kansion nimen, lisää se komennon loppuun.

Git kysyy tunnusta aina, kun se ottaa yhteyden sivustoon. Jotta tunnus muistetaan, ota käyttöön credential helper: Git kysyy vielä kerran ja säilyttää sitten tunnuksen. `store`-helper tallentaa sen salaamattomana tiedostoon `~/.git-credentials`.

```bash theme={null}
git config --global credential.helper store
```

## Muutosten hakeminen editorista

Suorita kansiossa:

```bash theme={null}
git pull
```

Git luettelee muuttuneet tiedostot. Editorissa tehdyt muutokset saapuvat committeina, joiden nimi on `Update on Overleaf.`.

```text theme={null}
Updating db007e3..c3e6332
Fast-forward
 main.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
```

## Muutosten lähettäminen

Tee muutoksistasi commit ja lähetä ne:

```bash theme={null}
git add main.tex
git commit -m "Add a line from Git"
git push
```

Tulosteen viimeinen rivi näyttää haaran, joka siirtyi:

```text theme={null}
   53aca61..db007e3  main -> main
```

Muutokset näkyvät editorissa, ja avoinna oleva editori päivittyy itsestään. Uudet tiedostot, kansiot ja uudelleennimeämiset näkyvät tiedostopuussa. **History**-näkymässä muutoksesi on merkitty **You (via Git)**. Commit-viestiäsi ei näytetä siellä.

![Projektin historia, jossa lähetetty rivi on merkitty You (via Git)](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-history.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f4d5575612ebd75db3656cac1ea495)

Push projektin historiassa

### Jos Git hylkää pushin

Jos projekti on muuttunut sillä välin, Git hylkää pushin:

```text theme={null}
 ! [rejected]        main -> main (fetch first)
```

Hae ensin nuo muutokset ja lähetä sitten uudelleen:

```bash theme={null}
git pull --no-rebase --no-edit
git push
```

Pelkkä `git pull` voi pysähtyä viestiin `fatal: Need to specify how to reconcile divergent branches.` Yllä oleva `--no-rebase`-valinta ratkaisee tämän: se yhdistää molemmat puolet.

Jos samat rivit ovat muuttuneet molemmilla puolilla, pull pysähtyy viestiin `CONFLICT (content): Merge conflict in main.tex`. Korjaa tiedosto ja suorita sitten:

```bash theme={null}
git add main.tex
git commit -m "Merge the changes from the editor"
git push
```

Sivusto ei hyväksy kahta asiaa:

* Muut haarat: `! [remote rejected] feature -> feature (wrong branch)`. Vain `main` on olemassa, joten lähetä työsi sinne.
* Pakotettu push: `! [remote rejected] main -> main (forced push prohibited)`. Lisää muutoksesi sen sijaan nykyisen `main`-haaran päälle.

### Jos Git ilmoittaa Authentication failed

```text theme={null}
remote: Enter your Git authentication token when prompted for a password.
fatal: Authentication failed for 'https://<your-site>/git/<project-id>/'
```

Tunnus on väärä tai poistettu, tai syötit tilisi salasanan. Luo uusi tunnus, jos sinulla ei enää ole sitä, koska olemassa olevaa tunnusta ei voi nähdä uudelleen.

## Tunnuksen poistaminen

Valitse **Account settings** -kohdan **Git integration** -osiossa tunnuksen vieressä oleva poistokuvake ja sitten valintaikkunassa **Delete**. Sen jälkeen Git vastaa tälle tunnukselle `Authentication failed`.

![Delete Authentication token -valintaikkuna](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-delete-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=1708062228778239c6465b0369614a18)

Tunnuksen poistaminen

> [!NOTE]
>
> Mitä vain lukuoikeuden omaavat yhteistyökumppanit voivat tehdä, kerrotaan [Git-integraation](https://ayakaleaf-pro.mintlify.site/fi/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md) Q\&A-osiossa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.