Subversion Repositories Scribus

Rev

Rev 2302 | Rev 8495 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2088 mrdocs 1
.TH scribus "1" "Updated 2005-05-04"
840 cbradney 2
.SH NAME
3
scribus - open source X11-based WYSIWYG desktop publishing app
4
.SH SYNOPSIS
5
scribus [-h|--help] [-v|--version] [-l|--lang language] [-la|--langs-available] [-f|--file|--] [filename]
6
.SH DESCRIPTION
7
Scribus is an open source desktop publishing program. It provides true WYSIWYG editing, excellent PDF export facilities, and a wide range of other input and output options.
8
 
9
Please see the scribus documentation at
10
.I http://docs.scribus.net/
11
or the program's built in help for more comprehensive and up-to-date documentation.
12
 
13
This man page only provides summaries of some aspects of the program's use. It's main purpose is to make sure you can find the full documentation quickly and easily.
14
.SH OPTIONS
15
The definitive options are in the program's usage statement. Run:
16
.B scribus --help
17
to view the usage statement.
18
 
19
.TP
20
.B -l, --lang xx
21
Overrides the system locale and runs Scribus in language xx. The language is specified with the same POSIX language codes that are used in the LANG and LC_ALL environment variables. For example, English can be selected with 'en' (generic English), 'en_GB' (British English), 'en_US' (American english), etc. Similarly, Deutsch can be selected with 'de' or 'de_DE'.
22
.TP
23
.B -la, --langs-available
24
Print a list of languages for which user interface translations are available. To use that language run Scribus as 'scribus -l xx' where xx is the short language code, or set the locale environment variables as described below.
25
.TP
26
.B -v, --version
27
Prints the Scribus version number and exits.
28
.TP
29
.B -f, --file
30
Open the specified file. It's possible to simply pass the file name as an unqualified argument instead of using this, though if the name begins with a - you will need to use --, eg 'scribus -- -myfile.sla'.
31
.TP
32
.B -h, --help
33
Print a brief usage summary.
2302 mrdocs 34
.TP
35
.B -fi, --font-info
36
Shows the font file listing as Scribus starts. This can be used for diagnosing missing glyphs within fonts or possible broken font files.
2963 craig 37
.TP
38
.B -ns, --no-splash
39
Suppresses display of the splash screen during SCribus start-up.
840 cbradney 40
.SH ENVIRONMENT
41
Scribus respects the standard locale environment variables. Others may be used through underlying libraries, such as Qt, or by programs used by Scribus.
42
.I http://docs.scribus.net/
43
and the in-program documentation may note other environment variables used by Scribus or the programs and libraries it uses.
44
.TP
45
.B LC_ALL, LC_MESSAGES, LANG
46
POSIX locale. See
47
.I locale(1).
48
Scribus uses these three environment variables, in the listed order of precedence, to select the language (including the user interface translation) to use. If none are set, it will fall back on the locale set by the underlying Qt library.
49
.TP
50
.B PATH
51
Scribus may search the PATH for external tools if their paths are not specified absolutely. This is currently most likely to affect you if you have multiple copies of gs(1) installed. You can set an absolute path to the correct gs(1) in your Scribus preferences and bypass the
52
.B PATH
53
search.
54
.PP
55
A few important environment variables from other programs are summarised here for convenience, though you should check the original program's documentation if you are having trouble.
56
.TP
57
.B GS_FONTPATH
58
GhostScript font path. Affects the font search path for GhostScript, a component Scribus uses for some PostScript operations. Add new directories containing fonts to this colon-separated list to help GhostScript find fonts in non-standard locations. See gs(1) and the GhostScript HTML documentation for more information.
59
.TP
60
.B GS_LIB
61
GhostScript library path. GhostScript searches this path for Fontmap files. Like
62
.B GS_FONTPATH
63
it's a colon separated list of directories. You will usually want to use
64
.B GS_FONTPATH
65
instead, though building a Fontmap file and using
66
.B GS_LIB
67
can speed things up if you have a
68
.I lot
69
of fonts. See gs(1) and the GhostScript HTML documentation for more information.
70
.SH FILES
71
.TP
72
.B $HOME/.scribus/
2088 mrdocs 73
User preferences are stored in $HOME/.scribus/ . Most other paths are configurable from the Scribus preferences. Scribus 1.3 preferences are separate from Scribus 1.2.x
74
.B $HOME/.scribus/scribus13.rc
840 cbradney 75
Scribus preferences file - formatted in a custom xml schema. May eventually be retired in favour of new format prefs file.
2088 mrdocs 76
.B $HOME/.scribus/prefs13.xml
77
Scribus 1.3 preferences are separate from Scribus 1.2.x
840 cbradney 78
.TP
1940 craig 79
.B $HOME/.fonts/
840 cbradney 80
.TP
1940 craig 81
.B $HOME/.fonts.conf
82
.TP
840 cbradney 83
.B /etc/fonts
1940 craig 84
Fontconfig, the library used by Scribus to locate fonts, is normally configured with files in /etc/fonts, mainly /etc/fonts/fonts.conf and /etc/fonts/local.conf . It may also use a config file $HOME/.fonts.conf and fonts in $HOME/.fonts/ . See fonts.conf(5) and the fontconfig documentation for more information. Note that Scribus may also use its internal font path to locate more fonts - see the Preferences dialog and scribus help.
840 cbradney 85
.SH SEE ALSO
86
The scribus documentation site http://docs.scribus.net/ and home page http://www.scribus.net/
87
 
88
gs(1), the gs html docs, and http://www.ghostscript.com/
89
 
90
.PP
91
The Qt library - http://www.trolltech.com/
92
 
93
fonts-conf(5) for info on configuring FontConfig
94
.SH RELATED SOFTWARE AND AFFILIATES
95
 
96
inkscape(1) - http://inkscape.org/
97
 
98
OpenClipArt - http://openclipart.org/
99
 
100
Other affiliates may be listed in the footer on http://www.scribus.net/
101
 
102
 
103
.SH BUGS
104
See
105
.I
106
http://bugs.scribus.net/
107
for the Scribus on-line status tracker, which is used to track bug reports and feature requests.
108
.B If you intend to submit a bug report or feature request, please search the bug database first.
109
.SH AUTHORS
110
Please see the About Scribus option in the Help menu for a list of authors, translators, and contributors.