|
0
|
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> |
