Debian

Introduction This document is about using Scribus Team repositories to obtain up-to-date Scribus packages for Debian GNU/Linux ( unstable/testing/stable also known as sid/squeeze/lenny for stable Scribus version 1.3.3.x - package scribus - or testing/unstable for 1.3.x developmental version - package scribus-ng ) and on Ubuntu ( Lucid, Karmic/Jaunty/Hardy for stable Scribus version 1.3.3.x or Lucid/Karmic/Jaunty for 1.3.xsvn developmental version). We have two identical archives - debian.tagancha.org and debian.scribus.net - that provide bandwidth redundancy and failover capability, so you can use either one or both of them. Instructions are the same whether you run a 32-bit or a 64-bit distribution. This repository also known as the Scribus Archive also contains fontmatrix packages for the listed Ubuntu releases. Keywords: Debian, Ubuntu, .deb, packages, repository, archive, step-by-step guide, 42. I. Short instructions for the impatient and experienced Stable Scribus (1.3.3.xx) is provided by the "scribus" package available for all releases. Developmental Scribus (1.3.xsvn) is provided by the "scribus-ng" package for Debian unstable/testing/stable or Ubuntu Intrepid Ibex and Jaunty only. We have both i386 and amd64 packages in our archive. Both scribus and scribus-ng packages can be installed on your system at the same time. 1. Add the repositories to package manager software Scribus archive's source lines can be simply added to /etc/apt/sources.list: Debian stable (Lenny): deb http://debian.scribus.net/debian/ stable main non-free contrib deb http://debian.tagancha.org/debian/ stable main non-free contrib

Debian testing (Squeeze): deb http://debian.scribus.net/debian/ testing main non-free contrib deb http://debian.tagancha.org/debian/ testing main non-free contrib

Debian unstable (Sid): deb http://debian.scribus.net/debian/ unstable main non-free contrib deb http://debian.tagancha.org/debian/ unstable main non-free contrib

Ubuntu Hardy Heron (hardy or 8.04): deb http://debian.scribus.net/debian/ hardy main non-free deb http://debian.tagancha.org/debian/ hardy main non-free

Ubuntu Jaunty Jackalope (jaunty or 9.04): deb http://debian.scribus.net/debian/ jaunty main non-free deb http://debian.tagancha.org/debian/ jaunty main non-free

Ubuntu Karmic Koala (karmic or 9.10): deb http://debian.scribus.net/debian/ karmic main non-free deb http://debian.tagancha.org/debian/ karmic main non-free Ubuntu Lucid Lynx (lucid or 10.04): deb http://debian.scribus.net/debian/ lucid main non-free deb http://debian.tagancha.org/debian/ lucid main non-free

2. Add the Scribus Archive signature Our repositories are cryptographically signed for added security. Add EEF818CF key from any major keyserver to apt-key to be able to verify that our packages have not been tampered with by a third party and to silence apt warnings about untrusted packages being installed. $ gpg --keyserver wwwkeys.eu.pgp.net --recv-keys EEF818CF

$ gpg --armor --export EEF818CF | sudo apt-key add - 3. Report bugs to the Scribus Bug Tracker not Debian or Ubuntu BTS

Do not file bug reports about the packages from the Scribus archive in the Debian or Ubuntu Bug Tracking Systems (BTS). Use distribution BTS only for the package versions currently present in that distribution. You are encouraged to contact the maintainer directly if you have package installation questions or for comments and suggestions about this document. If you have a Scribus issue unrelated to packaging you should use the scribus BTS.

II. Step-by-step instructions.

These instructions are focused on Ubuntu. 1. Add the Scribus Archive gpg key to your package manager using gui-apt-key  Start gui-apt-key from the command line by running "sudo gui-apt-key" or from the "Run Application" dialog window that appears when you press Alt+F2. When gui-apt-key starts you will see its main window. Enter the Scribus Archive key's ID into the "Key ID" box (1) and click on the "Add" button (2).  When the confirmation dialog appears click on the "OK" button.  As a result of you should see the Scribus Archive key in the list in the main window as the result (highlighted entry in the screenshot).</li> <img src="http://debian.scribus.net/images/gui-apt-key-result.png"/> </ul>

