Comment convertir HTML en PDF à l'aide de l'API REST dans Ruby

Convertisseur HTML en PDF | Convertir gratuitement en ligne HTML en PDF

En tant que développeur Ruby, vous pouvez convertir vos fichiers HTML en documents PDF par programmation sur le cloud à l’aide de l’API GroupDocs.Conversion Cloud. Le logiciel de conversion HTML en PDF est utile pour lire des articles hors ligne ou partager des fichiers convertis sous une forme portable. Dans cet article, nous allons apprendre à convertir du HTML en PDF à l’aide de l’API REST dans Ruby.

Les sujets suivants doivent être couverts dans ce didacticiel :

API REST de conversion HTML en PDF et installation du SDK Ruby

Pour commencer à convertir HTML en PDF sans perdre la mise en forme, nous utiliserons le SDK Ruby de GroupDocs.Conversion Cloud API en conservant le texte et les mises en page d’origine de votre page Web. Par conséquent, l’impression de vos documents n’entraînera pas une mise en page perplexe. Notre API vous permet de convertir vos documents et images de n’importe quel format de fichier pris en charge vers n’importe quel format dont vous avez besoin. Vous pouvez facilement convertir entre plus de 50 types de documents et d’images tels que Word, PowerPoint, Excel, PDF, HTML, CAO, images raster, etc.

Vous pouvez installer GroupDocs.Conversion html en bibliothèque pdf gratuitement dans votre application Ruby. Utilisez la commande ci-dessous dans la console rails pour convertir le gem de téléchargement gratuit html en pdf :

gem install groupdocs_conversion_cloud

Veuillez obtenir votre ID client et votre secret client à partir du tableau de bord avant de commencer à suivre les étapes et les exemples de code disponibles. Une fois que vous avez votre identifiant et votre secret, veuillez ajouter le code comme indiqué ci-dessous :

# Obtenez votre client_id et client_secret sur https://dashboard.groupdocs.cloud après une inscription gratuite.
# Chargez la gemme dans votre application ruby pour http://api.groupdocs.cloud

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Ajoutez votre nom de stockage ici
@mystorage = "InternalStorage"

Convertir HTML en PDF dans Ruby à l’aide de l’API REST

Vous pouvez convertir votre format HTML en fichier PDF pour afficher et lire hors ligne en suivant les étapes simples mentionnées ci-dessous :

Télécharger le fichier

Tout d’abord, téléchargez le document HTML sur le stockage cloud pour la conversion de plusieurs pages html2pdf en utilisant l’exemple de code ci-dessous :

# Initialisation de l'API pour créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Téléchargez le fichier sur le stockage en nuage

@htmlfile = "#{Rails.root}/public/groupdocs-files/two-pages.html"
@fileStream = File.new(@htmlfile, "r")

@request = GroupDocsConversionCloud::UploadFileRequest.new("html-to-pdf/two-pages.html", @fileStream, @mystorage)
@response = @fileApi.upload_file(@request)

@fileStream.close()

puts("HTML File Uploading completed." + (@response).to_s )

Par conséquent, le fichier HTML téléchargé sera disponible dans la section fichiers de votre tableau de bord sur le cloud.

Convertir HTML en PDF en Ruby

Vous pouvez facilement convertir un document HTML en PDF par programmation en suivant les étapes ci-dessous :

  • Créer une instance de ConvertApi
  • Créer une instance de ConvertSettings
  • Définissez le chemin du fichier HTML et le format du fichier de sortie sur “pdf”
  • Créer une instance de HtmlLoadOptions
  • Définissez la page\numérotation sur true
  • Attribuer des paramètres d’options de chargement
  • Définissez le chemin du fichier de sortie “html-to-pdf”
  • Créer ConvertDocumentRequest avec ConvertSettings
  • Enfin, appelez la méthode convertdocument() avec ConvertDocumentRequest

L’exemple de code suivant montre comment convertir un fichier HTML en document PDF à l’aide de l’API REST.

# Créer les instances d'API nécessaires
@fileApi = GroupDocsConversionCloud::ConvertApi.from_keys(@client_id, @client_secret)

# Préparer les paramètres de conversion
settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "html-to-pdf/two-pages.html"
settings.format = "pdf"

loadOptions = GroupDocsConversionCloud::HtmlLoadOptions.new
loadOptions.page_numbering = true

