NAME¶
bins_edit — Set fields in XML picture description files for BINS
SYNOPSIS¶
bins_edit [
-a |
--album ] [
-m |
--html ]
[
-t title | --title title ] [-e
event | --event event ] [-l
location | --location location ]
[-p people | --people people ]
[ -y date | --date date ] [-d
description | --description description ]
[ --longdesc longDescription] [--shortdesc
shortDescription ] [--sample
pictureFileName] [-g tag=
value |
--generic tag=
value ] [-h |
--help ] [-v | --verbose ]
[-q | --quiet ] [file] [
files
...]
DESCRIPTION¶
This manual page documents briefly the
bins_edit command.
This manual page was written for the
Debian distribution because the
original program does not have a manual page. Instead, it has documentation in
HTML in
/usr/share/doc/bins/index.html as well as a
--help
option.
bins_edit sets values in the XML picture description files that
bins(1) uses to generate galleries.
OPTIONS¶
This program follows the usual GNU command line syntax, with long options
starting with two dashes (`-'). A summary of options is included below.
- file
- By default, file is the filename of the XML file
with the image properties. If the argument has no .xml suffix, it
is added, so you can directly give picture names on the command line.
Spaces and other special characters (even newlines) can be used in values
given as parameters as long as they are enclosed between quotes.
-
- If the --album option is given, the filename refers
to the directory of images, and the album.xml in that directory
will be modified instead.
- -a
- --album
- edit album description (instead of the default of editing
the image description.) In this case, the file parameter must be the
source directory of the album. Only the --title, --longdesc,
--shortdesc and --sample switches make sense with this
option.
- -m
- --html
- input value will be interpreted as HTML code, thus, no HTML
encoding or quoting will be done.
- -t title
- --title title
- Set the title (of an image.)
- -e event
- --event event
- Set the event name (of an album or image.)
- -l location
- --location location
- Set the location (of an image.)
- -p people
- --people people
- Set the list of people (of an image.)
- -y date
- --date date
- Set the date (of an image.)
- -d description
- --description description
- Set the description (of an image.)
- --longdesc longDescription
- Set the long description (of an album.)
- --shortdesc shortDescription
- Set the short description (of an album.)
- --sample pictureFileName
- Select the sample picture, within this album, to be used on
the album list (template subalbum.html.) Note that the filename is
relative to the album directory, and thus doesn't have a directory
component.
- -g tag=value
- --generic tag=value
- This lets you set arbitrary fields in the relevant XML file
(of the image or the album.) Generic tags appear inside description
which appears inside image; the tag appears as the
name attribute of a field element, and the value
appears as the content of the element.
- -h
- --help
- Gives quick help (which this man page is based on.)
- -v
- --verbose
- This switch can appear several times to increase verbosity
level.
- -q
- --quiet
- Suppress output.
EXAMPLES¶
Set the title of the
Image.jpg file to "My picture":
bins_edit -t "My picture" Image.jpg
Set the title and location of all JPEG pictures in the directory:
bins_edit --title Holiday --location Paris *.jpg
Use of HTML values:
bins_edit --html --description '<b>BINS</b> is cool' file.jpg
Set the title short description and sample image of the album in the current
directory (note the dot as final parameter):
bins_edit -a -t "My Album" --sample image.jpg --shortdesc
"This is my album" .
SEE ALSO¶
bins (1).
AUTHOR¶
This manual page was written by Mark W. Eichin eichin@thok.org for the
Debian system (but may be used by others). As it is mostly derived from
the
bins_edit program itself, it is covered by the GNU General Public
License.