> ## 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.

# Dropbox-synkronisering

<Info>
  Denne funktion er udviklet af [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Den er introduceret i v6.4.0 og senere. Den er stadig i betastatus. Vi har brug for din feedback, hvis du oplever problemer.
</Info>

Dropbox-synkronisering holder en brugers projekter synkroniseret med brugerens Dropbox, ligesom på Overleaf Cloud: når en bruger har tilknyttet sin Dropbox-konto, vises hvert af brugerens projekter som en mappe i `Apps/<your Dropbox app>/`, ændringer i Overleaf sendes til Dropbox, og ændringer foretaget i Dropbox kommer tilbage til Overleaf.

### Opsætning af Dropbox-synkronisering

<Warning>
  Du skal først aktivere [git-bridge](/da/on-premises/configuration/overleaf-toolkit/git-integration): uden den skjuler kontoindstillingerne afsnittet om projektsynkronisering.

  ```dotenv title="config/overleaf.rc" theme={null}
  GIT_BRIDGE_ENABLED=true
  ```
</Warning>

Opret en app i [Dropbox App Console](https://www.dropbox.com/developers/apps), mens du er logget ind med den Dropbox-konto, der skal eje appen:

1. Klik på **Create app**, og udfyld derefter siden:
   * **1. Choose an API**: vælg **Scoped access**.
   * **2. Choose the type of access you need**: vælg **App folder**, ikke **Full Dropbox**. Overleaf synkroniserer kun inden for appens mappe.
   * **3. Name your app**: angiv et navn, f.eks. `Overleaf`. Det skal være unikt på Dropbox. Hver brugers projekter vises i `Apps/<name of your app>/` i brugerens Dropbox, og dette navn er `DROPBOX_APP_NAME` nedenfor.
   * Klik på **Create app**. Appen åbnes på fanen **Settings**.
2. På fanen **Permissions** skal du under **Files and folders** markere `files.metadata.write`, `files.content.write` og `files.content.read`. `account_info.read` og `files.metadata.read` markeres sammen med dem og kan ikke fravælges. Markér ikke andre tilladelser.
3. Klik på **Submit** i bjælken nederst på fanen **Permissions**. **Uden Submit gemmes tilladelserne ikke**, og Dropbox nægter at synkronisere filer for de brugere, der tilknytter deres konto.

<Frame caption="Dropbox App Console: de tilladelser, der skal markeres og gemmes med Submit">
  <img src="https://mintcdn.com/ayakaleaf-pro/34P8O6kHo91beEvQ/images/on-premises/dropbox-app-permissions.png?fit=max&auto=format&n=34P8O6kHo91beEvQ&q=85&s=8e99711b1fcf03d3d1655f65fea3a6b8" alt="" width="2302" height="1444" data-path="images/on-premises/dropbox-app-permissions.png" />
</Frame>

4. På fanen **Settings** skal du under **OAuth 2** angive `${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback` i **Redirect URIs** og derefter **klikke på Add**. Det er ikke nok at skrive URI'en: den gemmes først, når den vises i listen over feltet.

<Frame caption="Dropbox App Console: angiv redirect-URI'en, og klik derefter på Add">
  <img src="https://mintcdn.com/ayakaleaf-pro/34P8O6kHo91beEvQ/images/on-premises/dropbox-app-redirect-uri.png?fit=max&auto=format&n=34P8O6kHo91beEvQ&q=85&s=d980dc4dec22a90b5bf1f7e147cfc7c0" alt="" width="2788" height="1450" data-path="images/on-premises/dropbox-app-redirect-uri.png" />
</Frame>

5. På fanen **Settings** skal du under **Webhooks** angive `${OVERLEAF_SITE_URL}/dropbox/webhook` i **Webhook URIs** og derefter også **klikke på Add**. Dropbox kalder den med det samme for at kontrollere den, så Overleaf skal allerede køre med indstillingerne nedenfor og kunne nås fra internettet (se [Webhook](#webhook)). Dens status viser **Enabled**, når kontrollen er bestået.

Kopiér **App key** og **App secret** (klik på **Show**) fra fanen **Settings**, og tilføj derefter følgende indstillinger til dine Overleaf-miljøvariabelfiler. Du kan tilføje webhooken (trin 5), når Overleaf kører med dem.

```dotenv title="config/variables.env" wrap theme={null}
# used to encrypt the user's Dropbox refresh token.
# How to generate: `openssl rand -hex 32`
DROPBOX_TOKEN_CIPHER_PASSWORD=0123456789ABCDEFG # changed to yours

# Dropbox Sync Settings
DROPBOX_ENABLED=true
DROPBOX_APP_KEY=
DROPBOX_APP_SECRET=
# the name of your Dropbox app (step 1), which is the folder name in Apps/
DROPBOX_APP_NAME=Overleaf

# OAuth callback is: ${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback
# Webhook is: ${OVERLEAF_SITE_URL}/dropbox/webhook
# (Optional) DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808
```

<Warning>
  * Før du konfigurerer redirect-URI'en og webhooken, skal du sikre dig, at `OVERLEAF_SITE_URL` er sat korrekt.
  * Dropbox fastlåser et tokens tilladelser, når brugeren tilknytter sin konto: indsendelse af tilladelser ændrer ikke eksisterende tokens. Brugere, der tilknyttede deres konto, før tilladelserne blev indsendt, eller før du ændrede dem, skal fjerne tilknytningen til deres Dropbox-konto og tilknytte den igen.
  * En ny app har status **Development**. Hvis **Development users** på fanen **Settings** viser **Only you**, kan kun din Dropbox-konto tilknyttes: klik på **Enable additional users** for at lade andre brugere tilknytte deres. Derefter vises det, hvor mange brugere der har tilknyttet deres konto, f.eks. `1 / 500`: **en Development-app tillader højst 500 brugere**. For flere brugere skal du klikke på **Apply for production**, hvorefter Dropbox gennemgår appen.
</Warning>

Hvis du befinder dig i en region med begrænset netværksadgang, kan det være nødvendigt at konfigurere en proxy for at få adgang til Dropbox. Sæt følgende miljøvariabel: `DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808`. Det skal være en almindelig HTTP/HTTPS-videresendelsesproxy, og den må ikke bruge `127.0.0.1`.

### Webhook

Dropbox fortæller Overleaf om ændringer i Dropbox via en webhook, så de vises i Overleaf inden for få sekunder. Webhooken sendes til dit websteds adresse, `${OVERLEAF_SITE_URL}/dropbox/webhook`. Der kræves ingen ekstra port, men **Dropbox skal kunne nå den fra internettet**. Når du tilføjer den i App Console, kontrollerer Dropbox den med det samme.

Uden en webhook, for eksempel på en server som Dropbox ikke kan nå, sendes ændringer i Overleaf stadig til Dropbox, men ændringer i Dropbox kommer først tilbage, når en bruger klikker på *sync this project now* i editorens Dropbox-dialog.

### Sådan fungerer synkronisering

* **Tilknytning**: når en bruger tilknytter sin Dropbox-konto, sendes de projekter, brugeren ejer, til Dropbox. Projekter, der er delt med brugeren, vises i Dropbox ved deres næste ændring.
* **Overleaf til Dropbox**: nye filer, omdøbninger, flytninger, sletninger og omdøbninger af projekter sendes med det samme. Redigeringer i editoren sendes, når Overleaf gemmer dem i sit lager, nogle minutter efter at alle har forladt projektet. For at sende dem tidligere skal du klikke på *sync this project now* i editorens Dropbox-dialog (én gang i minuttet).
* **Dropbox til Overleaf**: nye og ændrede filer, nye mapper og sletninger i en projektmappe anvendes på projektet. En ny mappe øverst i appmappen bliver til et nyt projekt. Hvis en projektmappe slettes i Dropbox, markeres projektet som slettet i Overleaf.
* **Konflikter**: når en fil ændres begge steder på samme tid, vinder den seneste ændring. Dropbox kan beholde den anden version som en *conflicted copy*.
* **Samarbejdspartnere**: samarbejdspartnere, der tilknytter deres Dropbox, får de projekter, der er delt med dem. Seere med kun læseadgang og korrekturlæsere får projektet, men deres ændringer i Dropbox synkroniseres ikke tilbage til Overleaf.
* **Ignorerede filer**: filer, som Overleaf ikke synkroniserer, f.eks. build-output (`.aux`, `.log`, …), `.DS_Store` eller virtuelle Python-miljøer, forbliver kun i Dropbox.

### Q\&A

<Accordion title="Hvorfor kan en bruger ikke tilknytte sin Dropbox-konto?">
  <strong>Svar:</strong>

  * Projekter matches med Dropbox-mapper efter navn, så en bruger, der har to projekter med samme navn, bliver bedt om først at omdøbe et af dem.
  * En Dropbox-konto kan kun tilknyttes én Overleaf-konto.
</Accordion>

<Accordion title="Hvorfor blev tilknytningen til en Dropbox-konto fjernet?">
  <strong>Svar:</strong> Overleaf fjerner tilknytningen til en Dropbox-konto, når Dropbox afviser dens token (for eksempel efter at brugeren har fjernet appen i Dropbox), når Dropbox er fuld, eller når Dropbox har suspenderet kontoen. Brugeren kan tilknytte den igen, når problemet er løst.
</Accordion>

<Accordion title="Kan jeg omdøbe en projektmappe i Dropbox?">
  <strong>Svar:</strong> Omdøb i stedet projektet i Overleaf. For Overleaf betyder en omdøbning af mappen i Dropbox, at projektmappen slettes, og en ny oprettes, så det gamle projekt markeres som slettet, og et nyt projekt oprettes ud fra filerne.
</Accordion>


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