Siirtyminen olemassa olevasta asennuksesta

Siirrä olemassa oleva Overleaf Toolkit -käyttöönotto Ayakaleaf Prohon.

On tärkeää varmistaa, että otat yhtenäisen varmuuskopion ennen jokaista pääversion siirtoa, jotta voit tarvittaessa palata aiempaan versioon.

​

Siirtyminen Overleaf Communitystä

​

Tapaus 01: Overleaf Toolkitista

Jos käytät virallista Overleaf Toolkitia Overleaf Communityn kanssa, lisää overleaf-toolkit/config-hakemistoon tiedosto nimeltä docker-compose.override.yml, jonka sisältö on seuraava tai vastaava:

docker-compose.override.yml

---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version

Käynnistä instanssi suorittamalla:

bin/up

Siinä kaikki! Olet valmis. Seuraavaksi voit varmistaa, että Ayakaleaf-instanssisi toimii oikein ja että pääset verkkokäyttöliittymään. Kun kaikki toimii, jatka alla olevilla konfigurointivaiheilla ottaaksesi käyttöön edistyneitä ominaisuuksia, kuten:

• sandboxed-compiles.md
• authentication
• github-synchronisation.md
• zotero-integration.md

​

Tapaus 02: Docker Compose -tiedostosta

Jos käytät erillistä docker-compose.yml-tiedostoa, siirrä se ensin Overleaf Toolkitiin. Toolkit yksinkertaistaa paikallista asennusta, päivityksiä ja ylläpitoa.

Muunna nykyinen käyttöönottosi ohjeen docker-compose.yml-to-toolkit-migration.md mukaisesti. Säilytä nykyiset konfiguraatiosi ja datavolyymien polut siirron aikana.

Kun Toolkit-käyttöönotto on käynnissä, vaihda sen image Ayakaleaf Prohon ohjeen #from-overleaf-toolkit mukaisesti. Käynnistä instanssi komennolla bin/up ja varmista sitten, että pääset verkkokäyttöliittymään.

---

​

Siirtyminen Overleaf Server Prosta

Jos käytät tällä hetkellä kaupallisesti lisensoitua Overleaf Server Pro -instanssia ja haluat siirtyä Ayakaleaf Prohon, huomaa, että siirto voi vaatia jonkin verran lisätyötä, koska tietyt tietomuodot (templates) eivät välttämättä ole täysin yhteensopivia. Autamme kuitenkin mielellämme. Avaa issue tai ota meihin yhteyttä osoitteessa [e-mail], niin autamme sinua siirtymään Ayakaleaf Prohon maksutta.

---

​

Siirtyminen Overleaf CEP:stä

Saamme usein käyttäjiltä kysymyksiä siitä, voiko Overleaf CEP:stä siirtyä Ayakaleaf Prohon. Useimmissa tapauksissa Overleaf CEP ja Ayakaleaf Pro tarjoavat pääosin vastaavat toiminnot ja ovat datan osalta yhteensopivia versiosta 6.2.0 alkaen. Projektit voivat julkaista ominaisuuksia eri aikoina; voimme esimerkiksi poimia ominaisuuden Overleaf CEP:stä ja päinvastoin. Vaikka saman ominaisuuden toteutuksemme voivat hieman erota toisistaan, siirtymiseen ei yleensä ole painavaa syytä.

Jos haluat silti siirtyä Ayakaleaf Prohon tai kokeilla sitä, katso: #case-01-from-overleaf-toolkit. Siirtoprosessi on sama.

---

​

Siirtyminen Overleaf SaaS:sta

Valitettavasti siirtyminen Overleaf SaaS -alustalta itse ylläpidettyyn Ayakaleaf Pro -instanssiin voi olla huomattavasti vaikeampaa. Tällä hetkellä ainoa yleisesti saatavilla oleva tapa on ladata jokainen projekti ZIP-arkistona ja ladata se sitten itse ylläpitämääsi Ayakaleaf Pro -instanssiin. Tällöin siirtyvät vain projektin nykyiset tiedostot, mikä tarkoittaa, että menetät:

• Kaiken projektihistorian ja aiemmat revisiot
• Kaikki kommentit ja seuratut muutokset
• Kaikki Git-metatiedot ja commit-historian
• Kaikki GitHub-synkronointilinkit ja -asetukset
• Kaikki linkit BibTeX-tiedostojen ja kolmansien osapuolten viitteidenhallinta-alustojen välillä

---

​

Siirtyminen kolmannen osapuolen Overleaf-haarasta

Ayakaleaf Pro ei välttämättä tue ominaisuuksia, jotka ovat ominaisia tietylle kolmannen osapuolen Overleaf-haaralle. Kun haara poikkeaa merkittävästi upstream-Overleafin koodipohjasta – tai tuo muutoksia ylläpitämättä yhteensopivuutta upstreamin kanssa – myöhempien Overleaf-julkaisujen yhdistäminen voi muuttua erittäin vaikeaksi. Voit silti kokeilla yllä kuvattua siirtotapaa, mutta yhteensopivuutta ei taata, emmekä välttämättä pysty tarjoamaan apua tai teknistä tukea siirroissa tukemattomista haaroista.