> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Varmuuskopioi Macaly-projektisi ja synkronoi se GitHubin kanssa

Macalyn GitHub-integraatio yhdistää projektisi yksityiseen GitHub-repositorioon. Voit varmuuskopioida koodisi, synkronoida muutokset kumpaankin suuntaan ja jatkaa projektia uudessa keskustelussa, kun sille tulee tarve.

<Callout icon="user">
  Saatavilla [**Pro- ja Toimisto-paketeissa**](/docs/fi/welcome/pricing). Voit yhdistää minkä tahansa maksullisen workspacen kautta, jonka jäsen olet, vaikka henkilökohtainen workspacesi olisi Ilmainen-paketissa.
</Callout>

## Miksi yhdistää GitHub

* **Varmuuskopioi projektisi yksityiseen repositorioon.** Koodisi sijaitsee GitHub-repositoriossa, jonka omistat itse.
* **Työnnä päivitykset GitHubiin.** Lähetä Macalyn uusin versio repositorioon pull requestina, jonka yhdistät itse.
* **Vedä muutokset takaisin projektiisi.** Palauta projektisi GitHubiin tallennettuun versioon.
* **Tuo projekti GitHubista.** Aloita uusi Macaly-projekti repositoriosta, jonka olet aiemmin työntänyt.

## Yhdistä GitHub projektiisi

<Steps>
  <Step title="Avaa projektin asetukset">
    Napsauta projektissasi yläpalkin **Asetukset**-kohtaa ja avaa **Yleiset**-välilehti.
  </Step>

  <Step title="Luo repositorio">
    Vieritä kohtaan **GitHub-yhteys** ja napsauta **Luo GitHubiin**. Ensimmäisellä kerralla valtuutat Macalyn GitHubissa ja valitset, minkä GitHub-tilin tai organisaation yhdistät. Valitse tili, jolle sovellus on jo asennettu, tai valitse **Install on another GitHub account**. Macaly luo sitten yksityisen repositorion ja synkronoi projektisi sinne.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_create.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=52b1131022af029916fa54a18c0d8733" alt="Asetukset, Yleiset, GitHub-yhteys, Luo GitHubiin -painike" width="2400" height="1600" data-path="images/integrations_github_create.png" />
  </Step>

  <Step title="Repositoriosi on yhdistetty">
    Osiossa näkyy nyt repositorion nimi ja linkki, josta se aukeaa GitHubissa. Tästä eteenpäin voit työntää ja vetää muutoksia.
  </Step>
</Steps>

## Työnnä ja vedä muutoksia

Kun repositorio on yhdistetty, **GitHub-yhteys**-osiossa on kaksi painiketta:

* **Työnnä muutokset** lähettää Macalyn uusimman version GitHubiin. Macaly avaa pull requestin otsikolla ”Updates from Macaly”, jonka tarkistat ja yhdistät GitHubissa.
* **Vedä muutokset** korvaa projektisi tiedostot GitHubissa olevalla versiolla. Macaly pyytää ensin vahvistuksesi. `.env`- ja `.env.local`-tiedostosi säilyvät aina.

Voit poistaa repositorion yhteyden napsauttamalla sen nimen vieressä olevaa `X`-painiketta.

## Tuo projekti GitHubista

Voit aloittaa uuden Macaly-projektin repositoriosta, jonka olet aiemmin työntänyt Macalysta.

<Steps>
  <Step title="Ota tuontitoiminto käyttöön">
    Avaa tiliasetuksissa **Asetukset**, vieritä kohtaan **Lisäasetukset** ja ota käyttöön **Tuo GitHubista**. Tämä näyttää toiminnon aloitusnäytössä.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_import.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=062a4da2b66d8f3e5694b99325da393c" alt="Asetukset, Lisäasetukset, Tuo GitHubista -kytkin" width="2400" height="1600" data-path="images/integrations_github_import.png" />
  </Step>

  <Step title="Avaa Tuo GitHubista">
    Avaa aloitusnäytössä kehotekentän **+**-valikko ja valitse **Tuo GitHubista**.
  </Step>

  <Step title="Valitse repositorio">
    Hae repositorio ja valitse se. Macaly luo siitä uuden projektin. **Määritä**-painikkeella yhdistät GitHubin uudelleen tai vaihdat tiliä, ja **Päivitä**-painikkeella lataat luettelon uudelleen. Näet vain ne repositoriot, joihin GitHub-tililläsi on pääsy.
  </Step>
</Steps>

<Note>
  Tuonti toimii repositorioilla, jotka Macaly on luonut. Muiden kuin Macalyn luomien ulkoisten repositorioiden tuontia ei tueta.
</Note>

## Mitä synkronoidaan

Mukaan tulevat projektisi tiedostot, komponentit, sivut, tyylit, resurssit ja Macalyn määritykset. Ympäristömuuttujia (`.env`-tiedostoja) ja välimuistitiedostoja ei koskaan työnnetä, eikä vetäminen koskaan korvaa `.env`- ja `.env.local`-tiedostojasi.

## Hyvä tietää

* **Repositoriot ovat aina yksityisiä.** Macaly ei koskaan tee koodistasi julkista.
* **Ilmainen GitHub-tili riittää.** Maksullista GitHub-pakettia ei tarvita.
* **Työntäminen avaa pull requestin**, jonka yhdistät GitHubissa. Se ei muuta julkaistua sivustoasi.
* **Vetäminen korvaa projektisi tiedostot**, mutta säilyttää `.env`- ja `.env.local`-tiedostosi.


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