1. Ürün:% s
  2.   Kelime İşleme
  3.   Ruby
  4.   Sablon
 
  

Word DOCX Dosyaları Oluşturmak için Açık Kaynak Ruby Kütüphanesi

Kolaylıkla Word DOCX Belgeleri Oluşturmayı Sağlayan Güçlü Ücretsiz Ruby API'si. Belge Tasarlamayı Sağlar.'s Layout, Apply Styles, and Use Mail Merge Fields as Placeholders for Dynamic Content.

Sablon Kütüphanesi Nedir?

Yazılım geliştirme dünyasında rapor, fatura veya mektup gibi dinamik belgeler oluşturmak yaygın bir gereksinimdir. Birçok kütüphane sıfırdan belge oluşturabilse de, formatlamayı doğru yapmak genellikle zor bir öğrenme eğrisi ve zahmetli kodlama gerektirir. İşte bu noktada, güçlü bir açık kaynak Ruby kütüphanesi olan Sablon devreye girer. Sablon, Microsoft Word'ün tanıdık ortamını ve Ruby'nin gücünü birleştirerek minimal çaba ile karmaşık ve güzel biçimlendirilmiş belgeler oluşturmanızı sağlar. Word Docx oluşturma, MailMerge alanlarıyla içerik ekleme, gelişmiş biçimlendirme desteği, şablonlara ek açıklama ekleme, yapılandırılabilir HTML & CSS dönüşümü ve daha fazlası gibi özellikleri destekler.

Temel olarak, Sablon .docx dosyaları için bir belge şablon işleyicisidir. Word'ün yerleşik Mail Merge işlevini kullanarak, tanıdık bir ortamda şablonlar oluşturmanıza imkan tanır. Belgenizin düzenini tasarlayabilir, stiller uygulayabilir ve dinamik içerik için Mail Merge alanlarını yer tutucu olarak kullanabilirsiniz. Sablon daha sonra bu şablonu ve bir veri bağlamını (Ruby hash'i) alarak veriyle doldurulmuş son bir Word belgesi üretir. Bu yaklaşım sunum katmanını (Word şablonu) veri katmanından (Ruby kodunuz) ayırır, belge üretim sürecini temiz ve sürdürülebilir kılar. Söz dizimi, Ruby ve şablon dilleriyle tanışık olan herkes için sezgiseldir. Tasarımcı dostudur; içerik ve tasarım tamamen ayrılmıştır. Tasarımcılar kodla uğraşmadan doğrudan Word içinde çalışabilirler.

Previous Next

Sablon ile Başlarken

Sablon'u kurmanın önerilen yolu RubyGems kullanmaktır. Sorunsuz bir kurulum için lütfen aşağıdaki komutu kullanın.

RubyGems ile Belgeleri Kur


gem 'sablon'
You can also download it directly from GitHub.

Ruby ile Word Alanları Kullanarak İçerik Ekleme

En temel işlev, dinamik içerik eklemektir. Açık kaynak Ruby kütüphanesi Sablon, Word'ün yerleşik alan sözdizimini kullanarak yer tutucular tanımlar. Word şablonunuzda, dinamik içerik istediğiniz yere bir alan kodu eklersiniz. Sablon bu alanı değerinizle değiştirir. Aşağıdaki örnek, geliştiricilerin bir kullanıcıyı selamlamak için dinamik bir içerik parçasını nasıl ekleyebileceğini gösterir.

Ruby ile Word Docs Dosyasına Dinamik Metin İçerikleri Nasıl Eklenir?

require 'sablon'

template = Sablon.template(File.expand_path('~/template.docx'))
context = {
  name: "Sarah Connor"
}

template.render_to_file(File.expand_path('~/output.docx'), context)

Template:

Hello, «name»! Welcome to our platform.

Output:
Hello, Sarah Connor! Welcome to our platform.

HTML'den WordML Dönüşümü

Sablon'un öne çıkan özelliklerinden biri, HTML'i WordProcessingML ( .docx dosyalarının kullandığı XML formatı) formatına dönüştürme yeteneğidir. Bu, bir veritabanı veya zengin metin editöründen biçimlendirilmiş paragraflar, listeler veya tablolar gibi zengin metin içeriği eklemeniz gerektiğinde son derece yararlıdır. Sablon, HTML dizesini Word belgesinde uygun biçimlendirilmiş bir bölüme dönüştürür, başlıkları, kalın ve italik metni ve liste biçimlendirmesini korur. İşte mevcut bir şablonu yükleyip HTML içeriğini Ruby uygulamaları içinde Word Docx dosyasına dönüştüren basit bir örnek.

Ruby Kütüphanesi ile HTML İçerikleri Word Docx Dosyasına Nasıl Dönüştürülür?

require "sablon"

template = Sablon.template(File.expand_path("template.docx"))

html_content = "
Bu bir Alt Başlık
Bu bir paragraftır ve kalın ve italik metin içerir.
  • İlk öğe
  • İkinci öğe
"

context = {
  article_content: Sablon.content(:html, html_content)
}

template.render_to_file(File.expand_path("output.docx"), context)

Conditional Rendering

Ruby ile Dinamik Görsel Ekleme

Açık kaynak Sablon kütüphanesi, Ruby kütüphanesini kullanarak Word Docx belgelerine dinamik olarak görüntü eklemek için faydalı bir özellik eklemiştir. Sadece birkaç satır kodla geliştiriciler belgelerinize dinamik olarak görüntüler ekleyebilir. Bir görüntü dosyası belirtebilir ve Sablon bu görüntüyü belgeye gömer. Aşağıdaki örnek, Word belgelerine dinamik görüntü eklemenin nasıl yapılacağını gösterir.

Ruby Kütüphanesi ile Word Docx'e Dinamik Görsel Nasıl Eklenir?


// You would have a placeholder image in your template with a special filename like «=company_logo».

context = {
  company_logo: Sablon.content(:image, "path/to/your/logo.png")
}

Ruby ile Koşullu Renderleme

Sablon kütüphanesi koşullu blokları destekler; kullanıcıların bir değişkenin varlığına veya değerine göre Word belgelerinin bölümlerini gösterip gizlemesine izin verir. Bu, belgeleri belirli koşullara göre özelleştirmek için mükemmeldir. Örneğin aşağıdaki örnek, kullanıcıların bir word belgesi içinde belirli bilgileri gizlemek veya göstermek için komutlar ayarlayabileceğini gösterir. show_extra_info true ise, if ve endIf etiketleri arasındaki içerik son belgeye dahil edilir. False veya nil ise içerik çıkarılır.

Ruby Kullanarak Word Docx Belgelerinin Parçalarını Gösterme veya Gizleme Nasıl Yapılır?


context = {
  show_extra_info: true # or false
}
 Türkçe