File: scripter2.html

package info (click to toggle)
scribus-doc 1.5.6.1%2Bdfsg-1
  • links: PTS, VCS
  • area: non-free
  • in suites: bullseye
  • size: 59,640 kB
  • sloc: xml: 767; python: 157; makefile: 14
file content (271 lines) | stat: -rw-r--r-- 11,235 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
	<title>Scripts Included With Scribus</title>
</head>
<style>
@import "manual.css";
</style>
<body>
<h2>Scripts Included With Scribus</h2>

<p>If you select from the menu Script &gt; About Script, you are presented with a file dialog to find the script you would like to find information about. This can be challenging to locate where these scripts are on your system. Here we will show the information about the scripts included with Scribus.</p>


<h3>Autoquote</h3>
<p>This script transforms typewriter quotes to typographic quotes for a large variety of language conventions.</p>
<p>USAGE</p>

<p>You must have a document open, and a text frame selected.</br>
There will be a valueDialog asking for your language for the quotes,</br> 
the default is 'en', but change the default to suit your needs.</br>
Detected errors shut down the script with an appropriate message.</p>


<h3>Autoquote2</h3>
<p>This is a variation on Autoquote, offering some additional features, including the option to have dialogs in French, and to add spaces between quotes and the text it surrounds.</p>
<p>CHANGELOGS<br/>
Original script is quotes.py or autoquotes.py<br/>
9 oct 2013 :<br/>
The algorithm has been slightly changed for determining<br/>
whether a quote is opening or closing<br/>
+ it provides the choice for the type of space to add :<br/>
none or non-breaking or thin or non-breaking thin<br/>
+ spaces are only added when not already there...<br/>
+ a french version of the dialogs is included<br/>
25 oct 2013 :<br/>
choice to change the spaces for already existing correct doublequotes<br/>
if 'none' is chosen, then existing spaces inside double quotes are deleted<br/>
+ take into account already existing doublequotes for the correct choice open / close of next dquote<br/>
+ warning if some open/close inconsistency is detected<br/>
for example in « texte " suite »<br/>
5 apr 2017 :<br/>
+ added new language choice of de-g: German with inverted guillemets for double quotes</p>

<p>LIMITS<br/>
- it only acts on the currently selected frame<br/>
(todo : acting on more than one selected frame,<br/>
or on whole chain of linked text frame would be nice).<br/>
- Spaces are not added outside of the quotes.<br/>
(that could be a job for another more general typographic tool)</p>

<p>USAGE</p>
<p>You must have a document open, and a text frame selected.<br/>
Run script from scribus menu (Script > Run script...)<br/>
There will be a dialog asking for the language for the quotes, <br/>
Detected errors shut down the script with an appropriate message.<br/>
A dialog then asks what is your choice as for spaces.<br/>
Follow indications and answer 0, 1, 2 or 3 <br/>
Another dialog asks whether you want the script to manage <br/>
existing correct doublequotes.</p>

<h3>CalendarWizard</h3>
<p>This is a simple 'Calendar creation wizard' for Scribus. It's a fully
rewritten Calendar.py from Scribus examples. Enjoy.</p>

<p>DESCRIPTION & USAGE:</p>
<p>This script needs Tkinter. It will create a GUI with available options<br/>
for easy calendar page creation. You'll get new pages with calendar<br/>
tables into a new document you are asked for. Position of the<br/>
objects in page is calculated with the "golden-ratio" aspect from the<br/>
page margins.</p>

<p>Steps to create:</p>
<ol> <li>Fill requested values in the Calendar dialog</li>
<li>You will be prompted for new document</li>
<li>You will be prompted for new paragraph style which will be used
       in calendar text frames. It could be changed later.</li>
</ol>
<p>There are 2 types of calendar supported:</p>
<ol><li>Classic calendar with one month matrix per page. I suggest
       here PORTRAIT orientation.</li>
<li>Horizontal event calendar with one week per page with huge place
       for human inputs. There should be LANDSCAPE imho.</li>
<li>Horizontal event calendar with one week per page with huge place
       for human inputs. There should be LANDSCAPE imho.</li>
</ol>
<p>But everything works with both orientations well of course too.</p>
<h3>Caption</h3>
<p>Creates a text frame (caption) in selected location relative to 
one or more selected frames.</p>

<p>USAGE</p>

<p>Select one or more object (can be any kind of frame, or even imported vector graphics), <br/>

run script. Dialog appears for choosing placement of all caption frames <br/>

B/T/R/L (Bottom/Top/Right/Left).<br/>

Bottom and Top caption frames are sized to width of parent object and height <br/>

of 24 points. Right and Left caption frames sized to 150 points width and <br/>

40 points height.</p>

<h3>color2csv</h3>
<p>ABOUT THIS SCRIPT:</p>

<p>Export Scribus Colors to CSV</p>

<p>color2csv.py allows a user to export  the colors of a given scribus document in a csv file.<br/>
  The file will be a text file with comma separated values in the following format:<br/>
"colorname", c,m,y,k <br/>

If there is a document opened in scribus, color2csv uses this document as color source.<br/>
  If there is no document opened in scribus, color2csv displays a file open dialog to allow<br/>
  the user to chose a scribus file to get the colors from.<br/>

Use csv2color to import the colors into a scribus document from a csv file.</p>

<h3>ColorChart</h3>
<p>ABOUT THIS SCRIPT:</p>

<p>ColorChart.py allows a user to create color charts with all<br/>
the colors of a given scribus document.<br/>
It generates a color field for each color and a description<br/>
of the color, containing the color name, the CMYK values and<br/>
the RGB values.<br/>

