İçeriğe geç
Oleaflyv0.4.12

oleafly komutunu Windows, macOS veya Linux'ta kurun, projeleri bir terminalden ya da CI'dan derleyin ve denetleyin, çevrimiçi bir LaTeX hizmetiyle eşitleyin ve kodlama ajanlarını onun MCP sunucusu ve becerisi üzerinden bağlayın.

Oleafly, uygulamayla aynı projeler üzerinde çalışan bir komut satırı aracı olan oleafly ile gelir. Bir makaleyi bir terminalden, bir betikten ya da CI’dan derleyin veya denetleyin. Bir kodlama ajanına projenize güvenilir bir giriş yolu verin. Çevrimiçi bir LaTeX hizmetiyle ya da bir Oleafly sunucusuyla eşitleyin veya Oleafly ajanını uygulamayı açmadan çalıştırın.

Her platformda uygulamanın içinde gelir. Bu sayfa Oleafly 0.4.8 ve sonrasındaki komutları kapsar. Önceki sürümlerde daha azı vardı; bu yüzden ona bağlı betiklerde Oleafly sürümünüzü sabitleyin.

SistemUygulamanın onu tuttuğu yeroleafly komutunu PATH’inize koyun
Windowsoleafly-cli.exe uygulamanın yanında: kurulum programı için %LOCALAPPDATA%\Oleafly, MSI paketi için C:\Program Files\Oleafly içindeAyarlar → Genel içindeki Terminal komutu satırında Kur, onu %LOCALAPPDATA%\Oleafly\bin\oleafly.exe konumuna kopyalar ve o klasörü PATH’inize ekler
macOSOleafly.app/Contents/MacOS/oleafly-cliTerminal komutu satırında Kur, yazabiliyorsanız oleafly komutunu /usr/local/bin içine, yazamıyorsanız ~/.local/bin içine bağlar
Linux paketleri (.deb, .rpm)/usr/bin/oleafly-cliYapılacak bir şey yok: paket /usr/bin/oleafly dosyasını kurar
Linux AppImageAppImage’ın içindeKur, onu ~/.local/bin/oleafly konumuna kopyalar

Oleafly’nin başlattığı programlar, örneğin kendi terminali ve CLI ajanları, siz kurmadan önce bile oleafly komutunu her zaman PATH’lerinde bulur. OLEAFLY_CLI değişkeni onun tam yolunu tutar. Kendi TeX’inizden sonra gelmek üzere Oleafly’nin TinyTeX’ini de bulurlar. Oleafly ile gelen Tectonic, Typst ve Pandoc o PATH’te değildir; bu yüzden onları adlarıyla çağırmak yerine oleafly build ve oleafly export kullanın.

  1. Ayarlar → Genel bölümünü açın ve Terminal komutu satırında Kur’u seçin.
  2. Yeni bir PowerShell ya da Komut İstemi penceresi açın. Zaten açık olan pencereler eski PATH’i korur.
  3. Çalıştığını denetleyin:
Terminal penceresi
Get-Command oleafly
oleafly version

Aynı satırdaki Kaldır, kopyayı siler ve klasörü PATH’inizden yeniden çıkarır. Oleafly güncellendiğinde, kopyayı bir sonraki başlayışında yeniler.

Önce Oleafly’yi Uygulamalar klasörüne taşıyın. Disk görüntüsünden çalışan bir kopya, Kur yerine “Önce Oleafly’yi Uygulamalar klasörüne taşıyın” iletisini gösterir.

Komut uygulamaya bir bağlantıdır; bu yüzden Oleafly’yi güncellemek komutu da günceller. Klasör PATH’inizde değilse satır, kabuk profilinize eklemeniz gereken satırı gösterir. command -v oleafly ile denetleyin.

.deb ve .rpm paketleri, kurduğunuzda oleafly komutunu PATH’inize koyar. Arkasında hiçbir şey olmayan oleafly, uygulamayı açar.

AppImage bir kopya gerektirir; çünkü bir AppImage’ın içindeki dosyalar o kapanınca kaybolur. AppImage’ı daha yenisiyle değiştirdikten sonra satır Güncelle önerir. ~/.local/bin PATH’inizde değilse satır, eklemeniz gereken satırı gösterir.

