Jim Evins
aebcda43cb
- Modifies printing model to be similar to glabels-3.x. - Allow simple projects to print by-the-page (#51) - Added collated vs uncollated document merges - Added ability to separate merge groups by page - Updated man pages - Updated misc developer documentation
121 lines
3.0 KiB
ReStructuredText
121 lines
3.0 KiB
ReStructuredText
glabels-batch-qt
|
|
================
|
|
|
|
SYNOPSIS
|
|
--------
|
|
|
|
**glabels-batch-qt** [*options*] [*filename*]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
:program:`glabels-batch-qt` is a utility for printing a glabels project file
|
|
from the command line. It is suitable for use with scripts.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
.. program:: glabels-batch-qt
|
|
|
|
.. option:: -h, --help
|
|
|
|
Displays usage information and exits.
|
|
|
|
.. option:: -v, --version
|
|
|
|
Displays version information and exits.
|
|
|
|
.. option:: -p <printer>, --printer <printer>
|
|
|
|
Send output to <printer>.
|
|
|
|
.. option:: -o [<filename>], --output [<filename>]
|
|
Set output filename to <filename>. If filename is "-", write to standard output.
|
|
(Default="output.pdf")
|
|
|
|
.. option:: -s <n>, --sheets <n>
|
|
|
|
For simple projects, sets number of full sheets to <n>. (Default=1)
|
|
|
|
.. option:: -c <n>, --copies <n>
|
|
|
|
Set number of copies to <n>. (Default=1)
|
|
|
|
.. option:: -a, --collate
|
|
|
|
Collate merge copies.
|
|
|
|
.. option:: -g, --group
|
|
|
|
Start each merge group on a new page.
|
|
|
|
.. option:: -f <n>, --first <n>
|
|
|
|
Set starting position to <n>. (Default=1)
|
|
|
|
.. option:: -l, --outlines
|
|
|
|
Print label outlines.
|
|
|
|
.. option:: -m, --crop-marks
|
|
|
|
Print crop marks.
|
|
|
|
.. option:: -r, --reverse
|
|
|
|
Print in reverse (mirror image).
|
|
|
|
.. option:: -D <var>=<value>, --define <var>=<value>
|
|
|
|
Set initial value of user variable <var> to <value>.
|
|
|
|
FILES
|
|
-----
|
|
|
|
.. describe:: ${prefix}/share/glabels-qt/templates/
|
|
|
|
Directory containing predefined product templates distributed with glabels.
|
|
|
|
.. describe:: ${XDG_CONFIG_HOME}/glabels.org/glabels-qt/
|
|
|
|
Directory containing user defined product templates created with the
|
|
gLabels Product Template Designer. **Do not place manually created
|
|
templates here!**
|
|
|
|
.. describe:: ${HOME}/.glabels/
|
|
|
|
Directory for manually created product templates.
|
|
|
|
KNOWN ISSUES
|
|
------------
|
|
|
|
On GNU/Linux platforms, :program:`glabels-batch-qt` must be run from within a windowing environment, such as X or Wayland. This is because Qt requires a suitable platform to obtain system font information. A work-around is to run :program:`glabels-batch-qt` using a virtual X server environment:
|
|
|
|
.. code:: shell
|
|
|
|
xvfb-run glabels-batch-qt -o output.pdf myProject.glabels
|
|
|
|
|
|
REPORTING BUGS
|
|
--------------
|
|
|
|
On GNU/Linux platforms, :program:`glabels-batch-qt` must be run from within a windowing environment, such as X or Wayland. This is because Qt requires a suitable platform to obtain system font information. A work-around is to run :program:`glabels-batch-qt` using a virtual X server environment:
|
|
|
|
.. code:: shell
|
|
|
|
xvfb-run glabels-batch-qt -o output.pdf myProject.glabels
|
|
|
|
|
|
REPORTING BUGS
|
|
--------------
|
|
|
|
Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<https://github.com/jimevins/glabels-qt/issues>). You will need a GitHub account to submit new issues or to comment on existing issues.
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
:manpage:`glabels-qt(1)`
|
|
|
|
The gLabels homepage at <http://glabels.org/>.
|