# Dosyalarınız ve verileriniz

Bir projeyle neyin birlikte geldiğini bilin; kaynağı, geçmişi ve uygulama verilerini nasıl yedekleyeceğinizi öğrenin.

Makaleniz olağan kaynak dosyalarından oluşan bir klasördür. Bu dosyaları başka bir düzenleyiciyle açabilir, yedekleyebilir veya Oleafly'nin dışına çıkarabilirsiniz.

## Proje dosyaları

Kitaplık projeleri normalde `~/.oleafly/projects/` altında yaşar. Bir proje; LaTeX, Typst veya Markdown bir ana belge, bir kaynakça, şekiller ve araştırma malzemesi içerebilir.

`project.json`, projenin kimliğini ve ayarlarını kaydeder; ana belgesi, motoru ve sabitlenmiş Typst sürümü dahil. Bir `.git` dizini Git geçmişini tutar. Oleafly'nin oluşturduğu veya içe aktardığı bir proje normalde dosyalarının "Proje oluştur" adlı tek bir işlemesiyle başlar (bkz. [Git ve sürüm denetimi](/docs/git-history/#the-first-commit)). `.oleafly/build/` dizini üretilmiş derleme çıktısını içerir ve yeniden derlenerek yeniden oluşturulabilir.

Bir Typst projesi, içe aktardığı paketlerin kopyalarını bir `typst-packages` klasöründe tutabilir; böylece çevrimdışı ve diğer bilgisayarlarda derlenir. Typst ayrıca bir projenin `fonts` klasöründeki yazı tiplerini kullanır. Her iki klasör de projeyle birlikte taşınır.

