Narzędzia do przechwytywania i konwertowania Internetu

Konwertuj strony internetowe i HTML na PDFRuby API

Podczas konwertowania stron internetowych lub fragmentów HTML bezpośrednio na format PDF GrabzIt's Ruby API zapewnia następujące funkcje, które pomagają integrate GrabzIt into twój system tak łatwo, jak to możliwe. Jednak zanim zaczniesz, pamiętaj, że po wywołaniu set_pdf_options metoda save or save_to należy wykonać metodę, aby wykonać zrzut ekranu PDF.

Podstawowe opcje

Przechwytywanie PDF konwertuje całą stronę internetową into dokument PDF potencjalnie wielu stron. Do konwersji strony internetowej wymagany jest tylko jeden parametr into dokument PDF lub do konwertuj HTML na PDF jak pokazano w poniższych przykładach.

grabzItClient.url_to_pdf("https://www.tesla.com")
# Then call the save or save_to method
grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>")
# Then call the save or save_to method
grabzItClient.file_to_pdf("example.html")
# Then call the save or save_to method

Niestandardowy identyfikator

Możesz przekazać niestandardowy identyfikator do PDF metody pokazane poniżej, ta wartość jest następnie zwracana do twojego programu obsługi GrabzIt Ruby. Na przykład ten niestandardowy identyfikator może być identyfikatorem bazy danych, umożliwiając skojarzenie zrzutu ekranu z określonym rekordem bazy danych.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.url_to_pdf("https://www.tesla.com", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.file_to_pdf("example.html", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")

Nagłówki i stopki

Podczas tworzenia zrzutu ekranu w formacie PDF możesz poprosić o zastosowanie określonego szablon do wygenerowanego pliku PDF. Ten szablon musi być saved z góry i określi zawartość nagłówka i stopki wraz ze specjalnymi zmiennymi. W przykładowym kodzie poniżej użytkownik używa swojego szablonu o nazwie „mój szablon”.

Jeśli nie ma wystarczająco dużego górnego lub dolnego marginesu odpowiednio dla nagłówka lub stopki, nie pojawi się on w pliku PDF. W poniższym przykładzie ustawiliśmy górny i dolny margines na 20, aby zapewnić dużo miejsca.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.url_to_pdf("https://www.tesla.com", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.file_to_pdf("example.html", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")

Konwertuj element HTML na PDF

Jeśli chcesz bezpośrednio przekonwertować element HTML, taki jak div lub span, bezpośrednio into dokument PDF, który możesz za pomocą Ruby Gem GrabzIt. Musisz zdać Selektor CSS elementu HTML, który chcesz przekonwertować na targetElement Metoda.

...
<span id="Article">
<p>This is the content I am interested in.</p>
<img src="myimage.jpg">
</span>
...

W tym przykładzie chcemy uchwycić całą zawartość w zakresie, który ma identyfikator Article, dlatego przekazujemy to do GrabzIt, jak pokazano poniżej.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.targetElement = "#Article"

grabzItClient.url_to_pdf("http://www.bbc.co.uk/news", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")

Sposób przycinania pliku PDF podczas kierowania elementu HTML może być kontrolowane przy użyciu tych technik.