# SSS ve sorun giderme

Başlangıç, projeler, derleme, asistanlar ve yedekler hakkında hızlı yanıtlar.

## Başlarken

### Hesap açmam gerekir mi?

Hayır. Oleafly'yi indirin, açın ve yazmaya başlayın. Bulut yapay zeka sağlayıcısı, GitHub veya Dropbox gibi isteğe bağlı hizmetler kendi hesaplarını kullanır.

### Oleafly LaTeX, Typst ve Markdown destekliyor mu?

Evet. Proje oluştururken motoru seçin. Her motorun kendi düzenleme ve dışa aktarma yetenekleri vardır. [Hızlı başlangıç kılavuzu](/docs/getting-started/) ilk PDF'inizi baştan sona anlatır.

### Var olan bir makaleyi ya da özgeçmişi getirebilir miyim?

Evet. Proje kaynağını, bir ZIP arşivini ya da bir Git deposunu içe aktarın. Oleafly'de DOCX ve metin tabanlı PDF'ler için de dönüştürme yolları vardır. Doğru yolu seçmek için [Var olan bir projeyi getirme](/docs/import-project/) bölümünü okuyun.

### Çevrimdışı çalışabilir miyim?

Bulut bağlantısı olmadan yazabilir, dosyaları düzenleyebilir, yerel yazım denetimini kullanabilir ve indirilmiş bir yerel yapay zeka modelini çalıştırabilirsiniz. Tectonic, önbelleğe alınmış paketlerle derleyebilir. Yeni paketler, uzak başvurular, bulut modelleri, GitHub ve indirmeler bağlantı gerektirir. Çevrimdışıya geçmeden önce projeyi başarılı bir derlemeyle hazırlayın.

### Dosyalarım nerede?

Projeleriniz, yerel kitaplığınızda sıradan klasörlerdir. Onları kopyalayabilir, yedekleyebilir ya da başka bir araçta açabilirsiniz. [Verileriniz nerede durur](/docs/where-your-data-lives/); proje dosyalarını, uygulama ayarlarını ve kontrol noktalarını açıklar.

### Oleafly'yi tez ya da özgeçmiş için kullanabilir miyim?

Evet. [Tez iş akışı](/docs/workflows/thesis/) ya da [özgeçmiş iş akışı](/docs/workflows/resume/) ile başlayın. İkisi de bir araştırma makalesiyle aynı düzenleyiciyi, önizlemeyi, başvuruları ve dışa aktarma araçlarını kullanır.

## Kurulum

### İşletim sistemi kurulumu engelliyor

