|
0
|
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="<-"></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"><<a href="mailto:psionic%C2%A0@%C2%A0psionic.de">psionic?@?psionic.de</a>></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"><<a href="mailto:adrian_r%20@%20teleline.es">adrian_r @ teleline.es</a>></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 <BR> |
|
|
160 #but you may have to escape certain symbols for the command line e.g. |
|
|
161 #<A HREF=\"http://www.somesite.com\">Some Site</A> |
|
|
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> |
