Subversion Repositories Scribus

Rev

Rev 9672 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
597 cbradney 1
<qt>
2
<title>Compiling and Installing</title>
559 cbradney 3
<h2>Compiling and Installing</h2>
4
<p>In order to compile and install Scribus on your system, type the following
5
in the base directory of the Scribus distribution after uncompressing the
6
downloaded package:</p>
4376 cbradney 7
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
559 cbradney 8
<pre>
9
./configure
10
make
11
make install
12
</pre>
4376 cbradney 13
</td></tr></table></blockquote>
575 cbradney 14
<p>The <code>make install</code> command will have to be done with root access if you have not run the <code>./configure</code> command with a <code>--prefix=[dir]</code> option to specify a different install directory. The following is an example of how to configure and install into your home directory. (For more informaiton than the following line, look at the <a href="parallel-install.html">Parallel Install</a> section for more on having more than one version of Scribus installed at once)</p>
4376 cbradney 15
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
559 cbradney 16
<pre>
9690 cbradney 17
./configure --prefix=/usr;make;make install prefix=~/scribus/svn
559 cbradney 18
</pre>
4376 cbradney 19
</td></tr></table></blockquote>
559 cbradney 20
 
21
<p>If you receive warnings when running <code>./configure</code>, you will need to verify the versions of <code>autoconf</code> and <code>automake</code> by running:</p>
4376 cbradney 22
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
559 cbradney 23
<pre>
24
autoconf --version
25
automake --version
26
</pre>
4376 cbradney 27
</td></tr></table></blockquote>
575 cbradney 28
<p>If they are not at least of the versions mentioned in the <a href=install2.html">Requirements</a> section, you may, depending on your distribution, need to tell it to use a higher version like following:</p>
4376 cbradney 29
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
559 cbradney 30
<pre>
31
export WANT_AUTOCONF=&#034;2.5&#034;
32
export WANT_AUTOMAKE=&#034;1.7&#034;
33
</pre>
4376 cbradney 34
</td></tr></table></blockquote>
559 cbradney 35
<p>Having run those two commands, recheck the versions. If they still do not comply to those required, you will need to upgrade those programs, however most distributions contain a high enough version.</p>
575 cbradney 36
<p>You can launch Scribus from the command line with the following options:</p>
4376 cbradney 37
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
559 cbradney 38
<pre>
575 cbradney 39
scribus --help
559 cbradney 40
</pre>
4376 cbradney 41
</td></tr></table></blockquote>
559 cbradney 42
<p>Output:</p>
4376 cbradney 43
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
6577 mrdocs 44
<pre>scribus -h
45
 
575 cbradney 46
Scribus, Open Source Desktop Publishing
47
---------------------------------------
48
Homepage:       http://www.scribus.net
49
Documentation:  http://docs.scribus.net
6577 mrdocs 50
Wiki:           http://wiki.scribus.net
575 cbradney 51
Issues:         http://bugs.scribus.net
559 cbradney 52
 
53
Usage: scribus [option ... ] [file]
54
Options:
6577 mrdocs 55
   -h, --help             Print help (this message) and exit
56
   -l, --lang             Uses xx as shortcut for a language, eg `en' or `de'
57
  -la, --langs-available  List the currently installed interface languages
58
  -fi, --font-info        Show information on the console when fonts are being loaded
59
  -ns, --no-splash        Do not show the splashscreen on startup
60
  -v, --version          Output version information and exit
61
  -sb, --swap-buttons     Use right to left dialog button ordering (eg. Cancel/No/Yes instead of Yes/No/Cancel)
62
  -pr, --prefs filename   Use filename as path for user given preferences
559 cbradney 63
</pre>
4376 cbradney 64
</td></tr></table></blockquote>
559 cbradney 65
<p>The default location for the Scribus executable is located in <code>/usr/local/bin</code>. Documentation is located in <code>/usr/local/lib/scribus/doc</code></p>
66
<p>In addition, there is a <code>desktop.config</code> file named <code>scribus.desktop</code> which can be used for a menu shortcut or desktop shortcut. Simply copy this from the base directory of the installation source directory to your KDE desktop and this will launch Scribus. After dragging this to the desktop, right click and make sure the execute check box is checked. This file conforms to the latest <a href="http://www.freedesktop.org">www.freedesktop.org</a> specifications.</p>
575 cbradney 67
<p>Since Scribus uses <code>autoconf</code>, as long as you have the correct developement versions of the libraries, you should have little difficulty compiling it. Should you run into problems please report them to the Scribus mailing list or IRC channel. See <a href="resources.html">Community Resources</a> section of this manual.</p>
2797 mrdocs 68
<p>Lastly:</p>
4376 cbradney 69
<blockquote><table width="100%" border="1" bgcolor="#eeeeee"><tr><td border="0">
2797 mrdocs 70
<pre>man scribus</pre>
4376 cbradney 71
</td></tr></table></blockquote>
2797 mrdocs 72
<p> will list addtional info for startup.</p>
73
</qt>