Blame Scripts/Bash/Functions/Manual/manual.sh

4c79b5
#!/bin/bash
4c79b5
#
4de5d4
# manual.sh -- This function provides documentation features to
4c79b5
# centos-art.sh script. Here we initialize documentation variables and
4de5d4
# call manual_getActions functions.
4c79b5
#
7cd8e9
# Copyright (C) 2009, 2010 Alain Reguera Delgado
4c79b5
# 
7cd8e9
# This program is free software; you can redistribute it and/or
7cd8e9
# modify it under the terms of the GNU General Public License as
7cd8e9
# published by the Free Software Foundation; either version 2 of the
7cd8e9
# License, or (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
# ----------------------------------------------------------------------
418249
# $Id$
4c79b5
# ----------------------------------------------------------------------
4c79b5
    
4de5d4
function manual {
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.
4de5d4
    ENTRY=$(manual_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)
4456e8
4c79b5
    # Define chapter name for this documentation entry.
4c79b5
    CHAPTERNAME=$(basename $ENTRYCHAPTER)
4456e8
4c79b5
    # Initialize documentation functions and path patterns.
4de5d4
    manual_getActions
4c79b5
4c79b5
}