Dosyanın [resmi sürümlerden](https://github.com/Oleafly/Oleafly/releases/latest) geldiğini ve platformunuza uyduğunu denetleyin. Platforma özgü ilk açılış adımları için [kurulum kılavuzuna](/docs/install/#first-launch) bakın.

### Hangi Linux paketini kullanmalıyım?

Bilgisayarınıza uyan mimariyi ve AppImage'ı, Debian paketini ya da RPM'i seçin. Sistem gereksinimleri için [Linux kurulumu](/docs/install/#linux) bölümüne bakın.

## Derleme

### İlk derlemem yavaş

Tectonic, bu belgenin kullandığı paketleri indirmek zorunda kalabilir ve bir bilgisayardaki ilk derleme yaygın kullanılan bir paket grubunu da indirir. Bunlar sonraki derlemeler için önbelleğe alınır. Paketler hâlâ inerken derleme olağan beş dakikalık sınırını aşabilir. Ne olduğunu görmek için [Günlükler](/docs/compiling/#reading-the-logs) bölümünü açın.

### Bir paket eksik

Çevrimdışı kip açıksa iletideki **Kapat ve derle**'yi seçin ya da paketi indirmek için bir derleme boyunca kapatın. Sistem TeX araç zincirinde hatadaki **Bul ve kur**'u kullanın. Debian, Ubuntu ya da Fedora'dan gelen TeX Live, paketlerini `apt` veya `dnf` üzerinden alır. Bkz. [LaTeX motorları ve paketler](/docs/latex-engines/#recover-from-a-missing-file).

### pdfLaTeX seçtim ve Oleafly bir TeX dağıtımı istiyor

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX ve pLaTeX, bilgisayarınızda kurulu bir TeX dağıtımında çalışır. Hiç yoksa bunlardan birini seçmek, hiçbir şey derlenmeden önce bir iletişim kutusu açar. Birini kurmak için **TinyTeX'i indir ve kullan**'ı, yerleşik motora dönmek için **Tectonic'e geri dön**'ü seçin. Başarısız bir derlemeden sonra önizleme aynı seçimi **TinyTeX'i indir ve kullan** ile **Tectonic kullan** olarak sunar. Bkz. [TeX kurulu olmadığında](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX, latexmk için Perl gerektiğini söylüyor

MiKTeX'in `latexmk`'si Perl üzerinde çalışır ve MiKTeX Perl içermez. Strawberry Perl kurun ya da **Ayarlar → Motorlar → LaTeX** bölümünden, kendi Perl'ünü getiren ve derlemeleri MiKTeX'ten devralan TinyTeX'i kurun. Bkz. [MiKTeX ve Perl](/docs/latex-engines/#miktex-and-perl).

### PDF'imde metin eksik

Yazı tipinde o karakterler için glif yoktur. Bu en çok Korece, Çince ve Japonca metinde olur ve TeX karakterleri derlemeyi başarısız kılmadan atlar. Oleafly sizi uyarır ve bunları günlükte listeler. LaTeX'te uyarının yazınız için verdiği kurulumu yapıştırın. Typst'ta bildirimin sunduğu yazı tipi paketini indirin ya da karakterleri içeren bir yazı tipini projenin `fonts` klasörüne ekleyin. Markdown'da YAML başlığında `mainfont` veya `CJKmainfont` değerini onları içeren bir yazı tipine ayarlayın. Bkz. [PDF'ten eksik karakterler](/docs/latex-engines/#characters-missing-from-the-pdf) ve [Kutu olarak görünen karakterler](/docs/typst/#characters-that-show-as-boxes).

### Oleafly derlememi çok uzun sürdüğü için durdurdu

Bir derleme 5 dakika çalışabilir. Paketler hâlâ inerken sınır en çok 30 dakikaya kadar uzar. Markdown'dan PDF'e 15 dakika, Quarto ve Calepin'e bir saat tanınır. Yeniden derleyin: indirme kaldığı yerden sürer. Tectonic'te uzun taslaklar için derleme menüsünde **Derleme kipi**'ni **Hızlı** yapın.

### Yeni projeler kendi TeX kurulumumu kullanabilir mi?

Evet. **Ayarlar → Motorlar → LaTeX**'i açın ve **Varsayılan derleme motoru** olarak **latexmk (sistem TeX)** seçin. Yeni, içe aktarılan ve dönüştürülen LaTeX projeleri bundan sonra onunla başlar. Bkz. [Yeni projeler için varsayılan ayarlama](/docs/engines/#set-a-default-for-new-projects).

### Belgem minted ya da PythonTeX kullanıyor

Bu paketler belge derlenirken başka programlar çalıştırır; Oleafly bunu varsayılan olarak engeller. Bunlar sistem LaTeX'i gerektirir. Projedeki her dosyaya güveniyorsanız, düzenleyicinin üstünde görünen şeritte **Dış komutlara izin ver**'i seçin. Bkz. [Dış komutlara izin verme](/docs/latex-engines/#allow-external-commands).

### Derleme uyarılarla tamamlandı

**Günlükler**'i açın ve önce tanımsız atıfları ve başvuruları denetleyin. [Ön denetim](/docs/preflight/), dışa aktarmadan önce etkilenen kaynak konumlarını bulmanıza yardım eder.

### Bir derleme hatasını anlamıyorum

Asistandan günlüğü okumasını, hatayı düzeltmesini ve yeniden derlemesini isteyin. Önerilen eylemleri yol boyunca gözden geçirmek istediğinizde **Onay iste**'yi kullanın. Günlüğü [Discord](/discord)'daki yardım forumunda da paylaşabilirsiniz.

### Neden bir dışa aktarma biçimi eksik?

Kullanılabilir biçimler motora ve belge türüne bağlıdır. [Dışa aktarma tablosuna](/docs/export/#editable-formats) bakın.

## Yapay zeka asistanları

### Hangi asistanı kullanabilirim?

Bir model sağlayıcısı bağlayın, yerel bir model kullanın ya da bir [CLI ajanı](/docs/cli-agents/) seçin. [AI kurulumu](/docs/ai-setup/) her yolu anlatır.

### Düzenleyiciyi kullanmak için yapay zeka gerekir mi?

Hayır. Yazma, derleme, atıflar, önizlemeler, diyagramlar, proje geçmişi ve dışa aktarmalar asistan olmadan kullanılabilir.

### Asistan neler yapabilir?

Proje dosyalarıyla çalışabilir, kaynak arayabilir, bir PDF'i inceleyebilir, şekiller oluşturabilir, araçlar çalıştırabilir ve bozuk bir derlemeyi onarmaya yardım edebilir. İşi uygun bir plan ve onay ilkesiyle eşleştirin. Bkz. [Sohbet ve araçlar](/docs/ai-chat/).

### Bir modelin yanındaki Doğrulanmış ne anlama geliyor?

Model bir araç çağrısı sınamasından geçmiştir. Size proje eylemleri için model seçmede yardım eder; yazısının ya da araştırmasının kalitesini değerlendirmez. Bkz. [AI kurulumu](/docs/ai-setup/).

### Kullanım neden Bilinmiyor olarak görünüyor?

Bazı sağlayıcılar ve CLI ajanları kullanımı bildirmez. Bilinmiyor, değerin kullanılamadığı anlamına gelir. [Kullanım ve bütçeler](/docs/ai-usage/) bölümünü okuyun.

### Dış bir asistan bağlayabilir miyim?

Evet. Yerleşik bir [CLI ajanı bağlantısı](/docs/cli-agents/) kullanın, Oleafly'nin yerel [MCP sunucusunu](/docs/mcp/) etkinleştirin ya da ajanınızı, uygulama kapalıyken de çalışan [`oleafly` komutuna](/docs/cli/) bağlayın.

## Geçmiş ve iş birliği

### Önceki bir sürümü nasıl kurtarırım?

Başarılı derlemelerin kaynaklarını karşılaştırmak ve bir sürümü geri yüklemek için [Kontrol noktalarını](/docs/checkpoints/) açın. Kendiniz yönettiğiniz Git işlemeleri için [Kaynak Denetimi](/docs/git-history/)'ni kullanın.

### Ortak bir yazarla çalışabilir miyim?

Evet. [Canlı iş birliğiyle](/docs/collaboration/) siz ve ortak yazarlarınız, grubunuzun çalıştırdığı bir iş birliği sunucusu üzerinden aynı projeyi aynı anda düzenlersiniz. Her biriniz projeyi kendi bilgisayarınızdaki dosyalar olarak tutar. İşlemeleri alışveriş için kaynak arşivleri de paylaşabilir ya da [GitHub eşitlemesini](/docs/github-sync/) kullanabilirsiniz.

### Projelerimi iki bilgisayarda kullanabilir miyim?

Evet. [Bulut eşitleme](/docs/cloud-sync/), kitaplık projelerinizi ve ayarlarınızı kendi Dropbox'ınızda tutar; bağladığınız her bilgisayar onları indirebilir. Bağlamak için **Ayarlar → Veri Depolama → Bulut eşitleme** bölümünü açın. Bir projeyi bilgisayarlar arasında [GitHub eşitlemesiyle](/docs/github-sync/) de taşıyabilirsiniz.

### Kaynağı dışa aktarmak her şeyi yedekler mi?

Proje kaynağını yedekler. Otomatik kontrol noktaları, uygulama tercihleri ve kimlik bilgileri ayrı durur. İhtiyaç duyduklarınızı da kapsamak için [yedekleme kılavuzunu](/docs/where-your-data-lives/#back-up-your-work) izleyin.

## Sorun bildirin

**Ayarlar → Yardım ve Hakkında → Bilgiyi Kopyala**'yı açın ve bu ayrıntıları kısa bir tanım, sorunu yeniden oluşturma adımları ve ilgili günlükle birlikte ekleyin. [Issues](https://github.com/Oleafly/Oleafly/issues) içinde bildirin; sorular ve iş akışı yardımı için [Discord topluluğunu](/discord) kullanın.
