Blame Scripts/Bash/Functions/Help/help.sh

4c79b5
#!/bin/bash
4c79b5
#
4c79b5
# help.sh -- This function provides documentation features to
4c79b5
# centos-art.sh script. Here we initialize documentation variables and
4c79b5
# call help_getActions functions.
4c79b5
#
4c79b5
# Copyright (C) 2009-2010 Alain Reguera Delgado
4c79b5
# 
4c79b5
# This program is free software; you can redistribute it and/or modify
4c79b5
# it under the terms of the GNU General Public License as published by
4c79b5
# the Free Software Foundation; either version 2 of the License, or
4c79b5
# (at your option) any later version.
4c79b5
# 
4c79b5
# This program is distributed in the hope that it will be useful, but
4c79b5
# WITHOUT ANY WARRANTY; without even the implied warranty of
4c79b5
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
4c79b5
# General Public License for more details.
4c79b5
#
4c79b5
# You should have received a copy of the GNU General Public License
4c79b5
# along with this program; if not, write to the Free Software
4c79b5
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
4c79b5
# USA.
4c79b5
# 
4c79b5
# ----------------------------------------------------------------------
4c79b5
# $Id: help.sh 79 2010-09-18 06:17:44Z al $
4c79b5
# ----------------------------------------------------------------------
4c79b5
    
4c79b5
function help {
4c79b5
    
4c79b5
    # Define documentation base directory structure.
4c79b5
    MANUALS_DIR[0]='/home/centos/artwork/trunk/Manuals'
4c79b5
    MANUALS_DIR[1]=${MANUALS_DIR[0]}/$(cli_getCurrentLocale)
4c79b5
    MANUALS_DIR[2]=${MANUALS_DIR[1]}/Texinfo/Repository
4c79b5
    MANUALS_DIR[3]=${MANUALS_DIR[1]}/Info/Repository
4c79b5
    MANUALS_DIR[4]=${MANUALS_DIR[1]}/Html/Repository
4c79b5
    MANUALS_DIR[5]=${MANUALS_DIR[1]}/Plaintext/Repository
4c79b5
    
4c79b5
    # Define template directory for texinfo files.
4c79b5
    MANUALS_DIR[6]=${MANUALS_DIR[0]}/en/Texinfo/Tpl
4c79b5
    
4c79b5
    # Define location for texinfo files.
4c79b5
    MANUALS_FILE[1]=${MANUALS_DIR[2]}/repository.texi
4c79b5
    MANUALS_FILE[2]=${MANUALS_DIR[2]}/repository-chapter-menu.texi
4c79b5
    MANUALS_FILE[3]=${MANUALS_DIR[2]}/repository-chapter-nodes.texi
4c79b5
    
4c79b5
    # Define location for texinfo output files.
4c79b5
    MANUALS_FILE[4]=${MANUALS_DIR[3]}/repository.info
4c79b5
    MANUALS_FILE[5]=${MANUALS_DIR[5]}/repository.txt
4c79b5
    
4c79b5
    # Define chapter's file names.
4c79b5
    MANUALS_FILE[6]=chapter.texi
4c79b5
    MANUALS_FILE[7]=chapter-intro.texi
4c79b5
    MANUALS_FILE[8]=chapter-menu.texi
4c79b5
    MANUALS_FILE[9]=chapter-nodes.texi
4c79b5
    
4c79b5
    # Define texinfo template to initialize new sections.
4c79b5
    MANUALS_FILE[10]=${MANUALS_DIR[6]}/repository-chapter-section.texi
4c79b5
    MANUALS_FILE[11]=${MANUALS_DIR[2]}/repository-chapter-index.texi
4c79b5
    
4c79b5
    # Define documentation entry.
4c79b5
    ENTRY=$(help_getEntry)
4c79b5
    
4c79b5
    # Define directory used to store chapter's documentation entries.
4c79b5
    # At this point, we need to take a desition about
4c79b5
    # documentation-design, in order to answer the question: How do we
4c79b5
    # assign chapters, sections and subsections automatically, based
4c79b5
    # on the repository structure? 
4c79b5
    #
4c79b5
    # One solution would be: to use three chapters only to represent
4c79b5
    # the repository's first level structure (i.e., trunk,
4c79b5
    # branches, and tags) and handle everything else as sections. Sub
4c79b5
    # and subsub section will not have their own files, they will be
4c79b5
    # written inside section files instead.
4c79b5
    ENTRYCHAPTER=$(echo $ENTRY | cut -d / -f-10)
4c79b5
    
4c79b5
    # Define chapter name for this documentation entry.
4c79b5
    CHAPTERNAME=$(basename $ENTRYCHAPTER)
4c79b5
    
4c79b5
    # Initialize documentation functions and path patterns.
4c79b5
    help_getActions
4c79b5
4c79b5
}