Mercurial > bins

view doc/usage_album.xml @ 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

<?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 custom    SYSTEM "usage_custom.xml"    NDATA XML>
]>
<!-- $Id: usage_album.xml,v 1.6 2005/08/22 19:58:27 jerome Exp $ -->
<webpage id="usage_album">
  <config param="rcsdate" value="$Date: 2005/08/22 19:58:27 $"/>
  
  <head>
    <title>Creating an album</title>
    <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
  </head>


  <para>Put all your images in a directory, say
  <filename>~/images</filename>. Your images can be ordered into
  sub-directories.  Then, create an empty directory, where the album
  will be created, say <filename>~/album</filename>&nbsp;:</para>

  <programlisting>
    mkdir ~/album
  </programlisting>

  <para>and run bins with the two directories (source and destination)
    as parameters&nbsp;:</para>

  <programlisting>
    bins ~/images ~/album
  </programlisting>

  <para>This will create an HTML album, with sub-albums, thumbnails
  and scaled images.</para>

  <para>To change the appearance of the HTML album, a style can be
  chosen with the <option>-s</option> command line option or via the
  <literal>templateStyle</literal> parameter in the configuration or
  description files (see <olink
  targetdocent="custom">Customization</olink> below for information
  about these files). In this case, BINS will use the HTML templates
  found is the subdirectory named
  <filename>templates.</filename><userinput>style</userinput> (where
  <userinput>style</userinput> is the style name).</para>

  <para>BINS looks for this subdirectory in the directory specified by
  the <option>-t</option> command line option, then in
  <filename>~/.bins</filename> and finally in
  <filename>/etc/bins</filename>.</para>

  <para>See the <ulink url="bins_man.html">man page</ulink> for all
  style names available. If someone has the artistic talent to create
  HTML templates for a new style, <ulink
  url="mailto:jerome@sautret.org.ANTISPAM">I am
  interested</ulink>...</para>

  <para><command>bins</command> has some other command line options,
  type</para>

  <programlisting>
    bins -h
  </programlisting>

  <para>to see them and see the <command><ulink
  url="bins_man.html">bins(1)</ulink></command> man page.</para>


</webpage>