Eksport af projekter

I Server Pro og Community Edition 5.4.0 har vi inkluderet et script, der giver administratorer mulighed for at eksportere alle brugerprojekter (inklusive dem, der stadig er synlige i mapperne Slettet og Papirkurv) til en mappe på disken.

Outputtet fra dette script er det samme som ved manuelt at downloade en zip-fil med alle projekter fra brugerens projektoversigt. Scriptet gemmer alle ventende ændringer, før downloadet starter, for at sikre, at eksporten indeholder den nyeste version af projektet.

​

Begrænsninger

Eksportscriptet har følgende begrænsninger:

• Ingen projektindstillinger, såsom navnet på TeX Live-imaget eller kompileren, eksporteres. Disse skal angives, når projektet uploades til brugerens konto.
• Eksporterede projekter indeholder ingen versionshistorik.
• Ingen oplysninger om samarbejdspartnere bevares. Projekterne skal deles igen. Hvis der bruges linkdeling, genereres links til visning og redigering på ny (de vil ikke være de samme som før).
• Kommentarer og oplysninger om sporede ændringer eksporteres ikke.
• Projektets chathistorik eksporteres ikke.

Dette script er ikke designet til at erstatte en fuld sikkerhedskopi af systemet. For at sikre, at du kan gendanne din instans i et katastrofescenarie, anbefaler vi kraftigt, at du tager en konsistent sikkerhedskopi.

​

Flag

Navn	Beskrivelse
--help	Vis hjælp
--user-id	Bruger-ID’et (påkrævet, medmindre du bruger --export-all eller --project-id)
--project-id	Eksporter et enkelt projekt (kan ikke bruges sammen med --user-id eller --export-all)
--list	Vis brugerens projekter (kan ikke bruges sammen med --output)
--output	Zip-fil til output (ved enkeltstående eksportoperationer)
--export-all	Eksporter alle brugeres projekter (kræver --output-dir)
--output-dir	Mappe til lagring af alle brugeres eksportfiler
--log-level	Understøttede logniveauer: trace|debug|info|warn|error|fatal

​

Brug

Brug følgende kommando til at eksportere projekter for alle brugere:

# Overleaf Toolkit users
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# Legacy docker-compose.yml users
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

Hvis du kører Server Pro eller Community Edition <= 3.5.13, skal du opdatere ovenstående eksempel til at bruge scriptet export-legacy-user-projects.js.

​

Afslutning

Når eksporten er færdig, kan du få adgang til filerne via den mappe på værten, der er bind-monteret til /var/lib/overleaf i din docker-compose.yml-fil, eller via miljøvariablen OVERLEAF_DATA_PATH i filen config/overleaf.rc, hvis du bruger Toolkit.

Overleaf tillader i øjeblikket dublerede projektnavne. Hvis en bruger har projekter med samme navn, bliver disse projekter stadig tilføjet til brugerens zip-eksport, men ved udpakning vil kun én version være til stede. På Linux skriver unzip -B filer med samme navn som sikkerhedskopifiler i stedet for at overskrive dem.