Installation es

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

Instalar docxi: requisitos, configuración de Bundler y actualización

docxi es una gema escrita solo en Ruby. Al instalarla se añaden dos dependencias, nokogiri y rubyzip, y nada más. No hace falta ningún software de ofimática.

Requisitos

Requisito	Versión
Ruby	2.5 o posterior
nokogiri	>= 1.8, < 2, se instala automáticamente
rubyzip	>= 1.3, < 4, se instala automáticamente
Rails	No es necesario

Instalar con Bundler

Añade la gema a tu Gemfile:

gem "docxi", "~> 0.1"

Después instálala:

bundle install

Instalar sin Bundler

gem install docxi

Comprobar la instalación

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

En un proyecto con Bundler, ejecútalo como bundle exec ruby -e 'require "docxi"; puts Docxi::VERSION'. Muestra la versión instalada, por ejemplo 0.1.0.

Actualizar desde 0.0.x

Si tu Gemfile fija docxi en una 0.0.x, por ejemplo con "~> 0.0.6", cambia la línea a gem "docxi", "~> 0.1". Después ejecuta bundle update docxi. No hace falta cambiar el código, y la 0.1.0 genera los mismos documentos que la 0.0.6: el conjunto de pruebas compara la salida con archivos generados por la 0.0.6.

Qué ha cambiado internamente:

• nokogiri y rubyzip pueden tener ahora cualquier versión dentro de los rangos anteriores, así que docxi se instala junto a las versiones actuales de Rails.
• docxi ya no necesita que ActiveSupport esté cargado.
• Los archivos ZIP se escriben sin registros Zip64.
• Las imágenes se cargan sin Kernel#open, así que las URL funcionan en Ruby 3.
• tab, frame y los números de página en los encabezados funcionan.

Las aplicaciones con una versión de Ruby anterior a la 2.5 siguen recibiendo la 0.0.6, porque la 0.1.0 declara Ruby 2.5 como mínimo. El registro de cambios enumera todos los cambios.

Versiones probadas en CI

Cada versión de Rails se ejecuta con el framework completo cargado junto a 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 también ejecuta:

• las pruebas sin Rails en Ruby 2.5, 2.6 y 4.0
• las pruebas con rubyzip 1.3 (Ruby 2.5), rubyzip 2.4 (Ruby 3.3) y nokogiri 1.11 (Ruby 2.5)
• una comprobación de que LibreOffice puede convertir los documentos de ejemplo

Notas sobre plataformas

• nokogiri publica gemas precompiladas para las plataformas Linux, macOS y Windows más comunes. Cuando ninguna coincide, se compila desde el código fuente y necesita un compilador de C. Consulta la guía de instalación de nokogiri.
• CI se ejecuta en Ubuntu 24.04, y las pruebas también se han ejecutado en macOS. Windows no se ha probado.

Si la instalación falla

Los conflictos de Bundler con nokogiri o rubyzip casi siempre significan que se está resolviendo una versión antigua, docxi 0.0.6. Consulta Solución de problemas.

Páginas relacionadas

• Primeros pasos
• Configuración
• Despliegue

---

← Inicio de la wiki · README