2a. Method 1- Add the Scribus Archive as a new Repository using Software Sources <ul> Go to System > Administration > Software Sources. The Software Sources window will open. Choose the 'Other Software' tab.</li> <img src="http://debian.scribus.net/images/softwaresourcesbefore.png"/> Click on the Add button. When the dialogue opens type (or copy and paste) the appropriate source line from the list at the top of this document into the text field. For example, if you are running Debian Unstable release you would type or paste "deb http://debian.scribus.net/debian/ unstable main non-free contrib" as shown in the screenshot below. For Ubuntu Lucid Lynx it would be "deb http://debian.scribus.net/debian/ lucid main non-free" and so on.</li> <img src="http://debian.scribus.net/images/aptline.png"/> Left click on the 'Add Source' button and follow the prompts to update the repository index. To check if all went well you should now see your Software Sources updated to look like this:</li> <img src="http://debian.scribus.net/images/softwaresourcesafter.png"/> If it does not look right then highlight the line and left click on the Edit button. Make any changes necessary to ensure it looks like this:</li> <img src="http://debian.scribus.net/images/editsource.png"/> Close down Software Sources.</li> 2b. Method 2 - Add the Scribus Archive to your package manager using Synaptic

Start Synaptic package manager (later "Synaptic").</li> Click on "Settings" &gt; "Repositories" (Figure 1).</li> </ul> <img src="http://debian.scribus.net/images/synaptic-main_window-settings_menu-edited.png" alt="Synaptic Settings Menu" /> Figure 1. Settings &gt; Repositories menu. <ul> Click on "New" and type or paste in the "URI", "Distribution", and "Section(s)" and click on "OK" (Figure 2).</li> </ul> <img src="http://debian.scribus.net/images/synaptic-unstable-repositories-edited.png" alt="Add a repository" /> Figure 2. Adding a repository. <ul> click on the "Reload" button in the toolbar and wait for the package database update to complete.</li> 3. Installing Scribus Using Synaptic Click on the "Search" toolbar button. A "Find" dialog window will open. Type "scribus" in the "Search" field and click on the "Search" button (Figure 3).</li> </ul> <img src="http://debian.scribus.net/images/search-window-edited.png" alt="Search dialog" /> Figure 3. Searching. <ul> The search should produce results similar to the following (Figure 4).</li> </ul> <img src="http://debian.scribus.net/images/search-result-scribus-edited.png" alt="Search results" /> Figure 4. Search results. <ul> Right-click on the package you'd like to install in the search results or click on the small square in the leftmost "S" column and select "Mark for Installation" (Figure 5).</li> </ul> <img src="http://debian.scribus.net/images/mark_for_installation-edited.png" alt="Mark for installation" /> Figure 5. Mark package for installation. <ul> You should see your chosen package marked for installation in the main synaptic window as indicated by a yellow arrow in the "S" column (Figure 6).</li> </ul> <img src="http://debian.scribus.net/images/marked_for_installation.png" alt="Marked for installation" /> Figure 6. Package is marked for installation. Click on the "Apply" button in the toolbar. You should see the following dialog window (Figure 7).</li> <img src="http://debian.scribus.net/images/apply_changes.png" alt="Apply changes" /> Figure 7. Apply changes summary. <ul> Click on the "Apply" button in the above dialog window. You should see a succession of messages indicating that the package is being downloaded and installed (Figures 8-9).</li> </ul> <img src="http://debian.scribus.net/images/installing_software.png" alt="Installing software" /> Figure 8. Package being downloaded. <ul> </ul> <img src="http://debian.scribus.net/images/installed_software.png" alt="Installed software" /> Figure 9. Package being installed. <ul> <li>Depending on your synaptic preferences you might have to click on the "Close" button or the installation progress window might close by itself. At the end you should see a green square in the column "S" in front of your chosen package in the main synaptic window (Figure 10).</li> </ul> <img src="http://debian.scribus.net/images/installed_software-main_window.png" alt="Finished" /> Figure 10. Main window after package installation. 2-3c. Using Adept package manger to install a Scribus package

