Subversion Repositories Scribus

Rev

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

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