Subversion Repositories Scribus

Rev

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

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