Motorlar da AppImage’ın içinde kalır. Kopyalanan oleafly onları Oleafly’nin yerleşik terminalinden kullanabilir, ancak kendi açtığınız bir terminalden, bir CLI ajanından ya da asistanın çalıştırdığı bir komuttan kullanamaz. Bunlar için Tectonic, Typst ve Pandoc’u kurun ya da .deb veya .rpm paketini kullanın. oleafly doctor bu konuda uyarır.

oleafly version, uygulama sürümünü ve komutun kullanacağı motorları yazdırır. oleafly doctor motorları, TeX kurulumunuzu, uygulamayı, Git’i, terminal komutunu ve MCP istemcilerinizi denetler ve eksik olan her şey için bir çözüm yazdırır. Hiç TeX kurulu değilse uyarır, çünkü latexmk projeleri o zaman derlenemez. Proje dışında da çalışır.

oleafly . geçerli klasörü uygulamada açar. Diğer her komut içinde bulunduğunuz klasörde çalışır; -C ve ardından bir yol, onu başka bir yere yöneltir.

Terminal penceresi
cd ~/papers/thesis
oleafly init --engine typst
oleafly build
oleafly log --diagnostics
oleafly -C ~/papers/review --json build
  • oleafly init geçerli klasörü bir proje yapar. --engine, tectonic, latexmk, typst veya markdown değerini alır.
  • oleafly new ve ardından bir klasör, --template ile bir şablon kimliği, bir şablondan proje oluşturur. oleafly templates list --all şablonları listeler.
  • oleafly build, projenin motorunu ve ayarlarını uygulamayla aynı şekilde kullanır: Oleafly ile gelen Tectonic, Typst ve Pandoc ya da kurduğunuz LaTeX. --main projenin başka bir belgesini derler, --compiler latexmk projeleri için LaTeX derleyicisini seçer ve -o PDF’i başka bir yere kopyalar.
  • Bir Markdown belgesi, ön bilgisinin adlandırdığı belge türü olarak derlenir; örneğin slayt ya da mektup.
  • latexmk projeleri Ayarlar → Motorlar → LaTeX → TeX dağıtımlarını yönet altında Kullanımda işaretli TeX dağıtımını kullanır; bu yüzden orada Derlemelerde kullan ile seçtiğiniz bir dağıtım burada da geçerlidir.
  • Uygulamada yerinde açtığınız bir klasör, orada seçtiğiniz motor ve ana belgeyle, uygulamanın kendi derleme klasörüne derlenir.
  • Henüz bir proje olmayan ve uygulamada hiç açmadığınız bir LaTeX dosyaları klasörü, latexmk’yi isteyen bir şey olmadıkça yerleşik motorla derlenir: --compiler, pdflatex, lualatex, uplatex veya platex adını veren bir % !TEX program satırı, ujarticle gibi bir Japonca sınıf ya da oleafly config ile latexmk olarak ayarlanmış latex.default_engine. Belge pdfLaTeX veya LuaLaTeX istiyorsa ve latexmk bu bilgisayarda çalışamıyorsa derleme yerleşik motorda kalır ve bir uyarı yazdırır.
  • Uygulama ve komut aynı projeyi asla aynı anda derlemez: ikincisi birincisini bekler. Başarısız bir derleme son iyi PDF’i korur.
  • Başarısız bir derleme en çok 20 hatayı, Oleafly’nin elinde olduğu yerde bir açıklama ve ipuçlarıyla birlikte listeler. --quiet ile yalnızca hataları listeler.
  • --timeout, bir derleyiciyi o kadar saniye sonra durdurur; varsayılan 300’dür. Yerleşik motor paket indirirken süre son indirmeden itibaren sayılır; en çok 30 dakikaya kadar, --timeout daha uzunsa daha da uzun.
  • oleafly build, uygulamada Dış komutlara izin ver’i seçtiğiniz bir projede bile LaTeX’ten gelen shell komutlarını her zaman engeller. minted veya PythonTeX kullanan gibi onlara ihtiyaç duyan bir belge burada başarısız olur ve nedenini söyler. Onu uygulamada derleyin ya da latexmk’yi -shell-escape ile kendiniz çalıştırın. İkisini de yalnızca projedeki her dosyaya güveniyorsanız yapın.
  • Quarto ve Calepin projeleri yalnızca uygulamada derlenir. oleafly build bunu söyler ve aracı kendiniz çalıştırmayı yeğlerseniz quarto render veya calepin compile komutunu adlandırır.
  • oleafly watch her kaydettiğinizde yeniden derler. Bir derleme başlayamadığında hatayı ve ipucunu yazdırır, sonra sonraki değişikliğinizi bekler. oleafly log --diagnostics hataları ve uyarıları dosya ve satırla listeler, oleafly clean ise derleme çıktısını kaldırır.

