Migrace ze stávající instalace

Migrace stávajícího nasazení Overleaf Toolkit na Ayakaleaf Pro.

Je důležité, abyste si před každou migrací na novou hlavní verzi pořídili konzistentní zálohu, abyste se v případě potřeby mohli vrátit zpět.

​

Migrace z Overleaf Community

​

Případ 01: Z Overleaf Toolkitu

Pokud pro Overleaf Community používáte oficiální Overleaf Toolkit, stačí do adresáře overleaf-toolkit/config přidat soubor s názvem docker-compose.override.yml s následujícím nebo podobným obsahem:

docker-compose.override.yml

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

Instanci spustíte příkazem:

bin/up

A je to! Vše je připraveno. Dále můžete ověřit, že vaše instance Ayakaleaf běží správně a že máte přístup k webovému rozhraní. Jakmile vše funguje, pokračujte kroky konfigurace níže a povolte pokročilé funkce, jako jsou:

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

​

Případ 02: Ze souboru Docker Compose

Pokud používáte samostatný docker-compose.yml, nejprve jej migrujte na Overleaf Toolkit. Toolkit zjednodušuje on-premises instalaci, upgrady i údržbu.

Při převodu stávajícího nasazení postupujte podle docker-compose.yml-to-toolkit-migration.md. Během této migrace zachovejte svou současnou konfiguraci a cesty k datovým svazkům.

Jakmile nasazení s Toolkitem běží, postupujte podle #from-overleaf-toolkit a přepněte jeho image na Ayakaleaf Pro. Spusťte instanci pomocí bin/up a poté ověřte, že máte přístup k webovému rozhraní.

---

​

Migrace z Overleaf Server Pro

Pokud aktuálně provozujete komerčně licencovanou instanci Overleaf Server Pro a chtěli byste přejít na Ayakaleaf Pro, mějte na paměti, že migrace může vyžadovat určitou práci navíc, protože některé datové formáty (templates) nemusí být plně kompatibilní. Rádi vám však pomůžeme. Založte prosím issue nebo nás kontaktujte na [e-mail] a s migrací na Ayakaleaf Pro vám bezplatně pomůžeme.

---

​

Migrace z Overleaf CEP

Často dostáváme od uživatelů dotazy, zda mohou migrovat z Overleaf CEP na Ayakaleaf Pro. Ve většině případů nabízejí Overleaf CEP a Ayakaleaf Pro v zásadě rovnocennou funkcionalitu a od verze 6.2.0 zůstávají datově kompatibilní. Oba projekty mohou vydávat funkce v různých termínech; například můžeme převzít (cherry-pick) funkci z Overleaf CEP a naopak. Přestože se naše implementace téže funkce mohou mírně lišit, obecně neexistuje pádný důvod k migraci.

Pokud byste přesto chtěli na Ayakaleaf Pro migrovat nebo jej vyzkoušet, podívejte se na: #case-01-from-overleaf-toolkit. Postup migrace je stejný.

---

​

Migrace z Overleaf SaaS

Migrace z platformy Overleaf SaaS na vlastní hostovanou instanci Ayakaleaf Pro bohužel může být podstatně obtížnější. V současnosti je jedinou obecně dostupnou metodou stáhnout každý projekt jako ZIP archiv a poté jej nahrát do své vlastní instance Ayakaleaf Pro. Tím se přenesou pouze aktuální soubory projektu, což znamená, že přijdete o:

• Veškerou historii projektu a předchozí revize
• Všechny komentáře a sledované změny
• Všechna metadata Gitu a historii commitů
• Všechna propojení a nastavení synchronizace s GitHubem
• Všechna propojení mezi soubory BibTeX a platformami pro správu citací třetích stran

---

​

Migrace z forku Overleafu třetí strany

Ayakaleaf Pro nemusí podporovat funkce specifické pro konkrétní fork Overleafu třetí strany. Jakmile se fork výrazně odchýlí od upstreamového kódu Overleafu — nebo zavede změny bez zachování kompatibility s upstreamem — může být slučování následných vydání Overleafu nesmírně obtížné. Můžete se přesto pokusit o migraci výše popsaným způsobem, ale kompatibilita není zaručena a u migrací z nepodporovaných forků vám možná nebudeme schopni poskytnout pomoc ani technickou podporu.