Kostenlose Ruby API für Word DOCX-Erstellung und -Verarbeitung 

Open-Source-Ruby-Bibliothek, mit der Programmierer professionelle Office-Word-Dokumente erstellen, DOCX-Dateien ändern, Seitenränder hinzufügen und verschachtelte Tabellen mit HTML-ähnlicher Syntax einfügen können.

Die Caracal-Bibliothek gibt Ruby-Entwicklern die Möglichkeit, professionelle Office-Word-Dokumente in ihren eigenen Anwendungen mit HTML-ähnlicher Syntax zu generieren. Die Bibliothek erleichtert die Arbeit von Entwicklern, indem sie ihnen ermöglicht, einige einfache Befehle zum Erstellen und Verwalten von Office Open XML (OOXML) zu verwenden. Die Bibliothek ist Open Source und steht unter der MIT-Lizenz.

Die Bibliothek ist sehr gut gestaltet und trennt die Anweisungen zum Analysieren von Dokumenten von den Anweisungen zur Verarbeitung. Diese Strategie verleiht dem Rendering-Prozess eine große Flexibilität. Die Bibliothek hat mehrere wichtige Funktionen in Bezug auf die Verarbeitung von Word-Dokumenten integriert, wie z Tabellen, Unterstützung für verschachtelte Tabellen, Unterstützung für Bilder und vieles mehr.

Previous Next

Erste Schritte mit Caracal

Bitte fügen Sie das Gemfile der folgenden Befehlsanwendung für eine reibungslose Verwendung der Bibliothek hinzu.

Installieren Sie Caracal, indem Sie der Gemfile der Anwendung Code hinzufügen

 gem 'caracal'

Installieren Sie Caracal, indem Sie der Gemfile der Anwendung Code hinzufügen

bundle install

Erstellung von Word-Docx-Dateien mit Ruby

Die Open-Source-Bibliothek Caracal ermöglicht es Ruby-Entwicklern, DOCX-Dateien in ihren Apps mithilfe von Ruby-Code zu generieren. Das DOCX-Dateiformat ist eine gezippte Sammlung von XML-Dokumenten und wird mit dem OOXML-Standard erstellt. Die Bibliothek hilft Programmierern, indem sie die gesamte Struktur des Dokuments erstellt und die Ausgabedokumente komprimiert. Die Bibliothek unterstützt das Ändern der vorhandenen Dateien, das Anpassen der Seitengröße, das Festlegen von Rändern, das Anwenden von Stilen und vieles mehr.

Erstellen von Word-Dokumenten über die Ruby Caracas Bibliothek

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

Fügen Sie Tabellen und verschachtelte Tabellen in Word-Dateien hinzu

Die kostenlose Caracal-Bibliothek ermöglicht es Softwareentwicklern, mit nur wenigen Zeilen Ruby-Code Tabellen zu ihrem Word-Dokument hinzuzufügen und zu ändern. Die Bibliothek enthält mehrere wichtige Funktionen im Zusammenhang mit der Tabellenverwaltung, z. B. Titel hinzufügen, neue Spalten und Zeilen hinzufügen, oben, unten oder links und rechts gestalten, Stil auf eine bestimmte Zelle anwenden, Zellen zusammenführen oder teilen und vieles mehr. Die Bibliothek enthielt auch Unterstützung für verschachtelte Tabellen.

Verwenden Sie Listen in Word-Dokumenten

Die Open-Source-Bibliothek Caracal bietet Unterstützung für die Verwendung von Listen in DOCX-Dateien mit Ruby-Befehlen. Die Bibliothek ermöglicht das Hinzufügen geordneter und ungeordneter Listen in Word-Dokumenten. Es unterstützt auch tief verschachtelte Listen und das Mischen in anderen Kombinationen. Sie können ganz einfach Stile für die Listen definieren. Die Bibliothek unterstützt 9 Ebenen von Standardstilen für geordnete und ungeordnete Listen.

Wie Listen in Word-Dokumenten benutzt werden können,

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

Absatz und Lesezeichen in DOCX-Datei einfügen

Die Caracal-Bibliothek bietet Funktionen zum einfachen Hinzufügen von Absätzen zu ihren Word-Dokumenten. Die Bibliothek enthält mehrere Funktionen im Zusammenhang mit der Handhabung von Absätzen, wie z. B. Textausrichtung, Auswahl von Schriftarten, Definition von Schriftfarbe und Schriftgröße, Einstellung der Hintergrundfarbe, Anwendung der vertikalen Ausrichtung und so weiter. Es bietet auch Unterstützung für das einfache Einfügen von Lesezeichen direkt in das Dokument oder in Absatzblöcke.

Fügen Sie Lesezeichen zu Word-Dokumenten über die Ruby-Bibliothek hinzu.

# 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
 Deutsch