Typst’e özgü ayrıntılar için bkz. Typst projeleri.

Kodlama ajanları, komutun onlara verdiği üç şeyle en iyi çalışır: projenin haritası için oleafly context, okuyabilecekleri sonuçlar için --json ve neyin ters gittiğini söyleyen çıkış kodları. Bir ajanı bağlamanın üç yolu vardır.

Oleafly, oleafly-cli adlı bir beceriyle gelir. Ajana komutları, JSON çıktısını, çıkış kodlarını ve en iyi çalışan döngüyü öğretir: bağlamı okuyun, düzenleyin, derleyin, tanılamaları okuyun, ilk hatayı düzeltin.

Oleafly’nin terminalinde ve başlattığı CLI ajanlarında beceriyi diğerleri gibi seçin. Kendi başınıza çalıştırdığınız bir ajan için Ayarlar → Yapay Zeka Asistanı → Beceriler → Becerileri bu bilgisayardaki diğer ajanlarla paylaş seçeneğini açın. Oleafly o zaman becerilerini, oleafly-cli dahil, diğer kodlama ajanlarının okuduğu klasörlere bağlar; örneğin ~/.claude/skills, ~/.codex/skills ve ~/.agents/skills. oleafly skills path, başka bir klasörü okuyan ajanlar için becerilerin nerede olduğunu yazdırır.

oleafly mcp, standart girdi ve çıktı üzerinden konuşan bir MCP sunucusudur. Uygulama projenizi açıkken çağrıları uygulamanın kendi MCP sunucusuna iletir; böylece ajan uygulamanın her aracını ve onay istemlerinizi alır. Aksi hâlde tek başına çalışır; okuma araçları (proje durumu, proje haritası, dosyalar, arama, günlükler, doctor raporu, atıf arama) ve compile ile. Kopyalanacak bir URL ya da belirteç ve kurulacak bir Node.js yoktur.

compile bir araç eksik olduğu için çalışamadığında hatası, oleafly build’in yazdırdığıyla aynı ipucunu, örneğin TeX’in nasıl edinileceğini taşır; böylece ajan neyi kurmanız gerektiğini size söyleyebilir. oleafly agent run sırasındaki derlemeler de aynı şekilde bildirir.

En hızlı kurulum, oleafly mcp config --client ve ardından claude-code, claude-desktop, codex, cursor ya da gemini’dir. O istemci için girdiyi yazdırır; sizin için eklenmesini istiyorsanız istemcinin dosyasının yedeğiyle birlikte --write ekleyin. Sonrasında istemciyi yeniden başlatın ya da yeniden bağlayın. Bir projenin içinde projenin ayarlarına yazar; başka yerde kullanıcı ayarlarınıza yazar ve komutun tam yolunu kullanır; çünkü masaüstünden başlattığınız uygulamalar PATH’inizi görmeyebilir.

Terminal penceresi
claude mcp add --scope user oleafly -- oleafly mcp

Bir projenin içinde oleafly mcp config --client claude-code --write, sunucuyu bunun yerine projenin .mcp.json dosyasına ekler.

Claude Desktop sunucuları bir proje klasörü olmadan başlatır; bu yüzden girdisi her zaman uygulama üzerinden çalışır: Oleafly’yi projenizle açık tutun. oleafly için tam yolu kullanın. Windows’ta yoldaki her ters eğik çizgiyi ikiye katlayın.

claude_desktop_config.json
{
"mcpServers": {
"oleafly": {
"command": "/usr/local/bin/oleafly",
"args": ["mcp", "--bridge", "always"]
}
}
}

Dosya macOS’ta ~/Library/Application Support/Claude içinde, Windows’ta %APPDATA%\Claude içindedir.

~/.codex/config.toml
[mcp_servers.oleafly]
command = "oleafly"
args = ["mcp"]
tool_timeout_sec = 300

Her proje için ~/.cursor/mcp.json dosyasını, tek bir projenin içinde ise .cursor/mcp.json dosyasını kullanın.

~/.cursor/mcp.json
{
"mcpServers": {
"oleafly": {
"command": "oleafly",
"args": ["mcp"]
}
}
}
~/.gemini/settings.json
{
"mcpServers": {
"oleafly": {
"command": "oleafly",
"args": ["mcp"],
"timeout": 300000
}
}
}

