ADOC'u Çevrimiçi PDF'ye Dönüştür

ADOC'tan PDF'ye Dönüştürücü — Sıkça Sorulan Sorular ▼

ADOC'u Çevrimiçi PDF'ye Dönüştür — AsciiDoc'tan Taşınabilir Belgeye

AsciiDoc, teknik dokümantasyon için tercih edilen biçimlendirme dilidir — yazılım kılavuzları, API referansları, mimari karar kayıtları ve geliştirici el kitapları. .adoc ile yazmak size sürüm kontrollü düz metin verir; mühendislik ekibi dışındaki paydaşlarla paylaşmak ise AsciiDoc işlemcisi olmadan açabilecekleri bir şey gerektirir. ADOC'u PDF'ye dönüştürmek, başlıkları, listeleri, kod bloklarını, tabloları ve açıklama kutularını tam olarak tasarlandığı gibi işleyen temiz, biçimlendirilmiş bir belge üretir — alıcının Asciidoctor, Ruby veya herhangi bir derleme araç zinciri kurmasını gerektirmeden herhangi bir cihazda okunabilir, yazdırılabilir ve imzalanabilir.

ADOC Dosyası Nedir?

ADOC dosyası, AsciiDoc düz metin belgesidir. AsciiDoc, Markdown'dan daha zengin semantiğe sahip hafif bir biçimlendirme dilidir — yerel olarak çapraz referansları, dahil etmeleri, koşullu yönergeleri ve karmaşık tablo yapılarını destekler. Format, özellikle Antora, Asciidoctor veya DocBook'u yayımlama hattı olarak kullanan projelerde yazılım belgelendirme iş akışlarında yaygın olarak kullanılmaktadır.

• Uzantı: .adoc (eski dosyalar için ayrıca .asciidoc veya .asc)
• Kodlama: UTF-8 düz metin — Git ile sürüm kontrolü yapılabilir, diff'e uygundur
• İşlemci: Asciidoctor (Ruby), AsciidoctorJ (JVM), yerel PDF çıktısı için asciidoctor-pdf
• Kullananlar: Resmi belgeler için Red Hat, Spring Framework, Quarkus, Couchbase ve birçok açık kaynak proje
• Markdown'dan daha zengin: Tablolar, dipnotlar, kaynakçalar, çapraz dosya dahil etmeleri ve koşullu içerik blokları için yerel destek

Kimin ADOC'tan PDF'ye Dönüştürmesine Gerek Var?

• Taslak paylaşan teknik yazarlar: Asciidoctor kurulu olmayan bir ürün yöneticisine, hukuki inceleyiciye veya iş paydaşına devam eden bir belge gönderme.
• Belge sunan geliştiriciler: Üniversite dersleri, konferans sunumları ve müşteri teslimatları genellikle PDF gerektirir. ADOC kaynağı saniyeler içinde dönüştürülür.
• Açık kaynak proje sahipleri: Yayın arşivlerinin yanında dağıtım için README, CONTRIBUTING veya mimari belgelerinin PDF sürümünü üretme.
• Derleme hattı olmayan teknik ekipler: Her ekibin Asciidoctor veya Antora hattı kurulu değildir. Çevrimiçi dönüştürücü, herhangi bir araç zinciri yapılandırması olmadan dosyayı işler.
• Uyumluluk ve denetim dokümantasyonu: AsciiDoc'ta yazılmış güvenlik politikaları, çalışma kitapları ve mimari karar kayıtlarının uyumluluk incelemeleri ve denetimler için PDF olarak sunulması gerekiyor.
• İçerik ekibi devir teslimi: Mühendislikten bir içerik ekibine veya dış ajansa inceleme için evrensel erişilebilir biçimde kesinleşmiş bir spec veya tasarım belgesi teslim etme.

ADOC ve PDF — Temel Farklar

Çevrimiçi Dönüştürücü ve Total Doc Converter

Total Doc Converter'ı İndir

Komut Satırıyla Toplu ADOC'tan PDF'ye Dönüştürme

Total Doc Converter, belgelendirme yayın hatları veya tek geçişte .adoc spec'lerinden oluşan bir depoyu dönüştürme için komut satırından tüm AsciiDoc dosyası klasörlerini PDF'ye dönüştürür:

docconverter.exe /S "C:\Docs\*.adoc" /F PDF /O "C:\PDF-Output"

HTML çıktısının yanında PDF belgelendirme sürümlerini otomatik olarak üretmek için bir derleme betiğine entegre edin. Her derleme makinesinde tam Asciidoctor araç zinciri kurmadan AsciiDoc kaynak dosyalarından oluşan bir klasörden dağıtılabilir PDF el kitabı oluşturmak için yayın öncesi adım olarak çalıştırın.

ADOC File

PDF File