Mercurial > bins

comparison doc/usage_desc_xml.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 usage_custom SYSTEM "usage_custom.xml" NDATA XML>
6 ]>
7 <!-- $Id: usage_desc_xml.xml,v 1.4 2002/08/24 15:33:45 jerome Exp $ -->
8 <webpage id="usage_desc_xml">
9 <config param="rcsdate" value="$Date: 2002/08/24 15:33:45 $"/>
10
11 <head>
12 <title>Editing the XML files</title>
13 <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
14 </head>
15
16 <para><command>bins_edit</command> and
17 <command>bins-edit-gui</command> create a XML file for each picture
18 file commented (same name followed by <filename>.xml</filename>) and
19 an <filename>album.xml</filename> file in each directory of an album
20 which is commented. If you want to directly edit comments about the
21 image, or if you want to set some parameter (see the
22 <sgmltag>bins</sgmltag> section below) you can do so by editing the
23 XML file directly with an editor (supporting Unicode if you use
24 non-standard ASCII characters). The three main sections of this
25 files are:</para>
26 <itemizedlist>
27 <listitem><para>
28 <sgmltag>description</sgmltag>: contains desciption fields
29 (comment about the image or the album, like title, date,
30 location, etc.).</para></listitem>
31
32 <listitem>
33 <para>
34 <sgmltag>bins</sgmltag>: contains parameters to personalize
35 the <command>bins</command> program behavior (and thus, the
36 HTML album aspect). You can use here most of the parameters
37 found in the <filename>binsrc</filename> file (see <olink
38 targetdocent="usage_custom">Customization</olink>
39 section.)</para>
40 </listitem>
41
42 <listitem>
43 <para>
44 <sgmltag>exif</sgmltag>: store the data found in the Exif
45 structure of the image file. If the image file is modified and
46 the Exif structure is lost, BINS will use the data stored in
47 the description file (note that Exif data from the image file
48 takes precedence on the one of the description
49 file). <filename>album.xml</filename> files don't have this
50 section.</para>
51 </listitem>
52 </itemizedlist>
53
54 <para>
55 After setting or changing any value in the XML files, you have to rerun
56 <command>bins</command> to generate new HTML pages.
57 </para>
58
59 <para>
60 To see how you can change albums parameters, a sample
61 <filename>album.xml</filename> file is provided in the doc
62 directory.
63 </para>
64
65 </webpage>