vendor/knplabs/knp-snappy/doc/faq.md

   1 # Frequently asked questions
   2
   3 ###### *Q*: It does not work and everything is broken.
   4
   5 *A*: Please, try to execute the command manually in your shell. Snappy is a thin PHP wrapper and most likely your issue is with wkhtmltopdf itself or is already described in this FAQ. If not, feel free to open the issue in Snappy issue tracker.
   6
   7 How to get the command to execute -
   8
   9 ```php
  10 var_dump($snappy->getCommand('http://google.com', 'test.pdf'), array('some' => 'option'));
  11 ```
  12
  13 Please, note that wkhtmltopdf takes only input url or file name as a source.
  14
  15
  16 ###### *Q*: My tables are broken when it is rendered on multiple pages with break.
  17
  18 *A*: Add ```thead``` and ```tbody``` tags. Add the following css
  19 ```css
  20 table, tr, td, th, tbody, thead, tfoot {
  21     page-break-inside: avoid !important;
  22 }
  23 ```
  24
  25
  26 ###### *Q*: I have a PNG with a transparent background. When generating a PDF, the background turns black.
  27
  28 *A*: It is wkhtmltopdf bug as described in https://github.com/wkhtmltopdf/wkhtmltopdf/issues/2214. You should update wkhtmltopdf to at least 0.12.3-dev
  29
  30
  31 ###### *Q*: Is there a way to secure the pdf so it can't be edited?
  32
  33 *A*:  There is no way to add a password via wkhtmltopdf, but there is a way via other linux tools like pdftk
  34
  35
  36 ###### *Q*: We are using wkhtmltopdf to export html to pdf. It breaks the HTML in two pages of pdf. Can we add a break?
  37
  38 *A*: It is known problem of `wkhtmltopdf`. You can use css `page-break-after`, like:
  39 ```html
  40 <style type="text/css">
  41     .page {
  42         overflow: hidden;
  43         page-break-after: always;
  44     }
  45 </style>
  46
  47 <div class="page">
  48    new page
  49 </div>
  50 ```
  51
  52
  53 ###### *Q*: It says `wkhtmltopdf: cannot connect to X server` or `xvfb-run: error: Xvfb failed to start.`
  54
  55 *A*: Please, check your `wkhtmltopdf` version. It is recommended to use at least `0.12.2.1` and what is important - starting from `wkhtmltopdf >= 0.12.2` it doesn't require X server or emulation anymore. You can download new version from http://wkhtmltopdf.org/downloads.html or install via composer for Linux servers as stated in [README](https://github.com/KnpLabs/snappy#wkhtmltopdf-binary-as-composer-dependencies). If there is no possibility to update `wkhtmltopdf`, please check http://stackoverflow.com/questions/9604625/wkhtmltopdf-cannot-connect-to-x-server
  56
  57
  58 ###### *Q*: My PDF is always generated for a small screen resolution\I always receive a mobile version.
  59
  60 *A*: It is well-known issue of wkhtmltopdf, you can check https://github.com/wkhtmltopdf/wkhtmltopdf/issues/1508. One of solutions is to use xvbf and to setup xvbf resolution to desired one though a simple bit of css such as `zoom: .75;` would be sufficient in most cases.
  61
  62 ###### *Q*: My chars with accents in HTML document are not correctly rendered.
  63
  64 *A*: Make sure that you have set `<meta charset="UTF-8" />`
  65
  66 ###### *Q*: My document text is not correctly rendered, it is just black squares
  67
  68 *A*: Make sure you have installed `xfonts-base`, `xfonts-75dpi` and `urw-fonts`