Mercurial > bins

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