Subversion Repositories Scribus

Rev

Rev 8367 | Rev 12249 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
11401 mrdocs 1
This is Scribus Version 1.3.3.11, the fourteenth release of the 1.3.x development
8356 mrdocs 2
series. We have stablized 1.3.3.x and now consider his our stable release.
3
Scribus 1.2.x is deprecated.
1065 cbradney 4
 
1557 craig 5
CHANGES 1.2.x to 1.3.x
6
======================
7
 
3290 mrdocs 8
Important notes on the differences between 1.2.x and 1.3.x:
1231 mrdocs 9
 
1556 craig 10
1) Because of the new file format features, Scribus documents saved in 1.3.x
11
   are *not* backwardly compatible.
1231 mrdocs 12
 
1556 craig 13
2) Because of the new enhanced menu/keyboard shortcuts code, 1.2.x  keyboard
14
   short cuts are not migrated and will need to be recreated once on the first
3961 mrdocs 15
   launch 1.3.x.
1499 mrdocs 16
 
4415 mrdocs 17
3) On initial launch, 1.3.x will offer to convert preferences to the new 1.3.x
1556 craig 18
   format. This is recommended. Scribus 1.3.x will store its preferences
4415 mrdocs 19
   separately from 1.2.x. Moreover, 1.3.2 caches available fonts. The first
20
   startup may take longer than anticipated.
1231 mrdocs 21
 
4415 mrdocs 22
 
1556 craig 23
4) You *can* install both versions in parallel and run them at the same time.
2815 mrdocs 24
   The only caveat is to install them using different prefix/ directories e.g
1556 craig 25
   1.2 in /usr/local and 1.3 in /opt or $home/bin. You can use the --prefix
26
   argument to configure to set where Scribus should be installed.
1231 mrdocs 27
 
4023 mrdocs 28
Additionally, Scribus uses a different way to find fonts from Scribus 1.1.1.
1556 craig 29
To convert older( =< 1.1.1) documents follow the procedure below:
1231 mrdocs 30
 
238 Franz 31
1) Create a document with the old Version of Scribus containing all your Fonts.
68 Franz 32
2) Open the new Scribus and go to the Font Substitution List.
1065 cbradney 33
3) Clear out all current substitutions.
1556 craig 34
4) Open the Document created in 1) and substitute all the fonts with the
1065 cbradney 35
   correct new fonts.
68 Franz 36
 
1231 mrdocs 37
When you now open old documents Scribus will convert all font names
238 Franz 38
automatically.
39
 
8356 mrdocs 40
Scribus 1.3.3.8 includes support for building via CMake, a replacement
7249 mrdocs 41
for traditional autotools.
42
Please see:http://docs.scribus.net/index.php?lang=en&page=install4 for details.
43
 
1557 craig 44
For detailed changes please see the ChangeLog.
3 paul 45
 
1556 craig 46
To use Scribus in your native language be sure that the environment variable
47
LC_ALL, LC_MESSAGES, LANG, Qt locale, OR the command line option
2815 mrdocs 48
of -l/--lang <lang> is set correctly. This is also can be changed in the preferences
49
 and takes effect immediately.
3 paul 50
 
5020 mrdocs 51
The EPS/PS import feature again improved in 1.3.3 uses advanced features of Ghostscript.  We
1556 craig 52
recommend ALL users update to the newest version of Ghostscript available for
3290 mrdocs 53
your distribution. In addition, if you still have GS 7.0x, there are detailed hints on
1556 craig 54
docs.scribus.net for installing GS 8.x in parallel to the GS installed by your
2815 mrdocs 55
distribution.
302 Franz 56
 
5020 mrdocs 57
The current importer will now import raster images within an EPS file provided you have at
58
least GS 8.15, with the current limitations:
59
 
60
* imagemask doesn't work correctly
61
* clip path is ignored
62
* creates one file for each bitmap, which can be a lot
63
 
1556 craig 64
Activating Color Management *requires* installation of CMYK and RGB ICC
1231 mrdocs 65
profiles. Please see the included help files, FAQ's on www.scribus.net and
3683 mrdocs 66
http://docs.scribus.net for details. As of the 1.3.1 release,  Scribus ships with
3290 mrdocs 67
2 icc profiles, which are installed only to enable color management functionality.
3961 mrdocs 68
The profiles *do not* provide meaningful color management for printing. Additional
69
profiles are downloadable from www.scribus.net and depend on your hardware and
3290 mrdocs 70
printing environment.
3 paul 71
 
238 Franz 72
Other notes/known issues at the time of release:
73
 
