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

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
 
(79 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{HOWTO Index}}
[[Category:Installation]] [[Category:EN]] [[Category:Linux]]{{Update}}
'''Note:''' the main document maintained by the Debian/Ubuntu packager and other people is [[Debian|located here]].


'''"Debian" name here encompasses Debian proper (unstable/testing/stable or sid/etch/sarge) and Ubuntu breezy/hoary.'''
<div style="background-color: #fee; margin: 0 1em; padding: 0 10px; border: 1px dotted #c00;">
'''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 [https://launchpad.net/distros/ubuntu/+source/scribus/+bug/37711 Ubuntu] and [http://bugs.scribus.net/view.php?id=3826 Scribus bug tracker].
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'''.


== Installation ==
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
</div>


Scribus is packaged for Debian GNU/Linux by Oleksandr (Alex) Moskalenko <malex@tagancha.org>. Please contact me at that email if you have questions that do not belong to the Debian or Scribus BTS (Bug Tracking System) or for comments about this page.
== Adding repositories with Scribus related packages ==


If you'd like to stay on the leading edge of Scribus development please use upstream repositories as I have to upload scribus into Debian through a sponsor and it usually takes weeks to get an upload in. Because of that the official packages are usually well-behind what is available in the upstream repositories. Please try a package from an upstream directory to test the bug you discovered as it might have already been fixed and new package is available. This is called "the Scribus magic (TM)". Please note that the repositories listed below are IDENTICAL in order to provide a backup and additional bandwidth if needed. The contain packages for Debian stable,testing,unstable and Ubuntu hoary,breezy distributions. If you are using a different Debian based distribution you should use the "unstable" source lines and rebuild the source package.
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.
<p>
To use our upstream repositories:


Add the appropriate lines from the following list to your /etc/apt/sources.list file:
{|
!Vendor
!Distribution
!Available sets
|-
|Ubuntu || maverick || main
|-
|Ubuntu || lucid || main
|-
|Ubuntu || karmic || main
|}


<pre>
# debian.scribus.net - Primary repository
# Debian stable
deb http://debian.scribus.net/debian yourdistribution main
# debian.scribus.net - Primary repository
deb-src http://debian.scribus.net/debian yourdistribution main
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
# debian.tagancha.org - Backup repository
deb         http://debian.tagancha.org/debian/ stable main non-free contrib
deb http://debian.tagancha.org/debian yourdistribution main
deb-src     http://debian.tagancha.org/debian/ stable main non-free contrib
deb-src http://debian.tagancha.org/debian yourdistribution main
</pre>


<pre>
=== Example for the current release of Ubuntu ===
# Debian testing
If you are using the latest release of Ubuntu, your /etc/lsb-release should look similar to this:
deb        http://debian.scribus.net/debian/ testing main non-free contrib
DISTRIB_ID=Ubuntu
deb-src    http://debian.scribus.net/debian/ testing main non-free contrib
DISTRIB_RELEASE=10.04
DISTRIB_CODENAME=maverick
DISTRIB_DESCRIPTION="Ubuntu 10.04"


deb         http://debian.tagancha.org/debian/ testing main non-free contrib
Based on this information, using the primary site, the repositories you would add are:
deb-src     http://debian.tagancha.org/debian/ testing main non-free contrib
  deb http://debian.scribus.net/debian maverick main
</pre>
  deb-src http://debian.scribus.net/debian maverick main


<pre>
=== Kubuntu Graphical Example ===
# Debian unstable
An example of adding both repositories successfully to a system running breezy with Adept Manager.
deb        http://debian.scribus.net/debian/ unstable main non-free contrib
deb-src    http://debian.scribus.net/debian/ unstable main non-free contrib


deb        http://debian.tagancha.org/debian/ unstable main non-free contrib
* Go to  '''KDE menu/System/Adept (Package Manager)'''  <br>''Ubuntu: '''System'''/'''Administration'''/'''Synaptic (Package Manager)'''''
deb-src    http://debian.tagancha.org/debian/ unstable main non-free contrib
* In Adept go to '''Adept/Manage Repositories''' <br>''Ubuntu: in Synaptic go to '''Settings/Repositories/New'''''
</pre>
* 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:''


