Mercurial > bins

<?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>
author	Peter Gervai <grin@grin.hu>
date	Wed, 15 Oct 2008 23:32:04 +0200
parents	a84c32f131df
children