oleafly context projeyi haritalar: dosyalarını, yapısını, etiketlerini, atıflarını, eksik dosyalarını, çözülmemiş başvurularını ve son derlemenin sorunlarını. --format md bir isteme yapıştırılacak metin verir; --format json aynı haritayı bir program için verir.

oleafly check, projede Preflight denetimlerini çalıştırır ve Preflight paneliyle aynı sonuçları verir: başvurular, atıflar, etiketler, eksik dosyalar, kaynakça alanları, şekiller ve kör hakemlik için anonimlik. Derlenmiş PDF’e ihtiyaç duyan denetimler son derlemeyi kullanır.

oleafly lint, LaTeX ve BibTeX denetimlerini ve, onu içeren derlemelerde, yazım ve dilbilgisi denetimini çalıştırır. --fix, uygulanması güvenli olan düzeltmeleri uygular.

İkisi de --format human, json veya sarif değerlerini alır; --exit-code ise sorun buldukları zaman 9 koduyla çıkmalarını sağlar. SARIF, GitHub’ınki gibi kod tarama hizmetleriyle çalışır: raporu oleafly check --format sarif -o preflight.sarif ile yazın, upload-sarif eylemiyle yükleyin; her bulgu pull request içinde kendi satırında görünür.

oleafly remote, çevrimiçi LaTeX hizmeti hesabınızdaki projeleri indirir ve bir klasörü onlardan biriyle, uygulamanın kullandığı aynı birleştirmeyle eşitler tutar.

Oturum açma bilgileri uygulamanın şifreli deposunda durur; bu yüzden uygulamada yapılan bir oturum açma komut satırında da, komut satırında yapılan uygulamada da çalışır.

  • oleafly auth login online --with-token, hizmetin hesap ayarlarından aldığınız bir Git belirtecini kaydeder. Bağlamak ve eşitlemek için bir belirteç gerekir.
  • oleafly auth login online --from-browser firefox, projeleri listelemek ve indirmek için oturum açma bilginizi bu bilgisayardaki bir tarayıcıdan kopyalar. Firefox her sistemde çalışır; Chrome, Edge ve Brave macOS’ta çalışır. --cookie-stdin bunun yerine bir oturum çerezini okur.
  • oleafly auth login git --host https://gitlab.com, bir Git barındırıcısı için belirteç kaydeder.
  • oleafly auth status, her oturum açma bilgisini ve nereden geldiğini, hiçbir gizli bilgiyi göstermeden listeler.
  • oleafly auth logout bir oturum açma bilgisini kaldırır.
Terminal penceresi
oleafly remote list
oleafly remote import 64a1f0c2e5b7 --into ~/papers
cd ~/papers/thesis
oleafly remote link
oleafly remote sync
  • oleafly remote import projeleri yeni klasörlere indirir. Her hesapla çalışır.
  • oleafly remote link, bir klasörü çevrimiçi projesine hizmetin Git tümleştirmesi üzerinden bağlar; bunun için bir Git belirteci gerekir.
  • oleafly remote sync, çevrimiçi değişiklikleri klasöre birleştirir ve sizinkileri gönderir. --dry-run nelerin değişeceğini gösterir, --no-push ise göndermeden birleştirir.
  • Bir dosya iki tarafta da değiştiyse eşitleme hiçbir şey yazmaz ve 8 koduyla çıkar. Onu her dosya için --resolve ve dosyanın yolunu izleyen =local ya da =remote ile yeniden çalıştırın.
  • oleafly remote diff nelerin farklı olduğunu gösterir; --exit-code ile dosyalar farklıysa 9, çakışıyorsa 8 koduyla çıkar. --latexdiff --pdf, TeX dağıtımınızdaki latexdiff’i kullanarak değişikliklerinizin işaretli bir PDF’ini derler.
  • oleafly remote status, oleafly remote unlink ve oleafly remote open bağlantıyı gösterir, kaldırır ve projeyi tarayıcınızda açar.

