comparison doc/intro.xml @ 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
comparison
equal deleted inserted replaced
-1:000000000000 0:a84c32f131df
1 <?xml version="1.0" encoding="LATIN1" ?>
2 <!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN"
3 "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [
4 <!NOTATION XML SYSTEM "xml">
5 <!ENTITY intro SYSTEM "intro.xml" NDATA XML>
6 ]>
7 <!-- $Id: intro.xml,v 1.13 2005/08/21 20:12:33 jerome Exp $ -->
8 <webpage id="intro">
9 <config param="rcsdate" value="$Date: 2005/08/21 20:12:33 $"/>
10
11 <head>
12 <title>Introduction</title>
13 <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
14 </head>
15 <section>
16 <title>Features</title>
17
18 <para>The aim of BINS is to generate <emphasis role="bold">static
19 HTML photo albums</emphasis>. Some of the functionalities of BINS
20 are&nbsp;:</para>
21
22 <itemizedlist>
23
24 <listitem><para> generated album is <emphasis
25 role="bold">static</emphasis>&nbsp;: it's just plain
26 HTML/CSS/Javascript files (Javascript is not mandatory to view
27 the album), no need of any dynamic language (php, asp, etc.) nor
28 database on server side. Album can be burned on
29 CD or DVD.</para></listitem>
30
31 <listitem><para> album can contains other albums (<emphasis
32 role="bold">sub albums</emphasis>): the album can have a tree
33 structure&nbsp;; </para></listitem>
34
35 <listitem><para> generation
36 of a <emphasis role="bold">thumbnail</emphasis> and of <emphasis
37 role="bold">scaled images</emphasis> for each picture&nbsp;;
38 </para></listitem>
39
40 <listitem><para> generated album appearance
41 is <emphasis role="bold">fully customizable</emphasis> by using
42 <emphasis role="bold">HTML templates</emphasis> (5 different
43 templates sets are currently provided) and <emphasis
44 role="bold">configuration parameters</emphasis>: colors, number
45 and size of thumbnails per page, number and size of scaled
46 pictures (in pixels or percentage of the original image for the
47 size), fields to display, etc. Those parameters can be <emphasis
48 role="bold">set globally</emphasis> (system wide or per user),
49 <emphasis role="bold">per album</emphasis> or sub album or
50 <emphasis role="bold">per picture</emphasis> (for example, you
51 can change the colors of one sub album or one just one picture
52 page in an album by editing its description file)&nbsp;;
53 </para></listitem>
54
55 <listitem><para> several <emphasis
56 role="bold">description fields</emphasis> (date, location,
57 etc...) can be associated with the pictures (in text or HTML
58 format). You can easily add or customize these fields&nbsp;;
59 </para></listitem>
60
61 <listitem><para> description fields can be
62 set or modified via a <emphasis role="bold">command line
63 interface</emphasis> or a <emphasis role="bold">GTK+/GNOME-based
64 GUI</emphasis>&nbsp;; </para></listitem>
65
66 <listitem><para> A <emphasis role="bold">search engine</emphasis> is
67 included in the album&nbsp;: you can find some pictures by searching
68 keywords in their description fields.</para></listitem>
69
70 <listitem><para> Album can be generated from pictures managed by
71 <ulink url="http://www.nother.net/zoph/">Zoph</ulink>.
72 </para></listitem>
73
74 <listitem><para> <emphasis role="bold">speed up</emphasis> album
75 browsing by performing a clean up of <acronym>HTML</acronym>
76 code to reduce its size and by <emphasis
77 role="bold">pre-loading</emphasis> thumbnails in browser cache
78 using <emphasis>JavaScript</emphasis> code&nbsp;;
79 </para></listitem>
80
81 <listitem><para>Exif information and <emphasis role="bold">Digital
82 camera support</emphasis> :
83 <itemizedlist>
84 <listitem><para>
85 use the EXIF data structure found on some image files
86 (usually, those produced by digital cameras) to fill
87 automatically some fields (date and time for example).
88 </para></listitem>
89 <listitem><para>
90 BINS use the Orientation EXIF tag (which is normally set
91 when you rotate a image on you DigiCam) to
92 <emphasis role="bold">rotate the picture to correct
93 orientation</emphasis>.
94 </para></listitem>
95 <listitem><para>
96 For each image, a page provides all information
97 available on the picture and the <emphasis role="bold">DigiCam
98 settings</emphasis> when the photo was taken.
99 </para></listitem>
100 <listitem><para>
101 Additional information are provided for <emphasis
102 role="bold">Canon DigiCams</emphasis>.
103 </para></listitem>
104 <listitem><para>
105 Tooltips provide information about the meaning of some of
106 the fields.
107 </para></listitem>
108 <listitem><para>
109 All EXIF information is saved in the XML description file,
110 preventing they disappear when the image is
111 modified&nbsp;;
112 </para></listitem>
113 </itemizedlist>
114 </para></listitem>
115
116 <listitem>
117 <para>
118 <emphasis role="bold">internationalization</emphasis>
119 (generation of album in different languages) using gettext.
120 Current languages supported are Catalan, Dutch, English, Esperanto,
121 Finish, French, German, Hungarian, Italian, Japanese, Polish,
122 Russian, Spanish and Traditional Chinese &nbsp;;
123 </para>
124 </listitem>
125 <listitem><para>
126 <emphasis role="bold">customizable charset
127 encoding</emphasis> for HTML generation, including <emphasis
128 role="bold">UTF-8 (Unicode)</emphasis> support by
129 default. Generation of the Apache
130 <filename>.htaccess</filename> file for correct encoding
131 charset in HTTP headers&nbsp;;
132 </para></listitem>
133 <listitem><para>
134 use of <emphasis role="bold">XML files</emphasis> to save user
135 description of pictures and albums/subalbums and Exif data
136 from image file&nbsp;;
137 </para></listitem>
138 <listitem><para>
139 handle correctly file and directory names with spaces or
140 other odd characters (excepted '/'), and create
141 <emphasis role="bold">valid escaped URLs</emphasis>&nbsp;;
142 </para></listitem>
143
144 <listitem><para> generate <emphasis role="bold">valid
145 HTML/XHTML</emphasis> code. The level of HTML depends of the
146 style used. Some of the styles are valid, table free
147 XHTML.</para></listitem>
148 </itemizedlist>
149
150 </section>
151 <section>
152 <title>History</title>
153
154 <para>BINS (BINS Is Not SWIGS) is a modified version of <ulink
155 url="http://sourceforge.net/projects/swigs/">SWIGS</ulink>
156 (Structured Web Image Gallery System). I've made these
157 modifications because I need them. I tried to contact SWIGS
158 author, but I've got no response, so I decided to publish my
159 modified version in case someone is interested.</para>
160
161 <para>See <ulink url="ChangeLog">ChangeLog</ulink> file for
162 differences between SWIGS and BINS and new functionalities of each
163 version.</para>
164 </section>
165 </webpage>