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
165 lines
4.0 KiB
Groff
165 lines
4.0 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "GLABELS-BATCH-QT" "1" "Jan 01, 2020" "" "gLabels"
|
|
.SH NAME
|
|
glabels-batch-qt \- batch creation of labels and business cards
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.SH SYNOPSIS
|
|
.sp
|
|
\fBglabels\-batch\-qt\fP [\fIoptions\fP] [\fIfilename\fP]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBglabels\-batch\-qt\fP is a utility for printing a glabels project file
|
|
from the command line. It is suitable for use with scripts.
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Displays usage information and exits.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-v, \-\-version
|
|
Displays version information and exits.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-p <printer>, \-\-printer <printer>
|
|
Send output to <printer>.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-o [<filename>], \-\-output [<filename>]
|
|
.TP
|
|
.B Set output filename to <filename>. If filename is "\-", write to standard output.
|
|
.TP
|
|
.B (Default="output.pdf")
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-s <n>, \-\-sheets <n>
|
|
For simple projects, sets number of full sheets to <n>. (Default=1)
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-c <n>, \-\-copies <n>
|
|
Set number of copies to <n>. (Default=1)
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-a, \-\-collate
|
|
Collate merge copies.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-g, \-\-group
|
|
Start each merge group on a new page.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-f <n>, \-\-first <n>
|
|
Set starting position to <n>. (Default=1)
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-l, \-\-outlines
|
|
Print label outlines.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-m, \-\-crop\-marks
|
|
Print crop marks.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-r, \-\-reverse
|
|
Print in reverse (mirror image).
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-D <var>=<value>, \-\-define <var>=<value>
|
|
Set initial value of user variable <var> to <value>.
|
|
.UNINDENT
|
|
.SH FILES
|
|
.INDENT 0.0
|
|
.TP
|
|
.B ${prefix}/share/glabels\-qt/templates/
|
|
Directory containing predefined product templates distributed with glabels.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B ${XDG_CONFIG_HOME}/glabels.org/glabels\-qt/
|
|
Directory containing user defined product templates created with the
|
|
gLabels Product Template Designer. \fBDo not place manually created
|
|
templates here!\fP
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B ${HOME}/.glabels/
|
|
Directory for manually created product templates.
|
|
.UNINDENT
|
|
.SH KNOWN ISSUES
|
|
.sp
|
|
On GNU/Linux platforms, \fBglabels\-batch\-qt\fP 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 \fBglabels\-batch\-qt\fP using a virtual X server environment:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
xvfb\-run glabels\-batch\-qt \-o output.pdf myProject.glabels
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH REPORTING BUGS
|
|
.sp
|
|
On GNU/Linux platforms, \fBglabels\-batch\-qt\fP 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 \fBglabels\-batch\-qt\fP using a virtual X server environment:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
xvfb\-run glabels\-batch\-qt \-o output.pdf myProject.glabels
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH REPORTING BUGS
|
|
.sp
|
|
Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<\fI\%https://github.com/jimevins/glabels\-qt/issues\fP>). You will need a GitHub account to submit new issues or to comment on existing issues.
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fBglabels\-qt(1)\fP
|
|
.sp
|
|
The gLabels homepage at <\fI\%http://glabels.org/\fP>.
|
|
.SH COPYRIGHT
|
|
2020, Jim Evins <evins@snaught.com>
|
|
.\" Generated by docutils manpage writer.
|
|
.
|