Mercurial > bins
view doc/usage_desc_xml.html @ 9:0f248ad86f9f 1.1.29.e2
bins_edit: try to get encoding stuff right, move it into main
author | Peter Gervai <grin@grin.hu> |
---|---|
date | Thu, 16 Oct 2008 00:11: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="<-"></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>