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

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(71 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{HOWTO Index}}
[[Category:Installation]] [[Category:EN]] [[Category:Linux]]{{Update}}
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
'''Note:''' the main document maintained by the Debian/Ubuntu packager and other people is [[Debian|located here]].
<html xmlns="http://www.w3.org/1999/xhtml">
 
<head>
<div style="background-color: #fee; margin: 0 1em; padding: 0 10px; border: 1px dotted #c00;">
  <meta
'''BIG FAT WARNING:'''
  content="text/html; charset=ISO-8859-1"
Scribus users on any version of '''Kubuntu''' from Dapper Drake on may experience difficulties while changing values in real number spinboxes. This is a long standing bug which has been reported to both [https://launchpad.net/distros/ubuntu/+source/scribus/+bug/37711 Ubuntu] and [http://bugs.scribus.net/view.php?id=3826 Scribus bug tracker].
  http-equiv="content-type" />
As long as there is no real solution, you can use of the workarounds mentioned in [https://launchpad.net/distros/ubuntu/+source/scribus/+bug/37711 Ubuntu Bug Tracker], preferably remove the package '''scim_qtimm'''.
  <title>Scribus on Debian GNU
 
Linux</title>
Please refer also to [http://bugs.scribus.net/view.php?id=4423 this metabug] for other *buntu issues that may diminish its suitability as a good platform for Scribus and DTP
</head>
</div>
<body>
 
<h1>Scribus
== Adding repositories with Scribus related packages ==
on Debian GNU/Linux
 
and derivatives.</h1>
Repositories are provided for the majority of Debian and Ubuntu based systems. If you are uncertain which distribution you are running the file /etc/lsb-release will probably contain that information.
<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.
 
<p>
{|
"Debian" name here
!Vendor
encompasses Debian proper (unstable/testing/stable also known as
!Distribution
sid/etch/sarge) and at least Ubuntu breezy/hoary. Instructions on
!Available sets
rebuilding the source package may be applicable to other Debian
|-
derivatives and custom distributions.</strong>
|Ubuntu || maverick || main
<h2>Preamble</h2>
|-
Currently there are following Scribus-related packages in Debian: <a
|Ubuntu || lucid || main
href="http://packages.qa.debian.org/s/scribus.html">scribus</a>
|-
(Scribus 1.2.x), <a
|Ubuntu || karmic || main
href="http://packages.qa.debian.org/s/scribus-template.html">scribus-template</a>
|}
(Developer and
 
user-contributed additional templates), <a
  # debian.scribus.net - Primary repository
href="http://packages.qa.debian.org/s/scribus-doc.html">scribus-doc</a>
deb http://debian.scribus.net/debian yourdistribution main
(Scribus documentation, which has to be
deb-src http://debian.scribus.net/debian yourdistribution main
provided as a separate package due to is non-free nature by the Debian
 
Free
# debian.tagancha.org - Backup repository
Software Guidelines), <a
deb http://debian.tagancha.org/debian yourdistribution main
href="http://packages.qa.debian.org/i/icc-profiles.html">icc-profiles</a>
deb-src http://debian.tagancha.org/debian yourdistribution main
(A collection of common ICC profiles to use with Scribus and other
 
color profile-aware software), and <a
=== Example for the current release of Ubuntu ===
  href="http://packages.qa.debian.org/l/lprof.html">lprof</a>
If you are using the latest release of Ubuntu, your /etc/lsb-release should look similar to this:
(Hardware color profiler that
DISTRIB_ID=Ubuntu
can be used to create color profiles for your hardware to be used with
DISTRIB_RELEASE=10.04
Scribus). Scribus team also
DISTRIB_CODENAME=maverick
maintains an unofficial (outside of Debian proper) repository that
DISTRIB_DESCRIPTION="Ubuntu 10.04"
contains some of the packages
 
mentioned above with the most notable difference being a scribus-cvs
Based on this information, using the primary site, the repositories you would add are:
package (Scribus 1.3.x developmental
  deb http://debian.scribus.net/debian maverick main
series). scribus-cvs package can be installed in parallel with the
  deb-src http://debian.scribus.net/debian maverick main
scribus package. There are a couple reasons
 
for the existence of this upstream repository. First, Debian
=== Kubuntu Graphical Example ===
development puts a limit on how often a new scribus package can be
An example of adding both repositories successfully to a system running breezy with Adept Manager.
updated. It could take weeks between consecutive uploads. Because of
 
that the official packages are usually behind those available in our
* Go to '''KDE menu/System/Adept (Package Manager)'''  <br>''Ubuntu: '''System'''/'''Administration'''/'''Synaptic (Package Manager)'''''
upstream archives. Packages in our upstream repositories usually
* In Adept go to '''Adept/Manage Repositories''' <br>''Ubuntu:  in Synaptic go to '''Settings/Repositories/New'''''
follow scribus development fairly closely via cvs snapshot builds. For
* Add the following repositories one by one using the '''Add''' field and click on '''Apply''':<br>''Ubuntu: Fill the fields and use the '''OK''' button to add the following repositories:''
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
[[Image:Adding scribus repositories.png]]
package is available. This is called "the Scribus magic (TM)". Second,
 
Debian has strict Quality Assurance for
== Adding the repository key ==
packages with its requirements embodied in the extensive and thorough <a
 
href="http://www.debian.org/doc/debian-policy/">Debian
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-ng package.
Policy</a>. As Scribus libraries may
 
not yet be
==== On recent systems ====
installed in arbitrary locations due to code limitations scribus-cvs
As root:
package has it libraries in the /usr/local/lib
# apt-key adv --recv-keys --keyserver subkeys.pgp.net EEF818CF
hierarchy. This is a violation of DP and as such 1.3.x series
As a regular user:
scribus-cvs has to be confined to our upstream repository until
$ sudo apt-key adv --recv-keys --keyserver subkeys.pgp.net EEF818CF
it is ready to replace the venerable Scribus 1.2.x series.
==== On older systems ====
<h2>Debian setup for Scribus
As root:
repositories.</h2>
# gpg --keyserver subkeys.pgp.net --recv-keys EEF818CF
<h3>About the repositories.</h3>
# gpg --armor --export EEF818CF | apt-key add -
We actually maintain two identical repositories to provide bandwidth
 
redundancy and failover capability to our
As a regular user:
distribution of Debian scribus packages. These repositories contain x86
 
packages for Debian
$ gpg --keyserver subkeys.pgp.net --recv-keys EEF818CF
stable,testing and unstable and Ubuntu hoary and breezy branches. If
$ gpg --armor --export EEF818CF | sudo apt-key add -
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
==Installing Scribus and related packages==
package from our source package, so do not consider it as a strong
Launch '''Adept''' (on Kubuntu) or '''Synaptic''' (on Ubuntu) and install the following packages:  
obstacle to using these packages.
 
<h3>Repository usage.</h3>
* '''scribus''' &ndash; Scribus 1.3.3.x (stable branch) '''or'''
To use our repositories add the appropriate
* '''scribus-ng''' &ndash; Scribus 1.3.x (development branch) scribus-ng package can be installed paralelly to the  scribus package. Only available for lucid/maverick.
source lines from the following list to your
* '''scribus-template''' &ndash; developer and user-contributed additional templates
/etc/apt/sources.list file. Note that the lines starting with "deb" are
* '''scribus-doc''' &ndash; Scribus 1.3.3.x documentation, which has to be provided as a separate package due to its non-free nature by the Debian Free Software Guidelines
used for installation of the pre-compiled binary packages and the line
* '''scribus-ng-doc''' &ndash; Scribus 1.3.x documentation, which has to be provided as a separate package due to its non-free nature by the Debian Free Software Guidelines
starting with
* '''icc-profiles''' &ndash; a collection of common ICC profiles to use with Scribus and other color profile-aware software
"deb-src" are for the source package for building a binary
* '''lprof''' &ndash; hardware color profiler that can be used to create color profiles for your hardware to be used with Scribus
package for your distribution (if it has a different set of libraries),
* '''qt3-qtconfig''' &ndash; Ubuntu users are strongly advised to install this package for finetuning the Scribus GUI with their Gnome desktop
hardware (if it's not x86) or compiler optimizations (if you really
* '''gs-afpl''' &ndash; The AFPL Ghostscript PostScript interpreter, the Ghostscript version recommended by the Scribus team
know you want them).&nbsp;
 
<h3>Source lines for
 
/etc/apt/sources.list or for Synaptic et al.</h3>
Optionally, install the following high quality font packages:
<h4>Debian stable (Sarge):</h4>
* '''t1-xfree86-nonfree'''
<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>
* '''ttf-bitstream-vera'''
<h4>Debian testing (Etch):</h4>
* '''ttf-gentium'''
<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>
* '''ttf-xfree86-nonfree'''
<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>
==Fine tuning Scribus==
<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>
===Default GUI font (Ubuntu users only)===
<h4>Ubuntu breezy:</h4>
* Launch gtconfig: '''ALT + F2 / enter "qtconfig" / hit Enter'''
<div>Note that Ubuntu breezy
* Go to '''Fonts''' tab and choose the font family and size to match your Gnome settings
package can be also used for Ubuntu "Dapper" branch right now. When
 
Dapper
[[Image:Qtconfig.png]]
changes enough to require its own scribus or scribus-cvs package we
 
will
===External tools and additional fonts===
provide it.</div>
* Launch Scribus and go to '''File/Preferences/External Tools'''
<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>
* PostScript Interperter: enter '''gs-afpl'''
<h3>Using cryptographic repository
* Image Processing Tool: '''gimp-remote'''
signatures:</h3>
* Go to '''Fonts''' subsection and add/disable/enable additional fonts
Our repositories are cryptographically signed for added security. Add
 
the gpg-keys for our repositories to avoid having to confirm your
[[Image:External tools.png]]
installation choice to the package manager each time you update a
 
scribus or scribus-cvs package.
{{CC_BY_SA_and_GNU_FDL|2005-2007|Scribus Wiki authors mentioned in the page history}}
<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
<pre>apt-get install scribus scribus-cvs<br /></pre>
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.<br />
<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. You are encouraged to
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>
  <li>Open a root terminal.</li>
  <li>Type "visudo".</li>
  <li>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</li>
  <li>Press "ESC" to leave the
editing mode in Vi and return to the command
mode.</li>
  <li>Type ":wq!" to exit the
editor.</li>
</ul>
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/ <br />
Distribution: stable <br />
Section(s): main non-free contrib <br />
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.
<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
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
at http://julien.danjou.info/article-apt-build.html)
<pre>apt-build update<br /></pre>
<pre>apt-build install scribus (or scribus-cvs)<br /></pre>
<hr />
<h4>An alternate cool way - as
root or see the config setup below:</h4>
<ul>
  <li>Install "apt-src":
    <pre>apt-get install apt-src<br /></pre>
  </li>
  <li>Install the dependencies,
build and install scribus from source:
    <pre>apt-src -i install scribus<br /></pre>
  </li>
</ul>
<h4>To streamline this process and
build scribus as a user:</h4>
<strong>Configure apt-src:</strong>
<!-- br-->
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>
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 -
as root:</h4>
<pre>apt-get source -b scribus scribus-cvs<br /></pre>
<pre>apt-get build-dep scribus-cvs (or scribus)<br /></pre>
<hr />
<h4>Anoter way - as root:</h4>
<pre>apt-get install devscripts build-essential fakeroot<br /></pre>
<strong>Note:</strong>
This creates a minimal build environment.
<pre>apt-get source scribus-cvs (or "scribus" instead of "scribus-cvs")<br /></pre>
<pre>apt-get build-dep scribus-cvs (or scribus)<br /></pre>
<pre>cd scribus.... or scribus-cvs...<br /></pre>
Use the actual directory names.
<pre>debuild -us -uc<br /></pre>
<pre>cd ..<br /></pre>
<pre>dpkg -i scribus_.... or scribus-cvs_....<br /></pre>
<h3>About this document</h3>
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.
</body>
</html>

Latest revision as of 04:01, 15 January 2011

Update.png
This article is outdated. Please update the information to reflect the current status or knowledge. We will deprecate/delete in the future.

Note: the main document maintained by the Debian/Ubuntu packager and other people is located here.

BIG FAT WARNING: Scribus users on any version of Kubuntu from Dapper Drake on may experience difficulties while changing values in real number spinboxes. This is a long standing bug which has been reported to both Ubuntu and Scribus bug tracker. As long as there is no real solution, you can use of the workarounds mentioned in Ubuntu Bug Tracker, preferably remove the package scim_qtimm.

Please refer also to this metabug for other *buntu issues that may diminish its suitability as a good platform for Scribus and DTP

Adding repositories with Scribus related packages

Repositories are provided for the majority of Debian and Ubuntu based systems. If you are uncertain which distribution you are running the file /etc/lsb-release will probably contain that information.

Vendor Distribution Available sets
Ubuntu maverick main
Ubuntu lucid main
Ubuntu karmic main
# debian.scribus.net - Primary repository
deb http://debian.scribus.net/debian yourdistribution main
deb-src http://debian.scribus.net/debian yourdistribution main
# debian.tagancha.org - Backup repository
deb http://debian.tagancha.org/debian yourdistribution main
deb-src http://debian.tagancha.org/debian yourdistribution main

Example for the current release of Ubuntu

If you are using the latest release of Ubuntu, your /etc/lsb-release should look similar to this:

DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=10.04
DISTRIB_CODENAME=maverick
DISTRIB_DESCRIPTION="Ubuntu 10.04"

Based on this information, using the primary site, the repositories you would add are:

 deb http://debian.scribus.net/debian maverick main
 deb-src http://debian.scribus.net/debian maverick main

Kubuntu Graphical Example

An example of adding both repositories successfully to a system running breezy with Adept Manager.

  • Go to KDE menu/System/Adept (Package Manager)
    Ubuntu: System/Administration/Synaptic (Package Manager)
  • In Adept go to Adept/Manage Repositories
    Ubuntu: in Synaptic go to Settings/Repositories/New
  • Add the following repositories one by one using the Add field and click on Apply:
    Ubuntu: Fill the fields and use the OK button to add the following repositories:

Adding scribus repositories.png

Adding the repository key

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-ng package.

On recent systems

As root:

# apt-key adv --recv-keys --keyserver subkeys.pgp.net EEF818CF

As a regular user:

$ sudo apt-key adv --recv-keys --keyserver subkeys.pgp.net EEF818CF

On older systems

As root:

# gpg --keyserver subkeys.pgp.net --recv-keys EEF818CF
# gpg --armor --export EEF818CF | apt-key add -

As a regular user:

$ gpg --keyserver subkeys.pgp.net --recv-keys EEF818CF
$ gpg --armor --export EEF818CF | sudo apt-key add -

Installing Scribus and related packages

Launch Adept (on Kubuntu) or Synaptic (on Ubuntu) and install the following packages:

  • scribus – Scribus 1.3.3.x (stable branch) or
  • scribus-ng – Scribus 1.3.x (development branch) scribus-ng package can be installed paralelly to the scribus package. Only available for lucid/maverick.
  • scribus-template – developer and user-contributed additional templates
  • scribus-doc – Scribus 1.3.3.x documentation, which has to be provided as a separate package due to its non-free nature by the Debian Free Software Guidelines
  • scribus-ng-doc – Scribus 1.3.x documentation, which has to be provided as a separate package due to its 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
  • lprof – hardware color profiler that can be used to create color profiles for your hardware to be used with Scribus
  • qt3-qtconfig – Ubuntu users are strongly advised to install this package for finetuning the Scribus GUI with their Gnome desktop
  • gs-afpl – The AFPL Ghostscript PostScript interpreter, the Ghostscript version recommended by the Scribus team


Optionally, install the following high quality font packages:

  • t1-xfree86-nonfree
  • ttf-bitstream-vera
  • ttf-gentium
  • ttf-xfree86-nonfree

Fine tuning Scribus

Default GUI font (Ubuntu users only)

  • Launch gtconfig: ALT + F2 / enter "qtconfig" / hit Enter
  • Go to Fonts tab and choose the font family and size to match your Gnome settings

Qtconfig.png

External tools and additional fonts

  • Launch Scribus and go to File/Preferences/External Tools
  • PostScript Interperter: enter gs-afpl
  • Image Processing Tool: gimp-remote
  • Go to Fonts subsection and add/disable/enable additional fonts

External tools.png


(c)

The content of this page is available under the Creative Commons Attribution-ShareAlike Licence and Free Documentation Licence

If you alter, transform, or build upon this work, you may distribute the resulting work either under one or under both of the abovementioned licences.