source: trunk/SRC/Documentation/xmldoc/showpalettes.sh @ 218

#! /bin/sh
#+
#
# NAME
# ====
#
# showpalettes.sh - show available palettes
#
# SYNOPSIS
# ========
#
# ::
#
# $ showpalettes.sh -i indir -idl_dir idl_dir -o outdir -t tempdir
#
# DESCRIPTION
# ===========
#
# ``showpalettes.sh`` inspect ``indir`` and look for  ``.cpt`` files.
#
# A XML/DocBook outdir/showpalette.xml is produced to present palettes usage and
# building.
#
# By default, indir is the current directory.
#
# Log file is written on ${tempdir}/showpalette.log.\ *YYYYMMDDTHHMMSSZ*
#
# CAUTIONS
# ========
#
# SAXO_DIR must be set. The value should be the directory where
# SAXO is available.
#
# for example, if you work at LOCEAN and work with default SAXO,
# SAXO_DIR=/usr/home/smasson/SAXO_DIR.
#
# For working in progress, you should checkout SAXO on a personnal
# directory and set SAXO_DIR to the working space.
#
# example for me : SAXO_DIR=/usr/lodyc/incas/fplod/SAXO_DIR_ws/
#
# EXAMPLES
# ========
#
# For POST_IT in working space /usr/lodyc/incas/fplod/post_it_ws/
# with IDL 6.4
#
# ::
#
# $ /usr/lodyc/incas/fplod/post_it_ws/SRC/Documentation/xmldoc/showpalettes.sh -i /usr/lodyc/incas/fplod/post_it_ws/ -idl_dir /usr/local_linux/idl/idl_6.4/idl/ -o /tmp/ -t /tmp/
#
# For POST_IT in working space /usr/lodyc/incas/fplod/post_it_ws/
# with IDL 7.0
#
# ::
#
# $ /usr/lodyc/incas/fplod/post_it_ws/SRC/Documentation/xmldoc/showpalettes.sh -i /usr/lodyc/incas/fplod/post_it_ws/ -idl_dir /usr/local_linux/idl/idl70/ -o /tmp/ -t /tmp/
#
# TODO
# ====
#
# Some IDL files should be produced and processed to produce some plots (png files)
# to be added in each ctp file.
#
# EVOLUTIONS
# ==========
#
# $Id$
#
# - fplod 20100120T090231Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * fix typo
#   * add outdir and tempdir parameters
#
# - fplod 20091207T112658Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * creation
#
system=$(uname)
case "${system}" in
   AIX|IRIX64)
      echo " www : no specific posix checking"
   ;;
   *)
      set -o posix
   ;;
esac
command=$(basename ${0})
log_date=$(date -u +"%Y%m%dT%H%M%SZ")
#
usage=" Usage : ${command} -i indir -idl_dir idl_dir -o outdir -t tempdir"
#
minargcount=8
#echo " narg ${#}"
if [ ${#} -lt ${minargcount} ]
then
   echo "eee : not enought arguments (${#} vs ${minargcount})"
   echo "${usage}"
   exit 1
fi
#
# default
# default IDL command and directory
#idl_dir=/usr/local_linux/idl/idl64/ # overriding idl_dir for test ++
#
# default indir directory
indir=$(pwd)
# default outdir directory
outdir=/tmp/
# default tempdir directory
tempdir=/tmp/
#
# read parameters on command line
while [ ! -z "${1}" ]
do
   case ${1} in
      -i)
         indir=${2}
         shift
      ;;
      -idl_dir)
         idl_dir=${2}
         shift
      ;;
      -o)
         # directory for outputs choosen by user
         outdir=${2}
         shift
      ;;
      -t)
         # directory for temporary outputs choosen by user
         tempdir=${2}
         shift
      ;;
      -h)
         echo "${usage}"
         exit 0
      ;;
      *)
         # other choice
         echo "${usage}"
         exit 1
      ;;
   esac
   # next flag
   shift
done
#
set -u
#
# test if ${indir} exist
if [ ! -d ${indir} ]
then
   echo "eee : ${indir} not found"
   exit 1
fi
#
# test if ${tempdir} exist
if [ ! -d ${tempdir} ]
then
    mkdir -p ${tempdir}
    echo "${command} : iii : creation of \${tempdir}"
fi
#
# check for permission on ${tempdir}
if [ ! -x ${tempdir} ]
then
   echo " eee : ${tempdir} not reachable"
   exit 1
fi
#
# test if ${outdir} exist
if [ ! -d ${outdir} ]
then
    mkdir -p ${outdir}
    echo "${command} : iii : creation of \${outdir}"
fi
#
# check for permission on ${outdir}
if [ ! -x ${outdir} ]
then
   echo " eee : ${outdir} not reachable"
   exit 1
fi
#
if [ ! -w ${outdir} ]
then
   echo " eee : ${outdir} not writable"
   exit 1
fi
#
log=${tempdir}/$(basename ${command} .sh).log.${log_date}
#
# ++ test si IDL (car GDL inutilisable)
application=${idl_dir}/bin/idl
#
# find cpt files
list_cpt_files=$(find ${indir} \! \( -name '.svn' -prune \) -name "*.cpt")
#
# test if at least one found
if [ "${list_cpt_files}" = "" ]
then
   echo "iii : no cpt files found under ++"
   echo "iii : nothing to do !"
   exit 0 #++ 1
fi
#
# header of XML/DocBook file
cat << EOF > ${tempdir}/showpalettes${log_date}.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article [
<!ENTITY promptidl "idl&gt;">
]>

<article version="5.0"
xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:lang="en"
xml:id="palettes">

<title>Palettes</title>
<para>
Here are available palettes.
</para>
<sect1>
<title>How to use ?</title>
<para>
++
</para>
</sect1>
<sect1>
<title>Available palettes</title>
<para>
++
</para>
<variablelist>
EOF
#
# loop on palette files
for cpt_file in ${list_cpt_files}
do
   cpt_bfile=$(basename ${cpt_file})
   cat << EOF >> ${tempdir}/showpalettes${log_date}.xml
<varlistentry>
<term><filename>${cpt_bfile}</filename></term>
<listitem>
<para>
<mediaobject>
<imageobject>
<imagedata fileref="figpng/${cpt_bfile}.png"/>
</imageobject>
</mediaobject>
</para>
</listitem>
</varlistentry>
EOF
done
#
# footer of XML/DocBook file
cat << EOF >> ${tempdir}/showpalettes${log_date}.xml
</variablelist>
</sect1>
<sect1>
<title>How to build ?</title>
<para>
++
</para>
</sect1>
</article>
EOF
#
mv ${tempdir}/showpalettes${log_date}.xml ${outdir}/showpalettes.xml
echo "iii : ${outdir}/showpalettes.xml can be processed"
#
# end
exit 0