Mercurial > bins
view doc/faq.html @ 7:69923c621cfe
log verbosity
| author | Peter Gervai <grin@grin.hu> |
|---|---|
| date | Thu, 16 Oct 2008 00:05:56 +0200 |
| parents | a84c32f131df |
| children |
line wrap: on
line source
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><meta name="generator" content="Website XSL Stylesheet V2.2 "><link rel="home" href="index.html" title="BINS Photo Album"><link rel="up" href="index.html" title="BINS Photo Album"><link rel="previous" href="examples.html" title="Examples"><link rel="next" href="download.html" title="Download"><link rel="first" href="intro.html" title="Introduction"><link rel="last" href="license.html" title="License"><link rel="stylesheet" href="example.css" type="text/css"> <title>FAQ</title> <meta name="keyword" content="SAUTRET, BINS, album, faq"> </head><body class="tabular" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="faq" class="webpage"><a name="faq"></a><table border="0" cellpadding="0" cellspacing="0" width="100%" summary="Navigation"><tr><td valign="top" align="left" bgcolor="#4080FF" width="220"><p class="navtoc"><a href="index.html"><img align="left" border="0" src="graphics/banner.png" alt="Banner"></a><br clear="all"><br><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="intro.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="intro.html">Introduction</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="examples.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="examples.html">Examples</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="faq.html"><img src="graphics/navicons/triangle/current/leaf.gif" alt="+" border="0"></a><span class="curpage">FAQ?<img src="graphics/navicons/triangle/current/pointer.gif" alt="<-"></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="download.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="download.html">Download</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="install.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="install.html">Installation</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="usage_album.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_album.html">Usage</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="contact.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="contact.html">Contact and contribution</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="license.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="license.html">License</a></span><br></span><br></p></td><td valign="top" align="left" bgcolor="white"><h1>FAQ</h1><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469640"></a>Frequent Asked Questions</h2></div></div></div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469647"></a>What does BINS means ?</h3></div></div></div> <p> BINS Is Not Swigs. BINS is a fork of Swigs, which is not maintained anymore. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469658"></a>Does BINS run on Windows ?</h3></div></div></div> <p> I've never tried, but I don't think. It's written in Perl, which is portable, but it uses some *nix specific commands. Though it should not be so difficult to port, or maybe it can run with cygwin ? </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469672"></a>When I visualize a big image, it don't fit in my window, I must scroll to see it, should I buy a bigger monitor ?</h3></div></div></div> <p> Yes. Or else, you can click on the big image. By default, browsers like <a href="http://www.mozilla-europe.org/en/products/firefox/" target="_top">firefox</a> will display it automatically re-sized to your window. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469693"></a>How can I get bins to automatically rotate destination images ?</h3></div></div></div> <p> If your camera has a accelerometer to know which way is up, it will be done automatically. If not, you have to set manually the orientation of the images on your camera before downloading them on you computer. You can also use <span><strong class="command"><a href="usage_desc_gui.html">bins-edit-gui</a></strong></span> to set the orientation of the image. If you don't want to use the GUI, this can be done directly in the XML image description file. Put (or set if it is already there) the following tag in the <code class="sgmltag-element"><exif></code> section: </p> <pre class="programlisting"> <tag name="Orientation" priority="1"> left_bot </tag> </pre> <p> Adjust the <code class="literal">left_bot</code> to the orientation of your image (can be <code class="literal">right_top</code>, <code class="literal">left_bot</code> or <code class="literal">bot_right</code>). </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469760"></a>Is it possible to give my own order number for each image ?</h3></div></div></div> <p> This can be done with two different ways. </p> <div class="itemizedlist"><ul type="disc"><li> <p> You can prefix the name of images and directories with a number. You can use the <a href="usage_tools.html">add_num_prefix tool</a> to help you. You have the possibility to choose to reverse sort with the <code class="literal">reverseOrder</code> option or the <code class="literal">-r</code> command line switch. </p> </li><li> <p> You can put an optional file <code class="filename">album.list</code> in your albums (a slibling file to <code class="filename">album.xml</code>) that lists the files in the order you want them displayed. If <code class="filename">album.list</code> doesn't exist in a directory the sorting by image name is done as usual. </p> </li></ul></div> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469831"></a>Does BINS recreate all the albums even if I add or modify just a sub-album ? </h3></div></div></div> <p> For each picture, if it doesn't exists in destination album, it is processed. If it exists and the date of the source is greater than the date of the destination, it is also processed. If the destination is more recent, it is left unchanged. All the HTML is regenerated when <span><strong class="command">bins</strong></span> is run. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469853"></a>Can I put some HTML in description fields ? </h3></div></div></div> <p> Yes, take a look at the <code class="literal">-m</code> option of <span><strong class="command">bins_edit</strong></span>, see the <a href="bins_edit_man.html" target="_top">man page</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469882"></a>I tried to change the color style (or e-mail, home page, other template customisation...) but I can't see any change on the generated album, is this a bug ?</h3></div></div></div> <p>Some customisation parameters are not implemented in all templates. For example, color style is not implemented in <code class="literal">joi</code> templates. Instead, it uses the more modern alternate stylesheets mechanism, with the <code class="literal">customStyleSheet</code> parameters, which is not supported by the <code class="literal">swigs</code> template.</p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469916"></a>How can I tell BINS to skip resizing the image (just use the default image) ?</h3></div></div></div> <p> Add this in the <code class="filename">album.xml</code>: </p> <pre class="programlisting"> <sizes> <size name="Full Size" shortname="Full" height="100%" width="100%"> </sizes> </pre> <p> Its goes under the <code class="sgmltag-element"><bins></code> stanza. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469952"></a>Having two separate trees (source and HTML) is not efficient for my disk space usage, can I use only one tree ?</h3></div></div></div> <p> No, but you can use the <code class="literal">linkInsteadOfCopy</code> parameter to avoid any image file duplicate. Also, look at the <code class="literal">linkRelative</code> parameter. All is in the <a href="bins_man.html" target="_top">man page</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2469983"></a>Having one description file per image is to complex to maintain, can I put all description fields for all images in just one file ?</h3></div></div></div> <p> Yes, try the <span><strong class="command">bins_addtext</strong></span> <a href="usage_tools.html">tool</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2470008"></a>Why special characters (like those with accents) are not correctly rendered ?</h3></div></div></div> <p> Have you copied the <code class="filename">.htaccess</code> in the root of your published album ? See <span class="emphasis"><em>Encoding</em></span> <a href="usage_httpd.html">here</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2470035"></a>I've generated an album, but I can't find the search engine, where is it ?</h3></div></div></div> <p> For now, the search engine is only available with the <code class="literal">swigs</code> templates. Note that the <code class="literal">search</code> link will only show up with a browser supporting javascript. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2479318"></a>The "Loading Data" screen took a bit too long to go to the search page, is this normal ?</h3></div></div></div> <p> It depends of the size of your album. You can enable compression on your web server to reduce this time. See <span class="emphasis"><em>Compression</em></span> <a href="usage_httpd.html#usage_httpd.compression">here</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2479344"></a>Can I have several versions of an album in different languages without duplicating the pictures ?</h3></div></div></div> <p> Multi-languages albums are not handled by BINS, but you can do this manually with the <code class="literal">mod_rewrite</code> Apache module. </p> <p> Say you have four albums trees corresponding to the same album in different languages, in four different directories named with the language code: </p> <pre class="programlisting"> /var/www/album/da/... /var/www/album/de/... /var/www/album/en/... /var/www/album/fr/... </pre> <p> To have only one copy of each picture, remove them from all trees except one (say <code class="literal">en</code>): </p> <pre class="programlisting"> find /var/www/album/{da,de,fr} \( -iname \*.JPG -o -iname \*.jpg -o \ -iname \*.gif -o -iname \*.png -o -iname \*.avi -o -iname \*.mpg \) \ -exec rm -f {} \; </pre> <p> And add a <code class="literal">RewriteRule</code> to your Apache configuration file to redirect all request for an image to the <code class="literal">en</code> tree : </p> <pre class="programlisting"> RewriteEngine on RewriteRule ^/album/[^e][^n]/(.*\.(jpg|gif|png|avi|mpg))$ \ /album/en/$1 [NC] </pre> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2479420"></a>I've put some image names in the excludeFiles parameter, but it doesn't seems to works. Can you explain how to use this stuff ?</h3></div></div></div> <p> This should be set to <span class="emphasis"><em>one</em></span> regexp, so, for example, to ignore two images, the correct parameter should looks like : </p> <pre class="programlisting"> <parameter name="excludeFiles"> dscn20(89|90) </parameter> </pre> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2479447"></a>Why bins fails with "<code class="computeroutput">Assertion flags == 0 failed: file "Storable.xs", line 2336 at /usr/local/bin/bins line 4213.</code>" ?</h3></div></div></div> <p> See this <a href="http://www.email-lists.org/pipermail/bins/2004-January/000117.html" target="_top">post</a>. You can find more details <a href="http://www.google.fr/search?q=site:email-lists.org+Storable.xs&num=20&hl=fr&lr=&ie=UTF-8&oe=utf-8&filter=0" target="_top">here</a>. </p> </div> <div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2479480"></a>What is the syntax used in templates ?</h3></div></div></div> <p> <span><strong class="command">man HTML::Template</strong></span> </p> </div> </div><br></td></tr></table><div class="navfoot"><hr><table width="100%" border="0" summary="Footer navigation"><tr><td width="33%" align="left"><span class="footdate">$Date: 2005/08/24 20:04:39 $</span></td><td width="34%" align="center"><span class="foothome"><a href="index.html">Home</a></span></td><td width="33%" align="right">?</td></tr><tr><td colspan="3" align="right"><span class="footcopy"><span class="copyright">Copyright ? 2001, 2005, J?r?me SAUTRET. </span></span></td></tr></table></div></div></body></html>