oleafly server sign-in ve ardından sunucunun adresi, komut satırında tarayıcınızda onayladığınız bir kodla oturum açar. Komut satırı, sunucuda uygulamadan ayrı, kendi başına bir cihazdır.

  • oleafly server status ve oleafly server projects, sunucularınızı ve paylaşılan projeleri gösterir.
  • oleafly server share, bir projenin bağlantısını gösterir ve bağlantı paylaşımını ile yorumları açar ya da kapatır.
  • oleafly server members, bir projedeki kişileri listeler ve onları ekler, kaldırır ya da değiştirir. Paylaşımı ve üyeleri yalnızca sahibi değiştirebilir.
  • oleafly server comments, yorumları listeler, ekler, yanıtlar ve çözümler. Hemen gönderilemeyen bir yorum saklanır ve bir sonraki sefer gönderilir.

Bir projeyi ilk kez paylaşmak uygulamada yapılır. Bkz. Canlı iş birliği.

oleafly ask, hiçbir şeyi değiştirmeden proje hakkındaki bir soruyu yanıtlar. oleafly agent run bir görevi yapar.

Terminal penceresi
oleafly ask "Which sections cite Smith 2021?"
oleafly agent run --allow write "Fix the overfull boxes in chapter 3"
  • Ajan projeyi her zaman okuyabilir. --allow, write, commands veya network ekler ve izin vermediğiniz her şeyi reddeder. Hiçbir zaman durup bir soru sormaz.
  • Değişiklikler önce .oleafly/agent-runs/ içindeki bir inceleme klasörüne gider. oleafly agent apply ve ardından o klasör, onları projeye yazar; çalıştırmadaki --apply ise onları hemen yazar.
  • Sağlayıcı, model ve çaba uygulamanın ayarlarından ya da --provider, --model ve --effort seçeneklerinden gelir. Anahtar, sağlayıcının kendi ortam değişkeninden, örneğin ANTHROPIC_API_KEY, ya da uygulamanın şifreli deposundan gelir.
  • --json, çalıştırma bittiğinde tek bir sonuç yazdırır; --events ise çalışırken her olay için bir JSON satırı ekler.

Çıktıktan sonra araştırma görevlerini çalışır tutun

Bölüm başlığı “Çıktıktan sonra araştırma görevlerini çalışır tutun”

Bir araştırma görevini Oleafly kapalıyken çalışmaya devam et olarak işaretleyin. Çıktığınızda küçük bir arka plan yardımcısı bu görevleri devralır ve deney çalıştırmaları sürer. Onayınızı gerektiren bir adım görevi duraklatır ve bir bildirim gönderir. Oleafly’yi yeniden açtığınızda görevleri geri alır ve neler olduğunu gösterir. Bunu kapatın ya da yardımcıyı oturum açtığınızda başlatın; Ayarlar → Araştırma → Arka plan görevleri altında. oleafly daemon status yardımcının ne yaptığını gösterir.

Bunlar uygulamada kalır:

  • TinyTeX’i kurmak; Ayarlar → Motorlar → LaTeX → TeX dağıtımlarını yönet altında.
  • Shell komutları çalıştıran bir LaTeX belgesini, örneğin minted veya PythonTeX kullananı derlemek.
  • Quarto ve Calepin belgelerini derlemek.
  • Kaynakça güncel değilken bir derleme sırasında Biber’i yeniden çalıştırmak.
  • Kontrol noktaları oluşturmak ve birini projenin üzerine geri yüklemek.
  • Bir projeyi bir Oleafly sunucusunda ilk kez paylaşmak.

Her komut seçeneklerini --help ile açıklar. Tam başvuru depodadır: docs/cli.md (yeni sekmede açılır).

