txn2/txpdf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker Container Pulls

Check out the article Webpage to PDF Microservice for a quick getting started guide.

txPDF is an HTML to PDF microservice by txn2. txPDF is built on top of the n2pdf container exposing an API endpoint that returns a PDF document from web based POST request.

Example Post Body:

{
  "options": {
    "print_media_type": true
  },
  "pages": [
    {
      "Location": "https://www.example.com"
    }
  ]
}

If you want to convert web pages to PDF but do not need a web service you can use the n2pdf container directly as a command line tool.

txPDF is intended as a backend service and should only be accessible by other trusted services. txPDF allows the passing of template directives that can access environment or request data. This is useful and make txPDF highly flexible. However please treat txPDF as a remote code executor and implement it accordingly. See #2 for more on this issue.

Run the txPDF Docker container on your local workstation for testing. Forward port 8080 or any free port to txPDFs default service port 8080 on the container.

docker run --rm -p 8080:8080 -e IP=0.0.0.0 txn2/txpdf:2.0.2
curl -d "@examples/days.json" -X POST http://localhost:8080/getPdf --output test.pdf

txPDF can be configured with the following environment variables:

VariableDefaultPurpose
IP127.0.0.1Bind IP address
PORT8080Server listen port
DEBUGfalseVerbose logging
TOC_XSLPath to XSL transformation script for Table of Contents (example ./toc.xsl. Container holds a default ./toc.xsl
curl -d "@examples/multi-site.json" -X POST http://localhost:8080/getPdf --output test.pdf