Bezpłatny interfejs Ruby API do tworzenia i przetwarzania dokumentów DOCX w programie Word 

Biblioteka Ruby typu open source, która daje programistom możliwość tworzenia profesjonalnych dokumentów Office Word, modyfikowania plików DOCX, dodawania marginesów stron, wstawiania zagnieżdżonych tabel przy użyciu składni podobnej do HTML.

Biblioteka Caracal daje programistom Ruby możliwość generowania profesjonalnych dokumentów Office Word we własnych aplikacjach przy użyciu składni podobnej do HTML. Biblioteka ułatwia pracę programistom, umożliwiając im korzystanie z kilku prostych poleceń do tworzenia i zarządzania Office Open XML (OOXML). Biblioteka jest open source i jest dostępna na licencji MIT.

Biblioteka jest bardzo dobrze zaprojektowana i oddziela instrukcję parsowania dokumentów od instrukcji przetwarzania. Ta strategia daje procesowi renderowania dużą elastyczność. Biblioteka zawiera kilka ważnych funkcji związanych z przetwarzaniem dokumentów tekstowych, takich jak tworzenie dokumentów tekstowych, ustawianie rozmiaru strony, obsługa marginesów strony, podział strony, numery stron, obsługa czcionek, obsługa stylów i formatowania, dodawanie akapitu, korzystanie z łączy i zakładek, wstawianie tabele, obsługa tabel zagnieżdżonych, obsługa obrazów i wiele innych.

Previous Next

Pierwsze kroki z Caracal

Dodaj następujący plik Gemfile aplikacji poleceń, aby zapewnić płynne korzystanie z biblioteki.

Zainstaluj Caracal, dodając kod do pliku Gemfile aplikacji

 gem 'caracal'

Zainstaluj Caracal, dodając kod do pliku Gemfile aplikacji

bundle install

Tworzenie plików Word Docx za pomocą Ruby

Biblioteka Caracal o otwartym kodzie źródłowym umożliwia programistom Rubiego generowanie plików DOCX w swoich aplikacjach przy użyciu kodu Rubiego. Format pliku DOCX jest spakowaną kolekcją dokumentów XML i jest tworzony przy użyciu standardu OOXML. Biblioteka pomaga programistom, tworząc całą strukturę dokumentu i zip dokumentów wyjściowych. Biblioteka obsługuje modyfikowanie istniejących plików, dostosowywanie rozmiaru strony, ustawianie marginesów, stosowanie stylów i wiele więcej.

Tworzenie dokumentów Word przez Ruby Caracas Biblioteka

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

Dodaj tabele i tabele zagnieżdżone w plikach Word

Bezpłatna biblioteka Caracal umożliwia twórcom oprogramowania dodawanie i modyfikowanie tabel do ich dokumentu tekstowego za pomocą zaledwie kilku linijek kodu Rubiego. Biblioteka zawiera kilka ważnych funkcji związanych z zarządzaniem tabelami, takich jak dodawanie tytułu, dodawanie nowych kolumn i wierszy, stylizowanie górnej, dolnej lub lewej i prawej strony, stosowanie stylu do określonej komórki, scalanie lub dzielenie komórek i wiele innych. Biblioteka zawierała również obsługę tabel zagnieżdżonych.

Używaj list w dokumentach Word

Biblioteka Caracal o otwartym kodzie źródłowym zawiera obsługę używania list w plikach DOCX za pomocą poleceń Rubiego. Biblioteka umożliwia dodawanie list uporządkowanych i nieuporządkowanych w dokumentach tekstowych. Obsługuje również głęboko zagnieżdżone listy i mieszanie w innych kombinacjach. Możesz łatwo zdefiniować style list. Biblioteka obsługuje 9 poziomów domyślnych stylów zarówno dla list uporządkowanych, jak i nieuporządkowanych.

Jak używać listy wewnątrz dokumentów Word poprzez 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

Wstaw akapit i zakładki do pliku DOCX

Biblioteka Caracal zapewnia możliwość łatwego dodawania akapitów do ich dokumentów tekstowych. Biblioteka zawiera kilka funkcji związanych z obsługą akapitów, takich jak wyrównanie tekstu, wybór czcionek, zdefiniowanie koloru czcionki i ustawienie koloru tła czcionki, zastosowanie wyrównania w pionie i tak dalej. Zapewnia również obsługę łatwego wstawiania zakładek bezpośrednio do dokumentu lub wewnątrz bloków akapitów.

Dodaj zakładki do dokumentów Word za pośrednictwem 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
 Polski