Mercurial > bins
diff doc/usage_tools.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/usage_tools.html Wed Oct 15 23:28:56 2008 +0200 @@ -0,0 +1,188 @@ +<!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="<-"></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"><<a href="mailto:psionic%C2%A0@%C2%A0psionic.de">psionic @ psionic.de</a>></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"><<a href="mailto:adrian_r%20@%20teleline.es">adrian_r @ teleline.es</a>></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 <BR> + #but you may have to escape certain symbols for the command line e.g. + #<A HREF=\"http://www.somesite.com\">Some Site</A> + + </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>