KomutNe yapar
oleafly openBir klasörü uygulamada açar (geçerli klasör için oleafly .)
oleafly initGeçerli klasörü bir proje yapar
oleafly newBir proje oluşturur; bir şablon adlandırırsanız şablondan
oleafly templatesŞablonları listeler ve birini gösterir
oleafly buildProjeyi derler
oleafly watchHer kaydedişte yeniden derler
oleafly cleanDerleme çıktısını kaldırır
oleafly logSon derlemenin günlüğünü ya da sorunlarını gösterir
oleafly doctorMotorları, uygulamayı ve kurulumunuzu denetler
oleafly versionSürümü ve kullanılan motorları gösterir
oleafly project infoProjenin ayarlarını gösterir
oleafly projects listUygulamanın projelerini listeler
oleafly configProje ve uygulama ayarlarını okur ve ayarlar
KomutNe yapar
oleafly citeBir DOI, arXiv kimliği, ISBN ya da PubMed kimliği için BibTeX yazdırır; --add onu kaynakçaya ekler
oleafly literatureOpenAlex, Semantic Scholar, Crossref, arXiv ve PubMed’de arar
oleafly bib checkHiçbir gerçek kayıtla eşleşmeyen girdileri bulur
oleafly bib cleanAtıf anahtarlarını düzeltir ve yinelenenleri kaldırır; --apply değişiklikleri yazar
oleafly statsSözcükleri, başlıkları, şekilleri ve denklemleri sayar
oleafly synctexBir kaynak satırını PDF’e ve geri eşler
oleafly exportBelgeyi Word, HTML, Markdown, EPUB ve daha fazlasına dışa aktarır ve dışa aktarmanın neleri dışarıda bıraktığını listeler
oleafly convertBir dosyayı başka bir biçime dönüştürür
oleafly typstTypst sürümlerini listeler, kurar ve kaldırır
oleafly checkpointUygulamanın kontrol noktalarını listeler, karşılaştırır ve kopyalar
KomutNe yapar
oleafly contextProjeyi bir kişi ya da bir ajan için haritalar
oleafly mcpMCP sunucusunu çalıştırır; mcp config bir istemciyi kurar
oleafly skillsBecerileri listeler ve nerede olduklarını yazdırır
oleafly askProje hakkındaki bir soruyu yanıtlar
oleafly agentOleafly ajanını bir görev üzerinde çalıştırır
oleafly daemonGörevleri sürdüren yardımcıyı çalıştırır ve denetler
KomutNe yapar
oleafly checkPreflight denetimlerini çalıştırır
oleafly lintLaTeX, BibTeX, yazım ve dilbilgisi denetimlerini çalıştırır
KomutNe yapar
oleafly authÇevrimiçi LaTeX hizmetlerinde, Oleafly sunucularında ve Git barındırıcılarında oturum açar
oleafly remoteÇevrimiçi projeleri içe aktarır, bağlar ve eşitler
oleafly serverOleafly sunucularıyla çalışır: projeler, paylaşım, üyeler, yorumlar
KomutNe yapar
oleafly completionsbash, zsh, fish, PowerShell veya elvish için kabuk tamamlamalarını yazdırır
oleafly manKılavuz sayfasını yazdırır
oleafly help exit-codesÇıkış kodlarını açıklar
SeçenekNe yapar
-C ve ardından bir yolKomutu başka bir proje klasöründe çalıştırır
--jsonTek bir JSON sonucu yazdırır
--eventsSonuçtan önce ilerlemeyi JSON satırları olarak yazdırır
--quietYalnızca sonucu yazdırır
--logDerleyici günlüğünü none, tail ya da full olarak gösterir
--no-inputHiçbir zaman soru sormaz
--colorRengi auto, always ya da never olarak kullanır

--json ile her komut tek bir JSON nesnesi yazdırır: schema_version, ok, command, komutun kendi alanları ve warnings. Bir komut başarısız olduğunda error, bir kind, kararlı bir code ve bir message tutar. İşe yaradıklarında ayrıca bir hint, details ve yeniden denemek işe yarayabilecekse "retryable": true içerir. Bir alana güvenmeden önce schema_version değerini denetleyin.

{
"schema_version": 1,
"type": "result",
"ok": false,
"command": "remote sync",
"error": {
"kind": "conflict",
"code": "remote.conflicts",
"message": "2 files changed both here and online.",
"hint": "Pick a side with --resolve PATH=local or --resolve PATH=remote, then sync again.",
"details": { "conflicts": ["main.tex", "refs.bib"] }
},
"warnings": []
}

--events, sonuçtan önce her ilerleme olayı için bir JSON satırı ekler.

oleafly help exit-codes aynı tabloyu yazdırır.

KodAnlamı
0Çalıştı
1Oleafly’nin içinde bir şeyler ters gitti
2Komut yanlış kullanıldı ya da devam etmek için --yes gerekiyor
3Proje eksik ya da geçersiz, ya da bir yol projenin dışını gösteriyor
4Gereken bir araç ya da Oleafly uygulaması kurulu değil
5Derleme başarısız oldu
6Oturum açmanız gerekiyor
7Ağ başarısız oldu
8Başka bir şey projeyi tutuyor ya da bir eşitlemede çakışmalar var
9Bir denetim sorun buldu
130Ctrl+C’ye bastınız

