Web geliştiricileri için HTML içeriğini Word belgesine dönüştürmek her zaman zorlu bir süreç olmuştur. Mevcut çözümler genellikle ekran görüntüsü veya düzen korsanlığı kullanırken, DOM-docx tamamen farklı bir yaklaşım sunuyor. Bu yeni açık kaynaklı JavaScript kütüphanesi, HTML parçacıklarını doğrudan OOXML (Office Open XML) formatına çevirerek, Microsoft Word'de doğal olarak düzenlenebilir belgeler oluşturuyor.
DOM-docx'in en dikkat çekici özelliği, görsel regresyon döngüsü kullanarak sürekli olarak kendini geliştirmesidir. Kütüphane, HTML'i Chromium'da render ediyor, docx'e dönüştürüyor, LibreOffice ile rasterleştiriyor ve ardından insan onaylı metriklerle düzen ve yapısal doğruluğu puanlıyor. Bu sayede her güncellemede daha kaliteli çıktılar elde ediliyor.
Kurulumu oldukça basit: Sadece `npm install dom-docx` komutu yeterli. Node.js 20 veya üstü gerekiyor. Varsayılan inline yol için herhangi bir tarayıcıya veya Playwright'a ihtiyaç duyulmuyor. Ancak, hesaplanmış stiller (computed styles) veya rasterleştirme gibi gelişmiş özellikler için Playwright ve Chromium isteğe bağlı olarak yüklenebiliyor.
Teknik Analiz
Kütüphane hem Node.js hem de tarayıcı ortamında çalışabiliyor. Tarayıcıda, kullanıcının mevcut sekmesinde tamamen çalışarak herhangi bir ek kurulum gerektirmiyor. Node.js'de ise `convertHtmlToDocx` fonksiyonu ile HTML parçacığını doğrudan docx buffer'ına dönüştürebiliyorsunuz. CLI aracılığıyla da komut satırından dosya dönüşümü yapmak mümkün.
Gelecekte Ne Bekleniyor?
v0.1.x sürümünde başlıklar, paragraflar, listeler, tablolar, bağlantılar, blok alıntılar, yatay çizgiler, görseller ve temel flex satırları gibi birçok HTML öğesi destekleniyor. Ayrıca sayfa boyutu, yönlendirme, kenar boşlukları, varsayılan yazı tipi, meta veriler, üstbilgi/altbilgi ve sayfa numaraları gibi Word belgesi özellikleri de ayarlanabiliyor.
Detaylar ve Etkileri
DOM-docx'in gelecek sürümlerinde harici stil sayfaları, web fontları, CSS grid/float düzeni, formlar ve karmaşık SVG gibi özelliklerin desteklenmesi planlanıyor. Şimdiden denemek isteyenler için canlı demo sitesi (dom-docx.com) üzerinden dönüştürücüyü test edebilir, örnekleri inceleyebilir ve rehberi okuyabilirsiniz.
Kaynak: github.com
