Bir projeyi dışa aktarma ve dönüştürme
En güncel PDF'i kaydedin, düzenlenebilir kaynağı paketleyin, sayfa görsellerini veya HTML'i dışa aktarın, Typst ile PDF/A ve PDF/UA yazın ya da bir LaTeX, Typst veya Markdown belgesini dönüştürün.
Proje araç çubuğunda Dışa aktar’ı açın. Menü, geçerli belge motorunu ve türünü izler; bu yüzden yalnızca Oleafly’nin o proje için çalıştırabileceği yolları gösterir.

Alıcınızın ihtiyacı olan çıktıyı seçin
Bölüm başlığı “Alıcınızın ihtiyacı olan çıktıyı seçin”- PDF okuma, yazdırma ve çoğu gönderim portalı içindir.
- Kaynak ZIP, makaleye, şekillere, kaynakçaya ve yerel stillere ihtiyaç duyan ortak yazarlar veya sistemler içindir.
- Sayfa PNG’si, görsel bekleyen bir slayt, ileti veya inceleme sistemi içindir.
- Typst tarafından yazılan PNG, SVG veya HTML, her sayfayı görsel olarak, vektör sayfalar olarak ya da bir web sayfası olarak isteyen Typst projeleri içindir.
- Word, HTML, Markdown, Typst, LaTeX veya düz metin, içeriği başka bir biçimde düzenlemek ya da yeniden kullanmak isteyenler içindir.
- PowerPoint, bir sunuyu ya da Markdown belgesini slaytlara dönüştürmek içindir. EPUB, e-kitap okuyucu içindir. Hangilerinin göründüğü motora bağlıdır. Bkz. Sunum ve kitap dışa aktarmaları.
PDF, kaynak arşivi ya da sayfa görseli kaydetme
Bölüm başlığı “PDF, kaynak arşivi ya da sayfa görseli kaydetme”- Çıktının en son düzenlemelerinizi içermesi için Yeniden derle’yi seçin.
- Son sayfaları ve kaynakçayı da kapsayarak PDF’i inceleyin.
- Dışa aktar’ı açın.
- PDF olarak dışa aktar, Kaynağı dışa aktar (.zip) ya da Sayfayı PNG olarak dışa aktar seçeneğini seçin.
- Kaydetme penceresinde bir hedef seçin.
- Kaydedilen dosyayı bulmak için tamamlanma iletisindeki Klasörde göster’i seçin.
PDF ve sayfa görseli eylemleri, projede bir PDF olana dek devre dışı kalır ve menü PDF için önce bir derleme gerekir der. PDF olarak dışa aktar, önizlemede gösterilen PDF’i kaydeder. Sayfayı PNG olarak dışa aktar, önizlemede baktığınız sayfayı yüksek çözünürlükte kaydeder.
Kaynak arşivi, derleme önbelleklerini ve Git’in iç dosyalarını içermez. Sembolik bağlantıları da dışarıda bırakır ve tamamlanma iletisi kaç tanesini atladığını söyler.
PDF güncel olmadığında
Bölüm başlığı “PDF güncel olmadığında”Önizleme güncel olmadığında Oleafly yine de PDF’i ya da sayfa görselini kaydeder ve tamamlanma iletisi size bunu söyler:
- Başarısız bir derlemeden sonra, son derlemenin başarısız olduğunu ve dosyanın eksik olabileceğini söyler.
- Henüz derlemediğiniz düzenlemelerden sonra, dosyanın son derlemeden geldiğini ve en son düzenlemelerinizi içermediğini söyler.
Dosyayı birine göndermeden önce yeniden derleyin, önizlemeyi denetleyin ve yeniden dışa aktarın.
Typst görselleri ve HTML
Bölüm başlığı “Typst görselleri ve HTML”Bir Typst projesinin Dışa aktar menüsünde ayrıca Görseller ve HTML bulunur; bu seçenek Typst ile dışa aktar penceresini açar. Bu dosyaları Typst’ün kendisi çizer; bu yüzden PNG ve SVG sayfaları tıpkı PDF gibi görünür.
- PNG görselleri için Çözünürlük 72, 144, 300 ya da 600 PPI olabilir.
- SVG görselleri, sayfaları vektör grafik olarak korur.
- HTML, Deneysel olarak işaretlenmiştir. Typst’ün HTML’i metni ve görselleri korur ama sayfa düzenini ve çizimleri dışarıda bırakır. Typst 0.15’ten önce denklemleri de dışarıda bırakır ve HTML’i seçtiğinizde iletişim kutusu bunu söyler.
PNG ve SVG için Sayfalar, 1, 3-5 veya 8- gibi sayfa numaraları ve aralıkları alır. Tüm sayfalar için boş bırakın. Her sayfa, seçtiğiniz adın ardına numaralandırılarak kendi dosyasına kaydedilir. Sayfa aralıkları Typst 0.12 veya sonrasını, HTML ise Typst 0.13 veya sonrasını gerektirir. İletişim kutusu yalnızca projenin Typst sürümünün yapabildiğini sunar. Projede derleme varyantları varsa dışa aktarma, derleme menüsünde seçili olanı kullanır.
Typst ile PDF/A ve PDF/UA
Bölüm başlığı “Typst ile PDF/A ve PDF/UA”Typst, arşivlik ve erişilebilir PDF’leri kendisi yazar. Ön denetim için proje rayındaki kalkan simgesini açın ve Erişilebilirlik denetiminin altındaki PDF standartları bölümünü bulun. PDF/A-2b ya da PDF/UA-1 gibi bir Standart seçin, ardından PDF’i dışa aktar’ı seçin.
Liste, projenin Typst sürümüne bağlıdır. Typst 0.11’de hiçbiri yoktur, Typst 0.12 PDF/A-2b sunar, Typst 0.13 PDF/A-3b ekler, Typst 0.14 ve sonrası tüm PDF/A düzeylerini ve PDF/UA-1’i sunar. Typst 0.14 ve sonrası ayrıca her PDF’i ekran okuyucular için etiketler; bu yüzden ayrı bir etiketli derleme yoktur. PDF/UA-1, bir belge başlığı ve her görsel için alternatif metin gerektirir; Ön denetim ikisini de denetler.
Düzenlenebilir biçimler
Bölüm başlığı “Düzenlenebilir biçimler”| Proje motoru | Dışa aktarımdaki biçimler |
|---|---|
| LaTeX | Word, kaynakları kendi içinde barındıran MathML’li HTML, Markdown, Typst ve düz metin |
| Typst | LaTeX, Word, kaynakları kendi içinde barındıran MathML’li HTML, Markdown ve düz metin |
| Markdown | Word, kaynakları kendi içinde barındıran MathML’li HTML, Typst, LaTeX ve düz metin |
Bir Typst projesi ayrıca EPUB sunar; bir Markdown projesi PowerPoint ve EPUB sunar. Bir LaTeX projesi bunları yalnızca eşleşen bir belge sınıfı için sunar.
Bu dönüştürmeler Pandoc aracılığıyla yerel olarak çalışır. Oleafly, bilgisayarınızdaki uyumlu bir kurulumu kullanır ya da ilk gerektiğinde doğrulanmış yönetilen bir derlemeyi indirir.
Typst projeleri farklı bir yol izler. Typst önce belgeyi HTML olarak yazar; Pandoc bu HTML’i Word, HTML, Markdown, LaTeX, düz metin veya EPUB’a dönüştürür; böylece denklemler ve başvurular geçer. Bir belgenin bu yolu izleyip izleyemeyeceği projenin Typst sürümüne bağlıdır:
| Typst sürümü | Yol |
|---|---|
| 0.15 veya sonrası | HTML üzerinden |
| 0.13 ve 0.14 | Typst belgenin tamamını yazabildiğinde HTML üzerinden. Yazamadığında Pandoc bunun yerine Typst kaynağını okur. |
| 0.12 veya öncesi | Pandoc kaynağı okur |
Typst HTML’i yazarken bir hatayla durursa Pandoc her sürümde kaynağı okur. Pandoc, Typst 0.13 veya 0.14’te kaynağı okuduğunda, dışa aktarmada uyarı yoksa tamamlanma iletisi döndürülmüş, ölçeklenmiş, taşınmış veya eğilmiş metnin eksik olabileceği konusunda uyarır. En eksiksiz dışa aktarma için derleme menüsündeki Typst sürümü (bu proje) altından projeyi Typst 0.15 veya sonrasına geçirin.
Dışa aktarma HTML üzerinden gittiğinde align, grid ve rotate gibi yerleşim işlevlerinin içindeki metin onda kalır. CeTZ ile yapılmış bir çizim çizgilerini ve şekillerini kaybeder, yalnızca metin etiketlerini korur ve tamamlanma iletisi Typst’ün neleri dışarıda bıraktığını adlandırır.
Bir belgeyi dönüştürme
Bölüm başlığı “Bir belgeyi dönüştürme”- Bir kez derleyin ve varsa kaynak hatalarını düzeltin.
- Dışa aktar’ı açın ve hedef biçimi seçin.
- İstenirse Pandoc kurulumunu tamamlayın. Oleafly Pandoc’un kullanılamadığını söylerse Ayarlar → Motorlar → Markdown altında Pandoc’u onar’ı seçin, sonra yeniden dışa aktarın.
- Dönüştürülen dosyayı önerilen uzantıyla kaydedin.
- Tamamlanma iletisini okuyun. Uyarılardan söz ediyorsa dışa aktarmanın neyi dışarıda bıraktığını görmek için Uyarıları göster’i seçin.
- Dosyayı hedef uygulamada açın ve yapısını, görünümünü denetleyin.
Hızlı bir deneme için başlık, denklem, tablo, görsel ve atıf içeren kısa bir bölümü dışa aktarın. Bu beş öğe sağlam kalırsa makalenin tamamını dönüştürün ve yeniden gözden geçirin.
Çalışmaya devam edeceğiniz bir Typst projesine tüm bir LaTeX projesini dönüştürmek için bunun yerine Typst projesine dönüştürme özelliğini kullanın. Yeni bir proje oluşturur ve dikkat gerektiren noktaları raporlar.
Dönüştürme neyi korur
Bölüm başlığı “Dönüştürme neyi korur”Pandoc; başlıkları, paragrafları, listeleri, bağlantıları, atıfları, tabloları, görselleri ve düzenlenebilir matematik bölümlerini korumayı hedefler. Her kaynak dildeki her özelliği her hedefte yeniden üretemez. Şu alanları yakından denetleyin:
- özel LaTeX komutları ve ortamları
- elle ayarlanmış sayfa düzeni ya da yüzen nesneler
- karmaşık ya da iç içe geçmiş tablolar
- kaynakça biçimi ve atıf işleyişi
- doğrudan hedef karşılığı olmayan Typst işlevleri
- ham HTML ya da Markdown uzantıları
HTML dışa aktarması kaynaklarını içine gömer ve denklemleri MathML olarak yazar. Bu, kendi başına açılması gereken bir belgeyi paylaşmak için kullanışlı kılar; yine de okuyucularınızın kullandığı tarayıcılarda denemeye değer.
Her biçimin neyi koruduğu
Bölüm başlığı “Her biçimin neyi koruduğu”- Word ve PowerPoint dışa aktarmaları PDF, SVG ve WebP şekillerini 220 ppi PNG resimlere dönüştürür. Kaynakta boyutu olmayan bir şekil kendi genişliğini korur.
- HTML ve EPUB dışa aktarmaları PDF şekillerini PNG resimlere dönüştürür.
- LaTeX’ten dışa aktarılan Markdown ve düz metin başlığı, yazarı ve özeti korur.
- LaTeX’ten Markdown veya Typst’e, Markdown’dan LaTeX veya Typst’e dışa aktarmalar, projenin şekil dosyalarını kopyalamak yerine onlara bağlanır. Dışa aktarmada uyarı yoksa tamamlanma iletisi, derlemeden önce görselleri ve kaynakçayı dışa aktarılan dosyanın yanına kopyalamanızı hatırlatır. Typst veya LaTeX’e dışa aktarılan bir Markdown belgesi, bildirdiği kaynakçayı, hiç bildirmediyse projenin
.bibdosyalarını korur. - Bir Markdown belgesinin LaTeX dışa aktarımı, belgenin belge türünü izler. Slaytlar ve posterler Beamer kaynağına, bir rapor ya da kitap
#başlıklarında başlayan bölümlere, bir mektup ise KOMA-Script mektubuna dönüşür. - Typst’ten LaTeX’e dışa aktarma, belgenin görsellerini
.texdosyasının yanındaki bir<name>-mediaklasörüne kopyalar. SVG, GIF ve WebP görselleri orada PDF olur, çünkü LaTeX onları okuyamaz.
Dışa aktarmalar şekilleri ana belgenin klasöründe, proje kökünde ve her \graphicspath klasöründe arar ve uzantısız adlandırılmış bir şekli bulur. EPS şekilleri dönüştürülemez; bu yüzden bir uyarıyla birlikte dosyaya olduğu gibi girer. Bir Markdown belgesinin Word, HTML, EPUB veya PowerPoint dışa aktarmasında bir Mermaid bloğu, onun için kaydedilen şekli gösterir.
Dışa aktarma sonrası uyarılar
Bölüm başlığı “Dışa aktarma sonrası uyarılar”Pandoc, bir biçimin tutamadığı şeyleri dışarıda bırakır. Bu, bir LaTeX veya Markdown projesinden dışa aktarmada ya da kaynağı okuyan bir Typst dışa aktarmasında olduğunda tamamlanma iletisi, görselleri kopyalama hatırlatması gibi diğer notlarının yerine dosyanın uyarılarla kaydedildiğini ve kaç tane olduğunu söyler. Neyin eksik kaldığını listeleyen Dışa aktarma uyarıları’nı açmak için Uyarıları göster’i seçin. O iletişim kutusundaki Klasörde göster, kaydedilen dosyanın bulunduğu klasörü açar.
Liste şunları adlandırabilir:
- dışa aktarmanın dışarıda bıraktığı bir blok; biliniyorsa dosyası ve satırıyla; örneğin bir
tikzpicture, bir\includepdfya da\onlyveya\uncovergibi bir Beamer katman komutu - dışa aktarmanın bulamadığı veya dönüştüremediği bir şekil
- kaynakçada olmayan bir atıf anahtarı
- TeX kodu olarak kalan matematik
- henüz numarası olmayan başvurular; bir derleme bunları düzeltir
Tekrarlanan bir uyarı bir kez görünür ve liste 50’de durur. Bir PowerPoint dışa aktarması, bir şekil eksik olduğunda farklı çalışır: durur, dosya kaydetmez ve hata şeklin adını verir. HTML üzerinden giden Typst dışa aktarmaları, Typst’ün neleri dışarıda bıraktığını bunun yerine tamamlanma iletisinde söyler.
Sunum ve kitap dışa aktarmaları
Bölüm başlığı “Sunum ve kitap dışa aktarmaları”Bir LaTeX projesi bunları belge sınıfına göre eşleştirir. PowerPoint olarak dışa aktar (.pptx) bir Beamer sunusunda, EPUB olarak dışa aktar (.epub) ise book, report, memoir, scrbook ve scrreprt sınıflarında görünür.
Bir Beamer sunusunda her çerçeve yeni bir slayt başlatır, \section bir bölüm slaytı ekler ve \subsection hiçbir şey eklemez. Birden çok görseli olan ya da bir görselle başka içeriği olan bir çerçeve ikinci bir slayda taşabilir.
Typst ve Markdown projelerinde menü, bu dışa aktarmalar için belgeyi denetlemez. Bir Markdown projesi her zaman ikisini de sunar, bir Typst projesi her zaman EPUB sunar. Bir Markdown belgesi PowerPoint olduğunda her 1. düzey başlık bir bölüm slaytı olur ve her 2. düzey başlık yeni bir slayt başlatır. İstisna type: slides olan bir belgedir: ön bilgisindeki bir slide-level satırı, hangi başlık düzeyinin slayt başlattığını seçer. Her EPUB’a bir içindekiler bölümü eklenir ve denklemleri MathML’dir.
Bunları düzenlenebilir başlangıç noktaları olarak kullanın. Slayt yerleşimi ve kitap tipografisi biçimler arasında nadiren bire bir eşleşir; bu yüzden her slaytı ya da bölümü hedef uygulamada inceleyin.
Bağımsız bir şekli dışa aktarma
Bölüm başlığı “Bağımsız bir şekli dışa aktarma”Bağımsız şekil projesi, derlemeden sonra PDF olarak dışa aktar (vektör görsel) ve PNG olarak dışa aktar seçeneklerini sunar. Her ölçekte keskin çizgi ve metin için PDF seçin. Hedef yalnızca raster görseller kabul ediyorsa PNG seçin.
Çıktıyı proje içinde kaydetme
Bölüm başlığı “Çıktıyı proje içinde kaydetme”PDF önizlemesi de PDF’i projeye kaydet seçeneğini sunar. Bu, bir gönderim kopyasını ya da derlenmiş şekli kaynağın yanında tutar. Bu kopyayı güncel tutmak için aynı menüde Derlemede PDF’yi eşitle seçeneğini açın; Oleafly her başarılı derlemeden sonra proje adıyla adlandırılmış bir PDF’i yeniler. Önceki bir PDF, projeyi geri yüklemeden bir kontrol noktasından kaydedilebilir. O dosyayı yalnızca üretilmiş çıktıyı sürümlemeyi düşünüyorsanız Git geçmişine ekleyin.
Paylaşmadan önce denetleyin
Bölüm başlığı “Paylaşmadan önce denetleyin”Gönderimden önce Ön denetimi çalıştırın. Etiketli bir PDF gerekiyorsa LaTeX için erişilebilir dışa aktarma iş akışını izleyin ya da bir Typst projesinde bir PDF/UA standardı seçin; ardından sonucu bağımsız bir PDF/UA denetleyicisi ve insan tarafından yapılacak bir erişilebilirlik incelemesiyle doğrulayın. Ön denetim birçok yararlı sinyal denetler; ancak uygunluğu onaylamaz.