set -f
-VERSION="1.0.2+arch"
+VERSION="1.1.2"
function bpgallery_default_head() {
cat <<END
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>${TITLE}</title>
- <link rel="stylesheet" href="style.css" type="text/css" />
+ <link rel="stylesheet" href="${BASEURL}style.css" type="text/css" />
</head>
<body>
END
caption_alt=$caption
fi
cat << END
-<div class="thumbnail"><a href="$link"><img src="icons/$filename" alt="$caption_alt" /></a><div class="caption">$caption</div></div>
+<div class="thumbnail"><a href="$link"><img src="${ICONSDIRECTORY}/$filename" alt="$caption_alt" /></a><div class="caption">$caption</div></div>
END
}
}
div.navigation {
- width: 100%;
- margin: 2em;
- text-align: center;
+ margin: 0;
}
div.navigation ul {
- width: 100%;
display: inline;
+ margin: 0;
+ padding: 0;
text-align: center;
}
function bpgallery_default_page() {
$BPGALLERY_HEAD_FUNCTION
+
+ linkstart=""
+ linkend=""
+
+ if [[ ! -z $linklocation ]]; then
+ linkstart="<a href='$linklocation'>"
+ linkend="</a>"
+ fi
+
cat <<END
<h1>${caption}</h1>
<div class="navigation">
<ul>
- <li><a href='index.html'>Thumbnails</a></li>
+ <li><a href='${BASEURL}${INDEXDOCUMENT}'>Thumbnails</a></li>
END
if [[ ! -z $previouspage ]]; then
- echo "<li><a href='${previouspage}'>Previous</a></li>"
+ $ECHOCOMMAND "<li><a href='${previouspage}'>Previous</a></li>"
else
- echo "<li>Previous</li>"
+ $ECHOCOMMAND "<li>Previous</li>"
fi
if [[ ! -z $nextpage ]]; then
- echo "<li><a href='${nextpage}'>Next</a></li>"
+ $ECHOCOMMAND "<li><a href='${nextpage}'>Next</a></li>"
else
- echo "<li>Next</li>"
+ $ECHOCOMMAND "<li>Next</li>"
fi
cat <<END
</ul>
</div>
<div class="mainimage">
- <img src="${filename}" alt="${caption}" />
+ ${linkstart}<img src="${filename}" alt="${caption}" />${linkend}
</div>
END
$BPGALLERY_TAIL_FUNCTION
$ECHOCOMMAND $temp
}
+function bpgallery_cleanup_directory_name() {
+ temp=$1
+ temp=${temp//\%/_}
+ temp=${temp//:/_}
+ temp=${temp//;/_}
+ temp=${temp// /_}
+ temp=${temp//$/_}
+ temp=${temp//&/_}
+ temp=${temp//+/_}
+ temp=${temp//,/_}
+ temp=${temp//\//_}
+ temp=${temp//=/_}
+ temp=${temp//\?/_}
+ temp=${temp//@/_}
+ temp=${temp//\"/_}
+ $ECHOCOMMAND $temp
+}
+
declare -rf bpgallery_escape_url
if [[ ! -z ${BPGALLERY_THEME} ]] ; then
fi
if [[ -z $CONVERTTOOL ]]; then
- CONVERTTOOL=convert
+ hash convert
+ if [[ $? != 0 ]]; then
+ echo "Can't find convert, exiting"
+ exit 3
+ fi
+ CONVERTTOOL=$(hash -t convert)
+else
+ if [[ ! -x $CONVERTTOOL ]]; then
+ echo "Can't find convert at location $CONVERTTOOL, exiting"
+ exit 3
+ fi
fi
if [[ -z $FINDCOMMAND ]]; then
- FINDCOMMAND=find
+ hash find
+ if [[ $? != 0 ]]; then
+ echo "Can't find find, exiting"
+ exit 3
+ fi
+ FINDCOMMAND=$(hash -t find)
+else
+ if [[ ! -x $FINDCOMMAND ]]; then
+ echo "Can't find find at $FINDCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $XARGSCOMMAND ]]; then
- XARGSCOMMAND=xargs
+ hash xargs
+ if [[ $? != 0 ]]; then
+ echo "Can't find xargs, exiting"
+ exit 3
+ fi
+ XARGSCOMMAND=$(hash -t xargs)
+else
+ if [[ ! -x $XARGSCOMMAND ]]; then
+ echo "Can't find xargs at $XARGSCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $ECHOCOMMAND ]]; then
ECHOCOMMAND=echo
+else
+ if [[ ! -x $ECHOCOMMAND ]]; then
+ echo "Can't find echo at $ECHOCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $SORTCOMMAND ]]; then
- SORTCOMMAND=sort
+ hash sort
+ if [[ $? != 0 ]]; then
+ echo "Can't find sort, exiting"
+ exit 3
+ fi
+ SORTCOMMAND=$(hash -t sort)
+else
+ if [[ ! -x $SORTCOMMAND ]]; then
+ echo "Can't find sort, exiting"
+ exit 3
+ fi
fi
if [[ -z $IDENTIFYCOMMAND ]]; then
- IDENTIFYCOMMAND=identify
+ hash identify
+ if [[ $? != 0 ]]; then
+ echo "Can't find indentify, exiting"
+ exit 3
+ fi
+ IDENTIFYCOMMAND=$(hash -t identify)
+else
+ if [[ ! -x $IDENTIFYCOMMAND ]]; then
+ echo "Can't find identify at $IDENTIFYCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $HEADCOMMAND ]]; then
- HEADCOMMAND=head
+ hash head
+ if [[ $? != 0 ]]; then
+ echo "Can't find head, exiting"
+ exit 3
+ fi
+ HEADCOMMAND=$(hash -t head)
+else
+ if [[ ! -x $HEADCOMMAND ]]; then
+ echo "Can't find head at $HEADCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $GREPCOMMAND ]]; then
- GREPCOMMAND=grep
+ hash grep
+ if [[ $? != 0 ]]; then
+ echo "Can't find grep, exiting"
+ exit 3
+ fi
+ GREPCOMMAND=$(hash -t grep)
+else
+ if [[ ! -x $GREPCOMMAND ]]; then
+ echo "Can't find grep at $GREPCOMMAND, exiting"
+ exit 3
+ fi
fi
if [[ -z $SEDCOMMAND ]]; then
- SEDCOMMAND=sed
+ hash sed
+ if [[ $? != 0 ]]; then
+ echo "Can't find sed, exiting"
+ exit 3
+ fi
+ SEDCOMMAND=$(hash -t sed)
+else
+ if [[ ! -x $SEDCOMMAND ]]; then
+ echo "Can't find sed at $SEDCOMMAND, exiting"
+ exit 3
+ fi
+fi
+
+if [[ -z $WCCOMMAND ]]; then
+ hash wc
+ if [[ $? != 0 ]]; then
+ echo "Can't find wc, exiting"
+ exit 3
+ fi
+ WCCOMMAND=$(hash -t wc)
+ WCCOMMAND="$WCCOMMAND -l"
+else
+ if [[ ! -x $WCCOMMAND ]]; then
+ echo "Can't find wc at $WCCOMMAND, exiting"
+ exit 3
+ fi
+ WCCOMMAND="$WCCOMMAND -l"
fi
if [[ -z $WIDTH ]]; then
IMAGEEXTENSIONS="jpeg jpg gif png";
fi
-if [[ -z $WCCOMMAND ]]; then
- WCCOMMAND="wc -l"
-fi
-
if [[ -z $CAPTIONHEIGHT ]]; then
CAPTIONHEIGHT=75
fi
GENERATEPAGESFORFULLSIZE=0
fi
-if [[ $GENERATEPAGESFORFULLSIZE != 0 ]]; then
- if declare -F "bpgallery_${BPGALLERY_THEME}_page" > /dev/null ; then
- BPGALLERY_PAGE_FUNCTION="bpgallery_${BPGALLERY_THEME}_page"
- else
- BPGALLERY_PAGE_FUNCTION="bpgallery_default_page"
- fi
+if [[ -z $GENERATEPAGESFORMEDIUMSIZE ]]; then
+ GENERATEPAGESFORMEDIUMSIZE=1
+fi
+
+if [[ -z $PAGESDIRECTORY ]]; then
+ PAGESDIRECTORY=""
+else
+ removetrailingslashes=${PAGESDIRECTORY%/}
+ temp=$removetrailingslashes
+ while [[ $removetrailingslashes != $temp ]]; do
+ temp=$removetrailingslashes
+ removetrailingslashes=${temp%/}
+ done
+ PAGESDIRECTORY=$(bpgallery_escape_url "${PAGESDIRECTORY}")
+fi
+
+if [[ -z $MEDIUMWIDTH ]]; then
+ MEDIUMWIDTH=400
+fi
+
+if [[ -z $INDEXDOCUMENT ]]; then
+ INDEXDOCUMENT=index.html
+fi
+
+if [[ -z $MEDIUMDIRECTORY ]]; then
+ MEDIUMDIRECTORY=medium
+else
+ # Strip out anything that might be broken
+ MEDIUMDIRECTORY=$(bpgallery_cleanup_directory_name "$MEDIUMDIRECTORY")
+fi
+
+if [[ -z $ICONSDIRECTORY ]]; then
+ ICONSDIRECTORY=icons
+else
+ # Strip out anything that might be broken
+ ICONSDIRECTORY=$(bpgallery_cleanup_directory_name "$ICONSDIRECTORY")
+fi
+
+if declare -F "bpgallery_${BPGALLERY_THEME}_page" > /dev/null ; then
+ BPGALLERY_PAGE_FUNCTION="bpgallery_${BPGALLERY_THEME}_page"
+else
+ BPGALLERY_PAGE_FUNCTION="bpgallery_default_page"
fi
if declare -F "bpgallery_${BPGALLERY_THEME}_head" > /dev/null ; then
displays this help screen
--version
displays the version and exits
-
+
+This can also takes some environment variables, these will use defaults if not
+set.
+
+ TITLE
+ the title of the gallery
+
+ WIDTH
+ the width to make the icons
+
+ MEDIUMWIDTH
+ set the width of images in the medium size pages
+
+ BPGALLERY_THEME
+ set the theme to use (described below)
+
+ BPGALLERY_THEME_DIR
+ set an extra location to look for themes
+
+ OUTPUTHTML
+ sets the script output to be wrapped in a <pre> block
+
+ GENERATEPAGESFORMEDIUMSIZE
+ generate medium sized images and pages
+
+ GENERATEPAGESFORFULLSIZE
+ decide wether to generate pages for the full size images or not
+
+ INDEXDOCUMENT
+ name of the index page (e.g. index.html)
+
+Example:
+ TITLE="My Funky Gallery" WIDTH=200 INDEXDOCUMENT="welcome.html" GENERATEPAGESFORFULLSIZE=1 GENERATEPAGESFORMEDIUMSIZE=1 MEDIUMWIDTH=400 $0 /path/to/image/folder
END
}
END
}
-function generate_thumbs() {
- $ECHOCOMMAND "Generating Thumbnails"
+function generate_resized_images() {
+ $ECHOCOMMAND "Generating $2"
currentimage=0
- totalimages=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 --replace $ECHOCOMMAND {} | $WCCOMMAND);
- imagestoupdate=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 --replace $ECHOCOMMAND {} | while read filename; do filename=${filename//\"/\\\"}; if [ ! -r "icons/$filename" ] || [ "$filename" -nt "icons/$filename" ] || [ $($IDENTIFYCOMMAND -format "%w" "icons/$filename") -ne $WIDTH ]; then $ECHOCOMMAND $filename; fi; done | $WCCOMMAND)
+ totalimages=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 -I {} $ECHOCOMMAND {} | $WCCOMMAND);
+ imagestoupdate=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 -I {} $ECHOCOMMAND {} | while read filename; do filename=${filename//\"/\\\"}; if [ ! -r "$2/$filename" ] || [ "$filename" -nt "$2/$filename" ] || [ $($IDENTIFYCOMMAND -format "%w" "$2/$filename") -ne $1 ]; then $ECHOCOMMAND $filename; fi; done | $WCCOMMAND)
+ if [ $totalimages -eq 0 ]; then
+ # might as well exit at this point - there are no pictures
+ $ECHOCOMMAND "No images for the gallery - exiting."
+ exit 64
+ else
+ # check if the directory exists and create it other wise
+ if [ ! -d $2 ]; then
+ mkdir $2
+ fi
+
+ if [ ! -w $2 ]; then
+ $ECHOCOMMAND "Can't write to $2 directory, exiting"
+ exit 16
+ fi
+ fi
+
if [ $totalimages -eq $imagestoupdate ]; then
- $ECHOCOMMAND "Regenerating all thumbnails"
+ $ECHOCOMMAND "Regenerating all $2"
elif [ $imagestoupdate -eq 0 ]; then
- $ECHOCOMMAND "No Updated Thumbs, not regenerating"
+ $ECHOCOMMAND "No Updated $2, not regenerating"
return
else
- $ECHOCOMMAND "Generating $imagestoupdate of $totalimages thumbnails"
+ $ECHOCOMMAND "Generating $imagestoupdate of $totalimages $2"
fi
- $FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 --replace $ECHOCOMMAND {} | while read filename; do tempfilename=${filename//\"/\\\"/}; if [ ! -r "icons/$tempfilename" ] || [ "$tempfilename" -nt "icons/$tempfilename" ] || [ $($IDENTIFYCOMMAND -format "%w" "icons/$filename") -ne $WIDTH ]; then $ECHOCOMMAND -n $filename; $ECHOCOMMAND -n -e "\000"; fi; done | $XARGSCOMMAND -0 --verbose --max-procs=4 --replace $CONVERTTOOL -resize $WIDTH '{}' 'icons/{}' 2>&1 | while read throwout; do $ECHOCOMMAND done: $currentimage/$imagestoupdate images; currentimage=$((currentimage+1)); done
+ $FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 -I {} $ECHOCOMMAND {} | while read filename; do tempfilename=${filename//\"/\\\"/}; if [ ! -r "$2/$tempfilename" ] || [ "$tempfilename" -nt "$2/$tempfilename" ] || [ $($IDENTIFYCOMMAND -format "%w" "$2/$filename") -ne $1 ]; then $ECHOCOMMAND -n $filename; $ECHOCOMMAND -n -e "\000"; fi; done | $XARGSCOMMAND -0 --verbose --max-procs=4 -I {} $CONVERTTOOL -resize $1 '{}' $2/'{}' 2>&1 | while read throwout; do $ECHOCOMMAND done: $currentimage/$imagestoupdate images; currentimage=$((currentimage+1)); done
$ECHOCOMMAND done: $imagestoupdate/$imagestoupdate images
- $ECHOCOMMAND "Completed generating thumbs for $totalimages images"
+ $ECHOCOMMAND "Completed generating $2 for $totalimages images"
+}
+
+function generate_thumbs() {
+ if [[ ! -z $HEIGHT ]]; then
+ generate_resized_images "${WIDTH}x${HEIGHT}" $ICONSDIRECTORY
+ else
+ generate_resized_images $WIDTH $ICONSDIRECTORY
+ fi
+}
+
+function generate_medium() {
+ if [[ ! -z $MEDIUMHEIGHT ]]; then
+ generate_resized_images "${WIDTH}x${HEIGHT}" $MEDIUMDIRECTORY
+ else
+ generate_resized_images $MEDIUMWIDTH $MEDIUMDIRECTORY
+ fi
}
function generate_pages() {
previousimage=""
currentimage=""
nextimage=""
+ extra=""
+ extradir=""
+ addlinks=0
+
+ if [ ! -z $1 ]; then
+ extra=$1
+ fi
+
+ if [ ! -z $2 ]; then
+ extradir=$2/
+ addlinks=1
+ fi
+ if [ -z $2 ] && [[ $GENERATEPAGESFORMEDIUMSIZE != 0 ]]; then
+ addlinks=2
+ fi
+
$FINDCOMMAND . $FINDIMAGESOPTIONS | \
- $XARGSCOMMAND -0 --replace $ECHOCOMMAND {} | \
+ $XARGSCOMMAND -0 -I {} $ECHOCOMMAND {} | \
$SORTCOMMAND -g | \
while read imagefilename; do
previousimage=$currentimage
currentimage=$nextimage
- nextimage=$imagefilename
+ nextimage=${imagefilename#./}
+ addlink=""
+
+ if [[ $GENERATEPAGESFORFULLSIZE != 0 ]]; then
+ if [[ $addlinks == 1 ]]; then
+ addlink=${currentimage}.html
+ else
+ addlink=${currentimage}${extra}.html
+ fi
+ else
+ addlink=${currentimage}
+ fi
+
previouspage=$currentpage
currentpage=$nextpage
- nextpage=${imagefilename}.html
- filename=${currentimage}
- generate_general_page "$previouspage" "$currentpage" "$nextpage"
- echo $nextimage
+ if [[ $addlinks == 1 ]]; then
+ nextpage=${nextimage}${extra}.html
+ else
+ nextpage=${nextimage}.html
+ fi
+
+ if [[ "x$PAGESDIRECTORY" != "x" ]]; then
+ filename=../${extradir}${currentimage}
+ else
+ filename=${extradir}${currentimage}
+ fi
+ if [ "x$currentpage" != "x" ]; then
+ generate_general_page "$previouspage" "$currentpage" "$nextpage" $addlink
+ fi
+ $ECHOCOMMAND $nextimage
done | tail -n 2 | (
read previouspage
read currentpage
- filename=${currentpage}
- currentpage=${currentpage}.html
- previouspage=${previouspage}.html
+ addlink=""
+
+ if [[ $GENERATEPAGESFORFULLSIZE != 0 ]]; then
+ if [[ $addlinks == 1 ]]; then
+ addlink=${currentpage}.html
+ else
+ addlink=${currentpage}${extra}.html
+ fi
+ else
+ addlink=${currentpage}
+ fi
+
+ if [[ "x$PAGESDIRECTORY" != "x" ]]; then
+ filename=../${extradir}${currentpage}
+ else
+ filename=${extradir}${currentpage}
+ fi
+ if [[ $addlinks == 1 ]]; then
+ currentpage=${currentpage}${extra}.html
+ previouspage=${previouspage}${extra}.html
+ else
+ currentpage=${currentpage}.html
+ previouspage=${previouspage}.html
+ fi
nextpage=""
- generate_general_page "$previouspage" "$currentpage" ""
+ generate_general_page "$previouspage" "$currentpage" "" $addlink
)
}
-
+function generate_medium_pages() {
+ generate_pages __${MEDIUMDIRECTORY} ${MEDIUMDIRECTORY}
+}
function generate_general_page() {
nextpage=""
fi
+ if [[ ! -z $4 ]]; then
+ linklocation=$4
+ fi
+
if [ -r captions.txt ]; then
- caption=$($GREPCOMMAND -E "^${filename} " captions.txt); caption=${caption#* }
+ imagefilename=${filename##*/}
+ caption=$($GREPCOMMAND -E "^${imagefilename} " captions.txt); caption=${caption#* }
else
caption=""
fi
-
- $BPGALLERY_PAGE_FUNCTION > $currentpage
+
+ $BPGALLERY_PAGE_FUNCTION > "${UNIXPAGESDIRECTORY}$currentpage"
}
if [[ $OUTPUTHTML != 0 ]]; then
exit 8
fi
-if [ -e index.html ] && [ ! -w index.html ]; then
- $ECHOCOMMAND "Can't write index.html, exiting"
+if [ -e ${INDEXDOCUMENT} ] && [ ! -w ${INDEXDOCUMENT} ]; then
+ $ECHOCOMMAND "Can't write ${INDEXDOCUMENT}, exiting"
exit 8
fi
exit 8
fi
-if [ ! -d icons ]; then
- mkdir icons
-fi
+generate_thumbs
+
+if [[ "x$PAGESDIRECTORY" != "x" ]]; then
+ if [ ! -d $PAGESDIRECTORY ]; then
+ mkdir -p $PAGESDIRECTORY
+ fi
+
+ if [ ! -w $PAGESDIRECTORY ]; then
+ $ECHOCOMMAND "Can't write to $PAGESDIRECTORY directory, exiting"
+ exit 16
+ fi
+ UNIXPAGESDIRECTORY=$PAGESDIRECTORY/
+ PAGESDIRECTORY=$(bpgallery_escape_url $PAGESDIRECTORY)/
-if [ ! -w icons ]; then
- $ECHOCOMMAND "Can't write to icons directory, exiting"
- exit 16
+ BASEURL="../"
+else
+ BASEURL=""
+ UNIXPAGESDIRECTORY=""
fi
-generate_thumbs
+if [ $GENERATEPAGESFORMEDIUMSIZE != 0 ]; then
+ generate_medium
+ generate_medium_pages
+fi
if [ $GENERATEPAGESFORFULLSIZE != 0 ]; then
- generate_pages
+ if [ $GENERATEPAGESFORMEDIUMSIZE != 0 ]; then
+ generate_pages __${MEDIUMDIRECTORY}
+ else
+ generate_pages
+ fi
fi
if [ -r description.txt ] ; then
DESCRIPTION=""
fi
+BASEURL=""
$ECHOCOMMAND "Starting to generate page"
-$BPGALLERY_HEAD_FUNCTION > index.html
-$BPGALLERY_DESCRIPTION_FUNCTION >> index.html
+$BPGALLERY_HEAD_FUNCTION > ${INDEXDOCUMENT}
+$BPGALLERY_DESCRIPTION_FUNCTION >> ${INDEXDOCUMENT}
$ECHOCOMMAND "Adding Captions"
-$FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 --replace $ECHOCOMMAND {} |$SORTCOMMAND -g | while read filename; do filename=${filename#./}; if [ -r captions.txt ]; then caption=$($GREPCOMMAND -E "^$filename " captions.txt); caption=${caption#* }; else caption=""; fi; if [ $GENERATEPAGESFORFULLSIZE != 0 ]; then link=$(bpgallery_escape_url "${filename}.html"); else link=$(bpgallery_escape_url "$filename"); fi; filename=$(bpgallery_escape_url "$filename"); $BPGALLERY_THUMBSLINE_FUNCTION; done >> index.html
+extra=""
+if [ $GENERATEPAGESFORMEDIUMSIZE != 0 ]; then
+ extra=__${MEDIUMDIRECTORY}
+fi
+
+$FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 -I {} $ECHOCOMMAND {} | $SORTCOMMAND -g | while read filename; do filename=${filename#./}; if [ -r captions.txt ]; then caption=$($GREPCOMMAND -E "^$filename " captions.txt); caption=${caption#* }; else caption=""; fi; if [ $GENERATEPAGESFORMEDIUMSIZE != 0 ]; then link=${PAGESDIRECTORY}$(bpgallery_escape_url "${filename}${extra}.html"); elif [ $GENERATEPAGESFORFULLSIZE != 0 ]; then link=${PAGESDIRECTORY}$(bpgallery_escape_url "${filename}.html"); else link=$(bpgallery_escape_url "$filename"); fi; filename=$(bpgallery_escape_url "$filename"); $BPGALLERY_THUMBSLINE_FUNCTION; done >> ${INDEXDOCUMENT}
-$BPGALLERY_TAIL_FUNCTION >> index.html
+$BPGALLERY_TAIL_FUNCTION >> ${INDEXDOCUMENT}
$ECHOCOMMAND "Finished generating the page"
$ECHOCOMMAND "Generating stylesheet"
-cd icons
+cd $ICONSDIRECTORY
MAXHEIGHT=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 $IDENTIFYCOMMAND -format "%h\n" | $GREPCOMMAND -v "^$" | $SORTCOMMAND -g -r | $HEADCOMMAND -n 1)
MAXWIDTH=$($FINDCOMMAND . $FINDIMAGESOPTIONS | $XARGSCOMMAND -0 $IDENTIFYCOMMAND -format "%w\n" | $GREPCOMMAND -v "^$" | $SORTCOMMAND -g -r | $HEADCOMMAND -n 1)