<pre>
[[Image:Adding scribus repositories.png]]
# Ubuntu hoary
deb        http://debian.scribus.net/debian/ hoary main restricted
deb-src    http://debian.scribus.net/debian/ hoary main restricted


deb        http://debian.tagancha.org/debian/ hoary main restricted
== Adding the repository key ==
deb-src    http://debian.tagancha.org/debian/ hoary main restricted
</pre>


<pre>
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.
# Ubuntu breezy
deb        http://debian.scribus.net/debian/ breezy main restricted
deb-src    http://debian.scribus.net/debian/ breezy main restricted


deb        http://debian.tagancha.org/debian/ breezy main restricted
==== On recent systems ====
deb-src    http://debian.tagancha.org/debian/ breezy main restricted
As root:
</pre>
# 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 -


Once you added the relevant sources lines you can run
As a regular user:
<pre>
aptitude install scribus scribus-cvs
</pre>
or
<pre>
apt-get install scribus scribus-cvs
</pre>
or use your favorite graphical apt-get front-end such as synaptic (Don't forget to "Reload Package List" in the synaptic. It's the equivalent of apt-get update and has to be done before new packages from these repositories will become available to your package management tools).


'''The "scribus" package is for 1.2.xcvs stable series whereas "scribus-cvs" package will let you try the new 1.3cvs series, which is pretty stable and much more featureful than 1.2. "scribus-cvs" package installs into /usr/local hierarchy and can be installed in parallel with the scribus package, so you can have both and even run them at the same time.'''
$ gpg --keyserver subkeys.pgp.net --recv-keys EEF818CF
$ gpg --armor --export EEF818CF | sudo apt-key add -


However, please DO NOT file bug reports about the 1.3 scribus-cvs package or any packages in these upstream repositories into the Debian or Ubuntu BTS. Only use the distribution BTS for the package versions that are in that distribution. If you have a Scribus issue, which is not related to Debian packaging then it is much more preferable if you use scribus BTS for reporting bugs. Go to http://bugs.scribus.net and have fun.
==Installing Scribus and related packages==
Launch '''Adept''' (on Kubuntu) or '''Synaptic''' (on Ubuntu) and install the following packages:  


=== For NEW Linux users ===
* '''scribus''' &ndash; Scribus 1.3.3.x (stable branch) '''or'''
* '''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.
* '''scribus-template''' &ndash; developer and user-contributed additional templates
* '''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
* '''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
* '''icc-profiles''' &ndash; a collection of common ICC profiles to use with Scribus and other color profile-aware software
* '''lprof''' &ndash; hardware color profiler that can be used to create color profiles for your hardware to be used with Scribus
* '''qt3-qtconfig''' &ndash; Ubuntu users are strongly advised to install this package for finetuning the Scribus GUI with their Gnome desktop
* '''gs-afpl''' &ndash; The AFPL Ghostscript PostScript interpreter, the Ghostscript version recommended by the Scribus team


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:


* Open a root terminal.
Optionally, install the following high quality font packages:
* Type "visudo".
* '''t1-xfree86-nonfree'''
* Type "o" to open a new line (vi command) and type the following line
* '''ttf-bitstream-vera'''
(assuming your login name is "keay"):
* '''ttf-gentium'''
keay  ALL= NOPASSWD: /usr/sbin/synaptic
* '''ttf-xfree86-nonfree'''
* 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
==Fine tuning Scribus==
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
===Default GUI font (Ubuntu users only)===
on the "New" button and type in the appropriate parts. For example for "Sarge":
* Launch gtconfig: '''ALT + F2 / enter "qtconfig" / hit Enter'''
* Go to '''Fonts''' tab and choose the font family and size to match your Gnome settings


URI: http://debian.scribus.net/debian/ <br>
[[Image:Qtconfig.png]]
Distribution: stable <br>
Section(s): main non-free contrib <br>


Don't forget to enable that repository by selecting a checkbox in the leftmost
===External tools and additional fonts===
column. Now you can reload repository information by clicking on the "Reload"
* Launch Scribus and go to '''File/Preferences/External Tools'''
button in the main Synaptic window. Then you click on the "Search" button and
* PostScript Interperter: enter '''gs-afpl'''
search for "scribus". Once "scribus", "scribus-cvs", "scribus-doc", and
* Image Processing Tool: '''gimp-remote'''
"scribus-template" packages are found you can mark them for installation by
* Go to '''Fonts''' subsection and add/disable/enable additional fonts
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.


[[Image:External tools.png]]


=== Other branches ===
{{CC_BY_SA_and_GNU_FDL|2005-2007|Scribus Wiki authors mentioned in the page history}}
 
'''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 your distribution is not already supported ==
 
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: ===
 