Komut, terminal yoksa hiçbir zaman soru sormaz. --no-input soruları kapatır, bir CI değişkeni de öyle; evet gerektiren bir komut bu durumda 2 çıkış koduyla başarısız olur ve --yes ister. NO_COLOR ya da --color never rengi kapatır. Projenin dışına çıkacak yollar reddedilir.

DeğişkenKullanım
OLEAFLY_DATA_DIROleafly’nin veri klasörü, ~/.oleafly olmadığında
OLEAFLY_TECTONIC, OLEAFLY_LATEXMK, OLEAFLY_TYPST, OLEAFLY_PANDOCOleafly’nin bulduğu yerine kullanılacak bir derleyici
OLEAFLY_APPoleafly open komutunun başlattığı Oleafly uygulaması
OLEAFLY_ONLINE_GIT_TOKENÇevrimiçi LaTeX hizmeti için, kayıtlı olanın yerine kullanılan bir Git belirteci
OLEAFLY_DOWNLOAD_MIRRORTinyTeX ve Typst gibi indirmelerin geldiği yer: automatic, original ya da kendi yansınızın HTTPS adresi. Bkz. Kaynaklar sekmesi
OLEAFLY_TEX_REPOSITORYtlmgr’nin paketleri kurduğu TeX Live deposu
OLEAFLY_CLIOleafly’nin başlattığı programlar için ayarlanır: komutun tam yolu
CIAyarlandığında komut hiçbir zaman soru sormaz
NO_COLORAyarlandığında çıktıda renk olmaz
GördüğünüzDeneyebileceğiniz
oleafly bulunamıyorYeni bir terminal açın. Sonra Windows’ta Get-Command oleafly ile, macOS ve Linux’ta command -v oleafly ile denetleyin ve Ayarlar’ın gösterdiği satırı kabuk profilinize ekleyin
oleafly doctor eksik bir motor bildiriyordoctor’ın yazdırdığı komutla kurun ya da projeyi uygulamada bir kez açın
latexmk bulunamıyorUygulamada Ayarlar → Motorlar → LaTeX → TeX dağıtımlarını yönet altında TinyTeX’i kurun ya da ipucunun verdiği komutla TeX kurun. Bunun yerine yerleşik motoru kullanmak için bir projede oleafly config set engine tectonic ya da proje olmayan klasörler için oleafly config set latex.default_engine tectonic --global çalıştırın
Bir latexmk derlemesi eksik bir .sty veya .cls dosyasında duruyorTeX Live, MacTeX veya TinyTeX ile ipucu tlmgr search ve tlmgr install komutlarını verir. Debian, Ubuntu veya Fedora paketlerinden kurulan TeX Live, paketlerini bunun yerine apt ya da dnf’den alır: Debian ve Ubuntu’da apt-file search ve ardından dosya adı paketi bulur. MiKTeX ipucu vermez: paketi MiKTeX Console’da kurun, sonra yeniden derleyin
minted veya PythonTeX kullanan bir derleme başarısız oluyoroleafly build shell komutlarını engeller. Projeyi uygulamada Dış komutlara izin ver’i seçtikten sonra derleyin ya da latexmk’yi -shell-escape ile kendiniz çalıştırın
İlk derleme, paketler inerken zaman aşımına uğruyorYeniden derleyin. İndirme kaldığı yerden sürer. --timeout sınırı yükseltir
Bir Typst projesi kurulu olmayan bir sürüm istiyoroleafly typst install ve ardından o sürümü çalıştırın
Bir Linux AppImage’ında bir motor eksikAppImage’ın motorları yalnızca Oleafly’nin yerleşik terminalinde çalışır. Tectonic, Typst ve Pandoc’u kurun ya da .deb veya .rpm paketini kullanın
Bir MCP istemcisi sunucuyu başlatamıyorYapılandırılmış komutu bir terminalde çalıştırın, oleafly mcp config çıktısındaki tam yolu kullanın ve oleafly doctor çalıştırın
6 çıkış koduoleafly auth status çalıştırın, sonra yeniden oturum açın
Bir eşitleme sırasında 8 çıkış koduEşitlemeyi, listelediği her dosya için --resolve ile yeniden çalıştırın
macOS’ta Ayarlar “Önce Oleafly’yi Uygulamalar klasörüne taşıyın” diyorUygulamayı taşıyın, Uygulamalar’dan açın, sonra Kur’u seçin
Görsel önizlemesi

Yapay zekâ yanıtları yüklenemedi

Yeniden deneyin ya da dokümanlarda arama yapın.