Mercurial > bins

comparison doc/usage_album.xml @ 0:a84c32f131df 1.1.29

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