[Yerinde açtığınız](/docs/library/#folders-opened-in-place) bir klasör olduğu yerde kalır. Oleafly, o klasörün derlemelerini, ayarlarını, kontrol noktalarını ve sohbetlerini kendi veri klasöründe tutar; böylece sizin klasörünüze hiçbir şey eklenmez.

## Projenin dışında saklanan veriler

Uygulama tercihleri, şifrelenmiş sağlayıcı kimlik bilgileri, sohbet ve kullanım kayıtları, ek Typst sürümleri gibi indirilmiş araçlar ve kaydedilmiş kontrol noktaları yerel uygulama deposuna aittir. Oleafly'nin her asistan veya ajan turundan önce tuttuğu, o turun değiştirdiği dosyaları geri almanızı sağlayan proje kopyaları da öyle. `@` aramasının okuduğu Zotero kitaplığının kopyası da projede değil, orada yaşar. Bir makale klasörünü kopyalamak tüm o uygulama verisini kopyalamaz.

[Bağlı klasörler](/docs/linked-folders/) özgün konumlarında kalır. Bir kaynak arşivi, onları bağlamış olmanızdan dolayı içeriklerini içermez.

## Notlar nerede durur

[Notlar](/docs/notes/), bilgisayarınızdaki Markdown dosyalarıdır. Her kişisel not, projeler klasöründe, kitaplık projelerinizin yanında bir klasördür. Proje notu, projenin `notes` klasöründeki bir `.md` dosyasıdır; bu yüzden projeyle birlikte taşınır. Windows, macOS ve Linux'taki klasör ve bir notun klasörünün neler içerdiği için [Notlar nerede saklanır](/docs/notes/#where-notes-are-stored) bölümüne bakın.

## TinyTeX nerede durur

TinyTeX'i **Ayarlar → Motorlar → LaTeX** bölümünden kurduğunuzda Oleafly onu `~/.oleafly/tinytex` içine koyar. Kullanıcı klasörünüzün adı Korece ya da Çince bir ad gibi aksanlı veya Latin olmayan harfler içeriyorsa Windows bir istisnadır; çünkü TeX Live böyle bir klasörden çalışamaz. TinyTeX bu durumda, genellikle `C:\ProgramData` olan ProgramData içinde, `Oleafly-` ve kısa bir koddan oluşan adlı bir klasöre gider. Yönetici erişimi gerekmez. Oleafly o klasörü de kuramazsa bunu söyler. Tectonic ile derlemeye devam edebilir ya da TeX Live'ı kendiniz `C:\texlive` içine kurabilirsiniz.

**TeX dağıtımlarını yönet** altındaki TinyTeX satırı klasörü gösterir; okumak için bulanık yolun üzerine gelin. TinyTeX'i klasörü elle silmek yerine o satırdan kaldırın.

## Çalışmanızı yedekleyin

| Korunmasını istediğiniz | Nasıl korunur |
| --- | --- |
| Makale kaynağı ve proje varlıkları | Proje klasörünü kopyalayın veya bir kaynak ZIP'i dışa aktarın |
| Git işlemeleri | Depoyu yedekleyin veya yapılandırılmış uzak deponuza itin |
| Kaydedilmiş kontrol noktaları | Sürüm yönetiminden şifrelenmiş bir geçmiş arşivi dışa aktarın |
| Uygulama tercihleri ve yerel kayıtlar | Oleafly veri dizinini normal bilgisayar yedeğinize ekleyin |
| Bağlı veriler ve başvurular | Özgün klasörlerini yedekleyin |
| Kitaplık projeleri ve ayarları, bu bilgisayarın dışında | [Bulut eşitlemeyi](/docs/cloud-sync/) açarak Dropbox'ınızda bir kopya tutun |

Bir kaynak ZIP, derleme önbelleklerini ve Git'i kapsamaz. Uzak bir depo için [GitHub eşitlemeyi](/docs/github-sync/), kontrol noktası geçmişi için [kontrol noktası arşivlerini](/docs/checkpoints/) kullanın.

## Başka bir bilgisayara taşıyın

Oleafly'yi kurun ve makale projesini kopyalayın ya da klonlayın. Bağlı klasörleri ve model sağlayıcılarını o makinede yeniden bağlayın. Proje, derleyici seçimini ve üst verisini taşır; ek araçlar veya paketler kurulma gerektirebilir. Bu bilgisayarda bulunmayan bir sürümü sabitleyen bir Typst projesi, derlemeden önce onu indirmeyi önerir.

## Ekrandaki yollar

Ana klasörünüzün içindeki yollar, Ayarlar'da, sürüm geçmişinde, motor ve ajan ayrıntılarında ve sohbette `~/…` olarak görünür. Ayarlar'da dosya ve klasör yolları ayrıca üzerine gelene veya Tab ile onlara ulaşıncaya dek bulanık kalır; böylece bir ekran görüntüsü dosyalarınızın nerede yaşadığını göstermez.

## Ağ erişimi

Yazma ve yerel redaksiyon makinenizde gerçekleşir. Barındırılan yapay zeka, seçili sağlayıcıya verilen bağlamı alır. Görselleri ve taranmış PDF'leri okuyan araçlar, onlar için barındırılan bir model ya da Mathpix seçmediğiniz sürece yerel bir Ollama modeli kullanır; seçerseniz dosya o hizmete gider. Zotero atıfları bilgisayarınızdaki Zotero uygulamasıyla veya bir hesap bağladığınızda zotero.org ile iletişim kurar. Atıf araması, Zotero içe aktarması, alphaXiv araçları, GitHub eşitlemesi, Typst paket ve sürüm indirmeleri, diğer indirmeler ve güncelleme denetimleri kendi hizmetleriyle iletişim kurar. [Canlı iş birliği](/docs/collaboration/), paylaşılan her projeyi paylaşıldığı iş birliği sunucusuna gönderir. [Bulut eşitleme](/docs/cloud-sync/), kitaplık projelerinizi ve ayarlarınızı kendi Dropbox'ınıza gönderir. Ayarlar → Yardım ve Hakkında'yı açmak herkese açık sayıları getirir: projenin GitHub yıldız ve çatal sayıları ile Discord topluluğunda kaç üyenin çevrimiçi olduğu. İstekler hesap, proje veya kullanım bilgisi taşımaz ve çevrimdışı kip, Discord olanını atlar. Tectonic ve Typst'un ikisi de çevrimdışı kip üzerinden önbelleğe alınmış derlemeyi destekler.

[Ürün ilkelerini okuyun →](/docs/philosophy/)
