Безплатен API Ruby за създаване и обработка на 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. Библиотеката помага на програмистите, като създава цялата структура на документа и компресира изходните документи. Библиотеката поддържа модифициране на съществуващите файлове, коригиране на размера на страницата, задаване на полета, прилагане на стилове и много други.

Създаване на Word документи чрез библиотеката 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 позволява на разработчиците на софтуер да добавят и модифицират таблици към техния word документ само с няколко реда Ruby код. Библиотеката включва няколко важни функции, свързани с управление на таблици, като добавяне на заглавие, добавяне на нови колони и редове, стилизиране на горната, долната или лявата и дясна част, прилагане на стил към конкретна клетка, обединяване или разделяне на клетки и много други. Библиотеката също така включва поддръжка за вложени таблици.

Използвайте списъци в Word документи

Библиотеката с отворен код Caracal включва поддръжка за използване на списъци в DOCX файлове с помощта на Ruby команди. Библиотеката позволява добавяне на подредени, както и неподредени списъци в Word документи. Той също така поддържа дълбоки вложени списъци и смесване в други комбинации. Можете лесно да дефинирате стилове за списъците. Библиотеката поддържа 9 нива на стилове по подразбиране както за подредени, така и за неподредени списъци.

Как да използвате списъци в Word документи чрез 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 документи. Библиотеката включва няколко функции, свързани с обработката на абзаци, като подравняване на текст, избор на шрифтове, определяне на цвета на шрифта и размера на шрифта, задаване на фонов цвят, прилагане на вертикално подравняване и т.н. Освен това осигурява поддръжка за лесно вмъкване на отметки директно в документа или вътре в блокове с абзаци.

Добавяне на отметки към Word документи чрез 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
 Български