1. Məhsullar
  2.   Söz emalı
  3.   Ruby
  4.   Sablon
 
  

Word DOCX faylları yaratmaq üçün Açıq Mənbə Ruby Kitabxanası

Güclü Pulsuz Ruby API, proqram təminatı inkişaf etdiricilərinə asanlıqla Word DOCX sənədləri yaratmağa imkan verir. Sənədin dizaynını təmin edir.'s Layout, Apply Styles, and Use Mail Merge Fields as Placeholders for Dynamic Content.

Sablon Kitabxanası nədir?

Proqram təminatı inkişafı dünyasında, hesabatlar, fakturalar və ya məktublar kimi dinamik sənədlərin yaradılması ümumi bir tələbatdır. Bir çox kitabxana sıfırdan sənədlər yarada bilsə də, formatlamanı düzgün əldə etmək üçün çoxlu öyrənmə əyrisi və yorucu kodlaşdırma tələb edir. Burada Sablon, güclü açıq mənbə Ruby kitabxanası, köməkçiniz olur. Sablon, Microsoft Word‑in tanışlığından və Ruby‑nin gücündən yararlanaraq minimal səy ilə mürəkkəb və gözəl formatlanmış sənədlər yaratmağı inqilab edir. O, Word Docx yaratmaq, MailMerge sahələri vasitəsilə məzmun əlavə etmək, inkişaf etmiş formatlama dəstəyi, şablonlarda şərhlər əlavə etmək, konfiqurasiya edilə bilən HTML & CSS konvertasiyası və daha çox xüsusiyyətləri dəstəkləyir.

Əsas konsepsiyası olaraq, Sablon .docx faylları üçün sənəd şablon emalçısıdır. Word‑un daxili Mail Merge funksionallığından istifadə edərək, tanış bir mühitdə şablonlar yaratmağa imkan verir. Sənədinizin düzülüşünü dizayn edə, stillər tətbiq edə və dinamik məzmun üçün Mail Merge sahələrini yer tutucu kimi istifadə edə bilərsiniz. Sablon sonra bu şablonu və bir data kontekstini (Ruby hash‑i) götürərək, məlumatla dolu son Word sənədi yaradır. Bu yanaşma təqdimat qatını (Word şablonu) data qatından (Ruby kodunuz) ayırır, sənəd yaradılma prosesini təmiz və idarəolunan edir. Sintaksisi Ruby və şablon dillərinə tanış olanlar üçün intuitivdir. Dizayner‑dostudur, məzmun və dizayn tam ayrı‑ayrıdır. Dizaynerlər koda toxunmadan birbaşa Word‑də işləyə bilərlər.

Previous Next

Sablon ilə Başlamaq

Sablonu quraşdırmağın tövsiyə olunan yolu RubyGems‑dən istifadə etməkdir. Problemsiz quraşdırma üçün aşağıdakı əmri istifadə edin.

RubyGems vasitəsilə sənədləri quraşdırın


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

Ruby vasitəsilə Word sahələri ilə məzmun əlavə etmək

Ən əsas funksiya dinamik məzmun əlavə etməkdir. Açıq mənbə Ruby kitabxanası Sablon Word‑un daxili sahə sintaksisindən istifadə edərək yer tutucular təyin edir. Word şablonunuzda, dinamik məzmun istədiyiniz yerdə bir sahə kodu əlavə edirsiniz. Sablon bu sahəni dəyərinizlə əvəz edəcək. Aşağıdakı nümunə proqram inkişaf etdiricilərinin istifadəçini salamlamaq üçün dinamik məzmun parçacığını necə əlavə edə biləcəyini göstərir.

Ruby vasitəsilə Word sənəd faylına dinamik mətn məzmunu necə əlavə etmək?

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‑ni WordML‑ə konvertasiya

Sablonun önəmli xüsusiyyətlərindən biri, HTML‑i WordProcessingML‑ə ( .docx faylları üçün istifadə olunan XML formatı) çevirmə qabiliyyətidir. Bu, verilənlər bazasından və ya zəngin mətn redaktorundan formatlanmış paraqraflar, siyahılar və ya cədvəllər kimi zəngin mətn məzmunu əlavə etmək lazım olduqda son dərəcə faydalıdır. Sablon HTML sətirini Word sənədində düzgün formatlanmış bölməyə çevirir, başlıqları, qalın və italik mətnləri və siyahı formatlamasını qoruyur. Aşağıdakı sadə nümunə mövcud şablonu necə yükləyib HTML məzmununu Ruby tətbiqlərində Word Docx faylına çevirməyi göstərir.

Ruby kitabxanası vasitəsilə HTML məzmununu Word Docx faylına necə çevirmək?

require "sablon"

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

html_content = "
Bu bir Alt Başlıqdır
Bu qalın və italik mətnli bir paraqrafdır.
  • Birinci element
  • İkinci element
"

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

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

Conditional Rendering

Ruby vasitəsilə Dinamik Şəkil Əlavəsi

Açıq mənbə Sablon kitabxanası Ruby kitabxanası istifadə edərək Word Docx sənədlərinə dinamik şəkildə şəkil əlavə etmək üçün faydalı bir xüsusiyyət daxildir. Yalnız bir neçə kod sətiri ilə inkişaf etdiricilər sənədlərinə dinamik şəkildə şəkillər əlavə edə bilərlər. Şəkil faylını göstərə bilərsiniz və Sablon onu sənədə daxil edəcək. Aşağıdakı nümunə Word sənədlərində dinamik şəkil əlavə etmənin necə həyata keçiriləcəyini göstərir.

Ruby kitabxanası vasitəsilə Word Docx‑ə dinamik şəkildə şəkil necə əlavə etmək?


// 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 vasitəsilə Şərti Təsvir

Sablon kitabxanası şərti blokları dəstəkləyir, istifadəçilərə dəyişən mövcudluğu və ya dəyərinə əsasən Word sənədinin hissələrini göstərməyi və ya gizlətməyi imkan verir. Bu, müəyyən şərtlərə əsasən sənədlərin fərdiləşdirilməsi üçün mükəmməldir. Məsələn, aşağıdakı nümunə istifadəçilərin bir Word sənədində müəyyən məlumatı gizlətmək və ya göstərmək üçün əmrləri necə təyin edə biləcəyini göstərir. Əgər show_extra_info doğru (true) olsa, if və endIf etiketləri arasındakı məzmun son sənədə daxil olacaq. Əgər false və ya nil isə, məzmun silinəcək.

Ruby istifadə edərək Word Docx sənədlərinin hissələrini necə göstərmək və ya gizlətmək?


context = {
  show_extra_info: true # or false
}
 Azəri