Installation id

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

Menginstal docxi: persyaratan, penyiapan Bundler, dan peningkatan

docxi adalah gem yang sepenuhnya ditulis dengan Ruby. Pemasangannya hanya menarik dua dependensi, nokogiri dan rubyzip, tidak lebih. Tidak diperlukan perangkat lunak perkantoran.

Persyaratan

Persyaratan	Versi
Ruby	2.5 atau lebih baru
nokogiri	>= 1.8, < 2, dipasang otomatis
rubyzip	>= 1.3, < 4, dipasang otomatis
Rails	Tidak diperlukan

Instal dengan Bundler

Tambahkan gem ke Gemfile Anda:

gem "docxi", "~> 0.1"

Lalu pasang:

bundle install

Instal tanpa Bundler

gem install docxi

Periksa instalasi

ruby -e 'require "docxi"; puts Docxi::VERSION'

Di proyek Bundler, jalankan sebagai bundle exec ruby -e 'require "docxi"; puts Docxi::VERSION'. Perintah ini mencetak versi yang terpasang, misalnya 0.1.0.

Meningkatkan dari 0.0.x

Jika Gemfile Anda mengunci docxi ke versi 0.0.x, misalnya dengan "~> 0.0.6", ubah barisnya menjadi gem "docxi", "~> 0.1". Lalu jalankan bundle update docxi. Kode tidak perlu diubah, dan 0.1.0 menghasilkan dokumen yang sama dengan 0.0.6: rangkaian pengujian membandingkan keluarannya dengan file yang dihasilkan oleh 0.0.6.

Yang berubah di balik layar:

• nokogiri dan rubyzip kini boleh berversi apa saja dalam rentang di atas, sehingga docxi bisa dipasang berdampingan dengan versi Rails terkini.
• docxi tidak lagi memerlukan ActiveSupport dalam keadaan termuat.
• Arsip ditulis tanpa rekaman Zip64.
• Gambar dimuat tanpa Kernel#open, sehingga URL berfungsi di Ruby 3.
• tab, frame, dan nomor halaman di header berfungsi.

Aplikasi yang memakai Ruby lebih lama dari 2.5 tetap mendapatkan 0.0.6, karena 0.1.0 menyatakan Ruby 2.5 sebagai versi minimum. Catatan perubahan mencantumkan setiap perubahan.

Versi yang diuji di CI

Setiap versi Rails dijalankan dengan seluruh framework dimuat bersama docxi.

Ruby	Rails
2.5	5.2
2.7	6.0
3.0	6.1
3.1	7.0
3.2	7.1
3.3	7.2
3.4	8.0
4.0	8.1

CI juga menjalankan:

• pengujian tanpa Rails di Ruby 2.5, 2.6, dan 4.0
• pengujian dengan rubyzip 1.3 (Ruby 2.5), rubyzip 2.4 (Ruby 3.3), dan nokogiri 1.11 (Ruby 2.5)
• pemeriksaan bahwa LibreOffice bisa mengonversi dokumen contoh

Catatan platform

• nokogiri menyediakan gem yang sudah dikompilasi untuk platform Linux, macOS, dan Windows yang umum. Jika tidak ada yang cocok, nokogiri dikompilasi dari kode sumber dan memerlukan kompiler C. Lihat panduan instalasi nokogiri.
• CI berjalan di Ubuntu 24.04, dan pengujiannya juga pernah dijalankan di macOS. Windows tidak diuji.

Jika instalasi gagal

Konflik Bundler pada nokogiri atau rubyzip hampir selalu berarti docxi 0.0.6 versi lama yang sedang diresolusi. Lihat Pemecahan masalah.

Halaman terkait

• Memulai
• Konfigurasi
• Deployment

---

← Beranda wiki · README