Mercurial > bins

view doc/usage_desc_xml.html @ 6:3021deef1599

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Encoding related fixes * chomp encoding string * reformat else (seems someone hacked it in) * debug print encoding * do not use :utf8 binmode ("re-encode") on written file if the input is _already_ UTF-8
author Peter Gervai <grin@grin.hu>
date Thu, 16 Oct 2008 00:02:14 +0200
parents a84c32f131df
children
line wrap: on
line source

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><meta name="generator" content="Website XSL Stylesheet V2.2
"><link rel="home" href="index.html" title="BINS Photo Album"><link rel="up" href="usage_desc.html" title="Setting description fields"><link rel="previous" href="usage_desc_gui.html" title="Graphical interface"><link rel="next" href="usage_custom.html" title="Customization"><link rel="first" href="usage_desc_cli.html" title="Command line interface"><link rel="stylesheet" href="example.css" type="text/css">
    <title>Editing the XML files</title>
    <meta name="keyword" content="SAUTRET, BINS, album, gallery, photos, EXIF">
  </head><body class="tabular" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="usage_desc_xml" class="webpage"><a name="usage_desc_xml"></a><table border="0" cellpadding="0" cellspacing="0" width="100%" summary="Navigation"><tr><td valign="top" align="left" bgcolor="#4080FF" width="220"><p class="navtoc"><a href="index.html"><img align="left" border="0" src="graphics/banner.png" alt="Banner"></a><br clear="all"><br><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="intro.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="intro.html">Introduction</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="examples.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="examples.html">Examples</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="faq.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="faq.html">FAQ</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="download.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="download.html">Download</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="install.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="install.html">Installation</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="usage_album.html"><img src="graphics/navicons/triangle/other/open.gif" alt="?" border="0"></a><span class="ancestor"><a href="usage_album.html">Usage</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_album.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_album.html">Creating an album</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_desc.html"><img src="graphics/navicons/triangle/other/open.gif" alt="?" border="0"></a><span class="ancestor"><a href="usage_desc.html">Setting description fields</a></span><br></span><span class="shrink2"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_desc_cli.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_desc_cli.html">Command line interface</a></span><br></span><span class="shrink2"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_desc_gui.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_desc_gui.html">Graphical interface</a></span><br></span><span class="shrink2"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_desc_xml.html"><img src="graphics/navicons/triangle/current/leaf.gif" alt="+" border="0"></a><span class="curpage">Editing the XML files?<img src="graphics/navicons/triangle/current/pointer.gif" alt="&lt;-"></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_custom.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_custom.html">Customization</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_httpd.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_httpd.html">Web server configuration</a></span><br></span><span class="shrink1"><img src="graphics/blank.gif" alt="???"><img src="graphics/blank.gif" alt="???"><a href="usage_tools.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_tools.html">Tools</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="contact.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="contact.html">Contact and contribution</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="license.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="license.html">License</a></span><br></span><br></p></td><td valign="top" align="left" bgcolor="white"><h1>Editing the XML files</h1><p><span><strong class="command">bins_edit</strong></span> and
  <span><strong class="command">bins-edit-gui</strong></span> create a XML file for each picture
  file commented (same name followed by <code class="filename">.xml</code>) and
  an <code class="filename">album.xml</code> 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
  <code class="sgmltag-element">bins</code> 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:</p><div class="itemizedlist"><ul type="disc"><li><p>
      <code class="sgmltag-element">description</code>: contains desciption fields
      (comment about the image or the album, like title, date,
      location, etc.).</p></li><li>
      <p>
	<code class="sgmltag-element">bins</code>: contains parameters to personalize
	the <span><strong class="command">bins</strong></span> program behavior (and thus, the
	HTML album aspect). You can use here most of the parameters
	found in the <code class="filename">binsrc</code> file (see <a href="usage_custom.html">Customization</a>
	section.)</p>
    </li><li>
      <p>
	<code class="sgmltag-element">exif</code>: 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). <code class="filename">album.xml</code> files don't have this
	section.</p>
    </li></ul></div><p>
    After setting or changing any value in the XML files, you have to rerun
    <span><strong class="command">bins</strong></span> to generate new HTML pages.
  </p><p>
    To see how you can change albums parameters, a sample
    <code class="filename">album.xml</code> file is provided in the doc
    directory.
  </p><br></td></tr></table><div class="navfoot"><hr><table width="100%" border="0" summary="Footer navigation"><tr><td width="33%" align="left"><span class="footdate">$Date: 2002/08/24 15:33:45 $</span></td><td width="34%" align="center"><span class="foothome"><a href="index.html">Home</a></span></td><td width="33%" align="right">?</td></tr><tr><td colspan="3" align="right"><span class="footcopy"><span class="copyright">Copyright ? 2001, 2005,  J?r?me SAUTRET. </span></span></td></tr></table></div></div></body></html>