74
There is a bug in font outline handling for some fonts in the freetype
75
libraries. It's being worked on upstream. Don't file a bug report. Instead
1556 craig 76
change the font used if you need the outlines. This is not a Scribus bug.
4415 mrdocs 77
Some testing has shown that this bug is not present in freetype 2.1.10+, but
388 Franz 78
we counsel caution trying to upgrade freetype2. Upgrading freetype2 on some
2815 mrdocs 79
distributions can be quite difficult.
238 Franz 80
 
3290 mrdocs 81
PSD/CMYK TIFF Support
82
 
6017 mrdocs 83
1.3.3+ now has support for CMYK PSD and 8-bit CMYK TIFF support. RGB PSD and
3290 mrdocs 84
16-bit TIFF support is being developed. PSD and TIFF support includes layers, ICC
5048 mrdocs 85
profiles and embedding clipping paths. CMYKA is not yet supported as there is a
6919 mrdocs 86
limitation in the Qimage class. RGBA is supported. Current Scribus 1.3.4cvs does
87
handle a much larger variety of CMYKA files along with advanced PSD features.
3290 mrdocs 88
 
1849 mrdocs 89
Issue with gradients:
90
 
4415 mrdocs 91
If you have gradient (e.g. with black color) with 50% shade in both beginning
92
 and end of gradient, you end up with darker center than edges. One expects
93
the gradient to have equal shading from beginning to end, especially if there
94
 is no other color-stops in-between them. This we believe is a libart issue
95
 and not fixable by us. The gradient will export and print properly.
96
 The optional cairo build is a compile time option. The is enabled by:
97
./configure --enable-cairo
8356 mrdocs 98
The cairo build option is optional, has not received all the needed
99
 regression tests and requires cairo 1.2.x+ or greater.
100
Cario 1.2.x+ is strongly recommended.
1849 mrdocs 101
 
4415 mrdocs 102
Our experimental Cairo build does not have these issues.  We encourage those
103
 willing to test the Cairo backend builds and report issues to the mailing
104
list and/IRC. We *know* the Cairo enabled build is slower, but are encouraged
105
 by the on-going development by the Cairo team.
1849 mrdocs 106
 
3465 mrdocs 107
FONT ISSUES
108
===========
109
 
110
There are extensive notes and detailed on documentation on fonts and trouble
111
shooting of font issues in the help documentation and online at
112
http://docs.scribus.net  Please read these carefully before filing bugs.
113
 
114
There are issues with the postscript naming conventions with the Computer Modern
115
Type 1 fonts, depending on distribution.  In some cases, not all fonts from the
116
same family are visible in Scribus. We are working on a more complete solution
117
for the next release.
118
 
119
 
120
 
2084 craig 121
BUILDING AND INSTALLING FROM SOURCE
122
===================================
123
 
124
Please see the files `BUILDING' and `INSTALL' for details on how to compile and
125
install Scribus, library requirements, etc.
126
 
2410 craig 127
GHOSTSCRIPT
128
===========
129
 
3290 mrdocs 130
One of the more crucial tools Scribus depends on is Ghostscript. While it is
2410 craig 131
not required for compilation, Scribus must be able to find a recent version of
3290 mrdocs 132
Ghostscript at runtime for all features to be present and fully working. In
2410 craig 133
particular, printing, print preview, and PDF/EPS import will not be fully
5614 mrdocs 134
functional without Ghostscript. Ghostscript 8.5x is STRONGLY recommended.
2410 craig 135
Support for versions older than 7.07 is untested and Scribus may not operate
136
reliably using such an old version of gs.
137
 
3290 mrdocs 138
You can get a new version of Ghostscript from http://www.ghostscript.com/ .
139
There is documentation on how to install a new version of Ghostscript on the
2410 craig 140
Scribus website:
141
    http://docs.scribus.net/index.php?lang=en&sm=dtptoolbox&page=toolbox7
142
or you can just download it and install it in /usr/local, then set your PATH.
143
 
144
If you're compiling Scribus yourself, it will whine at you during configure if
3290 mrdocs 145
it notices an older version of Ghostscript, or can't find it at all. If you
2410 craig 146
know you have a newer version installed, run `gs --version' and (on bash)
147
`which gs' to check what version is being used and where it's installed. You
148
may need to tweak your PATH environment variable to find the newer version
3290 mrdocs 149
instead. Note that you can set which version of Ghostscript Scribus uses, and
2410 craig 150
where to find it, in the Scribus preferences.
151
 
