Mercurial > bins
diff doc/usage_desc_xml.xml @ 0:a84c32f131df 1.1.29
Import vendor version
author | Peter Gervai <grin@grin.hu> |
---|---|
date | Wed, 15 Oct 2008 23:28:56 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/usage_desc_xml.xml Wed Oct 15 23:28:56 2008 +0200 @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="LATIN1" ?> +<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN" + "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [ +<!NOTATION XML SYSTEM "xml"> +<!ENTITY usage_custom SYSTEM "usage_custom.xml" NDATA XML> +]> +<!-- $Id: usage_desc_xml.xml,v 1.4 2002/08/24 15:33:45 jerome Exp $ --> +<webpage id="usage_desc_xml"> + <config param="rcsdate" value="$Date: 2002/08/24 15:33:45 $"/> + + <head> + <title>Editing the XML files</title> + <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords> + </head> + + <para><command>bins_edit</command> and + <command>bins-edit-gui</command> create a XML file for each picture + file commented (same name followed by <filename>.xml</filename>) and + an <filename>album.xml</filename> file in each directory of an album + which is commented. If you want to directly edit comments about the + image, or if you want to set some parameter (see the + <sgmltag>bins</sgmltag> section below) you can do so by editing the + XML file directly with an editor (supporting Unicode if you use + non-standard ASCII characters). The three main sections of this + files are:</para> + <itemizedlist> + <listitem><para> + <sgmltag>description</sgmltag>: contains desciption fields + (comment about the image or the album, like title, date, + location, etc.).</para></listitem> + + <listitem> + <para> + <sgmltag>bins</sgmltag>: contains parameters to personalize + the <command>bins</command> program behavior (and thus, the + HTML album aspect). You can use here most of the parameters + found in the <filename>binsrc</filename> file (see <olink + targetdocent="usage_custom">Customization</olink> + section.)</para> + </listitem> + + <listitem> + <para> + <sgmltag>exif</sgmltag>: store the data found in the Exif + structure of the image file. If the image file is modified and + the Exif structure is lost, BINS will use the data stored in + the description file (note that Exif data from the image file + takes precedence on the one of the description + file). <filename>album.xml</filename> files don't have this + section.</para> + </listitem> + </itemizedlist> + + <para> + After setting or changing any value in the XML files, you have to rerun + <command>bins</command> to generate new HTML pages. + </para> + + <para> + To see how you can change albums parameters, a sample + <filename>album.xml</filename> file is provided in the doc + directory. + </para> + +</webpage>