1. Produk
  2.   Pemprosesan perkataan
  3.   Ruby
  4.   Caracal
 
  

Percuma API Ruby untuk Word  Penciptaan & Pemprosesan DOCX 

Pustaka Ruby sumber terbuka yang memberi pengaturcara keupayaan untuk membuat dokumen Office Word profesional, mengubah suai fail DOCX, menambah jidar halaman, menyisipkan jadual bersarang menggunakan sintaks seperti HTML.

Pustaka Caracal memberi pembangun Ruby keupayaan untuk menjana dokumen Office Word profesional di dalam aplikasi mereka sendiri menggunakan sintaks seperti HTML. Perpustakaan memudahkan kerja Pembangun dengan membolehkan mereka menggunakan beberapa arahan mudah untuk mencipta dan mengurus Office Open XML (OOXML). Perpustakaan adalah sumber terbuka dan boleh didapati di bawah lesen MIT.

Perpustakaan ini direka dengan sangat baik dan ia memisahkan arahan untuk penghuraian dokumen daripada arahan pemprosesan. Strategi ini memberikan proses pemaparan sejumlah fleksibiliti yang hebat. Perpustakaan telah menggabungkan beberapa ciri penting yang berkaitan dengan pemprosesan dokumen perkataan seperti penciptaan dokumen perkataan, menetapkan saiz halaman, sokongan jidar halaman, pemisah halaman, nombor halaman, sokongan fon, gaya dan sokongan pemformatan, menambah perenggan, menggunakan pautan dan penanda halaman, memasukkan jadual, sokongan jadual bersarang, sokongan imej dan banyak lagi.

Previous Next

Bermula dengan Caracal

Sila tambahkan Gemfile aplikasi arahan berikut untuk penggunaan perpustakaan yang lancar.

Pasang Caracal dengan menambahkan kod pada Gemfile Aplikasi

 gem 'caracal'

Pasang Caracal dengan menambahkan kod pada Gemfile Aplikasi

bundle install

Penciptaan Fail Word Docx menggunakan Ruby

Pustaka Caracal sumber terbuka membolehkan pembangun Ruby menjana fail DOCX di dalam apl mereka menggunakan kod Ruby. Format fail DOCX ialah koleksi dokumen XML yang dizip dan dibuat menggunakan standard OOXML. Perpustakaan membantu pengaturcara dengan mencipta keseluruhan struktur dokumen dan mengezipnya dokumen output. Perpustakaan menyokong mengubah suai fail sedia ada, melaraskan saiz halaman, menetapkan margin, menggunakan gaya dan banyak lagi.

Cipta Dokumen Word melalui Perpustakaan Ruby Caracal

Caracal::Document.save 'example.docx' do |docx|
  # page 1
  docx.h1 'Page 1 Header'
  docx.hr
  docx.p
  docx.h2 'Section 1'
  docx.p  'Lorem ipsum dolor....'
  docx.p
  docx.table @my_data, border_size: 4 do
    cell_style rows[0], background: 'cccccc', bold: true
  end
  # page 2
  docx.page
  docx.h1 'Page 2 Header'
  docx.hr
  docx.p
  docx.h2 'Section 2'
  docx.p  'Lorem ipsum dolor....'
  docx.ul do
    li 'Item 1'
    li 'Item 2'
  end
  docx.p
  docx.img 'https://www.example.com/logo.png', width: 500, height: 300
end

Tambahkan Jadual dan Jadual Bersarang dalam Fail Word

Pustaka Caracal percuma membolehkan pembangun perisian menambah dan mengubah suai jadual pada dokumen perkataan mereka dengan hanya beberapa baris kod Ruby. Pustaka telah menyertakan beberapa pengurusan jadual berkaitan fungsi penting seperti menambah tajuk, menambah lajur dan baris baharu, menggayakan bahagian atas, bawah atau kiri & kanan,  gunakan gaya pada sel tertentu, cantumkan atau belah sel dan banyak lagi. Perpustakaan juga termasuk sokongan untuk jadual bersarang.

Gunakan Senarai dalam Dokumen Word

Pustaka Caracal sumber terbuka telah menyertakan sokongan untuk menggunakan senarai dalam fail DOCX menggunakan arahan Ruby. Perpustakaan membenarkan penambahan senarai tertib dan tidak tersusun di dalam dokumen perkataan. Ia juga menyokong senarai bersarang dalam dan mencampurkan dalam kombinasi lain. Anda boleh menentukan gaya untuk senarai dengan mudah. Pustaka menyokong 9 tahap gaya lalai untuk senarai tersusun dan tidak tersusun.

Cara Menggunakan Senarai di dalam Dokumen Word melalui Perpustakaan Ruby

docx.ol do
  li 'First item'
  li do
    text 'Second item with a '
    link 'link', 'http://www.google.com'
    text '.'
    br
    text 'This sentence follows a line break.'
  end
end

Masukkan Perenggan dan Penanda Halaman ke Fail DOCX

Perpustakaan Caracal telah menyediakan fungsi untuk menambah perenggan pada dokumen perkataan mereka dengan mudah. Perpustakaan telah memasukkan beberapa fungsi yang berkaitan dengan pengendalian perenggan, seperti penjajaran teks, pemilihan fon, penentuan warna fon dan penetapan saiz fon warna latar belakang, gunakan penjajaran menegak dan sebagainya. Ia juga menyediakan sokongan untuk memasukkan penanda halaman terus ke dokumen atau di dalam blok perenggan dengan mudah.

Tambahkan Penanda Halaman pada Dokumen Word melalui Perpustakaan Ruby

# document-level bookmark
dox.bookmark_start id: 's1', name: 'section1'
docx.h2 'Section Heading'
docx.bookmark_end id: 's1'
docx.p  'Section content.'
# pargraph-level bookmark
docx.h2 'Section Heading'
docx.p do
  text 'Pretend this paragraph has a lot of text and we want to bookmark '
  bookmark_start id: 'p1', name: 'phrase1'
  text 'a single phrase'
  bookmark_end id: 'p1'
  text ' inside the larger block.'
end
 Melayu