3290 mrdocs 152
Debian users who haven't installed their own newer version of Ghostscript may
2410 craig 153
want to install gs-afpl then use:
154
    `update-alternatives --config gs'
3290 mrdocs 155
as root to select gs-afpl as the default version of Ghostscript to use.
2410 craig 156
 
2815 mrdocs 157
DISTRIBUTION AND OS SPECIFIC NOTES
1557 craig 158
=====================
388 Franz 159
 
7812 mrdocs 160
For MacOSX, OS/2 and Windows Please also see the specific platform notes as
161
well.
162
 
1557 craig 163
Debian
164
======
238 Franz 165
 
166
If Scribus does not start while complaining about the absence of
3290 mrdocs 167
Postscript fonts please install either xfonts-scalable or gsfonts-x11.
238 Franz 168
They are in the "Recommends" and will be installed by all sensible apt
169
front-ends.
170
 
2410 craig 171
Also see the section entitled `GHOSTSCRIPT'.
172
 
3979 mrdocs 173
SuSE 9.x/10.0
1557 craig 174
========
175
 
1231 mrdocs 176
1)The littlecms libs 1.10, which shipped with 9.0 does not offer complete
177
  support for all the the latest CMS features in Scribus 1.2+. There are updated
1065 cbradney 178
  SuSE 9.x RPM's available on the Scribus.net site. We also recommend using the
179
  latest version of lcms.
238 Franz 180
 
1231 mrdocs 181
2)If you are using Qt 3.3.x, please ensure you are using the latest Qt 3.3.2-2+
1065 cbradney 182
  rpms. The -2+ versions have an important fix for drag and drop in Scribus.
238 Franz 183
 
1556 craig 184
3)To enable direct CUPS support which recommended, make sure both cups-devel
1636 craig 185
  and openssl-devel are installed. Suse enables ssl support in CUPS. The
4911 mrdocs 186
  current Scribus config checks do not test for this. See the BUILDING file
187
  for details.
3683 mrdocs 188
4)There is an issue with certain dialogs in Scribus with Suse 9.3 and 10.0
189
 and Yes, No order. This is adressed in:
190
 https://bugzilla.novell.com/show_bug.cgi?id=119090
3961 mrdocs 191
 
238 Franz 192
 
1557 craig 193
Red Hat / Fedora
194
================
195
 
1556 craig 196
Fedora/RH users are recommended to have at least Qt 3.3.2-6. These have
197
important fixes for Scribus. The Scribus RPMS in Fedora Extras are of very high
198
quality and have been created with close cooperation from Fedora maintainers
199
and the Scribus Team. We recommend them for most users as they will ensure
200
correct integration with the menuing system and mime types.
1065 cbradney 201
 
3683 mrdocs 202
There are no packages for LittleCMS or a recent Ghostscript in Fedora Core ,
1910 mrdocs 203
though LittleCMS (lcms) is in Fedora Extras. Please see the included help files
2084 craig 204
and http://docs.scribus.net for details.
1910 mrdocs 205
Grey scale icc profiles in images are not supported in this release..
1557 craig 206
 
1910 mrdocs 207
There is a separate file, PACKAGING for detailed hints and notes on building
1868 mrdocs 208
packages for Scribus.
209
 
2555 craig 210
On Fedora, if you report a crash bug, it would be extremely handy if you could
211
build a debug version of Scribus (--enable-debug to configure) and get a stack
212
trace. This is not required, but does help us diagnose the problem more quickly
213
and reliably. Some information on stack traces can be found here:
2084 craig 214
 
2555 craig 215
http://fedora.linux.duke.edu/wiki/StackTraces
216
 
217
Mac OS X
218
========
219
 
220
There is also information about building and using Scribus on Mac OS X on the
2084 craig 221
Scribus wiki: http://wiki.scribus.net/ .
222
 
2555 craig 223
A Mac OS X native Aqua port is in early testing. More information can be found
224
on http://aqua.scribus.net/ .
2084 craig 225
 
226
Microsoft Windows
227
=================
228
 
4415 mrdocs 229
There is a separate readme for Windows, please see readme-win32.html
2084 craig 230
 
1557 craig 231
Additional information
232
======================
233
 
2815 mrdocs 234
More hints and other information are on the www.scribus.net and docs.scribus.net
1065 cbradney 235
sites. Full compile, install and FAQ's are available there.
236
 
237
There is a lively on-line community, both on IRC @ #scribus on irc.freenode.net
1557 craig 238
and the mailing list. Mailing list info can be found at:
1065 cbradney 239
 http://nashi.altmuehlnet.de/mailman/listinfo/scribus
240
 
1636 craig 241
Thanks to the many translators, testers, packagers and contributors who make
242
the Scribus community so special.
1231 mrdocs 243
 
302 Franz 244
For the Scribus Team,
3290 mrdocs 245
Craig Ringer
1065 cbradney 246
Peter Linnell
8356 mrdocs 247
in February 2007