Mercurial > bins

diff doc/usage_desc_xml.html @ 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.html	Wed Oct 15 23:28:56 2008 +0200
@@ -0,0 +1,41 @@
+<!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>