Debian Codegraph @

doc/upgrade.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4 <head>
5 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
6 <title>How-to upgrade a gallery from igal to llgal?</title>
7 <link rel="stylesheet" type="text/css" href="main.css"/>
8 </head>
9 <body>
10
11 <h1 class="title">How-to upgrade a gallery from igal to llgal?</h1>
12
13 <p><em>
14 This upgrade documentation is available <a href="http://bgoglin.free.fr/llgal/">on-line</a>
15 and in the tarball and distribution packages.
16 </em></p>
17
18
19
20 <h2 class="part" id="filelocation">File location</h2>
21
22 <p>
23 <tt>igal</tt> places all files in the working directory with existing images.
24 </p>
25 <ul>
26 <li><tt>.captions</tt></li>
27 <li><tt>.indextemplate.html</tt></li>
28 <li><tt>.slidetemplate.html</tt></li>
29 <li><tt>.slide_&lt;image&gt;</tt></li>
30 <li><tt>.thumb_&lt;image&gt;</tt></li>
31 <li><tt>.tile.png</tt></li>
32 <li><tt>igal.css</tt></li>
33 </ul>
34
35 <p>
36 <tt>llgal</tt> moves all these files in a .llgal, making the starting dot useless.
37 <tt>.slide_&lt;image&gt;</tt> is also replaced by <tt>.scaled_&lt;image&gt;</tt>.
38 </p>
39 <ul>
40 <li><tt>.llgal/captions</tt></li>
41 <li><tt>.llgal/indextemplate.html</tt></li>
42 <li><tt>.llgal/slidetemplate.html</tt></li>
43 <li><tt>.llgal/scaled_&lt;image&gt;</tt></li>
44 <li><tt>.llgal/thumb_&lt;image&gt;</tt></li>
45 <li><tt>.llgal/tile.png</tt></li>
46 <li><tt>.llgal/llgal.css</tt></li>
47 </ul>
48
49 <p>
50 Note that earlier versions of <tt>llgal</tt> use <tt>.llgal.files</tt> instead of <tt>.llgal</tt>.
51 </p>
52
53
54
55 <h2 class="part">CSS style sheet</h2>
56
57 <p>
58 The CSS style sheet has been updated. If you modified it, you should probably
59 diff against the original <tt>igal.css</tt>, and apply the difference (by hand)
60 to <tt>llgal.css</tt>.
61 </p>
62
63
64
65 <h2 class="part">Command line options</h2>
66
67 <ul>
68 <li>
69 All long options (more than one character) now requires a double dash.
70 </li>
71 <li>
72 <tt>igal -clean</tt> is now <tt>llgal --cleanall</tt>
73 since <tt>llgal --clean</tt> only removes file that have not been modified.
74 </li>
75 <li>
76 Captions generation uses <tt>--gc</tt> instead of <tt>-c</tt>.
77 The caption is automatically used if it exists, <tt>-c</tt> is not used anymore.
78 Captions generation from filename is <tt>--cf</tt> instead of <tt>-C</tt>.
79 </li>
80 <li>
81 Do not show image counter in captions is now <tt>--nc</tt> instead of <tt>-x</tt>.
82 </li>
83 <li>
84 The film effect in the index of thumbnails is now disabled by default. Instead of
85 disabling it with <tt>-r</tt>, you may now enable it with <tt>--fe</tt>.
86 </li>
87 <li>
88 <tt>--sp</tt> and <tt>--tp</tt> options got removed.
89 But <tt>scaled_image_filenameprefix</tt> and <tt>thumbnail_image_filenameprefix</tt>
90 configuration options allow prefix modification.
91 </li>
92 <li>
93 <tt>-bigy</tt> (limit image height in slides) is replaced with <tt>--sy</tt>.
94 <tt>-y</tt> (limit thumbnail height) is replaced with <tt>--ty</tt>.
95 </li>
96 <li>
97 <tt>-t</tt> has been removed, the user just need to modify the <tt>tile.png</tt> image
98 to get an updated layout.
99 </li>
100 <li>
101 <tt>--con</tt> has been removed, image generation command line may now be configured
102 by changing scaled_create_command and thumbnail_create_command configuration options.
103 </li>
104 </ul>
105
106
107
108 <h2 class="part">How-to upgrade</h2>
109
110 <p>
111 If you don't care about processing time:
112 </p>
113 <ul>
114 <li>Save your <tt>.captions</tt> file if it exists</li>
115 <li>Note the command line you used when creating the gallery
116 (see in the header of <tt>index.html</tt>)</li>
117 <li>Remove everything but the images with <tt>igal -clean</tt></li>
118 <li>Create a <tt>.llgal</tt> directory and move your captions files inside
119 (remember it is now named <tt>captions</tt> instead of <tt>.captions</tt>)</li>
120 <li>Run <tt>llgal</tt> with same options (see section 3 for details)</li>
121 </ul>
122
123 <p>
124 Recomputing the whole gallery might be long, especially if you have tons of images,
125 since thumbnails (and scaled images if <tt>--bigy</tt>/<tt>--bigxy</tt> is passed)
126 have to be generated.
127 </p>
128 <p>
129 If you don't want to regenerate these, see section <a href="#filelocation">File location</a>
130 and move <tt>.thumb_*</tt> and <tt>.slide_*</tt> files
131 to <tt>.llgal/thumb_*</tt> and <tt>scaled_*</tt> so that llgal uses them.
132 </p>
133
134
135
136 <hr />
137
138 <address id="addr">
139 The <a href="mailto:llgal AT googlegroups.com">llgal team</a>.
140 </address>
141
142 <div id="modif">
143 $Id: upgrade.html,v 1.1 2006/05/07 09:21:15 bgoglin Exp $
144 </div>
145
146 </body>
147 </html>