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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>How-to upgrade a gallery from igal to llgal?</title>
<link rel="stylesheet" type="text/css" href="main.css"/>
</head>
<body>
<h1 class="title">How-to upgrade a gallery from igal to llgal?</h1>
<p><em>
This upgrade documentation is available <a href="http://home.gna.org/llgal/">on-line</a>
and in the tarball and distribution packages.
</em></p>
<h2 class="part" id="filelocation">File location</h2>
<p>
<tt>igal</tt> places all files in the working directory with existing images.
</p>
<ul>
<li><tt>.captions</tt></li>
<li><tt>.indextemplate.html</tt></li>
<li><tt>.slidetemplate.html</tt></li>
<li><tt>.slide_<image></tt></li>
<li><tt>.thumb_<image></tt></li>
<li><tt>.tile.png</tt></li>
<li><tt>igal.css</tt></li>
</ul>
<p>
<tt>llgal</tt> moves all these files in a .llgal, making the starting dot useless.
<tt>.slide_<image></tt> is also replaced by <tt>.scaled_<image></tt>.
</p>
<ul>
<li><tt>.llgal/captions</tt></li>
<li><tt>.llgal/indextemplate.html</tt></li>
<li><tt>.llgal/slidetemplate.html</tt></li>
<li><tt>.llgal/scaled_<image></tt></li>
<li><tt>.llgal/thumb_<image></tt></li>
<li><tt>.llgal/tile.png</tt></li>
<li><tt>.llgal/llgal.css</tt></li>
</ul>
<p>
Note that earlier versions of <tt>llgal</tt> use <tt>.llgal.files</tt> instead of <tt>.llgal</tt>.
</p>
<h2 class="part">CSS style sheet</h2>
<p>
The CSS style sheet has been updated. If you modified it, you should probably
diff against the original <tt>igal.css</tt>, and apply the difference (by hand)
to <tt>llgal.css</tt>.
</p>
<h2 class="part">Command line options</h2>
<ul>
<li>
All long options (more than one character) now requires a double dash.
</li>
<li>
<tt>igal -clean</tt> is now <tt>llgal --cleanall</tt>
since <tt>llgal --clean</tt> only removes file that have not been modified.
</li>
<li>
Captions generation uses <tt>--gc</tt> instead of <tt>-c</tt>.
The caption is automatically used if it exists, <tt>-c</tt> is not used anymore.
Captions generation from filename is <tt>--cf</tt> instead of <tt>-C</tt>.
</li>
<li>
Do not show image counter in captions is now <tt>--nc</tt> instead of <tt>-x</tt>.
</li>
<li>
The film effect in the index of thumbnails is now disabled by default. Instead of
disabling it with <tt>-r</tt>, you may now enable it with <tt>--fe</tt>.
</li>
<li>
<tt>--sp</tt> and <tt>--tp</tt> options got removed.
But <tt>scaled_image_filenameprefix</tt> and <tt>thumbnail_image_filenameprefix</tt>
configuration options allow prefix modification.
</li>
<li>
<tt>-bigy</tt> (limit image height in slides) is replaced with <tt>--sy</tt>.
<tt>-y</tt> (limit thumbnail height) is replaced with <tt>--ty</tt>.
</li>
<li>
<tt>-t</tt> has been removed, the user just need to modify the <tt>tile.png</tt> image
to get an updated layout.
</li>
<li>
<tt>--con</tt> has been removed, image generation command line may now be configured
by changing scaled_create_command and thumbnail_create_command configuration options.
</li>
</ul>
<h2 class="part">How-to upgrade</h2>
<p>
If you don't care about processing time:
</p>
<ul>
<li>Save your <tt>.captions</tt> file if it exists</li>
<li>Note the command line you used when creating the gallery
(see in the header of <tt>index.html</tt>)</li>
<li>Remove everything but the images with <tt>igal -clean</tt></li>
<li>Create a <tt>.llgal</tt> directory and move your captions files inside
(remember it is now named <tt>captions</tt> instead of <tt>.captions</tt>)</li>
<li>Run <tt>llgal</tt> with same options (see section 3 for details)</li>
</ul>
<p>
Recomputing the whole gallery might be long, especially if you have tons of images,
since thumbnails (and scaled images if <tt>--bigy</tt>/<tt>--bigxy</tt> is passed)
have to be generated.
</p>
<p>
If you don't want to regenerate these, see section <a href="#filelocation">File location</a>
and move <tt>.thumb_*</tt> and <tt>.slide_*</tt> files
to <tt>.llgal/thumb_*</tt> and <tt>scaled_*</tt> so that llgal uses them.
</p>
<hr />
<p style="text-align: center">
<a href="http://validator.w3.org/check/referer">
<img src="http://www.w3.org/Icons/valid-xhtml11" alt="Valid XHTML 1.1!" class="icon" />
</a>
<a href="http://jigsaw.w3.org/css-validator/check/referer">
<img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" class="icon" />
</a>
<a href="http://validator.loulous.org/check?uri=referer">
<img style="border:0;width:88px;height:31px;" src="http://loulous.org/loulous.png" alt="Loulous
Compliant" />
</a>
</p>
<address id="addr">
The <a href="mailto:llgal-users AT gna.org">llgal team</a>.
</address>
<div id="modif">
$Id: upgrade.html,v 1.1 2006/05/07 09:21:15 bgoglin Exp $
</div>
</body>
</html>
|