settings.load_options = loadOptions
settings.output_path = "html-to-pdf"

# Convertir en PDF
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))
puts("HTML file successfully converted to pdf file.")

Télécharger le fichier converti

L’exemple de code ci-dessus enregistrera le fichier au format html2pdf sur le cloud. Vous pouvez le télécharger à l’aide de l’exemple de code suivant :

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Télécharger le fichier PDF Demande
@request = GroupDocsConversionCloud::DownloadFileRequest.new("html-to-pdf/two-pages.pdf", @mystorage)
@response = @fileApi.download_file(@request)

puts("PDF file successfully downloaded." + (@response).to_s )

Conversion HTML en PDF à l’aide des options avancées de Ruby

Vous pouvez également convertir des documents HTML en PDF à l’aide d’options avancées par programmation en suivant les étapes ci-dessous :

  • Créer une instance de ConvertApi
  • Créer une instance de ConvertSettings
  • Définissez le chemin du fichier HTML et le format du fichier de sortie sur “pdf”
  • Créer une instance de HtmlLoadOptions
  • Définissez la page\numérotation sur true
  • Créer une instance de PdfConvertOptions
  • Définissez diverses convertOptions center\window, from\page, margin\top etc.
  • Attribuer des paramètres d’options de chargement and convert options settings
  • Indiquez le chemin du fichier de sortie “html-to-pdf”
  • Créer ConvertDocumentRequest avec ConvertSettings
  • Maintenant, appelez enfin la méthode convertdocument() avec ConvertDocumentRequest

L’exemple de code suivant montre comment convertir un document HTML chrome en document PDF avec des paramètres avancés à l’aide de l’API REST dans Ruby. Veuillez suivre les étapes mentionnées précédemment pour charger et télécharger les fichiers.

#  Créer une instance de l'API de conversion HTML vers PDF
@fileApi = GroupDocsConversionCloud::ConvertApi.from_keys(@client_id, @client_secret)

# Définir les paramètres de conversion pour les options de fichier avancées

settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "html-to-pdf/two-pages.html"
settings.format = "pdf"
 
loadOptions = GroupDocsConversionCloud::HtmlLoadOptions.new
loadOptions.page_numbering = true

convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
convertOptions.center_window = true
convertOptions.compress_images = false
convertOptions.display_doc_title = true
convertOptions.dpi = 1024.0
convertOptions.fit_window = false
convertOptions.from_page = 1
convertOptions.grayscale = false
convertOptions.image_quality = 100
convertOptions.linearize = false
convertOptions.margin_top = 5
convertOptions.margin_left = 5
convertOptions.password = "password"
convertOptions.unembed_fonts = true
convertOptions.remove_unused_streams = true
convertOptions.remove_unused_objects = true
convertOptions.remove_pdfa_compliance = false
 
settings.load_options = loadOptions
settings.convert_options = convertOptions
settings.output_path = "html-to-pdf"

# Convertir HTML en PDF
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

puts("HTML file successfully converted to pdf file with advanced file options.")

Convertisseur HTML en PDF en ligne gratuitement

Comment convertir un fichier HTML en PDF en ligne gratuitement ? Convertissez HTML en PDF en ligne gratuitement et en un clic en utilisant notre meilleur convertisseur html en pdf gratuit. Il s’agit d’un convertisseur chrome html en pdf facile à utiliser en ligne gratuit. Ce convertisseur html en pdf gratuit a été développé à l’aide de l’API de conversion html en pdf ci-dessus. Veuillez essayer le chrome suivant convertisseur de document html en pdf en ligne gratuit.

Conclusion

Dans cet article, nous avons appris à convertir des documents HTML chromés en documents PDF à l’aide de la meilleure bibliothèque Ruby html en pdf sur le cloud. Cet article a également expliqué comment convertir du HTML en PDF avec des images à l’aide des options avancées. De plus, cet article a également expliqué comment télécharger par programme le fichier HTML dans le cloud, puis télécharger le fichier PDF converti à partir du cloud. Vous pouvez en savoir plus sur l’API de conversion de fichiers GroupDocs.Conversion à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et de communiquer avec nos API directement via le navigateur.

poser une question

Si vous avez des questions sur le convertisseur HTML vers PDF gratuit ou sur les API REST GroupDocs.Conversion Cloud, n’hésitez pas à nous les poser sur le Forum.

Voir également