Blob Blame History Raw
#!/bin/bash
#
# render_doBaseActions.sh -- This function performs base-rendition
# action for all files.
#
# Copyright (C) 2009, 2010, 2011 The CentOS Artwork SIG
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or (at
# your option) any later version.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
# ----------------------------------------------------------------------
# $Id$
# ----------------------------------------------------------------------

function render_doBaseActions {

    local -a FILES
    local FILE=''
    local OUTPUT=''
    local TEMPLATE=''
    local PARENTDIR=''
    local EXTENSION=''
    local TRANSLATION=''
    local EXTERNALFILE=''
    local EXTERNALFILES=''
    local THIS_FILE_DIR=''
    local NEXT_FILE_DIR=''
    local COUNT=0

    # Verify default directory where design models are stored in.
    cli_checkFiles "$(cli_getRepoTLDir)/Identity/Models/Themes/${FLAG_THEME_MODEL}" --directory

    # Define the extension pattern for template files. This is the
    # file extensions that centos-art will look for in order to build
    # the list of files to process. The list of files to process
    # contains the files that match this extension pattern.
    EXTENSION='(svgz|svg|docbook)'

    # Redefine parent directory for current workplace.
    PARENTDIR=$(basename "${ACTIONVAL}")

    # Define base location of template files.
    render_getDirTemplate
    
    # Define the list of files to process. Use an array variable to
    # store the list of files to process. This make posible to realize
    # verifications like: is the current base directory equal to the
    # next one in the list of files to process?  Questions like this
    # is let us to know when centos-art.sh is leaving a directory
    # structure and entering another. This information is required in
    # order for centos-art.sh to know when to apply last-rendition
    # actions.
    #
    # Another issue is that some directories might be named as if they
    # were files (e.g., using a renderable extension like .docbook).
    # In these situations we need to avoid such directories from being
    # interpreted as a renderable file. For this, pass the
    # `--type="f"' option when building the list of files to process
    # in order to retrive regular files only.
    #
    # Another issue to consider here, is that in some cases both
    # templates and outputs might be in the same location. In these
    # cases localized content are stored in the same location where
    # template files are retrived from and we need to avoid using
    # localized content from being interpreted as design models. In
    # that sake, supress language-specific files from the list of
    # files to process.
    #
    # Another issue to consider here, is the way of filtering. We
    # cannot expand the pattern specified by FLAG_FILTER with a `.*'
    # here (e.g., "${FLAG_FILTER}.*\.${EXTENSION}") because tha would
    # suppress any possibility of the user to specifiy just one file
    # name in locations where more than one file with the same name as
    # prefix exists (e.g., `repository.docbook',
    # `repository-preamble.docbook' and `repository-parts.docbook').
    # Instead, pass control of this to the user whom can use regular
    # expression markup in the `--filter' option to decide whether to
    # match `repository.docbook' (e.g., through
    # `--filter="repository"') or both `repository-preamble.docbook'
    # and `repository-parts.docbook' (e.g., through
    # `--filter="repository.*"').
    for FILE in $(cli_getFilesList ${TEMPLATE} \
        --pattern="${FLAG_FILTER}\.${EXTENSION}" --type="f" \
        | egrep -v '/[[:alpha:]]{2}_[[:alpha:]]{2}/');do
        FILES[((++${#FILES[*]}))]=$FILE
    done

    # Start processing the base rendition list of FILES. Fun part
    # approching :-).
    while [[ $COUNT -lt ${#FILES[*]} ]];do

        # Define base file.
        FILE=${FILES[$COUNT]}

        # Define the base directory path for the current file being
        # process.
        THIS_FILE_DIR=$(dirname ${FILES[$COUNT]})

        # Define the base directory path for the next file that will
        # be process.
        if [[ $(($COUNT + 1)) -lt ${#FILES[*]} ]];then
            NEXT_FILE_DIR=$(dirname ${FILES[$(($COUNT + 1))]})
        else
            NEXT_FILE_DIR=''
        fi

        # Print separator line.
        cli_printMessage '-' --as-separator-line

        # Define final location of translation file.
        TRANSLATION=$(dirname $FILE \
           | sed -r 's!trunk/(Manuals|Identity)!trunk/Locales/\1!')/$(cli_getCurrentLocale)/messages.po

        # Print final location of translation file.
        if [[ ! -f "$TRANSLATION" ]];then
            cli_printMessage "`gettext "None"`" --as-translation-line
        else
            cli_printMessage "$TRANSLATION" --as-translation-line
        fi

        # Define final location of template file.
        TEMPLATE=${FILE}

        # Print final location of template file.
        if [[ ! -f "$TEMPLATE" ]];then
            cli_printMessage "`gettext "None"`" --as-design-line
        else
            cli_printMessage "$TEMPLATE" --as-design-line
        fi
 
        # Define final location of output directory.
        render_getDirOutput

        # Get relative path to file. The path string (stored in FILE)
        # has two parts: 1. the variable path and 2. the common path.
        # The variable path is before the common point in the path
        # string. The common path is after the common point in the
        # path string. The common point is the name of the parent
        # directory (stored in PARENTDIR).
        #
        # Identity/Models/Themes/.../Firstboot/3/splash-small.svg
        # -------------------------^| the     |^------------^
        # variable path             | common  |    common path
        # -------------------------v| point   |    v------------v
        # Identity/Images/Themes/.../Firstboot/Img/3/splash-small.png
        #
        # What we do here is remove the varibale path, the common
        # point, and the file extension parts in the string holding
        # the path retrived from design models directory structure.
        # Then we use the common path as relative path to store the
        # the final image file.
        #
        # The file extension is removed from the common path because
        # it is set when we create the final image file. This
        # configuration let us use different extensions for the same
        # file name.
        #
        # When we render using base-rendition action, the structure of
        # files under the output directory will be the same used after
        # the common point in the related design model directory
        # structure.
        FILE=$(echo ${FILE} \
            | sed -r "s!.*${PARENTDIR}/!!" \
            | sed -r "s/\.${EXTENSION}$//")

        # Define absolute path to final file (without extension).
        FILE=${OUTPUT}/$(basename "${FILE}")

        # Define instance name from design model.
        INSTANCE=$(cli_getTemporalFile ${TEMPLATE})

        # Apply translation file to design model to produce the design
        # model translated instance. 
        render_doTranslation

        # Expand translation markers inside design model instance.
        cli_replaceTMarkers ${INSTANCE}

        # Redefine name of rendition backend based on the file
        # extension of template instance.
        if [[ $INSTANCE =~ '\.(svgz|svg)$' ]];then
            RENDER_BACKEND='svg'
        elif [[ $INSTANCE =~ '\.docbook$' ]];then
            RENDER_BACKEND='docbook'
        else
            cli_printMessage "`gettext "The template file you try to render is not supported yet."`" --as-error-line
        fi

        # Initialize backend-specific functionalities.
        cli_exportFunctions "${RENDER_BACKEND_DIR}/$(cli_getRepoName \
            ${RENDER_BACKEND} -d)" "${RENDER_BACKEND}"

        # Perform backend base-rendition.
        ${RENDER_BACKEND}

        # Perform backend post-rendition.
        ${RENDER_BACKEND}_doPostActions

        # Perform backend last-rendition.
        ${RENDER_BACKEND}_doLastActions

        # Unset backend-specific functionalities from environment.
        # This is required to prevent end up with more than one
        # backend-specifc function initialization, in those cases when
        # different template files are rendered in just one execution
        # of `centos-art.sh' script.
        cli_unsetFunctions "${RENDER_BACKEND_DIR}/$(cli_getRepoName \
            ${RENDER_BACKEND} -d)" "${RENDER_BACKEND}"

        # Remove template instance. 
        if [[ -f $INSTANCE ]];then
            rm $INSTANCE
        fi

        # Increment file counter.
        COUNT=$(($COUNT + 1))

    done

}