1. Товары
  2.   Обработка текстов
  3.   Ruby
  4.   Caracal
 
  

Бесплатный Ruby API для создания и обработки Word DOCX 

Библиотека Ruby с открытым исходным кодом, которая дает программистам возможность создавать профессиональные документы Office Word, изменять файлы DOCX, добавлять поля страниц, вставлять вложенные таблицы с использованием синтаксиса, похожего на HTML.

Библиотека Caracal дает разработчикам Ruby возможность создавать профессиональные документы Office Word в своих собственных приложениях с использованием синтаксиса, подобного HTML. Библиотека упрощает работу разработчиков, позволяя им использовать несколько простых команд для создания и управления Office Open XML (OOXML). Библиотека имеет открытый исходный код и доступна по лицензии MIT.

Библиотека очень хорошо спроектирована и отделяет инструкции по разбору документов от инструкций по обработке. Эта стратегия придает процессу рендеринга большую гибкость. Библиотека включает в себя несколько важных функций, связанных с обработкой текстовых документов, таких как создание текстовых документов, настройка размера страницы, поддержка полей страницы, разрыв страницы, номера страниц, поддержка шрифтов, поддержка стилей и форматирования, добавление абзаца, использование ссылок и закладок, вставка таблицы, поддержка вложенных таблиц, поддержка изображений и многое другое.

Previous Next

Начало работы с каракалом

Пожалуйста, добавьте Gemfile следующего командного приложения для беспрепятственного использования библиотеки.

Установите Caracal, добавив код в Gemfile приложения.

 gem 'caracal'

Установите Caracal, добавив код в Gemfile приложения.

bundle install

Создание файлов Word Docx с использованием Ruby

Библиотека Caracal с открытым исходным кодом позволяет разработчикам Ruby создавать файлы DOCX внутри своих приложений, используя код Ruby. Формат файла DOCX представляет собой заархивированную коллекцию XML-документов и создается с использованием стандарта OOXML. Библиотека помогает программистам, создавая всю структуру документа и заархивируя в него выходные документы. Библиотека поддерживает изменение существующих файлов, настройку размера страницы, настройку полей, применение стилей и многое другое.

Создание текстовых документов через библиотеку 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

Добавление таблиц и вложенных таблиц в файлы Word

Бесплатная библиотека Caracal позволяет разработчикам программного обеспечения добавлять и изменять таблицы в своих текстовых документах всего за пару строк кода на Ruby. Библиотека включает несколько важных функций, связанных с управлением таблицами, таких как добавление заголовка, добавление новых столбцов и строк, стилизация верхней, нижней или левой и правой сторон, применение стиля к определенной ячейке, объединение или разделение ячеек и многое другое. В библиотеку также включена поддержка вложенных таблиц.

Используйте списки внутри документов Word

Библиотека Caracal с открытым исходным кодом включает поддержку использования списков внутри файлов DOCX с помощью команд Ruby. Библиотека позволяет добавлять как упорядоченные, так и неупорядоченные списки внутри документов Word. Он также поддерживает глубокие вложенные списки и смешивание в других комбинациях. Вы можете легко определить стили для списков. Библиотека поддерживает 9 уровней стилей по умолчанию как для упорядоченных, так и для неупорядоченных списков.

Как использовать списки в Word Documents через Ruby Library

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

Вставить абзац и закладки в файл DOCX

Библиотека Caracal предоставляет функциональные возможности для легкого добавления абзаца в текстовые документы. Библиотека включает несколько функций, связанных с обработкой абзацев, таких как выравнивание текста, выбор шрифтов, определение цвета шрифта и размера шрифта, установка цвета фона, применение вертикального выравнивания и так далее. Он также обеспечивает поддержку для простой вставки закладок непосредственно в документ или внутри блоков абзацев.

Добавить закладки в Word Documents через Ruby Library

# 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
 Русский