Bu makalede, 2007'den beri kullanılan Microsoft Word'ün yerel belge biçimi olan Markdown [1] ve DOCX arasındaki dönüştürmeye bir göz atacağız. Markdown ve Asciidoc meraklılarının (benim gibi) neden bu davayla ilgilendiğini merak edebilirsiniz. Bir grup başka yazarla işbirliği yapmak bir duruma yol açabilir, oysa bir veya daha fazla katılımcı çıktı formatı olarak DOCX ister. Kimseyi hayal kırıklığına uğratmayın ve bunun yerine hangi sınırlamaların olduğunu ve tüm grup üyelerini nasıl mutlu etmeye çalışabileceğimizi öğrenin.
Markdown nedir?
"Markdown'a Giriş" [2] bölümünde daha önce belirtildiği gibi, Markdown'ın amacı basit bir metinden HTML'ye dönüştürmedir. Bunun arkasındaki fikir, web sayfaları, belgeler ve özellikle blog girişleri yazmayı bir e-posta yazmak kadar kolay hale getirmekti. Bugün itibariyle, hafif biçimlendirme açıklama dillerinin bir sınıfının fiili eşanlamlısıdır ve hedefe ulaşılmış olarak görülebilir.
Markdown, düz metin biçimlendirme sözdizimi kullanır. HTML'ye benzer bir yaklaşımla, metninizdeki başlıkları, listeleri, resimleri ve referansları gösteren bir dizi işaretçi. Aşağıdaki birkaç satır, iki başlık (1. ve 2. düzey) ve iki paragraf içeren temel bir belgeyi ve bir liste ortamını göstermektedir.
## Fransa
Bu bir yer seçimi:
* Paris (_Ile de France_)
* Strazburg (_Alsace_)
Uygun bir ziyaret planı için yaklaşık bir hafta.
DOCX'e dönüştürme
Markdown belgenizi DOCX'e dönüştürmek için pandoc [3] aracını kullanın. Pandoc bir Haskell kütüphanesidir ve kendisini "evrensel belge dönüştürücü" veya "Belge dönüştürme için İsviçre çakısı" olarak tanımlar. Linux, Microsoft Windows, Mac OS X ve BSD gibi çeşitli platformlar için mevcuttur. Pandoc, genellikle Debian GNU/Linux, Ubuntu ve CentOS gibi Linux dağıtımları için bir paket olarak dahil edilir.
Basit bir dönüşüm çağrısı aşağıdaki gibidir:
$ pandoc -o testi.docx testi.mdİlk parametre '-o' çıktı dosyasına atıfta bulunur, ardından dosyanın adı ('test.belge'). Dosya uzantısı, pandoc'un istenen çıktı biçimini tanımlamasına yardımcı olur. İkinci parametre girdi dosyasını adlandırır - bizim durumumuzda bu sadece 'test'tir.md'.
Yukarıda gösterilen komutun uzun versiyonu, '-f markdown' ve '-t docx' iki parametresini içerir. İlki 'tat' terimini kısaltır ve girdi dosyasının biçimini tanımlar. İkincisi çıktı dosyası için aynısını yapar ve '-to'yu kısaltır.
Tam komut aşağıdaki gibidir:
$ pandoc -o testi.docx -f işaretleme -t docx testi.mdDönüştürülen dosyanın Microsoft Word kullanılarak açılması aşağıdaki çıktıyla sonuçlanır:
Pandoc, farklı metin öğeleri için stil sayfaları kullanır. Bu, bu öğeleri daha sonra tüm belge boyunca ihtiyaçlarınıza göre ayarlamanıza olanak tanır. Pandoc'un daha yeni sürümleri de tam tersini sunar - bir DOCX dosyasını aşağıdaki gibi Markdown'a dönüştürebilirsiniz:
$ pandoc -o testi.md testi.belgeArdından, oluşturulan dosya aşağıdaki içeriğe sahiptir:
Avrupa'da Gezilecek Tavsiye Edilen Yerler====================================
Fransa
------
Bu bir yer seçimi:
- Paris (*Ile de France*)
- Strazburg (*Alsas*)
Uygun bir ziyaret planı için yaklaşık bir hafta.
Kullanışlı Komut Satırı Seçenekleri
Pandoc seçeneklerinin listesi oldukça uzun. Aşağıdakiler daha iyi sonuçlar elde etmenize ve hayatınızı çok daha kolay hale getirmenize yardımcı olur:
* '-P' (uzun versiyon '-preserve-tabs'): Sekmeleri boşluklara dönüştürmek yerine koru. Bu, metninizin parçası olan girintili satırlara sahip kod blokları için yararlıdır.
* '-S' (uzun versiyon '-smart'): Tipografik olarak doğru çıktı üretin.
Bu seçenek, tırnak işaretlerini, kısa çizgileri/tireleri ve ayrıca üç noktayı (“… ”) düzeltir. “Bay” gibi bazı kısaltmalardan sonra ek, bölünemez boşluklar eklenir.”.
* '-track-changes=value': Microsoft Word “Değişiklikleri İzle” özelliğinin yardımıyla üretilen eklemeler, silmeler ve yorumlarla ne yapılacağını belirtir. Değer, belgede yapılan değişiklikleri dahil etmek veya kaldırmak için kabul, red veya tümü olabilir. Sonuç, düz bir dosyadır.
Daha fazla seçenek için belgelere ve Pandoc'un kılavuz sayfasına bakın.
Özet
Markdown ve DOCX arasındaki dönüşüm artık bir gizem değil. Birkaç adımda yapılır ve çok iyi çalışır. Mutlu hack 🙂
Bağlantılar ve Referanslar
* [1] İşaretleme
* [2] Frank Hofmann: Markdown'a Giriş
* [3] Pandoc
Teşekkür
Yazar, makaleyi hazırlarken yardımlarından dolayı Annette Kalbow'a teşekkür eder.