Manual.rst

General

• Project homepage: https://qfq.io
• Latest releases: https://qfq.io/download
• Development: https://git.math.uzh.ch/typo3/qfq
• Chat: https://hello.math.uzh.ch > QFQ

Installation

The following features are only tested / supported on linux hosts:

• General: QFQ is coded to run on Linux hosts, preferable on Debian derivates like Ubuntu.
• HTML to PDF conversion - command wkhtmltopdf.
• Concatenation of PDF files - command pdfunite.
• Mime type detection for uploads - command file.

Preparation

Report & Form

To normalize UTF8 input, php-intl package is needed by

• normalizer::normalize()

For the download function, the programs pdfunite and file are necessary to concatenate PDF files.

Preparation for Ubuntu:

sudo apt install php-intl
sudo apt install poppler-utils libxrender1 file pdf2svg  # for file upload, PDF and 'HTML to PDF' (wkhtmltopdf), PDF split
sudo apt install inkscape imagemagick            # to render thumbnails

wkhtmltopdf

wkhtmltopdf will be used by QFQ to offer 'website print' and 'HTML to PDF' conversion. The program is not included in QFQ and has to be manually installed.

• The Ubuntu package wkhtmltopdf needs a running Xserver - this does not work on a headless webserver.
  • Best is to install the QT version from the named website above.
  • In case of trouble with wkhtmltopdf, also install 'libxrender1'.
  • The current version 0.12.4 might have trouble with https connections. Version 0.12.5-dev (github master branch) seems more reliable. Please contact the QFQ authors if you need a compiled Ubuntu version of wkhtmltopdf.