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 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
|
<!DOCTYPE HTML PUBLIC '-//W3C//DTD HTML 4.01 Transitional//EN'>
<html>
<head>
<style>
<!--
:lang(nl) { color: green; }
-->
</style>
<link rel='alternate' type='text/html' href='../Section_5.html' hreflang='en' lang='en' title='album documentation'>
<link rel='alternate' type='text/html' href='../de/Section_5.html' hreflang='de' lang='de' title='album documentation'>
<link rel='alternate' type='text/html' href='../es/Section_5.html' hreflang='es' lang='es' title='album documentation'>
<link rel='alternate' type='text/html' href='../fr/Section_5.html' hreflang='fr' lang='fr' title='album documentation'>
<meta http-equiv='Content-Language' content='nl'>
<link rel='alternate' type='text/html' href='../ru/Section_5.html' hreflang='ru' lang='ru' title='album documentation'>
<link rel='alternate' type='text/html' href='../it/Section_5.html' hreflang='it' lang='it' title='album documentation'>
<link rel='alternate' type='text/html' href='../hu/Section_5.html' hreflang='hu' lang='hu' title='album documentation'>
<title>MarginalHacks album - Feature Requests, Bugs, Patches and Troubleshooting
- Documentation</title>
<link rel='shortcut icon' HREF='/favicon.ico' type='image/x-gif'>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style>
<!--
code {color: red;}
tt {color: #ff6666;}
A:hover {background-color: yellow;}
-->
</style>
<script language='JavaScript'>
<!--
ver4 = (document.layers || document.all) ? 1 : 0;
if (document.images) {
ImageArray = new Array (
'http://DavePics.com/Domains/MarginalHacks.gif',
'http://DavePics.com/Domains/MarginalHacks_down.gif',
'http://DavePics.com/Domains/GetDave.gif',
'http://DavePics.com/Domains/GetDave_down.gif',
'http://DavePics.com/Domains/Daveola.gif',
'http://DavePics.com/Domains/Daveola_down.gif',
'http://DavePics.com/Domains/DaveSource.gif',
'http://DavePics.com/Domains/DaveSource_down.gif' )
ImageList = new Array ();
for (counter in ImageArray) {
ImageList[counter] = new Image();
ImageList[counter].src = ImageArray[counter];
}
};
defaultStatus = 'Marginal Hacks'
//-->
</script>
</head>
<body bgcolor=white link='#0000FF' alink='#0000FF' vlink='#5000FF' text='#000000'>
<div lang='en'>
<center>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr> <td rowspan=2>
<a href='http://MarginalHacks.com/'
onMouseOver = document.images['MarginalHacks'].src='http://DavePics.com/Domains/MarginalHacks_down.gif'
onMouseOut = document.images['MarginalHacks'].src='http://DavePics.com/Domains/MarginalHacks.gif'
onMouseDown = document.images['MarginalHacks'].src='http://DavePics.com/Domains/MarginalHacks_down.gif'
onMouseUp = document.images['MarginalHacks'].src='http://DavePics.com/Domains/MarginalHacks.gif'>
<img name=MarginalHacks alt='MarginalHacks.com'
src='http://DavePics.com/Domains/MarginalHacks.gif'
width=69 height=60 border=0></a>
<a href='http://DaveSource.com/'
onMouseOver = document.images['DaveSource'].src='http://DavePics.com/Domains/DaveSource_down.gif'
onMouseOut = document.images['DaveSource'].src='http://DavePics.com/Domains/DaveSource.gif'
onMouseDown = document.images['DaveSource'].src='http://DavePics.com/Domains/DaveSource_down.gif'
onMouseUp = document.images['DaveSource'].src='http://DavePics.com/Domains/DaveSource.gif'>
<img name=DaveSource alt='DaveSource.com'
src='http://DavePics.com/Domains/DaveSource.gif'
width=69 height=60 border=0></a>
<a href='http://GetDave.com/'
onMouseOver = document.images['GetDave'].src='http://DavePics.com/Domains/GetDave_down.gif'
onMouseOut = document.images['GetDave'].src='http://DavePics.com/Domains/GetDave.gif'
onMouseDown = document.images['GetDave'].src='http://DavePics.com/Domains/GetDave_down.gif'
onMouseUp = document.images['GetDave'].src='http://DavePics.com/Domains/GetDave.gif'>
<img name=GetDave alt='GetDave.com - all the current Dave Pointers.'
src='http://DavePics.com/Domains/GetDave.gif'
width=69 height=60 border=0></a>
<a href='http://Daveola.com/'
onMouseOver = document.images['Daveola'].src='http://DavePics.com/Domains/Daveola_down.gif'
onMouseOut = document.images['Daveola'].src='http://DavePics.com/Domains/Daveola.gif'
onMouseDown = document.images['Daveola'].src='http://DavePics.com/Domains/Daveola_down.gif'
onMouseUp = document.images['Daveola'].src='http://DavePics.com/Domains/Daveola.gif'>
<img name=Daveola alt='Daveola.com - My home.'
src='http://DavePics.com/Domains/Daveola.gif'
width=69 height=60 border=0></a>
</td>
<td bgcolor=#000000 align=right>
<font size=+2 face='lucida, helvetica' color=#ccccc0>
A l b u m <br>
F i v e - - F e a t u r e R e q u e s t s , B u g s , P a t c h e s a n d T r o u b l e s h o o t i n g
<br>
</font>
</td></tr>
<tr height=16>
<td height=16 align=right>
<a href="http://del.icio.us/post?url=http://MarginalHacks.com/Hacks/album/&title=Marginal+Hacks+Photo+Album+Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Del.icio.us"><img src="/Bookmarks/delicious.gif" title="Add 'Marginal Hacks Photo Album Generator' to Del.icio.us" alt="Add 'Marginal Hacks Photo Album Generator' to Del.icio.us" border="0"></a>
<a href="http://digg.com/software/Marginal_Hacks_Photo_Album_Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Digg 'Marginal Hacks Photo Album Generator'"><img src="/Bookmarks/digg.gif" title="Digg 'Marginal Hacks Photo Album Generator'" alt="Digg 'Marginal Hacks Photo Album Generator'" border="0"></a>
<a href="http://furl.net/storeIt.jsp?t=Marginal+Hacks+Photo+Album+Generator&u=http://MarginalHacks.com/Hacks/album/" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to FURL"><img src="/Bookmarks/furl.gif" title="Add 'Marginal Hacks Photo Album Generator' to FURL" alt="Add 'Marginal Hacks Photo Album Generator' to FURL" border="0"></a>
<a href="http://reddit.com/submit?url=http://MarginalHacks.com/Hacks/album/&title=Marginal+Hacks+Photo+Album+Generato" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to reddit"><img src="/Bookmarks/reddit.gif" title="Add 'Marginal Hacks Photo Album Generator' to reddit" alt="Add 'Marginal Hacks Photo Album Generator' to reddit" border="0"></a>
<a href="http://www.stumbleupon.com/refer.php?url=http://MarginalHacks.com/Hacks/album/&title=Marginal+Hacks+Photo+Album+Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Stumble Upon"><img src="/Bookmarks/stumbleupon.gif" title="Add 'Marginal Hacks Photo Album Generator' to Stumble Upon" alt="Add 'Marginal Hacks Photo Album Generator' to Stumble Upon" border="0"></a>
<a href="http://www.technorati.com/faves?add=http://MarginalHacks.com/Hacks/album/" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Technorati"><img src="/Bookmarks/technorati.gif" title="Add 'Marginal Hacks Photo Album Generator' to Technorati" alt="Add 'Marginal Hacks Photo Album Generator' to Technorati" border="0"></a>
<a href="http://myweb2.search.yahoo.com/myresults/bookmarklet?u=http://MarginalHacks.com/Hacks/album/&t=Marginal+Hacks+Photo+Album+Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Yahoo My Web"><img src="/Bookmarks/myweb2.gif" title="Add 'Marginal Hacks Photo Album Generator' to Yahoo My Web" alt="Add 'Marginal Hacks Photo Album Generator' to Yahoo My Web" border="0"></a>
<a href="http://www.google.com/bookmarks/mark?op=edit&output=popup&bkmk=http://MarginalHacks.com/Hacks/album/&title=Marginal+Hacks+Photo+Album+Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Google Bookmarks"><img src="/Bookmarks/google.gif" title="Add 'Marginal Hacks Photo Album Generator' to Google Bookmarks" alt="Add 'Marginal Hacks Photo Album Generator' to Google Bookmarks" border="0"></a>
<a href="http://www.squidoo.com/lensmaster/bookmark?http://MarginalHacks.com/Hacks/album/" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Squidoo"><img src="/Bookmarks/squidoo.gif" title="Add 'Marginal Hacks Photo Album Generator' to Squidoo" alt="Add 'Marginal Hacks Photo Album Generator' to Squidoo" border="0"></a>
<a href="http://www.spurl.net/spurl.php?url=http://MarginalHacks.com/Hacks/album/&title=Marginal+Hacks+Photo+Album+Generator" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Spurl"><img src="/Bookmarks/spurl.gif" title="Add 'Marginal Hacks Photo Album Generator' to Spurl" alt="Add 'Marginal Hacks Photo Album Generator' to Spurl" border="0"></a>
<a href="http://www.bloglines.com/sub/http://MarginalHacks.com/Hacks/album/" class="social_img" onclick="window.open(this.href, '_blank', 'scrollbars=yes,menubar=no,height=600,width=750,resizable=yes,toolbar=no,location=no,status=no'); return false;" title="Add 'Marginal Hacks Photo Album Generator' to Bloglines"><img src="/Bookmarks/bloglines.gif" title="Add 'Marginal Hacks Photo Album Generator' to Bloglines" alt="Add 'Marginal Hacks Photo Album Generator' to Bloglines" border="0"></a>
</td>
</tr>
</table>
<a name=top>
<table cellpadding=8 width='100%'> <tr>
<td valign=top>
<table>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/'>Home</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Themes.html'>Themes/Examples</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Languages.html'>Languages</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Plugins.html'>Plugins</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/License.html'>License</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Download.html'>Download</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3>Documentation
<font size='-1'>
<br><span lang='en'> <img src="..//flag.png"> <a href="../">English</a></span>
<br><span lang='de'> <img src="../de/flag.png"> <a href="../de">Deutsch</a></span>
<br><span lang='es'> <img src="../es/flag.png"> <a href="../es">Español</a></span>
<br><span lang='fr'> <img src="../fr/flag.png"> <a href="../fr">Français</a></span>
<br><span lang='nl'> <img src="flag.png"> Nederlands</span>
<br><span lang='ru'> <img src="../ru/flag.png"> <a href="../ru">Русский</a></span>
<br><span lang='it'> <img src="../it/flag.png"> <a href="../it">Italiano</a></span>
<br><span lang='hu'> <img src="../hu/flag.png"> <a href="../hu">magyar</a></span>
</font>
</h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Mailing_List.html'>Mailing List</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/CHANGELOG.html'>CHANGELOG</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href='http://MarginalHacks.com/Hacks/album/Praises.html'>Praises</a> </h3>
<p>
</td></tr>
<tr bgcolor=#BBBBBB><td>
<h3><a href=/Contact/>Contact</a> </h3>
<p>
</td></tr>
</table>
</td>
<td valign=top>
<p><hr><p>
<a href='.'>Table Of Contents</a>
<ol><li> <a href='#Feature_Requests'>Feature Requests</a>
<li> <a href='#Bug_reports'>Bug reports</a>
<li> <a href='#Writing_Patches,_Modifying_album'>Writing Patches, Modifying album</a>
<li> <a href='#Known_Bugs'>Known Bugs</a>
<li> <a href='#PROBLEM:_My_index_pages_are_too_large'>PROBLEM: My index pages are too large!</a>
<li> <a href='#ERROR:_no_delegate_for_this_image_format_(._album)'><b>ERROR:</b> no delegate for this image format (./album)</a>
<li> <a href='#ERROR:_no_delegate_for_this_image_format_(some_non_image_file)'><b>ERROR:</b> no delegate for this image format (some_non_image_file)</a>
<li> <a href='#ERROR:_no_delegate_for_this_image_format_(some.jpg)'><b>ERROR:</b> no delegate for this image format (some.jpg)</a>
<li> <a href='#ERROR:_identify:_JPEG_library_is_not_available_(some.jpg)'><b>ERROR:</b> identify: JPEG library is not available (some.jpg)</a>
<li> <a href='#ERROR:_Cant_get_[some_image]_size_from_-verbose_output.'><b>ERROR:</b> Can't get [some_image] size from -verbose output.</a>
</ol><p><hr><p>
<pre>
<b><a name='Feature_Requests'>1:</a> Feature Requests</b>
If there's something you want added to album, first make sure
it doesn't already exist! Check the man page or the usage:
<code>% man album</code>
<code>% album -h</code>
Also see -more and -usage options.
If you don't see it there, consider writing a patch or a plugin.
<b><a name='Bug_reports'>2:</a> Bug reports</b>
Before you submit a bug, please make sure you have the most current release of album!
When submitting a bug, I need to know <b>at least</b>:
1) Your operating system
2) The exact problem and the exact error messages
I'd also like to know, if possible:
1) The exact album command you ran
2) The output from the command
And I generally also need the debug output of album:
<code>% album -d</code>
Finally, make sure that you've got the most current
version of album, and the most current themes as well.
<b><a name='Writing_Patches,_Modifying_album'>3:</a> Writing Patches, Modifying album</b>
If you want to modify album, you might want to check with me
first to make sure it's not already on my development plate.
If not, then consider writing it as a plugin instead of patching
the album source. This avoids adding complexity to album for
features that may not be globally used.
If it needs to go into album (for example, if it's a bug), then
please make sure to first download the most <a href='http://MarginalHacks.com/bin/album'>recent copy of album</a>
first, then patch that and send me either a diff, a patch, or the
full script. If you comment off the changes you make that'd be great too.
<b><a name='Known_Bugs'>4:</a> Known Bugs</b>
v3.11: -clear_* and -no_* doesn't clear out parent directory options.
v3.10: Burning CDs doesn't quite work with theme absolute paths.
v3.00: Array and code options are saved backwards, for example:
"album -lang aa .. ; album -lang bb .." will still use language 'aa'
Also, in some cases array/code options in sub-albums will not
be ordered right the first time album adds them and you may
need to rerun album. For example:
"album -exif A photos/ ; album -exif B photos/sub"
Will have "B A" for the sub album, but "A B" after: "album photos/sub"
<b><a name='PROBLEM:_My_index_pages_are_too_large'>5:</a> PROBLEM: My index pages are too large!</b>
I get many requests to break up the index pages after reaching a certain
threshold of images.
The problem is that this is hard to manage - unless the index pages are
treated just like sub-albums, then you now have three major components
on a page, more indexes, more albums, and thumbnails. And not only is
that cumbersome, but it would require updating all the themes.
Hopefully the next major release of album will do this, but until then
there is another, easier solution - just break the images up into
subdirectories before running album.
I have a tool that will move new images into subdirectories for you and
then runs album:
<a href='http://MarginalHacks.com/Hacks/album/tools/in_album'>in_album</a>
<b><a name='ERROR:_no_delegate_for_this_image_format_(._album)'>6:</a> <b>ERROR:</b> no delegate for this image format (./album)</b>
You have the album script in your photo directory and it can't make
a thumbnail of itself! Either:
1) Move album out of the photo directory (suggested)
2) Run album with -known_images
<b><a name='ERROR:_no_delegate_for_this_image_format_(some_non_image_file)'>7:</a> <b>ERROR:</b> no delegate for this image format (some_non_image_file)</b>
Don't put non-images in your photo directory, or else run with -known_images.
<b><a name='ERROR:_no_delegate_for_this_image_format_(some.jpg)'>8:</a> <b>ERROR:</b> no delegate for this image format (some.jpg)</b>
<b><a name='ERROR:_identify:_JPEG_library_is_not_available_(some.jpg)'>9:</a> <b>ERROR:</b> identify: JPEG library is not available (some.jpg)</b>
Your ImageMagick installation isn't complete and doesn't know how
to handle the given image type.
<b><a name='ERROR:_Cant_get_[some_image]_size_from_-verbose_output.'>10:</a> <b>ERROR:</b> Can't get [some_image] size from -verbose output.</b>
ImageMagick doesn't know the size of the image specified. Either:
1) Your ImageMagick installation isn't complete and can't handle the image type.
2) You are running album on a directory with non-images in it without
using the -known_images option.
If you're a <a href='http://MarginalHacks.com/redir.cgi?Gentoo.org/'>gentoo linux</a> user and you see this error, then run this command
as root (thanks Alex Pientka):
USE="avi gif jpeg mpeg png quicktime tiff" emerge imagemagick
</pre>
<p><font size='-1'><li> Created by <a href='http://MarginalHacks.com/Hacks/make_faq/'>make_faq</a> from <a href='http://MarginalHacks.com/'>Marginal Hacks</a></font><p>
</td>
</tr>
</table>
</div>
</body>
</html>
<pre>
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
^
|
</pre>
|