Mercurial > bins

<!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="usage.html" title="Usage"><link rel="previous" href="usage_httpd.html" title="Web server configuration"><link rel="next" href="contact.html" title="Contact and contribution"><link rel="first" href="usage_album.html" title="Creating an album"><link rel="stylesheet" href="example.css" type="text/css">
    <title>Tools</title>
    <meta name="keyword" content="SAUTRET, BINS, album, gallery, photos, EXIF">
  </head><body class="tabular" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="usage_tools" class="webpage"><a name="usage_tools"></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/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="faq.html">FAQ</a></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/open.gif" alt="?" border="0"></a><span class="ancestor"><a href="usage_album.html">Usage</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_album.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_album.html">Creating an album</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_desc.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_desc.html">Setting description fields</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_custom.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_custom.html">Customization</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_httpd.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_httpd.html">Web server configuration</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_tools.html"><img src="graphics/navicons/triangle/current/leaf.gif" alt="+" border="0"></a><span class="curpage">Tools?<img src="graphics/navicons/triangle/current/pointer.gif" alt="&lt;-"></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>Tools</h1><p>
    The BINS archive contains a <code class="filename">tools</code> directory
    with some small BINS related utilities. Here is a quick
    documentation about these tools.
  </p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469644"></a><span><strong class="command">bins_cleanupgallery</strong></span></h2></div></div></div>

    <p>
      The <span><strong class="command">bins_cleanupgallery</strong></span> script can be use to
      remove any unused file in your HTML galleries, for example
      images you have removed from you source tree. Run it without
      argument for usage information. Note that this script is still
      experimental, so if it performs wrong, just re-run bins to
      recreate erased files.
    </p>
    <p>
      This program was written by Jochen Schaeuble
      <code class="email">&lt;<a href="mailto:psionic%C2%A0@%C2%A0psionic.de">psionic?@?psionic.de</a>&gt;</code>.
    </p>
  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469675"></a><span><strong class="command">anti_bins</strong></span></h2></div></div></div>

    <p>
      This program creates a image files tree for each image size from
      a BINS generated album. Edit the variables in the configuration
      section and run it.
    </p>
    <p>
      Note that this program will not work if there is files or
      directories with space in their name in your tree.
    </p>
  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469701"></a><span><strong class="command">remove_num_prefix</strong></span></h2></div></div></div>

    <p>
      This script remove numeric prefixes added with
      <span><strong class="command">add_num_prefix</strong></span>. See below.
    </p>
  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469724"></a><span><strong class="command">add_num_prefix</strong></span></h2></div></div></div>

    <p>
      <span><strong class="command">add_num_prefix</strong></span> adds incremental numeric
      prefixes to files. You can use it to order the images in your
      albums. Note that there is an alternate method to order images
      and sub-albums, using the <code class="filename">album.list</code> file
      (see the <a href="#faq">FAQ</a>).
    </p>
    <pre class="programlisting">
      Usage:
      add_num_prefix start step files...
      Add a numeric prefix starting at 'start', incrementing by 'step' on 'files'.
    </pre>
    <p>
      For example, say that you have two sets of images, from two
      digicams. The images are named <code class="filename">IMG_*</code> for
      the first one, and <code class="filename">DSC*</code> for the second one.
      You want that the first set appears first in the album, and
      then, you want to change the order of some pictures. You start
      by adding a prefix on the first set:
    </p>
    <pre class="programlisting">
      add_num_prefix 0100 100 IMG_*
    </pre>
    <p>The images are now named like this:
    </p>
    <pre class="programlisting">
      0100_IMG_5103.JPG
      0200_IMG_5104.JPG
      0300_IMG_5105.JPG
      ....
      2500_IMG_6144.JPG
    </pre>
    <p>
      Then do the same on the second set (note that the last image of
      the first set in now named
      <code class="filename">2500_IMG_*</code>):</p>
    <pre class="programlisting">
      add_num_prefix 2600 100 DSC*
    </pre>
    <p>
      Then, you can reorder some of the pictures by changing their
      prefix. Just rename them with a file manager or on command line:
    </p>
    <pre class="programlisting">
      mv 1400_IMG_3450.JPG 0550_IMG_3450.JPG
    </pre>
    <p>
      You can also change the order of several pictures with
      <span><strong class="command">remove_num_prefix</strong></span> and
      <span><strong class="command">add_num_prefix</strong></span>. For example, to move all
      pictures between 1200 (included) to 1600 (not included) after
      the picture number 0100, use the following
      commands:
    </p>
    <pre class="programlisting">
      remove_num_prefix 1[2-5]*_IMG*.JPG
      add_num_prefix 0110 10 IMG*
    </pre>
    <p>This remove the prefix of the pictures you want to move, and
      add a new one beginning after 0100, with a small step. If you have
      already some XML files in your album, run also:
    </p>
    <pre class="programlisting">
      remove_num_prefix 1[2-5]00_*.xml
      add_num_prefix 0110 10 IMG*
    </pre>
  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469873"></a><span><strong class="command">bins_addtext</strong></span></h2></div></div></div>

    <p>

      Adrian Rossiter <code class="email">&lt;<a href="mailto:adrian_r%20@%20teleline.es">adrian_r @ teleline.es</a>&gt;</code> wrote this
      program. It can be used to set description fields in an
      alternate way. Here are the instructions from Adrian:
    </p>

    <p>
      I build a directory tree of image albums as normal, but in each
      album directory I create an
      <code class="filename">include_images.txt</code> file containing a list
      of the album images in the order I want them. I get bins to only
      consider the images in the
      <code class="filename">include_images.txt</code> files by setting the
      <code class="literal">excludeFiles</code> parameter in
      <code class="filename">binsrc</code> to exclude all files
      (<code class="filename">.*</code>).
    </p>
    <p>
      I then add comment lines to the
      <code class="filename">include_images.txt</code> files which I process
      with a <span><strong class="command">bins_addtext</strong></span> to set up the album. At
      the beginning I add the album details, then after each image I
      add the title and description. <span><strong class="command">bins_addtext</strong></span>
      simply calls the <span><strong class="command">bins_edit</strong></span> program with the
      various details as arguments.
    </p>
    <p>

      This is working out reasonably well as I can easily change the
      album, image text, order of images, etc just by editing one text
      file. Here is an example include_images.txt file for a one image album:
    </p>
    <pre class="programlisting">

         #Some Album Title (1 line)
         #Long description of Some Album
         #(can be many
         #lines)
         #|Short description of Some Album (starts after the pipe symbol)
         #can be many lines, then put another pipe symbol and this is followed
         #by the sample album image)
         #|some_image.gif

         some_image.gif
         #Some Image Title (1 line)
         #Description of Some Image
         #can be many lines
         #and include html &lt;BR&gt;
         #but you may have to escape certain symbols for the command line e.g.
         #&lt;A HREF=\"http://www.somesite.com\"&gt;Some Site&lt;/A&gt;

    </pre>
    <p>
      I call the script <span><strong class="command">bins_addtext</strong></span>. It just takes
      a list of directories where it looks for
      <code class="filename">include_images.txt</code> and processes it. You
      can use a different file by passing the name with the
      <code class="literal">-f</code> option, e.g process
      <code class="filename">include_images.txt</code> in the current directory:
    </p>
    <pre class="programlisting">
        bin_addtext ./
    </pre>
    <p>
      Process album_desc.txt in directories some_album1 and some_album2:
    </p>
    <pre class="programlisting">
      bin_addtext -f album_desc.txt some_album1 some_album2
    </pre>
  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2479294"></a><span><strong class="command">bins_txt2xml</strong></span></h2></div></div></div>

    <p>
      This is used to convert the old txt description files used in
      BINS older than 1.1.0 version to the new XML one. Run it with
      the directory of your image tree as parameter.
    </p>
  </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/22 23:53:32 $</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>
author	Peter Gervai <grin@grin.hu>
date	Thu, 16 Oct 2008 00:02:14 +0200
parents	a84c32f131df
children