home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 November / CPNL0711.ISO / beeld / teken / scribus-1.3.3.9-win32-install.exe / BUILDING < prev    next >
Text File  |  2007-03-24  |  13KB  |  317 lines
  1. Generic build instructions are available in the INSTALL file. Please read these
  2. notes below for Scribus-specifc information plus notes about compiling Scribus on
  3. particular distributions and operating systems.
  4.  
  5. CMake Build
  6. ====================
  7.  
  8. Scribus 1.3.3.6+ and Scribus 1.3.4 plus have an optional build system which
  9. replaces the traditionally used so called autotools. CMake (cmake.org) is 
  10. a modern, cross-platform replacement for autotools. 
  11.  
  12. Please see install4.html or http://docs.scribus.net/index.php?lang=en&page=install4
  13. for details *after* reviewing the build requirements below.
  14.  
  15.  
  16.  
  17. REQUIREMENTS AND BUILDING - *BSD/Linux/*nix
  18. =========================
  19.  
  20. You must install the libraries listed below BEFORE running configure or
  21. compiling Scribus:
  22.  
  23. Requirements:
  24.     Qt >= 3.3 (3.3.7+ recommended)
  25.     Freetype >= 2.1.3 (2.2.1+ strongly recommended)
  26.     libart >= 2.3.10+ (2.3.17+ recommended)
  27.     libtiff >= 3.6.0
  28.     LittleCMS (liblcms) = 1.12 (1.15+ recommended)
  29.     libjpeg (depending on how Qt is packaged)
  30.     libpng
  31.  
  32. If you are installing from distro packages, the base package is NOT ENOUGH. You
  33. MUST also install the -dev or -devel package, or Scribus can not use the
  34. library.
  35.  
  36.  
  37. Recommended:
  38.     CUPS
  39.     Fontconfig >= 2.0
  40.     LibXML2 >= 2.6.0
  41.     GhostScript >= 8.0 (8.15 or greater preferred)
  42.     Python >= 2.3
  43.     tkinter for the font sampler script
  44.     python-imaging for the font sampler preview
  45.     pkgconfig (to assist finding other libraries)
  46.  
  47.  
  48.  
  49. If any recommended libraries (and their dev/devel packages or headers) are not
  50. installed, some features will be disabled by configure. If you later install
  51. any of these dependencies, you will have to re-run configure and re-compile
  52. Scribus before the features are enabled.
  53.  
  54. LIBRARIES IN NON-STANDARD LOCATIONS
  55. ===================================
  56.  
  57. You can skip this section unless:
  58.     (a) You have libraries installed in unusual locations such as your home
  59.         directory or an add-in package collection (eg fink); or
  60.     (b) Scribus is not finding libraries that you KNOW you have installed
  61.         (remember the -dev/-devel package if applicable).
  62.  
  63. If any of your libraries are in non-standard locations and not on the same
  64. --prefix as you're configuring Scribus with, you will need to set some extra
  65. environment variables when configuring and compiling Scribus to ensure that
  66. configure and gcc can find all the required information. Where
  67. /home/fred/libfred is the path to the the directory the lib was installed to
  68. (--prefix), eg /usr/local or /home/fred/libfred (*NOT* the lib/ subdirectory
  69. the actual library file is in), the following commands to bash should do the
  70. trick:
  71.  
  72.     instdir=/home/fred/libfred
  73.     export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:${instdir}/lib/pkgconfig"
  74.     export LIBRARY_PATH="${LIBRARY_PATH}:${instdir}/lib"
  75.     export LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:${instdir}/lib"
  76.     export CPATH="${CPATH}:${instdir}/include"
  77.     export PATH="${PATH}:${instdir}/bin"
  78.  
  79. In most cases, you can get away with just some of them for any given lib, but
  80. setting all of those means any of the several methods of finding libraries that
  81. might be used should work. These requirements are standard for pretty much any
  82. package, they are not specific to Scribus - it's just most packages don't
  83. bother to explain this to you ;-)
  84.  
  85. If you have more than one collection of libraries, simply repeat the above
  86. commands for each additional location.
  87.  
  88. In general, you should not add "-I/path" directives to `CXXFLAGS', `CPPFLAGS',
  89. or `CFLAGS'; that's what `CPATH' is for. Similarly, use `LIBRARY_PATH' rather
  90. than adding "-L/path" to `LDFLAGS' when trying to get `ld' to find a library.
  91.  
  92. `LD_LIBRARY_PATH' may also need to be set when running Scribus later. To avoid
  93. this requirement under Linux, add the library path to `/etc/ld.so.conf' (on its
  94. own line, nothing but the path, eg "/home/fred/libfred/lib" without the quotes)
  95. and run ldconfig as root. Other operating systems have other requirements.
  96.  
  97. MacOS/X users may need to set `DYLD_LIBRARY_PATH' as well as `LD_LIBRARY_PATH'.
  98.  
  99. Note that Scribus's build scripts will always find a library installed to the
  100. same --prefix as Scribus its self ; no special configuration should be required
  101. in that case.  Any failure to do so is a bug and should be reported on
  102. http://bugs.scribus.net/ .
  103.  
  104. REQUIREMENTS - DETAILS
  105. ======================
  106.  
  107. We strongly recommend having Qt 3.3.6+. Qt 3.3 is now the *minimum*. Older
  108. versions of Qt are *not* supported. If you build Qt from sources, the
  109. recommended ./configure switches are the same as used by KDE. Use of other
  110. switches aside from those used by distro packages can make trouble shooting
  111. issues very difficult at times.
  112. See: http://developer.kde.org/build/compile_kde3_3.html
  113.  
  114. Scribus requires Freetype. If you are compiling from source, you will need to
  115. have the freetype headers installed - these can usually be found in a -devel
  116. package for your distro.
  117.  
  118. It is strongly recommended that you install the CUPS development packages if
  119. you are compiling Scribus. Without CUPS, Scribus will have significantly
  120. reduced printing functionality.
  121.  
  122. Fontconfig, if installed, will let Scribus find fonts using the same method as
  123. most other major desktop applications such as all KDE and GNOME applications.
  124. If fontconfig support is installed, Scribus will not search your X font path, X
  125. server configuration, or X font server configuration for fonts - it will only
  126. use fonts found using fontconfig and any custom font locations configured in
  127. the preferences.
  128.  
  129. Python will be used to add scripting support to Scribus. If Python is not
  130. found, or there are no header files for Python installed (usually because you
  131. haven't installed the development package), the scripting support will not be
  132. enabled.
  133.  
  134. See the distro-specific notes below for more information on installing and
  135. using Scribus with your distro.
  136.  
  137. If you have a 64-bit version of Qt, sometimes ./configure will not detect the 
  138. 64-bit version headers. Try : ./configure --enable-libsuffix=64 to test for 64-bit 
  139. versions of libraries.
  140.  
  141. If you're on an AMD64 Linux distro and configure can't find Python, try using the argument:
  142.     --with-extra-libs=/usr/lib64
  143. to configure.
  144.  
  145. TROUBLESHOOTING
  146. ===============
  147.  
  148. If Scribus can't find a library, there are several things you should do.
  149. First of all, read `DISTRO SPECIFIC BUILD INFORMATION' below and see if
  150. there's anything there for your OS / distro.
  151.  
  152. Next, ensure you definitely have the library installed, as well as any
  153. additional development packages that may be required to use it.  On Linux, make
  154. sure to install the "-dev" or "-devel" package for the missing library. After
  155. doing this, re-run configure.
  156.  
  157. If the library is still not found, please read and act on the section above,
  158. entitled `LIBRARIES IN NONSTANDARD LOCATIONS'. Check that all those environment
  159. variables are set to sensible values. If you are using any other custom CFLAGS,
  160. LDFLAGS, CXXFLAGS, CPPFLAGS, etc, then unset or disable them unless you're really
  161. sure you know what you're doing. This is doubly true for "optimisation" flags
  162. like -mcpu and -march .
  163.  
  164. If you're still having problems, have a look at config.log (in the same
  165. directory as configure) and see if you can tell what the problem is. You'll
  166. probably want to use some sort of search command to look for the name of the
  167. library that's not being found - config.log is *long*.
  168.  
  169. If you're still unable to determine what the problem is, please post a message
  170. to the Scribus mailing list or report a bug on bugs.scribus.net. If you report
  171. a bug, please attach a gzipped copy of config.log. If posting to the mailing
  172. list, DO NOT attach config.log - but if possible, please post it on a website
  173. or somewhere else we can get to it and provide the address. Otherwise, just
  174. email it if someone asks for it. In any problem report, MAKE SURE YOU INCLUDE
  175. THE FOLLOWING INFORMATION:
  176.     - Operating system or distro, eg "Mac OS X" or "Debian Linux"
  177.     - OS or distro version, eg "Panther" or "Fedora Core 3". This is NOT the
  178.       Linux kernel version, though you can provide that too.
  179.     - Scribus version you're trying to compile, eg "1.2.1" or "1.3 cvs". If
  180.       you're building CVS, please make sure you've run "cvs up -Pd -C" (this
  181.       WILL erase any patches / custom changes you've made) then re-built
  182.       starting at "make -f Makefile.cvs" before reporting a problem. If
  183.       you're using a snapshot or CVS, please tell us when you downloaded
  184.       it (eg "todays CVS snapshot").
  185.     - What compiler you're using. You can get this from `gcc --version'.
  186.       if you're using gcc.
  187.     - If you're having problems with a particular library, what version
  188.       of the library you have installed and where you got it from. eg:
  189.       "freetype 2.0.1 from sunfreeware,"
  190.       "LittleCMS 1.1.4, compiled myself and installed in /usr/local,"
  191.       "freetype 2.1.3 from backports.org,"
  192.       "fontconfig 2.2.0 (stock Fedora Core 3 devel package)"
  193.       "I installed the qt-3.0.1.rpm and qt-devel-3.0.1.rpm from the CD."
  194.     - Check again to make REALLY REALLY SURE you have the devel package
  195.       installed.
  196.     - Any environment variables you may have set
  197.     - Anything else you can think of that might be useful. There's no
  198.       such thing as too much information, though please put big files
  199.       elsewhere rather than sending them to the mailing list.
  200.  
  201. It's best if you do a search of the mailing list archives and/or
  202. bugs.scribus.net before reporting a problem, too. This is doubly true for
  203. development versions of Scribus.
  204.  
  205. DISTRO SPECIFIC BUILD INFORMATION
  206. =================================
  207.  
  208. This section contains information about compiling Scribus that's specific to
  209. particular operating systems and Linux distros. More distro-specific
  210. information can be found in the README.
  211.  
  212. Debian
  213. ======
  214.  
  215. Recommended packages for compiling from source on Sarge (Debian 3.1):
  216.     libqt3-mt-dev (Required)
  217.     libfreetype6-dev (Required)
  218.     libart-2.0-dev (Required)
  219.     libcupsys2-dev
  220.     liblcms1-dev
  221.     libfontconfig1-dev
  222.     libtiff4-dev
  223.     libxml2-dev
  224.     python2.3-dev  or  python2.4-dev
  225.     gs-afpl
  226.  
  227. You are unlikely to be able to compile Scribus 1.3.x on Debian 3.0 (Woody)
  228. without significant upgrades; it is not at all recommended. Scribus 1.3.x
  229. should be considered not to support Debian Woody.
  230.  
  231. More info can be found in the README.
  232.  
  233. Red Hat / Fedora
  234. ================
  235.  
  236. Recommended packages for compiling from source on FC4 / FC5
  237.     libstdc++-devel (Required)
  238.     gcc-c++ (Required)
  239.     qt-devel (Required)
  240.     freetype-devel (Required)
  241.     libart_lgpl-devel (Required)
  242.     fontconfig-devel
  243.     cups-devel
  244.     libtiff-devel
  245.     libxml2-devel
  246.     python-devel
  247.     lcms-devel
  248.     libpng-devel
  249.     libjpeg-devel
  250.  
  251. You can install these packages with 'yum install packagename' as root. You may
  252. need to run up2date first to set up your yum configuration (not required on
  253. FC4). Be patient - the first time you run yum it may take a long time to
  254. download the headers for all the security updates that have been released.
  255.  
  256. You may also need to 'export QTDIR=/usr/lib/qt-3.3' before running
  257. configure or make.
  258.  
  259. More info can be found in the README.
  260.  
  261. Suse/Opensuse
  262. ====
  263.  
  264. Recommended packages for compiling from source on SuSE 9.x/10.x:
  265.     qt3-devel (required)
  266.     libart_lgpl-devel (required)
  267.     freetype2-devel (required)
  268.     fontconfig-devel
  269.     liblcms-devel
  270.     libtiff-devel
  271.     libxml2-devel
  272.     libpng-devel
  273.     libjpeg-devel
  274.     cups-devel
  275.     openssl-devel (required if CUPS support is needed) 
  276.     libpng-devel
  277.     libjpeg-devel
  278.     update-desktop-files
  279.     python-devel
  280.     tk
  281.     python-imaging
  282.  
  283. You can install these packages using YaST. You may find it difficult to compile Scribus 1.3.x
  284. on anything older than Suse 9.1. In addtion, you are recommended to have the updated KDE/Qt
  285. packages which are provided as supplemental from ftp.suse.com or mirrors.
  286.  
  287. Mac OS X
  288. ========
  289.  
  290. No detailed build instructions yet. Please see the README for info on MacOS/X.
  291.  
  292. Fink or a similar package collection will generally be required for compiling
  293. Scribus. Scribus requires several libraries that do not come with Mac OS X,
  294. and a few where the version in Mac OS X is too old.
  295.  
  296. Mac OS X users will want a copy of freetype that was configured with
  297. --enable-old-macfonts . The Mac OS X bundled Freetype is too old, and the one
  298. that comes with Fink is not (at time of writing) configured that way. You'll
  299. need to compile your own copy of Freetype, then use --with-extra-includes and
  300. --with-extra-libs or environment variables to tell configure where to find it.
  301.  
  302. See `LIBRARIES IN NON-STANDARD LOCATIONS' for additional instructions. /sw is
  303. a "non standard location" that won't be searched by most of the tools configure
  304. uses, so you must tell Scribus about it.
  305.  
  306. Microsoft Windows
  307. =================
  308.  
  309. No build instructions yet. Please see the README for info on Scribus under
  310. Windows.
  311.  
  312. Other distros/OSes
  313. ==================
  314.  
  315. Please feel free to submit a list of package names and versions required to
  316. compile Scribus on your distro, or build instructions for your OS.
  317.