Merge branch 'wkhtml' into 'master'

discourage wkhtmltopdf

See merge request !72

docs/general/requirements.md

@@ -25,12 +25,6 @@ If your server meets all of the requirements described on this page, CiviCRM *sh
 
 In general, CiviCRM is a demanding web application which requires substantial server resources. It may not perform well on all hosting platforms. Learn more about [choosing your hosting platform](../planning/hosting.md).
 
-### Optional Libraries
-
-Some people report better performance in some circumstances when rendering PDF files (e.g. reports or invoices). CiviCRM has a configuration option to use a system binary for WKHTMLtoPDF. [https://wkhtmltopdf.org/](https://wkhtmltopdf.org/) You can find this setting under "System Settings" > "Misc".
-
-Another reason to use it is that is solves [the issue](unicode_pdf.md) of how to handle unicode fonts needed for some languages.
-
 ## CMS {:#cms}
 
 A CMS, or Content Management System, is a type of application which controls and manages the content of a website. CiviCRM must be installed within one of these compatible CMS platforms.

docs/general/unicode_pdf.md

@@ -6,7 +6,7 @@ In Drupal 9, the entire DOMPDF library is downloaded during install, so it will
 
 Note when testing to see if you've succeeded, use letters that are entirely outside the character set included in the basic font files, e.g. use cyrillic letters such as `д`. Several letters like `ü` will work either way so aren't a good test.
 
-??? example "Option A: Install the unicode font files for DOMPDF"
+??? example "Install the unicode font files for DOMPDF"
 
     Note - except for CJK character support below these steps are done for you if you install [dompdf-fonts](https://github.com/eileenmcnaughton/dompdf-fonts)
 
@@ -49,14 +49,3 @@ Note when testing to see if you've succeeded, use letters that are entirely outs
     1. Note this will overwrite the `dompdf_font_family_cache.php` file you created earlier for DejaVu, so to also have DejaVu you will now need to edit the file and copy the php array from earlier back in.
     1. Now you no longer need the `load_font` utility or its folder and can delete it.
     1. Unlike with DejaVu which CiviCRM sets as the default font, you will need to specify the font when composing the PDF in the places where you use the CJK characters. You can use the Source button in CKEditor to do this and type it directly into the HTML: e.g. `<p style="font-family: simsun;">的</p>`
-
-??? example "Option B: Install wkhtmltopdf instead"
-
-    This may also have an advantage for reports that cause DOMPDF to run out of memory. A possible disadvantage is the output may not be exactly the same or as well tested with CiviCRM as DOMPDF since it is not the default. You only need to do this once.
-
-    1. Your operating system's package manager may already make it available to install. If not then go to https://wkhtmltopdf.org and download the file for your operating system.
-    1. Note the full path to the executable binary.
-    1. In CiviCRM go to Administer - System Settings - Misc.
-    1. A couple lines down there is a setting `Path to wkhtmltopdf executable`.
-    1. Fill it in, e.g. `/usr/local/bin/wkhtmltopdf`
-    1. Click the Save button.