Mercurial > bins

comparison doc/usage_tools.html @ 0:a84c32f131df 1.1.29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import vendor version
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:28:56 +0200
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:a84c32f131df
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><meta name="generator" content="Website XSL Stylesheet V2.2
3 "><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">
4 <title>Tools</title>
5 <meta name="keyword" content="SAUTRET, BINS, album, gallery, photos, EXIF">
6 </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>
7 The BINS archive contains a <code class="filename">tools</code> directory
8 with some small BINS related utilities. Here is a quick
9 documentation about these tools.
10 </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>
11
12 <p>
13 The <span><strong class="command">bins_cleanupgallery</strong></span> script can be use to
14 remove any unused file in your HTML galleries, for example
15 images you have removed from you source tree. Run it without
16 argument for usage information. Note that this script is still
17 experimental, so if it performs wrong, just re-run bins to
18 recreate erased files.
19 </p>
20 <p>
21 This program was written by Jochen Schaeuble
22 <code class="email">&lt;<a href="mailto:psionic%C2%A0@%C2%A0psionic.de">psionic @ psionic.de</a>&gt;</code>.
23 </p>
24 </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>
25
26 <p>
27 This program creates a image files tree for each image size from
28 a BINS generated album. Edit the variables in the configuration
29 section and run it.
30 </p>
31 <p>
32 Note that this program will not work if there is files or
33 directories with space in their name in your tree.
34 </p>
35 </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>
36
37 <p>
38 This script remove numeric prefixes added with
39 <span><strong class="command">add_num_prefix</strong></span>. See below.
40 </p>
41 </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>
42
43 <p>
44 <span><strong class="command">add_num_prefix</strong></span> adds incremental numeric
45 prefixes to files. You can use it to order the images in your
46 albums. Note that there is an alternate method to order images
47 and sub-albums, using the <code class="filename">album.list</code> file
48 (see the <a href="#faq">FAQ</a>).
49 </p>
50 <pre class="programlisting">
51 Usage:
52 add_num_prefix start step files...
53 Add a numeric prefix starting at 'start', incrementing by 'step' on 'files'.
54 </pre>
55 <p>
56 For example, say that you have two sets of images, from two
57 digicams. The images are named <code class="filename">IMG_*</code> for
58 the first one, and <code class="filename">DSC*</code> for the second one.
59 You want that the first set appears first in the album, and
60 then, you want to change the order of some pictures. You start
61 by adding a prefix on the first set:
62 </p>
63 <pre class="programlisting">
64 add_num_prefix 0100 100 IMG_*
65 </pre>
66 <p>The images are now named like this:
67 </p>
68 <pre class="programlisting">
69 0100_IMG_5103.JPG
70 0200_IMG_5104.JPG
71 0300_IMG_5105.JPG
72 ....
73 2500_IMG_6144.JPG
74 </pre>
75 <p>
76 Then do the same on the second set (note that the last image of
77 the first set in now named
78 <code class="filename">2500_IMG_*</code>):</p>
79 <pre class="programlisting">
80 add_num_prefix 2600 100 DSC*
81 </pre>
82 <p>
83 Then, you can reorder some of the pictures by changing their
84 prefix. Just rename them with a file manager or on command line:
85 </p>
86 <pre class="programlisting">
87 mv 1400_IMG_3450.JPG 0550_IMG_3450.JPG
88 </pre>
89 <p>
90 You can also change the order of several pictures with
91 <span><strong class="command">remove_num_prefix</strong></span> and
92 <span><strong class="command">add_num_prefix</strong></span>. For example, to move all
93 pictures between 1200 (included) to 1600 (not included) after
94 the picture number 0100, use the following
95 commands:
96 </p>
97 <pre class="programlisting">
98 remove_num_prefix 1[2-5]*_IMG*.JPG
99 add_num_prefix 0110 10 IMG*
100 </pre>
101 <p>This remove the prefix of the pictures you want to move, and
102 add a new one beginning after 0100, with a small step. If you have
103 already some XML files in your album, run also:
104 </p>
105 <pre class="programlisting">
106 remove_num_prefix 1[2-5]00_*.xml
107 add_num_prefix 0110 10 IMG*
108 </pre>
109 </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>
110
111 <p>
112
113 Adrian Rossiter <code class="email">&lt;<a href="mailto:adrian_r%20@%20teleline.es">adrian_r @ teleline.es</a>&gt;</code> wrote this
114 program. It can be used to set description fields in an
115 alternate way. Here are the instructions from Adrian:
116 </p>
117
118 <p>
119 I build a directory tree of image albums as normal, but in each
120 album directory I create an
121 <code class="filename">include_images.txt</code> file containing a list
122 of the album images in the order I want them. I get bins to only
123 consider the images in the
124 <code class="filename">include_images.txt</code> files by setting the
125 <code class="literal">excludeFiles</code> parameter in
126 <code class="filename">binsrc</code> to exclude all files
127 (<code class="filename">.*</code>).
128 </p>
129 <p>
130 I then add comment lines to the
131 <code class="filename">include_images.txt</code> files which I process
132 with a <span><strong class="command">bins_addtext</strong></span> to set up the album. At
133 the beginning I add the album details, then after each image I
134 add the title and description. <span><strong class="command">bins_addtext</strong></span>
135 simply calls the <span><strong class="command">bins_edit</strong></span> program with the
136 various details as arguments.
137 </p>
138 <p>
139
140 This is working out reasonably well as I can easily change the
141 album, image text, order of images, etc just by editing one text
142 file. Here is an example include_images.txt file for a one image album:
143 </p>
144 <pre class="programlisting">
145
146 #Some Album Title (1 line)
147 #Long description of Some Album
148 #(can be many
149 #lines)
150 #|Short description of Some Album (starts after the pipe symbol)
151 #can be many lines, then put another pipe symbol and this is followed
152 #by the sample album image)
153 #|some_image.gif
154
155 some_image.gif
156 #Some Image Title (1 line)
157 #Description of Some Image
158 #can be many lines
159 #and include html &lt;BR&gt;
160 #but you may have to escape certain symbols for the command line e.g.
161 #&lt;A HREF=\"http://www.somesite.com\"&gt;Some Site&lt;/A&gt;
162
163 </pre>
164 <p>
165 I call the script <span><strong class="command">bins_addtext</strong></span>. It just takes
166 a list of directories where it looks for
167 <code class="filename">include_images.txt</code> and processes it. You
168 can use a different file by passing the name with the
169 <code class="literal">-f</code> option, e.g process
170 <code class="filename">include_images.txt</code> in the current directory:
171 </p>
172 <pre class="programlisting">
173 bin_addtext ./
174 </pre>
175 <p>
176 Process album_desc.txt in directories some_album1 and some_album2:
177 </p>
178 <pre class="programlisting">
179 bin_addtext -f album_desc.txt some_album1 some_album2
180 </pre>
181 </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>
182
183 <p>
184 This is used to convert the old txt description files used in
185 BINS older than 1.1.0 version to the new XML one. Run it with
186 the directory of your image tree as parameter.
187 </p>
188 </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>