![](https://products-qa.fileformat.com/fr/pdf/ruby/prawn/header-image.png)
Prawn
Génération rapide de PDF via la bibliothèque Ruby Open Source
API Ruby PDF gratuite qui permet aux programmeurs de créer et de modifier des fichiers PDF ; insérez, modifiez des graphiques et dessinez du texte sur une page PDF dans Ruby Apps.
Le format de document portable (PDF) est un format de fichier fiable et sécurisé très populaire pour la présentation, le partage et l'impression de fichiers à travers le monde. La bibliothèque Ruby open source Prawn a fourni des fonctionnalités complètes pour travailler avec des documents PDF à l'aide de la bibliothèque Ruby. La bibliothèque est très facile à utiliser et bien documentée, ce qui facilite le travail du développeur. Il aide les développeurs à créer facilement un système de génération de documents PDF hautement flexible.
La bibliothèque Prawn comprend plusieurs fonctionnalités importantes qui permettent aux développeurs de logiciels de gérer facilement leurs documents PDF, telles que la création de PDF à partir de zéro, l'incorporation d'images PNG et JPG, l'ajout de dessins vectoriels au PDF, l'utilisation de polices intégrées et de polices TrueType, la prise en charge du cryptage. , document PDF sécurisé à l'aide d'un mot de passe, prise en charge du rendu du texte, prise en charge des polices basées sur UTF-8, rendu du texte de droite à gauche, prise en charge des contours et bien d'autres.
Premiers pas avec la crevette
Pour installer le Prawn sur votre système, veuillez exécuter la commande suivante,
Installer Prawn via RubyGems
gem install prawn
Créer des fichiers PDF via la bibliothèque Ruby
La bibliothèque Open source Ruby Prawn permet aux développeurs de logiciels de créer par programme des documents PDF en utilisant quelques lignes de code Ruby. La bibliothèque propose 3 méthodes différentes pour la création de documents PDF avec des paramètres et des polices par défaut. Celles-ci se font par affectation, bloc implicite ou bloc explicite. Une fois créé, vous pouvez facilement accéder et modifier chaque partie de votre document PDF. Vous pouvez facilement ajouter une nouvelle page, définir la taille de la page et les marges, modifier les styles de police, appliquer la mise en forme et bien plus encore.
Créer et rendre un fichier PDF via Ruby
# 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
Insérer et modifier un graphique dans des PDF
La bibliothèque Prawn donne aux développeurs de logiciels le pouvoir d'ajouter des dessins vectoriels dans leurs documents PDF à l'aide de code Ruby. Les développeurs peuvent facilement dessiner des lignes, des polygones, des courbes, des cercles, etc. à n'importe quel endroit de leur choix dans une page PDF. La bibliothèque a inclus plusieurs fonctions importantes pour travailler avec des graphiques tels que les couleurs de remplissage, appliquer des styles et des motifs de tirets, définir l'épaisseur de la ligne et lui appliquer une couleur, utiliser le mode fusionné, appliquer la transformation ainsi que la transparence, etc.
Utilisation d'images dans des documents PDF
La bibliothèque Ruby open source Prawn a fourni un support pour l'insertion d'images dans vos fichiers PDF à l'aide de commandes Ruby. Actuellement, la bibliothèque inclut la prise en charge des images JPEG et PNG. Plusieurs fonctionnalités importantes sont fournies pour gérer vos images dans un fichier PDF, telles que l'ajustement de la position, la prise en charge de la mise à l'échelle de l'image, le réglage séparé de la largeur et de la hauteur de l'image, l'ajustement proportionnel de l'image, etc.
Générer une image et une échelle pour s'adapter au PDF via Ruby
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
Dessiner du texte sur une page PDF
La bibliothèque Prawn permet aux professionnels du logiciel de dessiner facilement du texte sur une page PDF dans leur application Ruby. Vous pouvez facilement commencer à dessiner du texte sur une position spécifiée d'une page PDF. Vous pouvez facilement ajuster la position du texte, faire pivoter le texte en fonction de vos besoins, appliquer la taille de la police, la prise en charge d'une ligne et de plusieurs lignes, et bien plus encore.
Dessiner du texte sur une page PDF via la bibliothèque Ruby
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