If there is a document opened in scribus, ColorChart uses this<br/>
document as color source and creates a new document with the<br/>
color chart.<br/>
If there is no document opened in scribus, ColorChart displays<br/>
a file open dialog to allow the user to chose a scribus file<br/>
to generate a colorchart of.<br/>
You will be asked to give a name for the color chart. This name<br/>
will be displayed in the pages headlines.</p>

<h3>csv2color</h3>
<p>ABOUT THIS SCRIPT:</p>

<p>Import Colors from a CSV file to Scribus<br/>

csv2color.py allows a user to import colors from a given csv file into a scribus document. <br/>
The file must be a text file with comma separated values in the following format:<br/>

"colorname", c,m,y,k <br/>

There must be a document opened in scribus where the colors can be defined in. <br/>
  If the csv contanins one or more color names that already exist in the document,<br/>
  the colors will be imported with a `*` as prefix.<br/>

  This script is especially helpful if you want to use CMYK color representations of<br/>
  color systems like HKS, Pantone or RAL in Scribus. Lots of such CMYK translation tables <br/>
  can be found on the Web. <br/>
  One can easily copy such a table into a text file, save it in the obove described format<br/>
  and import it into a scribus document.<br/>

Use color2csv to export the colors from a scribus document into a csv file.</p>

<h3>DirectImageImport</h3>
<p>This script imports an image and places it on current page.<br/>
Image frame is adapted to the picture and set to non-proportional mode,<br/>
so some distortion may be seen after import.<br/>

To enlarge the image proportionally, press CTRL key while editing.<br/>

Tested with scribus 1.3.3.3<br/>

Author: Konrad Stania<br/>

some modifications 2009 by Gregory Pittman, tested on Scribus 1.3.3.13svn<br/>

This newer version uses the Python Imaging Library to get the dimensions of the<br/>
image to be imported, and adjusts the frame accordingly. Initially the frame will<br/>
be created centered, at 80% of the page's width or height, whichever is smaller. <br/>
There is an adjustment to 80% of the height of the page in case this is exceeded <br/>
by the initial calculation.<br/>

<p>USAGE:</p>

<p>You must have a document open. Run the script, a dialog asks you to choose an<br/>
image to load. A proportional frame is automatically created and image loaded, <br/>
then adjusted to frame size.</p>

<h3>FontSample</h3>
<p>DESCRIPTION & USAGE:</p>
<p>This script needs Tkinter. It will create a GUI with an alphabetical list<br/>
of fonts using the names as they will be shown in Scribus. User can select<br/>
one or more fonts and create an example sheet(s) to print or create a PDF<br/>
from. It is heavily commented to make it easier for the user to adjust it<br/>
for his / her own needs.<br/>

Note: this version needs read/write access to .scribus directory in users<br/>
home. You will also need Python Imaging Library (PIL) installed.<br/>
If your system does not meet these requirements then change showPreviewPanel<br/>
to a value of 0. This will disable the new preview features.</p>

<h3>importcsv2table</h3>
<p>ABOUT THIS SCRIPT:</p>

<p>Import CSV data files as tables into Scribus</p>
<ol>
<li>Create any frame of any size on your page but positioned 
where you want the table to be located (upper left corner)</li>

<li>Make sure it is selected</li>

<li>Execute this script:<br/>

You will be prompted first for the width of the left column in mm,
then the right column in mm, then height of all cells, and finally
for a csv filename</li>

<li>The data from the csv file will be imported and a table of
textboxes will be drawn on the page.</li>
</ol>
<p>LIMITATIONS:</p>
<ol>
<li>You are limited to two-column CSV data in your file.</li>

<li>In Scribus versions 1.3.5svn, when the script ends, you cannot
adjust text, colors, and line features for a group, whereas in 1.3.3.x,
all of these can be done without ungrouping.</li>
</ol>
<p>HINTS:</p>

<p>Postgresql:<br/>
You can easily create a CSV file with a Postgresql database. From Postgresql,<br/>
toggle unaligned output with the '\a' switch, then activate a comma as<br/>
a separator with '\f ,' (without apostrophes). Send output to a file<br/>
with '\o myfile.csv', then query your database.</p>

<p>Sqlite3:<br/>
You can use "sqlite3 -csv" in the command line or ".mode csv" in sqlite's<br/>
interactive shell.</p>

<h3>InfoBox</h3>
<p>A simple script for exact placement of a frame (infobox)
over the current textbox,<br/> asking the user for the width
of the infobox and in which column to place it.</p>

<p>Some enhancements:</p>
<ul>
<li>You can now create a text frame or an image frame, and also load
an image.</li>

<li>More than one infobox can be added to a text frame by repeatedly running
  the script (ie, no name conflicts occur).</li>

<li>Height and Y-Pos of top of infobox can be specified.</li>

<li>Works with any page unit - pts, mm, in, and picas, cm, and even ciceros.</li>

<li>Infobox has Text Flows Around Frame activated, also
  Scale Image to Frame for images.</li>

<li>If you load an image with the script, an exactly correct frame height is made.</li>
</ul>
<p>USAGE</p>

<p>Select a textframe, start the script and have phun<br/>
Default name for the infobox is 'infobox' + name_of_selected_frame,
but this can be changed.</p>

<h3>Ligatursatz</h3>
<p>Unfortunately, this script has no usage information. It appears to be designed to<br/>
  automatically create ligatures from certain letter combinations, in particular<br/>
  for the German language.</p>
</body>
</html>