annotate doc/usage_desc_cli.xml @ 6:3021deef1599

Encoding related fixes * chomp encoding string * reformat else (seems someone hacked it in) * debug print encoding * do not use :utf8 binmode ("re-encode") on written file if the input is _already_ UTF-8
author Peter Gervai <grin@grin.hu>
date Thu, 16 Oct 2008 00:02:14 +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_desc_xml SYSTEM "usage_desc_xml.xml" NDATA XML>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
8 ]>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
9 <!-- $Id: usage_desc_cli.xml,v 1.3 2002/07/29 16:54:50 jerome Exp $ -->
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
10 <webpage id="usage_desc_cli">
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
11 <config param="rcsdate" value="$Date: 2002/07/29 16:54:50 $"/>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
12
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
13 <head>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
14 <title>Command line interface</title>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
15 <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
16 </head>
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 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
19 You can use the <command>bins_edit</command> program to set
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
20 description fields or one or several images. For example, to add
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
21 the comment <userinput>my picture</userinput> to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
22 <filename>pic.jpg</filename>, go to the images directory (where
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
23 <filename>pic.jpg</filename> is), and type:
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
24 </para>
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 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
27 bins_edit -d "my picture" pic.jpg
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
28 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
29
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
30 <para>The <option>-d</option> option stands for description. You can
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
31 set other fields, like location or date. Run <command>bins_edit
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
32 --help</command> to see all fields available and read the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
33 <command><ulink url="bins_edit_man.html">bins_edit(1)</ulink></command>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
34 man page. The description text can be HTML with the
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
35 <option>--html</option> switch. You can run
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
36 <command>bins_edit</command> on several images, for example:</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
37
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
38 <programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
39 $ bins_edit -l "Paris" -y "2001" *.jpg
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
40 </programlisting>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
41
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
42 <para>For each album (and sub-albums), you can also set a title, a
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
43 description and a sample image to be used as a thumbnail to
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
44 represent the album. To do so, you can use
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
45 <command>bins_edit</command> with the<option> --album</option>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
46 switch. Type <command>bins_edit --help</command> for more
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
47 details.</para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
48
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
49 <para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
50 After setting or changing any fields, you have to rerun
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
51 <command>bins</command> to generate new HTML pages.
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
52 </para>
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
53
a84c32f131df Import vendor version
Peter Gervai <grin@grin.hu>
parents:
diff changeset
54 </webpage>