![](https://products-qa.fileformat.com/de/pdf/ruby/prawn/header-image.png)
Prawn
Schnelle PDF-Generierung über die Open-Source-Ruby-Bibliothek
Kostenlose Ruby PDF API, mit der Programmierer PDF-Dateien erstellen und ändern können; Grafiken einfügen, bearbeiten und Text auf einer PDF-Seite in Ruby Apps zeichnen.
Das Portable Document Format (PDF) ist ein sehr beliebtes, zuverlässiges und sicheres Dateiformat zum Präsentieren, Freigeben und Drucken von Dateien auf der ganzen Welt. Die Open-Source-Ruby-Bibliothek Prawn hat die vollständige Funktionalität für die Arbeit mit PDF-Dokumenten unter Verwendung der Ruby-Bibliothek bereitgestellt. Die Bibliothek ist sehr einfach zu bedienen und gut dokumentiert, was die Arbeit des Entwicklers erleichtert. Es hilft Entwicklern, mit Leichtigkeit ein hochflexibles System zur Generierung von PDF-Dokumenten zu erstellen.
Die Prawn-Bibliothek umfasst mehrere wichtige Funktionen, die es Softwareentwicklern ermöglichen, ihre PDF-Dokumente einfach zu handhaben, z. B. PDF-Erstellung von Grund auf neu, Einbetten von PNG- und JPG-Bildern, Hinzufügen von Vektorzeichnungen zu PDF, Verwenden integrierter Schriftarten und TrueType-Schriftarten, Verschlüsselungsunterstützung , sicheres PDF-Dokument mit einem Passwort, Textwiedergabeunterstützung, Unterstützung für UTF-8-basierte Schriftarten, Textwiedergabe von rechts nach links, Gliederungsunterstützung und vieles mehr.
Erste Schritte mit Garnelen
Um das Garnelen auf Ihrem System zu installieren, führen Sie bitte den folgenden Befehl aus:
Installieren Sie Prawn über RubyGems
gem install prawn
Erstellen Sie PDF-Dateien über die Ruby-Bibliothek
Die Open-Source-Ruby-Bibliothek Prawn ermöglicht es Softwareentwicklern, mit ein paar Zeilen Ruby-Code programmgesteuert PDF-Dokumente zu erstellen. Die Bibliothek hat 3 verschiedene Möglichkeiten für die Erstellung von PDF-Dokumenten mit Standardeinstellungen und Schriftarten bereitgestellt. Dies sind durch Zuweisung, implizite Blockierung oder explizite Blockierung. Nach der Erstellung können Sie einfach auf jeden Teil Ihres PDF-Dokuments zugreifen und ihn ändern. Sie können ganz einfach eine neue Seite hinzufügen, Seitengröße und Ränder festlegen, Schriftstile ändern, Formatierungen anwenden und vieles mehr.
PDF-Datei über Ruby erstellen und rendern
# Using explicit block form and rendering to a file
content = "Hello World"
Prawn::Document.generate "example.pdf" do |pdf|
# self here is left alone
pdf.font "Times-Roman"
pdf.draw_text content, :at => [200,720], :size => 32
end
Grafiken in PDFs einfügen und bearbeiten
Die Prawn-Bibliothek gibt Softwareentwicklern die Möglichkeit, mithilfe von Ruby-Code Vektorzeichnungen in ihre PDF-Dokumente einzufügen. Entwickler können problemlos Linien, Polygone, Kurven, Kreise usw. an jeder beliebigen Stelle auf einer PDF-Seite zeichnen. Die Bibliothek enthält mehrere wichtige Funktionen für die Arbeit mit Grafiken, z. B. Füllfarben, Anwenden von Strichstilen und Mustern, Festlegen der Linienstärke und Anwenden von Farbe darauf, Verwenden des Mischmodus, Anwenden von Transformation sowie Transparenz und so weiter.
Verwenden von Bildern in PDF-Dokumenten
Die Open-Source-Ruby-Bibliothek Prawn bietet Unterstützung für das Einfügen von Bildern in Ihre PDF-Dateien mithilfe von Ruby-Befehlen. Derzeit enthält die Bibliothek Unterstützung für JPEG- und PNG-Bilder. Es gibt mehrere wichtige Funktionen zum Verwalten Ihrer Bilder in einer PDF-Datei, z. B. Anpassen der Position, Unterstützung der Bildskalierung, separates Einstellen der Bildbreite und -höhe, proportionales Anpassen des Bilds und so weiter.
Generieren Sie Bilder und skalieren Sie sie, um sie in PDF über Ruby einzupassen
Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do
pigs = "#{Prawn::DATADIR}/images/pigs.jpg"
image pigs, :at => [50,450], :width => 450
dice = "#{Prawn::DATADIR}/images/dice.png"
image dice, :at => [50, 450], :scale => 0.75
end
Text auf PDF-Seite zeichnen
Mit der Prawn-Bibliothek können Software-Profis problemlos Text auf einer PDF-Seite in ihrer Ruby-Anwendung zeichnen. Sie können ganz einfach mit dem Zeichnen von Text an einer bestimmten Position einer PDF-Seite beginnen. Sie können die Textposition ganz einfach anpassen, Text nach Ihren Bedürfnissen drehen, die Schriftgröße anwenden, einzelne und mehrere Zeilen unterstützen und vieles mehr.
Zeichnen Sie Text auf einer PDF-Seite über die Ruby-Bibliothek
def draw_text!(text, options)
unless font.unicode? || font.class.hide_m17n_warning || text.ascii_only?
warn "PDF's built-in fonts have very limited support for " \
"internationalized text.\nIf you need full UTF-8 support, " \
"consider using an external font instead.\n\nTo disable this " \
"warning, add the following line to your code:\n" \
"Prawn::Fonts::AFM.hide_m17n_warning = true\n"
font.class.hide_m17n_warning = true
end
x, y = map_to_absolute(options[:at])
add_text_content(text, x, y, options)
end