For an alternative method using the "Adept" package manager found in Kubuntu see <a href="http://wiki.scribus.net/index.php/Getting_Scribus_on_Ubuntu/Kubuntu_up_and_running">Getting Scribus on Ubuntu/Kubuntu up and running.</a>

About the Scribus Archive There are following Scribus related packages in Debian and Ubuntu : Scribus applications and documentation: <ul> <li><a href="http://packages.qa.debian.org/s/scribus.html">scribus</a> (Scribus 1.3.3.x) - Stable branch. This is the recommended version to use at this time.</li> <li><a href="http://packages.qa.debian.org/s/scribus-doc.html">scribus-doc</a> Scribus 1.3.3.x documentation.</li> <li><a href="http://packages.qa.debian.org/s/scribus-ng.html">scribus-ng</a> (Scribus 1.3.5svn) - Developmental branch with new features and capabilities. Use if you really need the new features in development, but save your work often and <a href="http://bugs.scribus.net" target="_blank" title="Scribus Bug Tracking System">report bugs</a> when you encounter them. </li> <li><a href="http://packages.qa.debian.org/s/scribus-ng-doc.html">scribus-ng-doc</a> Scribus 1.3.5svn documentation.</li> </ul> Additional data, color profiles, templates, and auxillary applications: <ul> <li> <a href="http://packages.qa.debian.org/s/scribus-template.html">scribus-template</a> - Additional document templates. </li> <li><a 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 color profile-aware software. You must Install this package if you want to enable color management. </li> <li><a href="http://packages.qa.debian.org/l/lprof.html">lprof</a> Hardware color profiler tool for creating ICC profiles to be used with Scribus. </li> <li><a href="http://packages.debian.org/unstable/x11/qt3-qtconfig">qt3-qtconfig</a> allows users to configure the look and behavior of any Qt3 application - necessary to overcome some Ubuntu problems.</li> </ul> <ul> <li><a href="http://podofo.sourceforge.net/" target="_blank">podofo</a> is a library to work with the PDF file format. All our scribus-ng packages in the Scribus Archive are podofo-enabled.</li> </ul> <ul> </ul> Instructions on rebuilding the source packages are also applicable to other Debian derivatives and custom distributions not covered here. <a href="mailto:malex@scribus.info">Oleksandr Moskalenko</a> maintains a Scribus Team's Debiain/Ubuntu repository (Scribus Archive) that contains the newest "scribus", "scribus-doc", "scribus-ng", and "scribus-ng-doc" packages. Note that the only way to run latest Scribus versions on Debian/Stable and Ubuntu Gutsy/Hardy/Intrepid is to use Scribus Archive. Unfortunately, Ubuntu has a number of qt3 related problems (see <a href="http://wiki.scribus.net/index.php/Getting_Scribus_on_Ubuntu/Kubuntu_up_and_running">Getting Scribus on Ubuntu/Kubuntu up and running</a>), so we recommend using Debian to run Scribus. Only Debian/Unstable and Ubuntu/Intrepid have the newest 1.3.5svn based scribus-ng packages as other branches have too old Qt4 libraries. About this document This how-to has been originally created for Scribus Wiki page by the following Scribus Wiki users: malex, mhanski, Zero0w, JureCuhalev, Cbradney, and Joolsr. This page is licensed under <a href="http://creativecommons.org/licenses/by-sa/2.0/%20">CC BY-SA</a>.