Difference between revisions of "Getting Scribus on Ubuntu/Kubuntu up and running"

From Scribus Wiki
Jump to navigation Jump to search
(wikification of markup)
Line 1: Line 1:
{{HOWTO Index}}
+
'''Scribus on Debian GNU/Linux and derivatives'''
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
 
<html xmlns="http://www.w3.org/1999/xhtml">
+
The main page is now located at http://debian.scribus.net. This page must be kept as strict xhtml 1.0 and any modifications should be followed by a notification to malex@tagncha.org, so the main page could be updated.
<head>
+
 
  <meta
+
"Debian" name here encompasses Debian proper (unstable/testing/stable also known as sid/etch/sarge) and at least Ubuntu breezy/hoary. Instructions on rebuilding the source package may be applicable to other Debian derivatives and custom distributions.
content="text/html; charset=ISO-8859-1"
+
 
http-equiv="content-type" />
+
== Preamble ==
  <title>Scribus on Debian GNU
+
Currently there are following Scribus-related packages in Debian: [http://packages.qa.debian.org/s/scribus.html Scribus] (Scribus 1.2.x), [http://packages.qa.debian.org/s/scribus-template.html scribus-template] (Developer and
Linux</title>
+
user-contributed additional templates), [http://packages.qa.debian.org/s/scribus-doc.html scribus-doc] (Scribus documentation, which has to be provided as a separate package due to is non-free nature by the Debian Free
</head>
+
Software Guidelines), [http://packages.qa.debian.org/i/icc-profiles.html icc-profiles] (A collection of common ICC profiles to use with Scribus and other color profile-aware software), and [http://packages.qa.debian.org/l/lprof.html LPROF] (Hardware color profiler that can be used to create color profiles for your hardware to be used with Scribus).  
<body>
+
 
<h1>Scribus
+
Scribus team also maintains an unofficial (outside of Debian proper) repository that contains some of the packages
on Debian GNU/Linux
+
mentioned above with the most notable difference being a scribus-cvs package (Scribus 1.3.x developmental series). scribus-cvs package can be installed in parallel with the scribus package. There are a couple reasons for the existence of this upstream repository.
and derivatives.</h1>
+
 
<strong>The main page is now located at http://debian.scribus.net. This page must be kept as strict xhtml 1.0 and any modifications should be followed by a notification to malex@tagncha.org, so the main page could be updated.
+
First, Debian development puts a limit on how often a new scribus package can be updated. It could take weeks between consecutive uploads. Because of that the official packages are usually behind those available in our upstream archives. Packages in our upstream repositories usually follow scribus development fairly closely via cvs snapshot builds. For instance, if you discovered a but you are advised to install the most
<p>
+
recent package as the bug might have already been fixed and a fixed package is available. This is called "the Scribus magic (TM)".
"Debian" name here
+
 
encompasses Debian proper (unstable/testing/stable also known as
+
Second, Debian has strict Quality Assurance for packages with its requirements embodied in the extensive and thorough [http://www.debian.org/doc/debian-policy/ Debian Policy]. As Scribus libraries may not yet be
sid/etch/sarge) and at least Ubuntu breezy/hoary. Instructions on
+
installed in arbitrary locations due to code limitations scribus-cvs package has it libraries in the /usr/local/lib
rebuilding the source package may be applicable to other Debian
+
hierarchy. This is a violation of DP and as such 1.3.x series scribus-cvs has to be confined to our upstream repository until it is ready to replace the venerable Scribus 1.2.x series.  
derivatives and custom distributions.</strong>
+
 
<h2>Preamble</h2>
+
== Debian setup for Scribus repositories ==
Currently there are following Scribus-related packages in Debian: <a
+
 
href="http://packages.qa.debian.org/s/scribus.html">scribus</a>
+
=== About the repositories ===
(Scribus 1.2.x), <a
+
 
href="http://packages.qa.debian.org/s/scribus-template.html">scribus-template</a>
+
We actually maintain two identical repositories to provide bandwidth redundancy and failover capability to our
(Developer and
+
distribution of Debian scribus packages. These repositories contain x86 packages for Debian stable,testing and unstable and Ubuntu hoary and breezy branches. If you are using a different Debian-based distribution or your hardware is not x86-based such as PowerPC or AMD64 you can easily build a Scribus package from our source package, so do not consider it as a strong obstacle to using these packages.
user-contributed additional templates), <a
+
 
href="http://packages.qa.debian.org/s/scribus-doc.html">scribus-doc</a>
+
=== Repository usage ===
(Scribus documentation, which has to be
+
 
provided as a separate package due to is non-free nature by the Debian
+
To use our repositories add the appropriate source lines from the following list to your /etc/apt/sources.list file. Note that the lines starting with "deb" are used for installation of the pre-compiled binary packages and the line starting with "deb-src" are for the source package for building a binary package for your distribution (if it has a different set of libraries), hardware (if it's not x86) or compiler optimizations (if you really know you want them).
Free
+
 
Software Guidelines), <a
+
=== Source lines for /etc/apt/sources.list or for Synaptic et al ===
href="http://packages.qa.debian.org/i/icc-profiles.html">icc-profiles</a>
+
 
(A collection of common ICC profiles to use with Scribus and other
+
==== Debian stable (Sarge): ====
color profile-aware software), and <a
+
 
href="http://packages.qa.debian.org/l/lprof.html">lprof</a>
+
<pre># debian.scribus.net - Primary repository
(Hardware color profiler that
+
deb http://debian.scribus.net/debian/ stable main non-free contrib
can be used to create color profiles for your hardware to be used with
+
deb-src http://debian.scribus.net/debian/ stable main non-free contrib
Scribus). Scribus team also
+
# debian.tagancha.org - Backup repository
maintains an unofficial (outside of Debian proper) repository that
+
deb http://debian.tagancha.org/debian/ stable main non-free contrib
contains some of the packages
+
deb-src http://debian.tagancha.org/debian/ stable main non-free contrib</pre>
mentioned above with the most notable difference being a scribus-cvs
+
 
package (Scribus 1.3.x developmental
+
==== Debian testing (Etch): ====
series). scribus-cvs package can be installed in parallel with the
+
<pre># debian.scribus.net - Primary repository<
scribus package. There are a couple reasons
+
deb http://debian.scribus.net/debian/ testing main non-free contrib
for the existence of this upstream repository. First, Debian
+
deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
development puts a limit on how often a new scribus package can be
+
# debian.tagancha.org - Backup repository
updated. It could take weeks between consecutive uploads. Because of
+
deb http://debian.tagancha.org/debian/ testing main non-free contrib
that the official packages are usually behind those available in our
+
deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib</pre>
upstream archives. Packages in our upstream repositories usually
+
 
follow scribus development fairly closely via cvs snapshot builds. For
+
==== Debian unstable (Sid): ====
instance, if you discovered a but you are advised to install the most
+
<pre># debian.scribus.net - Primary repository
recent package as the bug might have already been fixed and a fixed
+
deb http://debian.scribus.net/debian/ unstable main non-free contrib
package is available. This is called "the Scribus magic (TM)". Second,
+
deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
Debian has strict Quality Assurance for
+
# debian.tagancha.org - Backup repository
packages with its requirements embodied in the extensive and thorough <a
+
deb http://debian.tagancha.org/debian/ unstable main non-free contrib
href="http://www.debian.org/doc/debian-policy/">Debian
+
deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib</pre>
Policy</a>. As Scribus libraries may
+
 
not yet be
+
==== Ubuntu Hoary:====
installed in arbitrary locations due to code limitations scribus-cvs
+
<pre># debian.scribus.net - Primary repository
package has it libraries in the /usr/local/lib
+
deb http://debian.scribus.net/debian/ hoary main restricted
hierarchy. This is a violation of DP and as such 1.3.x series
+
deb-src http://debian.scribus.net/debian/ hoary main restricted
scribus-cvs has to be confined to our upstream repository until
+
# debian.tagancha.org - Backup repository
it is ready to replace the venerable Scribus 1.2.x series.
+
deb http://debian.tagancha.org/debian/ hoary main restricted
<h2>Debian setup for Scribus
+
deb-src http://debian.tagancha.org/debian/ hoary main restricted</pre>
repositories.</h2>
+
 
<h3>About the repositories.</h3>
+
==== Ubuntu Breezy: ====
We actually maintain two identical repositories to provide bandwidth
+
 
redundancy and failover capability to our
+
Note that Ubuntu breezy package can be also used for Ubuntu "Dapper" branch right now. When Dapper
distribution of Debian scribus packages. These repositories contain x86
+
changes enough to require its own scribus or scribus-cvs package we will provide it.
packages for Debian
+
 
stable,testing and unstable and Ubuntu hoary and breezy branches. If
+
<pre># debian.scribus.net - Primary repository
you are using a different Debian-based distribution or your hardware is
+
deb http://debian.scribus.net/debian breezy main restricted
not x86-based such as PowerPC or AMD64 you can easily build a Scribus
+
deb-src http://debian.scribus.net/debian breezy main restricted
package from our source package, so do not consider it as a strong
+
# debian.tagancha.org - Backup repository
obstacle to using these packages.
+
deb http://debian.tagancha.org/debian breezy main restricted
<h3>Repository usage.</h3>
+
deb-src http://debian.tagancha.org/debian breezy main restricted</pre>
To use our repositories add the appropriate
+
 
source lines from the following list to your
+
=== Using cryptographic repository signatures: ===
/etc/apt/sources.list file. Note that the lines starting with "deb" are
+
 
used for installation of the pre-compiled binary packages and the line
+
Our repositories are cryptographically signed for added security. Add the gpg-keys for our repositories to avoid having to confirm your installation choice to the package manager each time you update a scribus or scribus-cvs package.
starting with
+
 
"deb-src" are for the source package for building a binary
+
<pre>root$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
package for your distribution (if it has a different set of libraries),
+
root$ gpg --armor --export DA286F326C5F196B | apt-key add - </pre>
hardware (if it's not x86) or compiler optimizations (if you really
+
 
know you want them).&nbsp;
+
or as a normal user (with an appropriate entry for apt-key in the sudoers file):
<h3>Source lines for
+
 
/etc/apt/sources.list or for Synaptic et al.</h3>
+
<pre>user$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
<h4>Debian stable (Sarge):</h4>
+
user$ gpg --armor --export DA286F326C5F196B | sudo apt-key add - </pre>
<pre># debian.scribus.net - Primary repository<br />deb http://debian.scribus.net/debian/ stable main non-free contrib<br />deb-src http://debian.scribus.net/debian/ stable main non-free contrib<br /># debian.tagancha.org - Backup repository<br />deb http://debian.tagancha.org/debian/ stable main non-free contrib<br />deb-src http://debian.tagancha.org/debian/ stable main non-free contrib<br /></pre>
+
 
<h4>Debian testing (Etch):</h4>
+
=== Final installation step ===
<pre># debian.scribus.net - Primary repository<br />deb http://debian.scribus.net/debian/ testing main non-free contrib<br />deb-src http://debian.scribus.net/debian/ unstable main non-free contrib<br /># debian.tagancha.org - Backup repository<br />deb http://debian.tagancha.org/debian/ testing main non-free contrib<br />deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib<br /></pre>
+
Once you added the relevant sources lines to your /etc/apt/sources.list you can run
<h4>Debian unstable (Sid):</h4>
+
 
<pre># debian.scribus.net - Primary repository<br />deb http://debian.scribus.net/debian/ unstable main non-free contrib<br />deb-src http://debian.scribus.net/debian/ unstable main non-free contrib<br /># debian.tagancha.org - Backup repository<br />deb http://debian.tagancha.org/debian/ unstable main non-free contrib<br />deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib<br /></pre>
+
<pre>aptitude install scribus scribus-cvs</pre>
<h4>Ubuntu hoary:</h4>
+
 
<pre># debian.scribus.net - Primary repository<br />deb http://debian.scribus.net/debian/ hoary main restricted<br />deb-src http://debian.scribus.net/debian/ hoary main restricted<br /># debian.tagancha.org - Backup repository<br />deb http://debian.tagancha.org/debian/ hoary main restricted<br />deb-src http://debian.tagancha.org/debian/ hoary main restricted<br /></pre>
 
<h4>Ubuntu breezy:</h4>
 
<div>Note that Ubuntu breezy
 
package can be also used for Ubuntu "Dapper" branch right now. When
 
Dapper
 
changes enough to require its own scribus or scribus-cvs package we
 
will
 
provide it.</div>
 
<pre># debian.scribus.net - Primary repository<br />deb http://debian.scribus.net/debian breezy main restricted<br />deb-src http://debian.scribus.net/debian breezy main restricted<br /># debian.tagancha.org - Backup repository<br />deb http://debian.tagancha.org/debian breezy main restricted<br />deb-src http://debian.tagancha.org/debian breezy main restricted<br /></pre>
 
<h3>Using cryptographic repository
 
signatures:</h3>
 
Our repositories are cryptographically signed for added security. Add
 
the gpg-keys for our repositories to avoid having to confirm your
 
installation choice to the package manager each time you update a
 
scribus or scribus-cvs package.
 
<pre>root$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B<br />root$ gpg --armor --export DA286F326C5F196B | apt-key add - </pre>
 
or as a normal user (with an appropriate entry for apt-key in the
 
sudoers file):
 
<pre>user$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B<br />user$ gpg --armor --export DA286F326C5F196B | sudo apt-key add - </pre>
 
<h3>Final installation step</h3>
 
Once you added the relevant sources lines to your /etc/apt/sources.list
 
you can run
 
<pre>aptitude install scribus scribus-cvs<br /></pre>
 
 
or
 
or
<pre>apt-get install scribus scribus-cvs<br /></pre>
+
 
in a root terminal or use your favorite graphical apt-get front-end
+
<pre>apt-get install scribus scribus-cvs</pre>
such as synaptic or aptitude. Don't forget to "Reload Package List" in
+
 
the synaptic. It's the equivalent of "apt-get (or aptitude) update" and
+
in a root terminal or use your favorite graphical apt-get front-end such as synaptic or aptitude. Don't forget to "Reload Package List" in the synaptic. It's the equivalent of "apt-get (or aptitude) update" and has to be done to make new packages from our repositories available to your package management tools.
has to be done to make new packages from our repositories available to
+
 
your package management tools.<br />
+
=== Bug reporting ===
<br />
+
 
<h3>Bug reporting</h3>
+
Please DO NOT file bug reports about the packages from these upstream repositories into the Debian or Ubuntu BTS (Bug Tracking Systems). Only use the distribution BTS for the package version that is in that distribution. If you have a Scribus issue that is not related to Debian packaging then use the scribus BTS at http://bugs.scribus.net for reporting bugs.
Please DO NOT file bug reports about the packages from these upstream
+
 
repositories into the Debian or
+
You are encouraged to contact the maintainer Oleksandr (Alex) Moskalenko ([mailto:malextagancha.org]), if you have package installation questions or related Scribus issues that you believe do not belong in Scribus BTS or for comments and suggestions about this document.
Ubuntu BTS (Bug Tracking Systems). Only use the distribution BTS for
+
 
the package version that
+
=== Step-by-step procedure for new Debian GNU/Linux users ===
is in that distribution. If you have a Scribus issue that is not
+
 
related to Debian packaging then use the scribus BTS at
+
You don't have to log on as root, but you have to have superuser privileges to edit the /etc/apt/sources.list file. Fortunately, on a Linux system you can do that with ease. Please open a root terminal or open a regular terminal and
http://bugs.scribus.net for reporting bugs. You are encouraged to
+
become root through a "su" command. You will have to provide root password when prompted. Then, you can launch your favorite text editor from that terminal and edit the sources.list file as outlined in the [[Scribus on Debian GNU/Linux]] page. Alternatively, you can do a bit more work upfront to achieve a more permanent access to package manipulation system. If you are familiar with the VI editor you can do the following:
contact the maintainer <a
 
href="mailto:malextagancha.org">Oleksandr (Alex)
 
Moskalenko</a> if you have package
 
installation questions or related Scribus issues that
 
you believe do not belong in Scribus BTS or for comments and
 
suggestions about this document.
 
<h3>Step-by-step procedure for new
 
Debian GNU/Linux users.</h3>
 
You don't have to log on as root, but you have to have superuser
 
privileges to
 
edit the /etc/apt/sources.list file. Fortunately, on a Linux system you
 
can do
 
that with ease. Please open a root terminal or open a regular terminal
 
and
 
become root through a "su" command. You will have to provide root
 
password
 
when prompted. Then, you can launch your favorite text editor from that
 
terminal and edit the sources.list file as outlined in the
 
http://wiki.scribus.net/index.php/Scribus_on_Debian_GNU/Linux page.
 
Alternatively, you can do a bit more work upfront to achieve a more
 
permanent
 
access to package manipulation system. If you are familiar with the VI
 
editor
 
you can do the following:
 
 
<ul>
 
<ul>
 
   <li>Open a root terminal.</li>
 
   <li>Open a root terminal.</li>
Line 171: Line 124:
 
editor.</li>
 
editor.</li>
 
</ul>
 
</ul>
Now you are ready to launch the very nice graphical apt-get front-end
+
Now you are ready to launch the very nice graphical apt-get front-end Synaptic with a "sudo synaptic" command at any time. If you are a new Linux user, Synaptic will help you get started easier than you probably would with command line tools. Once you launch Synaptic select the "Settings/Repositories" menu entry. Click on the "New" button and type or paste in the appropriate source lines. For example for "Debian Sarge":
Synaptic with a "sudo synaptic" command at any time. If you are a new
+
 
Linux
+
<pre>URI: http://debian.scribus.net/debian/
user, Synaptic will help you get started easier than you probably would
+
Distribution: stable
with
+
Section(s): main non-free contrib</pre>
command line tools.
+
 
Once you launch Synaptic select the "Settings/Repositories" menu entry.
+
Don't forget to enable that repository by selecting a checkbox in the leftmost column. Now you can reload repository information by clicking on the "Reload" button in the main Synaptic window. Then you click on the "Search" button and
Click
+
search for "scribus". Once "scribus", "scribus-cvs", "scribus-doc", and "scribus-template" packages are found you can mark them for installation by double-clicking on them or by right-clicking and selecting "Mark for installation".  
on the "New" button and type or paste in the appropriate source lines.
+
 
For example for "Debian Sarge":
+
When you are done, click on the "Apply" button to proceed with installation. After that you should have the packages installed and may begin to use Scribus.
URI: http://debian.scribus.net/debian/ <br />
+
 
Distribution: stable <br />
+
== Building from a source package for other Debian-based distributions ==
Section(s): main non-free contrib <br />
+
 
Don't forget to enable that repository by selecting a checkbox in the
+
Instructions below have been rendered mostly obsolete for the x86 architecture by the new repositories. If you have non-x86 hardware or would like to build an optimized package you can still use these instructions. You can submit packages for other architectures to me and I will place them into the repository. If you have a non-x86 arch or would like to optimize the packages for your CPT you can achive these goals by a very simple package rebuild. Make sure that you have the deb-src lines for scribus repositories uncommented and run the following commands:
leftmost
 
column. Now you can reload repository information by clicking on the
 
"Reload"
 
button in the main Synaptic window. Then you click on the "Search"
 
button and
 
search for "scribus". Once "scribus", "scribus-cvs", "scribus-doc", and
 
"scribus-template" packages are found you can mark them for
 
installation by
 
double-clicking on them or by right-clicking and selecting "Mark for
 
installation". When you are done, click on the "Apply" button to
 
proceed with
 
installation. After that you should have the packages installed and may
 
begin
 
to use Scribus.
 
<h3>Building from a source package
 
for other Debian-based distributions</h3>
 
Instructions below have been rendered mostly obsolete for the x86
 
architecture by the new repositories. If you have non-x86 hardware or
 
would like to build an optimized package you can still use these
 
instructions. You can submit packages for other architectures to me and
 
I will place them into the repository. If you have a non-x86 arch or
 
would like to optimize the packages for your CPT you can achive these
 
goals by a very simple package rebuild. Make sure that you have the
 
deb-src lines for scribus repositories uncommented and run the
 
following commands:
 
 
<hr />The cool way (TM) - as root
 
<hr />The cool way (TM) - as root
 
or set up sudo for yourself as a user:
 
or set up sudo for yourself as a user:
<pre>apt-get install apt-build<br /></pre>
+
 
Answer questions about your CPU and stuff - see an excellent document
+
<pre>apt-get install apt-build</pre>
at http://julien.danjou.info/article-apt-build.html)
+
 
<pre>apt-build update<br /></pre>
+
Answer questions about your CPU and stuff - see an excellent document at http://julien.danjou.info/article-apt-build.html
<pre>apt-build install scribus (or scribus-cvs)<br /></pre>
+
 
 +
<pre>apt-build update
 +
apt-build install scribus (or scribus-cvs)</pre>
 
<hr />
 
<hr />
<h4>An alternate cool way - as
+
 
root or see the config setup below:</h4>
+
==== An alternate cool way - as root or see the config setup below: ====
 
<ul>
 
<ul>
 
   <li>Install "apt-src":
 
   <li>Install "apt-src":
     <pre>apt-get install apt-src<br /></pre>
+
     <pre>apt-get install apt-src</pre>
 
   </li>
 
   </li>
 
   <li>Install the dependencies,
 
   <li>Install the dependencies,
 
build and install scribus from source:
 
build and install scribus from source:
     <pre>apt-src -i install scribus<br /></pre>
+
     <pre>apt-src -i install scribus</pre>
 
   </li>
 
   </li>
 
</ul>
 
</ul>
<h4>To streamline this process and
+
==== To streamline this process and build scribus as a user: ====
build scribus as a user:</h4>
+
'''Configure apt-src:'''
<strong>Configure apt-src:</strong>
+
 
<!-- br-->
 
 
Add the following lines to /etc/apt/apt.conf or ~/.apt-src/config file:
 
Add the following lines to /etc/apt/apt.conf or ~/.apt-src/config file:
<pre>APT::Src::RootCommand su -c;<br />APT::Src::BuildDeps<br /></pre>
+
<pre>APT::Src::RootCommand su -c;
This is especially convenient if you set up the no-password su to root
+
APT::Src::BuildDeps</pre>
for yourself through pam. Otherwise you'll likely have to type a
+
 
password.
+
This is especially convenient if you set up the no-password su to root for yourself through pam. Otherwise you'll likely have to type a password.
<hr />
+
 
<h4>Without apt-build or apt-src -
+
==== Without apt-build or apt-src - as root: ====
as root:</h4>
+
 
<pre>apt-get source -b scribus scribus-cvs<br /></pre>
+
<pre>apt-get source -b scribus scribus-cvs
<pre>apt-get build-dep scribus-cvs (or scribus)<br /></pre>
+
apt-get build-dep scribus-cvs (or scribus)</pre>
<hr />
+
 
<h4>Anoter way - as root:</h4>
+
==== Anoter way - as root: ====
<pre>apt-get install devscripts build-essential fakeroot<br /></pre>
+
<pre>apt-get install devscripts build-essential fakeroot</pre>
 
<strong>Note:</strong>
 
<strong>Note:</strong>
 
This creates a minimal build environment.
 
This creates a minimal build environment.
<pre>apt-get source scribus-cvs (or "scribus" instead of "scribus-cvs")<br /></pre>
+
<pre>apt-get source scribus-cvs (or "scribus" instead of "scribus-cvs")
<pre>apt-get build-dep scribus-cvs (or scribus)<br /></pre>
+
apt-get build-dep scribus-cvs (or scribus)
<pre>cd scribus.... or scribus-cvs...<br /></pre>
+
cd scribus.... or scribus-cvs...</pre>
 +
 
 
Use the actual directory names.
 
Use the actual directory names.
<pre>debuild -us -uc<br /></pre>
+
 
<pre>cd ..<br /></pre>
+
<pre>debuild -us -uc
<pre>dpkg -i scribus_.... or scribus-cvs_....<br /></pre>
+
cd ..
<h3>About this document</h3>
+
dpkg -i scribus_.... or scribus-cvs_....</pre>
As of 2006-01-30 this how-to has been originally created for Scribus
+
 
Wiki page by the following Scribus Wiki users: malex (Oleksandr
+
== About this document ==
Moskalenko), mhanski (Maciej Hanski), Zero0w (Wily Yuen), JureCuhalev,
+
 
Cbradney (Craig Bradney),
+
As of 2006-01-30 this how-to has been originally created for Scribus Wiki page by the following Scribus Wiki users: malex (Oleksandr Moskalenko), mhanski (Maciej Hanski), Zero0w (Wily Yuen), JureCuhalev, Cbradney (Craig Bradney), and Joolsr.
and Joolsr.
 
</body>
 
</html>
 

Revision as of 13:43, 28 March 2006

Scribus on Debian GNU/Linux and derivatives

The main page is now located at http://debian.scribus.net. This page must be kept as strict xhtml 1.0 and any modifications should be followed by a notification to malex@tagncha.org, so the main page could be updated.

"Debian" name here encompasses Debian proper (unstable/testing/stable also known as sid/etch/sarge) and at least Ubuntu breezy/hoary. Instructions on rebuilding the source package may be applicable to other Debian derivatives and custom distributions.

Preamble

Currently there are following Scribus-related packages in Debian: Scribus (Scribus 1.2.x), scribus-template (Developer and user-contributed additional templates), scribus-doc (Scribus documentation, which has to be provided as a separate package due to is non-free nature by the Debian Free Software Guidelines), icc-profiles (A collection of common ICC profiles to use with Scribus and other color profile-aware software), and LPROF (Hardware color profiler that can be used to create color profiles for your hardware to be used with Scribus).

Scribus team also maintains an unofficial (outside of Debian proper) repository that contains some of the packages mentioned above with the most notable difference being a scribus-cvs package (Scribus 1.3.x developmental series). scribus-cvs package can be installed in parallel with the scribus package. There are a couple reasons for the existence of this upstream repository.

First, Debian development puts a limit on how often a new scribus package can be updated. It could take weeks between consecutive uploads. Because of that the official packages are usually behind those available in our upstream archives. Packages in our upstream repositories usually follow scribus development fairly closely via cvs snapshot builds. For instance, if you discovered a but you are advised to install the most recent package as the bug might have already been fixed and a fixed package is available. This is called "the Scribus magic (TM)".

Second, Debian has strict Quality Assurance for packages with its requirements embodied in the extensive and thorough Debian Policy. As Scribus libraries may not yet be installed in arbitrary locations due to code limitations scribus-cvs package has it libraries in the /usr/local/lib hierarchy. This is a violation of DP and as such 1.3.x series scribus-cvs has to be confined to our upstream repository until it is ready to replace the venerable Scribus 1.2.x series.

Debian setup for Scribus repositories

About the repositories

We actually maintain two identical repositories to provide bandwidth redundancy and failover capability to our distribution of Debian scribus packages. These repositories contain x86 packages for Debian stable,testing and unstable and Ubuntu hoary and breezy branches. If you are using a different Debian-based distribution or your hardware is not x86-based such as PowerPC or AMD64 you can easily build a Scribus package from our source package, so do not consider it as a strong obstacle to using these packages.

Repository usage

To use our repositories add the appropriate source lines from the following list to your /etc/apt/sources.list file. Note that the lines starting with "deb" are used for installation of the pre-compiled binary packages and the line starting with "deb-src" are for the source package for building a binary package for your distribution (if it has a different set of libraries), hardware (if it's not x86) or compiler optimizations (if you really know you want them).

Source lines for /etc/apt/sources.list or for Synaptic et al

Debian stable (Sarge):

# debian.scribus.net - Primary repository
deb http://debian.scribus.net/debian/ stable main non-free contrib
deb-src http://debian.scribus.net/debian/ stable main non-free contrib
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian/ stable main non-free contrib
deb-src http://debian.tagancha.org/debian/ stable main non-free contrib

Debian testing (Etch):

# debian.scribus.net - Primary repository<
deb http://debian.scribus.net/debian/ testing main non-free contrib
deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian/ testing main non-free contrib
deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib

Debian unstable (Sid):

# debian.scribus.net - Primary repository
deb http://debian.scribus.net/debian/ unstable main non-free contrib
deb-src http://debian.scribus.net/debian/ unstable main non-free contrib
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian/ unstable main non-free contrib
deb-src http://debian.tagancha.org/debian/ unstable main non-free contrib

Ubuntu Hoary:

# debian.scribus.net - Primary repository
deb http://debian.scribus.net/debian/ hoary main restricted
deb-src http://debian.scribus.net/debian/ hoary main restricted
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian/ hoary main restricted
deb-src http://debian.tagancha.org/debian/ hoary main restricted

Ubuntu Breezy:

Note that Ubuntu breezy package can be also used for Ubuntu "Dapper" branch right now. When Dapper changes enough to require its own scribus or scribus-cvs package we will provide it.

# debian.scribus.net - Primary repository
deb http://debian.scribus.net/debian breezy main restricted
deb-src http://debian.scribus.net/debian breezy main restricted
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian breezy main restricted
deb-src http://debian.tagancha.org/debian breezy main restricted

Using cryptographic repository signatures:

Our repositories are cryptographically signed for added security. Add the gpg-keys for our repositories to avoid having to confirm your installation choice to the package manager each time you update a scribus or scribus-cvs package.

root$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
root$ gpg --armor --export DA286F326C5F196B | apt-key add - 

or as a normal user (with an appropriate entry for apt-key in the sudoers file):

user$ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys DA286F326C5F196B
user$ gpg --armor --export DA286F326C5F196B | sudo apt-key add - 

Final installation step

Once you added the relevant sources lines to your /etc/apt/sources.list you can run

aptitude install scribus scribus-cvs

or

apt-get install scribus scribus-cvs

in a root terminal or use your favorite graphical apt-get front-end such as synaptic or aptitude. Don't forget to "Reload Package List" in the synaptic. It's the equivalent of "apt-get (or aptitude) update" and has to be done to make new packages from our repositories available to your package management tools.

Bug reporting

Please DO NOT file bug reports about the packages from these upstream repositories into the Debian or Ubuntu BTS (Bug Tracking Systems). Only use the distribution BTS for the package version that is in that distribution. If you have a Scribus issue that is not related to Debian packaging then use the scribus BTS at http://bugs.scribus.net for reporting bugs.

You are encouraged to contact the maintainer Oleksandr (Alex) Moskalenko ([1]), if you have package installation questions or related Scribus issues that you believe do not belong in Scribus BTS or for comments and suggestions about this document.

Step-by-step procedure for new Debian GNU/Linux users

You don't have to log on as root, but you have to have superuser privileges to edit the /etc/apt/sources.list file. Fortunately, on a Linux system you can do that with ease. Please open a root terminal or open a regular terminal and become root through a "su" command. You will have to provide root password when prompted. Then, you can launch your favorite text editor from that terminal and edit the sources.list file as outlined in the Scribus on Debian GNU/Linux page. Alternatively, you can do a bit more work upfront to achieve a more permanent access to package manipulation system. If you are familiar with the VI editor you can do the following:

  • Open a root terminal.
  • Type "visudo".
  • Type "o" to open a new line (vi command) and type the following line (assuming your login name is "scribusoid"): scribusoid ALL= NOPASSWD: /usr/sbin/synaptic
  • Press "ESC" to leave the editing mode in Vi and return to the command mode.
  • Type ":wq!" to exit the editor.

Now you are ready to launch the very nice graphical apt-get front-end Synaptic with a "sudo synaptic" command at any time. If you are a new Linux user, Synaptic will help you get started easier than you probably would with command line tools. Once you launch Synaptic select the "Settings/Repositories" menu entry. Click on the "New" button and type or paste in the appropriate source lines. For example for "Debian Sarge":

URI: http://debian.scribus.net/debian/
Distribution: stable
Section(s): main non-free contrib

Don't forget to enable that repository by selecting a checkbox in the leftmost column. Now you can reload repository information by clicking on the "Reload" button in the main Synaptic window. Then you click on the "Search" button and search for "scribus". Once "scribus", "scribus-cvs", "scribus-doc", and "scribus-template" packages are found you can mark them for installation by double-clicking on them or by right-clicking and selecting "Mark for installation".

When you are done, click on the "Apply" button to proceed with installation. After that you should have the packages installed and may begin to use Scribus.

Building from a source package for other Debian-based distributions

Instructions below have been rendered mostly obsolete for the x86 architecture by the new repositories. If you have non-x86 hardware or would like to build an optimized package you can still use these instructions. You can submit packages for other architectures to me and I will place them into the repository. If you have a non-x86 arch or would like to optimize the packages for your CPT you can achive these goals by a very simple package rebuild. Make sure that you have the deb-src lines for scribus repositories uncommented and run the following commands:


The cool way (TM) - as root

or set up sudo for yourself as a user:

apt-get install apt-build

Answer questions about your CPU and stuff - see an excellent document at http://julien.danjou.info/article-apt-build.html

apt-build update
apt-build install scribus (or scribus-cvs)

An alternate cool way - as root or see the config setup below:

  • Install "apt-src":
    apt-get install apt-src
  • Install the dependencies, build and install scribus from source:
    apt-src -i install scribus

To streamline this process and build scribus as a user:

Configure apt-src:

Add the following lines to /etc/apt/apt.conf or ~/.apt-src/config file:

APT::Src::RootCommand su -c;
APT::Src::BuildDeps

This is especially convenient if you set up the no-password su to root for yourself through pam. Otherwise you'll likely have to type a password.

Without apt-build or apt-src - as root:

apt-get source -b scribus scribus-cvs
apt-get build-dep scribus-cvs (or scribus)

Anoter way - as root:

apt-get install devscripts build-essential fakeroot

Note: This creates a minimal build environment.

apt-get source scribus-cvs (or "scribus" instead of "scribus-cvs")
apt-get build-dep scribus-cvs (or scribus)
cd scribus.... or scribus-cvs...

Use the actual directory names.

debuild -us -uc
cd ..
dpkg -i scribus_.... or scribus-cvs_....

About this document

As of 2006-01-30 this how-to has been originally created for Scribus Wiki page by the following Scribus Wiki users: malex (Oleksandr Moskalenko), mhanski (Maciej Hanski), Zero0w (Wily Yuen), JureCuhalev, Cbradney (Craig Bradney), and Joolsr.