Commit bafa0d78 authored by Carsten  Rose's avatar Carsten Rose

Add QFQ_LOG documentation. Enhance wkhtml debug info

parent 9d5751f6
Pipeline #2204 passed with stages
in 3 minutes and 4 seconds
......@@ -115,13 +115,26 @@ Configure via Typo3 Installtool `All configuration > $TYPO3_CONF_VARS['FE']`: ::
alternative to lower the security level, create a separated page subtree which is only accessible (configured via
Typoscript) from specific IPs **or** if a FE-User is logged in.
If there are problems with converting/downloading FE_GROUP protected pages, check `SHOW_DEBUG_INFO = download` to debug.
If there are problems with converting/downloading FE_GROUP protected pages, check configuration_ `showDebugInfo = download` to debug.
.. note::
Converting HTML to PDF gives no error message but RC=-1? Check carefully all includes of CSS, JS, images
and so on! Typically some of them fails to load and wkhtml stops running!
and so on! Typically some of them fails to load and wkhtml stops running! Verify the correct loading of all elements
by calling the site via a regular browser and bypassing any browser cache (Ctrl F5).
Checklist wkhtml problems
"""""""""""""""""""""""""
* `config.baseUrl` is configured and correct. The baseUrl has to be the same protocol as the website (http or https).
* To track down problems:
* In configuration_ set `debug.showDebugInfo=auto,download`.
* Do the download.
* Check QFQ_LOG_ for any output.
* Grab the URL given in the QFQ_LOG_, open a browser in private mode (no existing browser session) and open the URL.
* Check the `--cookie-jar '/tmp/qfq.cookie....'` file for the cookie.
* Call wkhtml manually on the webserver, with the same options as given in the QFQ_LOG_.
HTML to PDF conversion
""""""""""""""""""""""
......@@ -942,13 +955,28 @@ When using different QFQ versions and a shared 'QFQ data'-database, there is som
Debug
=====
SQL Logging
-----------
.. _QFQ_LOG:
QFQ Log
-------
Setup in configuration_
* *qfqLog*
* Filename where to log QFQ debug and error messages.
* File is relative to the `<site path>` or absolute (starting with '/').
* Content: error situations of QFQ and debug, if enabled.
All non SQL related information will be logged to QFQ log file.
.. _SQL_LOG:
SQL Log
-------
Setup in configuration_
* *sqlLog*
* Filename where to log SQL queries and statistical data.
......@@ -993,7 +1021,7 @@ Setup in configuration_
* *download*:
* During a download (especially by using wkhtml), temporary files are not deleted automatically. Also the
``wkhtmltopdf`` and ``pdfunite`` command lines will be logged to `SQL_LOG`_. Use this only to debug problems on download.
``wkhtmltopdf`` and ``pdfunite`` command lines will be logged to `QFQ_LOG`_. Use this only to debug problems on download.
.. _REDIRECT_ALL_MAIL_TO:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment