annotate doc/faq.xml @ 10:f962189bab94

Added tag 1.1.29.e2 for changeset 0f248ad86f9f
author Peter Gervai <grin@grin.hu>
date Thu, 16 Oct 2008 00:16:50 +0200
parents a84c32f131df
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
1 <?xml version="1.0" encoding="LATIN1" ?>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
2 <!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN"
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
3 "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
4 <!NOTATION XML SYSTEM "xml">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
5 <!ENTITY usage_desc_cli SYSTEM "usage_desc_cli.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
6 <!ENTITY usage_desc_gui SYSTEM "usage_desc_gui.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
7 <!ENTITY usage_httpd SYSTEM "usage_httpd.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
8 <!ENTITY usage_tools SYSTEM "usage_tools.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
9 ]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
10
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
11 <!-- $Id: faq.xml,v 1.4 2005/08/24 20:04:39 jerome Exp $ -->
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
12 <webpage id="faq">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
13 <config param="rcsdate" value="$Date: 2005/08/24 20:04:39 $"/>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
14
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
15 <head>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
16 <title>FAQ</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
17
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
18 <keywords>SAUTRET, BINS, album, faq</keywords>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
19
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
20 </head>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
21
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
22 <webtoc/>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
23
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
24 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
25 <title>Frequent Asked Questions</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
26
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
27 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
28 <title>What does BINS means ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
29 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
30 BINS Is Not Swigs. BINS is a fork of Swigs, which is not
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
31 maintained anymore.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
32 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
33 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
34
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
35 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
36 <title>Does BINS run on Windows ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
37 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
38 I've never tried, but I don't think. It's written in Perl,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
39 which is portable, but it uses some *nix specific commands.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
40 Though it should not be so difficult to port, or maybe it can
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
41 run with cygwin ?
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
42 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
43 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
44
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
45 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
46 <title>When I visualize a big image, it don't fit in my window,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
47 I must scroll to see it, should I buy a bigger monitor ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
48 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
49 Yes. Or else, you can click on the big image. By default,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
50 browsers like <ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
51 url="http://www.mozilla-europe.org/en/products/firefox/">firefox</ulink>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
52 will display it automatically re-sized to your window.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
53 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
54 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
55
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
56 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
57 <title>How can I get bins to automatically rotate destination
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
58 images ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
59 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
60 If your camera has a accelerometer to know which way is up, it
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
61 will be done automatically. If not, you have to set manually
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
62 the orientation of the images on your camera before
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
63 downloading them on you computer. You can also use
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
64 <command><olink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
65 targetdocent="usage_desc_gui">bins-edit-gui</olink></command>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
66 to set the orientation of the image. If you don't want to use
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
67 the GUI, this can be done directly in the XML image
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
68 description file. Put (or set if it is already there) the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
69 following tag in the <sgmltag>&lt;exif></sgmltag> section:
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
70 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
71 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
72 <![CDATA[
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
73 <tag name="Orientation" priority="1">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
74 left_bot
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
75 </tag>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
76 ]]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
77 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
78 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
79 Adjust the <literal>left_bot</literal> to the orientation
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
80 of your image (can be <literal>right_top</literal>,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
81 <literal>left_bot</literal> or <literal>bot_right</literal>).
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
82 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
83 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
84
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
85 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
86 <title>Is it possible to give my own order number for each
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
87 image ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
88 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
89 This can be done with two different ways.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
90 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
91 <itemizedlist>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
92 <listitem>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
93 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
94 You can prefix the name of images and directories with a
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
95 number. You can use the <olink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
96 targetdocent="usage_tools">add_num_prefix tool</olink> to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
97 help you. You have the possibility to choose to reverse sort
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
98 with the <literal>reverseOrder</literal> option or the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
99 <literal>-r</literal> command line switch.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
100 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
101 </listitem>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
102 <listitem>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
103 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
104 You can put an optional file <filename>album.list</filename>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
105 in your albums (a slibling file to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
106 <filename>album.xml</filename>) that lists the files in the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
107 order you want them displayed. If
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
108 <filename>album.list</filename> doesn't exist in a directory
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
109 the sorting by image name is done as usual.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
110 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
111 </listitem>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
112 </itemizedlist>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
113 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
114
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
115 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
116 <title>Does BINS recreate all the albums even if I add or modify
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
117 just a sub-album ? </title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
118 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
119 For each picture, if it doesn't exists in destination album,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
120 it is processed. If it exists and the date of the source is
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
121 greater than the date of the destination, it is also
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
122 processed. If the destination is more recent, it is left
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
123 unchanged. All the HTML is regenerated when
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
124 <command>bins</command> is run.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
125 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
126 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
127
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
128 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
129 <title>Can I put some HTML in description fields ? </title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
130 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
131 Yes, take a look at the <literal>-m</literal> option of
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
132 <command>bins_edit</command>, see the <ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
133 url="bins_edit_man.html">man page</ulink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
134 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
135 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
136
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
137 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
138 <title>I tried to change the color style (or e-mail, home page,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
139 other template customisation...) but I can't see any change on
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
140 the generated album, is this a bug ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
141
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
142 <para>Some customisation parameters are not implemented in all
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
143 templates. For example, color style is not implemented in
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
144 <literal>joi</literal> templates. Instead, it uses the more
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
145 modern alternate stylesheets mechanism, with the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
146 <literal>customStyleSheet</literal> parameters, which is not
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
147 supported by the <literal>swigs</literal> template.</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
148 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
149
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
150 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
151 <title>How can I tell BINS to skip resizing the image (just use
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
152 the default image) ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
153
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
154 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
155 Add this in the <filename>album.xml</filename>:
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
156 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
157 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
158 <![CDATA[
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
159 <sizes>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
160 <size name="Full Size" shortname="Full" height="100%" width="100%">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
161 </sizes>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
162 ]]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
163 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
164 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
165 Its goes under the <sgmltag>&lt;bins></sgmltag> stanza.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
166 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
167 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
168
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
169 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
170 <title>Having two separate trees (source and HTML) is not
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
171 efficient for my disk space usage, can I use only one tree
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
172 ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
173
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
174 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
175 No, but you can use the <literal>linkInsteadOfCopy</literal>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
176 parameter to avoid any image file duplicate. Also, look at the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
177 <literal>linkRelative</literal> parameter. All is in the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
178 <ulink url="bins_man.html">man page</ulink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
179 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
180 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
181
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
182 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
183 <title>Having one description file per image is to complex to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
184 maintain, can I put all description fields for all images in
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
185 just one file ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
186 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
187 Yes, try the <command>bins_addtext</command> <olink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
188 targetdocent="usage_tools">tool</olink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
189 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
190 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
191
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
192 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
193 <title>Why special characters (like those with accents) are not
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
194 correctly rendered ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
195 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
196 Have you copied the <filename>.htaccess</filename> in the root
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
197 of your published album ? See <emphasis>Encoding</emphasis>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
198 <olink targetdocent="usage_httpd">here</olink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
199 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
200 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
201
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
202 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
203 <title>I've generated an album, but I can't find the search
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
204 engine, where is it ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
205 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
206 For now, the search engine is only available with the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
207 <literal>swigs</literal> templates. Note that the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
208 <literal>search</literal> link will only show up with a
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
209 browser supporting javascript.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
210 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
211 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
212
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
213 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
214 <title>The "Loading Data" screen took a bit too long to go to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
215 the search page, is this normal ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
216 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
217 It depends of the size of your album. You can enable
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
218 compression on your web server to reduce this time. See
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
219 <emphasis>Compression</emphasis> <olink targetdocent="usage_httpd"
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
220 localinfo="usage_httpd.compression">here</olink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
221 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
222 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
223
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
224 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
225 <title>Can I have several versions of an album in different
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
226 languages without duplicating the pictures ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
227 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
228 Multi-languages albums are not handled by BINS, but you can do
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
229 this manually with the <literal>mod_rewrite</literal> Apache
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
230 module.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
231 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
232 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
233 Say you have four albums trees corresponding to the same album
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
234 in different languages, in four different directories named
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
235 with the language code:
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
236 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
237 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
238 /var/www/album/da/...
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
239 /var/www/album/de/...
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
240 /var/www/album/en/...
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
241 /var/www/album/fr/...
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
242 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
243 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
244 To have only one copy of each picture, remove them from all
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
245 trees except one (say <literal>en</literal>):
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
246 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
247 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
248 find /var/www/album/{da,de,fr} \( -iname \*.JPG -o -iname \*.jpg -o \
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
249 -iname \*.gif -o -iname \*.png -o -iname \*.avi -o -iname \*.mpg \) \
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
250 -exec rm -f {} \;
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
251 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
252 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
253 And add a <literal>RewriteRule</literal> to your Apache
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
254 configuration file to redirect all request for an image to the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
255 <literal>en</literal> tree :
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
256 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
257 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
258 RewriteEngine on
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
259 RewriteRule ^/album/[^e][^n]/(.*\.(jpg|gif|png|avi|mpg))$ \
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
260 /album/en/$1 [NC]
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
261 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
262 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
263
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
264 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
265 <title>I've put some image names in the excludeFiles parameter,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
266 but it doesn't seems to works. Can you explain how to use this
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
267 stuff ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
268 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
269 This should be set to <emphasis>one</emphasis> regexp, so, for
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
270 example, to ignore two images, the correct parameter should
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
271 looks like :
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
272 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
273 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
274 <![CDATA[
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
275 <parameter name="excludeFiles">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
276 dscn20(89|90)
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
277 </parameter>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
278 ]]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
279 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
280 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
281
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
282 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
283 <title>Why bins fails with "<computeroutput>Assertion flags == 0
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
284 failed: file "Storable.xs", line 2336 at /usr/local/bin/bins
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
285 line 4213.</computeroutput>" ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
286 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
287 See this <ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
288 url="http://www.email-lists.org/pipermail/bins/2004-January/000117.html">post</ulink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
289 You can find more details <ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
290 url="http://www.google.fr/search?q=site:email-lists.org+Storable.xs&amp;num=20&amp;hl=fr&amp;lr=&amp;ie=UTF-8&amp;oe=utf-8&amp;filter=0">here</ulink>.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
291 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
292 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
293
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
294 <section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
295 <title>What is the syntax used in templates ?</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
296 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
297 <command>man HTML::Template</command>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
298 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
299 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
300
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
301 </section>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
302 </webpage>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
303