Render web documents as PDF, PNG, and JPEG files Leave feedback
On this page
GroupDocs.Viewer for Python allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your Java application.
To start using the GroupDocs.Viewer API, create a Viewer class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the Viewer.view method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages.
GroupDocs.Viewer supports the following web file formats:
- Hypertext Markup Language Format (.HTML / .HTM)
- MIME HTML Format (.MHTML)
- MHTML Web Archive (.MHT)
- Compiled HTML Help Format (.CHM)
Create a PdfViewOptions class instance and pass it to the Viewer.view method to convert a web file to PDF. The PdfViewOptions class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: Rendering to PDF.
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions
def render_web_to_pdf():
# Load web document
with Viewer("groupdocs-documentation.mhtml") as viewer:
# Create a PDF file for the document.
# Specify the PDF file name.
viewOptions = PdfViewOptions("render_web_to_pdf/optimized_for_web.pdf")
viewer.view(viewOptions)
if __name__ == "__main__":
render_web_to_pdf()
groupdocs-documentation.mhtml is the sample file used in this example. Click here to download it.
The following image demonstrates the result:
Create a PngViewOptions class instance and pass it to the Viewer.view method to convert a web file to PNG. Use the PngViewOptions.height and PngViewOptions.width methods to specify the output image size in pixels.
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions
def render_web_to_png():
# Load web document
with Viewer("groupdocs-documentation.mhtml") as viewer:
# Convert the web file to PNG.
# {0} is replaced with the page numbers in the output image names.
viewOptions = PngViewOptions("render_web_to_png/optimized_for_web_{0}.pdf")
# Set width and height.
viewOptions.width = 950
viewOptions.height = 800
viewer.view(viewOptions)
if __name__ == "__main__":
render_web_to_png()
groupdocs-documentation.mhtml is the sample file used in this example. Click here to download it.
The following image demonstrates the result:
Create a JpgViewOptions class instance and pass it to the Viewer.view method to convert a web file to JPEG. Use the JpgViewOptions.height and JpgViewOptions.width methods to specify the output image size in pixels.
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions
def render_web_to_jpg():
# Load web document
with Viewer("groupdocs-documentation.mhtml") as viewer:
# Create a JPEG image for each page.
# {0} is replaced with the current page number in the image name.
viewOptions = JpgViewOptions("render_web_to_jpg/web_to_jpg_{0}.jpg")
# Set width and height.
viewOptions.width = 1600
viewOptions.height = 650
viewer.view(viewOptions)
if __name__ == "__main__":
render_web_to_jpg()
groupdocs-documentation.mhtml is the sample file used in this example. Click here to download it.
CHM is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an HtmlViewOptions.for_embedded_resources class instance and pass it to the Viewer.view method. The HtmlViewOptions class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: Rendering to HTML.
To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the HtmlViewOptions.for_embedded_resources method and specify the output file name.
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions
def render_chm_to_html():
# Load CHM file
with Viewer("sample.chm") as viewer:
# Convert the CHM file to HTML.
# {0} is replaced with the page numbers in the output file names.
viewOptions = HtmlViewOptions.for_embedded_resources("render_chm_to_html/chm_result_{0}.html")
# Enable the following option to display all CHM content on a single HTML page.
# viewOptions.render_to_single_page = True
viewer.view(viewOptions)
if __name__ == "__main__":
render_chm_to_html()
sample.chm is the sample file used in this example. Click here to download it.
The following image demonstrates the result:
If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the HtmlViewOptions.for_external_resources method and pass the following parameters:
- The output file path format
- The path format for the folder with external resources
- The resource URL format
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions
def render_chm_to_html_external():
# Load CHM file
with Viewer("sample.chm") as viewer:
# Convert the CHM file to HTML.
# Specify the output file names and location of external resources.
viewOptions = HtmlViewOptions.for_external_resources("render_chm_to_html_external/pdf_page_{0}.html", "render_chm_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_chm_to_html_external/pdf_page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
if __name__ == "__main__":
render_chm_to_html_external()
sample.chm is the sample file used in this example. Click here to download it.
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