<pre>
apt-get install apt-build
</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
</pre>
<pre>
apt-build install scribus (or scribus-cvs)
</pre>
 
<hr>
 
=== An alternate cool way - as root or see the config setup below: ===
* Install "apt-src":
<pre>
apt-get install apt-src
</pre>
 
* Install the dependencies, build and install scribus from source:
<pre>
apt-src -i install scribus
</pre>
 
'''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:
<pre>
APT::Src::RootCommand su -c;
APT::Src::BuildDeps
</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>
 
=== Without apt-build or apt-src - as root: ===
 
<pre>
apt-get build-dep scribus-cvs (or scribus)
</pre>
 
<pre>
apt-get source -b scribus scribus-cvs
</pre>
 
<hr>
 
=== Anoter way - as root: ===
 
<pre>
apt-get install devscripts build-essential fakeroot
</pre>
''Note: This creates a minimal build environment.''
 
<pre>
apt-get source scribus-cvs (or "scribus" instead of "scribus-cvs")
</pre>
<pre>
apt-get build-dep scribus-cvs (or scribus)
</pre>
<pre>
cd scribus.... or scribus-cvs...
</pre>
At this moment these are scribus-1.2.1+cvs20050620 and scribus-cvs-1.3+cvs20050629), but it's just an example. Use the actual directory names.
<pre>
debuild -us -uc
</pre>
<pre>
cd ..
</pre>
<pre>
dpkg -i scribus_.... or scribus-cvs_....
</pre>
At the moment these are scribus_1.2.1+cvs20050620-2_i386.deb and scribus-cvs_1.3+cvs20050629-1_i386.deb, but use the actual file names.
<p>
Voila - you have a scribus (1.2) or scribus-cvs (1.3) package built and optimized for your Sarge (Debian 3.1 a.k.a. stable) system.
 
 
== User notes about installation on other Debian-based distributions ==
 
Please post your experiences about the Scribus availability on other Debian-based distributions. If you just want to get the latest package on one of them - follow the source package rebuild procedure above.
 
==
''''''NOTE''' There are now std repositories for both Hoary and Breezy Ubuntu for Scribus 1.2 and 1.3 dev series packkges. So you do NOT have to use the notes below. I have left them  there should the need arise to build a deb from source from a Debian build.''' ==
 
'''Ubuntu Linux Hoary (5.04)'''
 
Using the 1.3 CVS and the 1.2.2 CVS from the Debian CVS builds and rebuilding from source works fine for me. Originally I just tried to install the these packages using just apt-get install scribus but with Ubuntu had some major dependency errors with gcc etc.
 
With the help of the scribus list, I now use (admittedly a slight variant of the building from source for Debian) notes, ie, as root, or with sudo:-
 
'''apt-get source -b scribus-cvs'''
 
This alerted me to many dev libraries that were missing. Ubuntu doesn't (not surprisingly) have many dev libs installed on the std build. This command does the actual complie. If you use 'scribus-cvs' you will currently get the v1.3 dev series build, whereas if you use just 'scribus' you will get the stabile 1.2.2 release ie the 1.2 CVS series builds.
 
Once these were all installed, I did :-
 
'''apt-get build-dep scribus-cvs'''
 
This builds the scribus-cvs package for you from source. It took around half an hour, and spews out a lot of messages. Eventually, you should find a scribus-cvs deb in the directory that you are working in.
 
Then just do
 
'''apt-get install scribus-cvs'''
 
& Bingo !
 
As I said before, I'm not a Debian/Ubuntu expert and I'm sure there may be betters ways of doing this.
The scribus packages do however work ''fine'' on Ubuntu when building from source. I have had NO errors part from std occasional crashes of the CVS package.
 
'''NOTE'''
It seems from experimentation that you should stick with either the official install method as mentioned above, or the method I use, BUT NOT BOTH !

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.