1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211
|
==========================================================
BINS Photo Album
Version 1.1.29
Mar. 17, 2002
http://bins.sautret.org/
Jerome@Sautret.org
BINS is free software, licensed under the GNU GPL. See the
COPYING file for details.
==========================================================
(Une documentation en franais est disponible dans
doc/index_fr.html
ou en-ligne sur
http://bins.sautret.org/index_fr.html )
A complete documention in HTML format can be found in doc/index.html
or on-line on http://bins.sautret.org. See it for BINS installation
and usage.
See also the bins(1), bins_edit(1) and bins-edit-gui(1) man pages.
The aim of BINS is to generate HTML photo albums.
Some of the functionalities of BINS are:
- album can contains other albums (sub albums): the album
can have a tree structure ;
- generation of a thumbnail and of scaled images of each picture ;
- number and size of scaled pictures can be personalized, in pixels
or percentage of the original image ;
- several description fields (date, location, etc...) can be associated with
the pictures ;
- usethe EXIF data structure found on some JPEG (usually, those
produced by digital cameras) to fill automatically some fields (date and
time for example).
You can see an example of an album generated by BINS at
http://album.sautret.org/
This my personal album with french I18N.
BINS (BINS Is Not SWIGS) is a modified version of SWIGS (Structured
Web Image Gallery System). I've made these modifications because I need
them. I tried to contact SWIGS author, but I've got no response, so I
decided to publish my modified version in case someone is interested.
See ChangeLog file for differences between SWIGS and BINS.
Migrating from BINS version earlier than 1.1.0
==============================================
A new XML format is use for pictures and albums description files in
BINS 1.1.0. There is an utility bins_txt2xml to convert from old
format to new one:
WARNING: make a backup of your album before proceding to the
migration, just in case something goes wrong.
Install the new bins and bins_edit program in tour path as explained
in the installation documentation.
Run the bins_txt2xml with the source directory of the album as a parameter :
bins_txt2xml ~/album
This will create .xml files for each .txt in your album and its
subalbums. This can take some time...
You can then run the new bins to check if the new desc files are OK.
When you are sure all is OK. You can delete the old .txt files:
find ~/album -name \*.txt -exec rm -f {} \;
License
=======
BINS is free software, licensed under the GNU GPL. See COPYING file
for details.
BINS is Copyright (c) 2001-2004 Jrme Sautret (Jerome @ Sautret.org).
Original SWIGS code is Copyright (c) 2000 Brendan McMahan
(mcmahahb @ whitman.edu).
Initial code based on IDS 0.21 is Copyright (c) John Moose
(moosejc @ muohio.edu).
Original SWIGS README:
======================
_______________________________________________________________________________
SWIGS README, INSTALL, and DOCUMENTATION
version 0.1.1
Dec. 31, 2000
Brendan McMahan (mcmahahb@whitman.edu)
http://people.whitman.edu/~mcmahahb/projects/swigs.html
_______________________________________________________________________________
Document Contents:
Requirements
Installation and Usage Overview
SWIGS command line options
File Formats for Image Text Files
File Formats for Album Text Files
Requirements:
* ImageMagick with PerlMagick (http://www.imagemagick.org/)
* the "Image::Size" Perl module (http://www.cpan.org/).
Installation and Usage Overview:
1 Decompress swigs.tar.gz into a directory, say ~/swigs/
2 To immediately test your installation, run
./swigs.pl -t templates/ sample_input/ sample_output/
3 The default search location for templates is $HOME/.swigs_templates
You can copy the templates to that location so you don't have to
specificy the -t option everytime you run swigs.
4 Put the images you want into a directory
(possibly including subdirectories), say ~/pics/
5 Edit the HTML templates in ~/swigs/templates/ if desired
6 Create text files with annotations for each image and directory
if desired. For a description of the file formats, see below.
7 run ./swigs.pl ~/pics/ ~/swigs-output/
SWIGS command line options:
swigs.pl [-o [src]] [-t template_dir] source_dir target_dir
-o Tells script to use only one copy of image, using html size specs
(height, width specs in the image tag) for scaled versions. The
default src of the single image is scaled. The possible values are:
"scaled" (make scaled copy of orig in target_dir hierarchy,
sized to max size). Default.
"copied" (copy orig to web dir)
"custom" (use copy if filesize < 1meg
resize, resave, if bigger than 1 meg)
-t template_dir
directory where html templates are stored. If nothing is
specified, then the direcory is assumed to be templates/
-p If this option is given, then prefix ordering numbers on
directories are removed. For example, if one has directories
may, june, and august, they can be renamed 0_may, 1_june, and
2_august and they will appear in the album in the correct order.
Procceeding numbers followed by an underscore are stripped.
File Formats for Image Text Files:
* If the image is named foo.jpg (or foo.someothersupportedformat)
then the associated description file should be foo.jpg.txt. The
older format, foo.txt, is also still recognized, but should be
avoid do to possible conflicts if you hava a foo.jpg and a foo.png
in the same directory (for example).
* Each starting or ending tag goes on its own line. Each block of
data between tags may take any number of lines.
<title>
Type a short title for the image.
</title>
<event>
The event where the image was taken.
</event>
<location>
The location where the image was taken.
</location>
<people>
The names of the people in the image. Should be a comma separated
list without the word "and" to allow for easy parsing in future
versions that allow searching. For example:
Colin, Mike, Steph, Jeff, Marc
</people>
<date>
The date and time the image was taken.
</date>
<description>
A description of the image and any other information.
</description>
File Formats for Album Text Files:
* Each starting or ending tag goes on its own line. Each block of
data between tags may take any number of lines.
* The text file must be called album.txt
* One album.txt file may be included in each directory.
<title>
A short title for the album. If none is specified, the directory name
is used with underscores replaced by spaces.
</title>
<sampleimage>
The name of an image (without any path information) in the directory
to use as a representative for the album. Only specified if there are
actually images in the directory. For example:
Image003.jpg
</sampleimage>
<shortdesc>
A short description of the contents of the album.
</shortdesc>
<longdesc>
A longer description of the contents of the album. If none is
specified, the short description is used.
</longdesc>
|