| 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_<image></tt></li> |
| 30 |
<li><tt>.thumb_<image></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_<image></tt> is also replaced by <tt>.scaled_<image></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_<image></tt></li> |
| 44 |
<li><tt>.llgal/thumb_<image></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> |