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...]
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.
This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.
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, --albumedit 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, --htmlinput value will be interpreted as HTML code, thus, no HTML encoding or quoting will be done.
-t title, --title titleSet the title (of an image.)
-e event, --event eventSet the event name (of an album or image.)
-l location, --location locationSet the location (of an image.)
-p people, --people peopleSet the list of people (of an image.)
-y date, --date dateSet the date (of an image.)
-d description, --description descriptionSet the description (of an image.)
--longdesc longDescriptionSet the long description (of an album.)
--shortdesc shortDescriptionSet the short description (of an album.)
--sample pictureFileNameSelect 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=valueThis 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, --helpGives quick help (which this man page is based on.)
-v, --verboseThis switch can appear several times to increase verbosity level.
-q, --quietSuppress output.
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" .
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.