Mercurial > bins
diff doc/faq.html @ 0:a84c32f131df 1.1.29
Import vendor version
| author | Peter Gervai <grin@grin.hu> |
|---|---|
| date | Wed, 15 Oct 2008 23:28:56 +0200 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/faq.html Wed Oct 15 23:28:56 2008 +0200 @@ -0,0 +1,274 @@ +<!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>