annotate doc/usage_album.xml @ 11:8b62360dc2a5 default tip

Adding notes, cloning edit-gui
author Peter Gervai <grin@grin.hu>
date Sun, 02 Nov 2008 16:29:52 +0100
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 custom SYSTEM "usage_custom.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
6 ]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
7 <!-- $Id: usage_album.xml,v 1.6 2005/08/22 19:58:27 jerome Exp $ -->
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
8 <webpage id="usage_album">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
9 <config param="rcsdate" value="$Date: 2005/08/22 19:58:27 $"/>
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 <head>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
12 <title>Creating an album</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
13 <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
14 </head>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
15
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
16
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
17 <para>Put all your images in a directory, say
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
18 <filename>~/images</filename>. Your images can be ordered into
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
19 sub-directories. Then, create an empty directory, where the album
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
20 will be created, say <filename>~/album</filename>&nbsp;:</para>
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 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
23 mkdir ~/album
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
24 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
25
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
26 <para>and run bins with the two directories (source and destination)
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
27 as parameters&nbsp;:</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
28
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
29 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
30 bins ~/images ~/album
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
31 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
32
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
33 <para>This will create an HTML album, with sub-albums, thumbnails
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
34 and scaled images.</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
35
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
36 <para>To change the appearance of the HTML album, a style can be
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
37 chosen with the <option>-s</option> command line option or via the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
38 <literal>templateStyle</literal> parameter in the configuration or
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
39 description files (see <olink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
40 targetdocent="custom">Customization</olink> below for information
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
41 about these files). In this case, BINS will use the HTML templates
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
42 found is the subdirectory named
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
43 <filename>templates.</filename><userinput>style</userinput> (where
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
44 <userinput>style</userinput> is the style name).</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
45
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
46 <para>BINS looks for this subdirectory in the directory specified by
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
47 the <option>-t</option> command line option, then in
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
48 <filename>~/.bins</filename> and finally in
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
49 <filename>/etc/bins</filename>.</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
50
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
51 <para>See the <ulink url="bins_man.html">man page</ulink> for all
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
52 style names available. If someone has the artistic talent to create
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
53 HTML templates for a new style, <ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
54 url="mailto:jerome@sautret.org.ANTISPAM">I am
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
55 interested</ulink>...</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
56
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
57 <para><command>bins</command> has some other command line options,
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
58 type</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
59
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
60 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
61 bins -h
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
62 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
63
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
64 <para>to see them and see the <command><ulink
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
65 url="bins_man.html">bins(1)</ulink></command> man page.</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
66
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
67
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
68 </webpage>