Installation vi

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

Cài đặt docxi: yêu cầu, thiết lập Bundler và nâng cấp

docxi là một gem viết hoàn toàn bằng Ruby. Khi cài đặt, gem chỉ kéo theo hai phụ thuộc là nokogiri và rubyzip, ngoài ra không có gì khác. Không cần phần mềm văn phòng nào.

Yêu cầu

Yêu cầu	Phiên bản
Ruby	2.5 trở lên
nokogiri	>= 1.8, < 2, được cài tự động
rubyzip	>= 1.3, < 4, được cài tự động
Rails	Không bắt buộc

Cài đặt bằng Bundler

Thêm gem vào Gemfile của bạn:

gem "docxi", "~> 0.1"

Sau đó cài đặt:

bundle install

Cài đặt không dùng Bundler

gem install docxi

Kiểm tra cài đặt

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

Trong dự án dùng Bundler, hãy chạy lệnh dưới dạng bundle exec ruby -e 'require "docxi"; puts Docxi::VERSION'. Lệnh sẽ in ra phiên bản đã cài, ví dụ 0.1.0.

Nâng cấp từ 0.0.x

Nếu Gemfile của bạn cố định docxi ở bản 0.0.x, chẳng hạn bằng "~> 0.0.6", hãy đổi dòng đó thành gem "docxi", "~> 0.1". Sau đó chạy bundle update docxi. Bạn không cần sửa mã, và 0.1.0 tạo ra những tài liệu giống hệt 0.0.6: bộ kiểm thử so sánh đầu ra với các tệp do 0.0.6 tạo ra.

Những gì đã thay đổi bên trong:

• nokogiri và rubyzip giờ có thể ở bất kỳ phiên bản nào trong các khoảng nêu trên, nên docxi cài được cùng các phiên bản Rails hiện tại.
• docxi không còn cần ActiveSupport đã được nạp.
• Tệp nén được ghi mà không có bản ghi Zip64.
• Hình ảnh được nạp mà không dùng Kernel#open, nên URL hoạt động trên Ruby 3.
• tab, frame và số trang trong đầu trang đều hoạt động.

Ứng dụng chạy Ruby cũ hơn 2.5 vẫn tiếp tục nhận bản 0.0.6, vì 0.1.0 khai báo Ruby 2.5 là phiên bản tối thiểu. Nhật ký thay đổi liệt kê mọi thay đổi.

Các phiên bản được kiểm thử trong CI

Mỗi phiên bản Rails được chạy với toàn bộ framework được nạp cùng 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 còn chạy:

• các bài kiểm thử không có Rails trên Ruby 2.5, 2.6 và 4.0
• các bài kiểm thử với rubyzip 1.3 (Ruby 2.5), rubyzip 2.4 (Ruby 3.3) và nokogiri 1.11 (Ruby 2.5)
• một bước kiểm tra LibreOffice có chuyển đổi được các tài liệu mẫu hay không

Ghi chú về nền tảng

• nokogiri cung cấp gem biên dịch sẵn cho các nền tảng Linux, macOS và Windows phổ biến. Nếu không có bản phù hợp, gem sẽ được biên dịch từ mã nguồn và cần một trình biên dịch C. Xem hướng dẫn cài đặt nokogiri.
• CI chạy trên Ubuntu 24.04, và các bài kiểm thử cũng đã được chạy trên macOS. Windows không được kiểm thử.

Nếu cài đặt thất bại

Xung đột của Bundler quanh nokogiri hoặc rubyzip gần như luôn có nghĩa là bản docxi 0.0.6 cũ đang được chọn. Xem Khắc phục sự cố.

Trang liên quan

• Bắt đầu
• Cấu hình
• Triển khai

---

← Trang chủ wiki · README