API de Ruby gratuita para la creación y el procesamiento de DOCX de Word
Biblioteca Ruby de código abierto que brinda a los programadores la capacidad de crear documentos profesionales de Office Word, modificar archivos DOCX, agregar márgenes de página, insertar tablas anidadas usando una sintaxis similar a HTML.
La biblioteca Caracal brinda a los desarrolladores de Ruby la capacidad de generar documentos profesionales de Office Word dentro de sus propias aplicaciones utilizando una sintaxis similar a HTML. La biblioteca facilita el trabajo de los desarrolladores al permitirles usar algunos comandos simples para crear y administrar Office Open XML (OOXML). La biblioteca es de código abierto y está disponible bajo la licencia MIT.
La biblioteca está muy bien diseñada y separa las instrucciones de análisis de documentos de las instrucciones de procesamiento. Esta estrategia le da al proceso de renderizado una gran flexibilidad. La biblioteca ha incorporado varias funciones importantes relacionadas con el procesamiento de documentos de Word, como la creación de documentos de Word, la configuración del tamaño de la página, la compatibilidad con los márgenes de página, los saltos de página, los números de página, la compatibilidad con las fuentes, la compatibilidad con estilos y formato, la adición de un párrafo, el uso de enlaces y marcadores, la inserción de tablas, soporte de tablas anidadas, soporte de imágenes y muchos más.
Primeros pasos con Caracal
Agregue el archivo Gemfile de la siguiente aplicación de comando para un uso fluido de la biblioteca.
Instale Caracal agregando código al Gemfile de la aplicación
gem 'caracal'
Instale Caracal agregando código al Gemfile de la aplicación
bundle install
Creación de archivos Word Docx usando Ruby
La biblioteca Caracal de código abierto permite a los desarrolladores de Ruby generar archivos DOCX dentro de sus aplicaciones utilizando el código de Ruby. El formato de archivo DOCX es una colección comprimida de documentos XML y se crea utilizando el estándar OOXML. La biblioteca ayuda a los programadores creando la estructura completa del documento y comprimiéndola en los documentos de salida. La biblioteca admite la modificación de los archivos existentes, el ajuste del tamaño de la página, la configuración de márgenes, la aplicación de estilos y mucho más.
Crear documentos de Word a través de la Biblioteca Ruby Caracas
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
Agregar tablas y tablas anidadas en archivos de Word
La biblioteca gratuita de Caracal permite a los desarrolladores de software agregar y modificar tablas a su documento de Word con solo un par de líneas de código Ruby. La biblioteca ha incluido varias funciones importantes relacionadas con la administración de tablas, como agregar título, agregar nuevas columnas y filas, diseñar la parte superior, inferior o izquierda y derecha, aplicar estilo a una celda específica, combinar o dividir celdas y mucho más. La biblioteca también incluía soporte para tablas anidadas.
Usar listas dentro de documentos de Word
La biblioteca Caracal de código abierto ha incluido soporte para usar listas dentro de archivos DOCX usando comandos de Ruby. La biblioteca permite agregar listas ordenadas y desordenadas dentro de documentos de Word. También admite listas anidadas profundas y mezclas en otras combinaciones. Puede definir fácilmente estilos para las listas. La biblioteca admite 9 niveles de estilos predeterminados para listas ordenadas y desordenadas.
Cómo usar Listas dentro de Documentos de Word vía Biblioteca 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
Insertar párrafo y marcadores en un archivo DOCX
La biblioteca Caracal ha proporcionado funcionalidad para agregar párrafos a sus documentos de Word con facilidad. La biblioteca ha incluido varias funciones relacionadas con el manejo de párrafos, como la alineación del texto, la selección de fuentes, la definición del color de fuente y el tamaño de fuente, la configuración del color de fondo, la aplicación de alineación vertical, etc. También brinda soporte para insertar marcadores directamente en el documento o dentro de bloques de párrafo con facilidad.
Agregar marcadores a documentos de Word a través de la Biblioteca 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
