#!/bin/bash # -*- coding: utf-8 mode: sh -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8 function display_help() { uecho "$scriptname: générer un fichier $NAME USAGE $scriptname [options] OPTIONS -t TEMPLATE Indiquer le modèle de fichier à utiliser pour la génération. Les valeurs valides sont: ${TEMPLATES[*]} -e, --edit -g, --no-edit Editer (resp. ne pas éditer) le fichier après l'avoir généré. Par défaut, l'éditeur est lancé après la génération. -f, --overwrite Ecraser le fichier s'il existe déjà -E, --encoding ENCODING Spécifier l'encoding à utiliser pour la génération du fichier --doctype DOCTYPE -4, --html4 -5, --html5 Spécifier le type de document. Les options -4 et -5 sont équivalentes à --doctype html4 et --doctype html5, respectivement. -b, --baseurl BASEURL Spécifier le chemin à partir de la racine qui contient les resources blueprint et bootstrap -B, --bspath, --bppath CLPATH Spécifier le chemin sous BASEURL à partir duquel charger bootstrap ou blueprint. La valeur par défaut est 'bootstrap' pour l'option --bs, 'blueprint' pour l'option --bp -s, --bs, --bootstrap Activer le support de bootstrap. L'option --bs est automatiquement activée si l'option --bspath n'est pas utilisée et le répertoire [BASEURL/]bootstrap/ existe -p, --bp, --blueprint Activer le support de blueprint. L'option --bp est automatiquement activée si l'option --bppath n'est pas utilisée et le répertoire [BASEURL/]blueprint/ existe -n, --nobs, --no-bootstrap, --nobp, --no-blueprint Désactiver le support de bootstrap et blueprint -j, --jquery -k, --no-jquery Activer (resp. désactiver) le chargement de jQuery à partir de BASEURL pour les pages nues et avec blueprint. Avec bootstrap, le chargement de jQuery est toujours effectué et cette option est ignorée. --hl, --titlehl TITLEHL Spécifier le tag à utiliser pour le titre. Vaut par défaut 'h1' pour les templates HTML et PHP, 'h2' pour les templates overview et package -T, --title TITLE Spécifier le titre du document. --head-title HTITLE Spécifier le titre pour le tag dans la section <head>. La valeur par défaut est celle de l'option --title." } NAME=www TEMPLATES=(html javadoc-package javadoc-overview php cakephp-ctp css javascript) NAMES=(package.html overview.html) EXTS=(html htm php phps ctp css js) if [ $# -eq 2 ]; then if [ "$1" == "--matches-template" ]; then for template in "${TEMPLATES[@]}"; do [ "$template" == "$2" ] && exit 0 done exit 1 elif [ "$1" == "--matches-name" ]; then for name in "${NAMES[@]}"; do [ "$name" == "$2" ] && exit 0 done exit 1 elif [ "$1" == "--matches-ext" ]; then for ext in "${EXTS[@]}"; do [ "$ext" == "$2" ] && exit 0 done exit 1 fi fi #source /etc/ulib || exit 1 source "$(dirname "$0")/../ulib/ulib" || exit 1 urequire DEFAULTS function check_overwrite() { if [ -e "$1" -a -z "$overwrite" ]; then eerror "$1: refus d'écraser un fichier déjà existant (utiliser -f)" return 1 fi return 0 } function __update_title() { titlehl="$(strlower "$titlehl")" [ -n "$titlehl" ] || titlehl=h1 [ "${titlehl:0:1}" == "h" ] || titlehl="h$titlehl" [ -n "$title" ] || { title="$(basename "$file")" title="${title%.*}" } [ -n "$head_title" ] || head_title="$title" } function __generate_html() { # $file et $mode doivent être initialisés local dir="$(dirname "$file")" local nobpsuppl nobplocal nobpmobile if [ "$csslib" == auto ]; then if [ -n "$clpath" ]; then if [ "$clpath" == bootstrap -o -z "${clpath##*/bootstrap}" ]; then csslib=bootstrap elif [ "$clpath" == blueprint -o -z "${clpath##*/blueprint}" ]; then csslib=blueprint else csslib= fi elif [ -d "$dir/${baseurl#/}bootstrap" ]; then csslib=bootstrap elif [ -d "$dir/${baseurl#/}blueprint" ]; then csslib=blueprint else csslib= fi fi if [ "$csslib" == bootstrap ]; then [ -n "$clpath" ] || clpath=bootstrap elif [ "$csslib" == blueprint ]; then [ -n "$clpath" ] || clpath=blueprint [ -f "$dir/${baseurl#/}bpsuppl.css" ] || nobpsuppl=1 [ -f "$dir/${baseurl#/}bplocal.css" ] || nobplocal=1 [ -f "$dir/${baseurl#/}bpmobile.css" ] || nobpmobile=1 fi clpath="$baseurl$clpath" [ "${clpath:$((-1)):1}" == / ] || clpath="$clpath/" local jquerymin if [ "$jquery" == auto ]; then if [ "$csslib" == bootstrap ]; then jquery= elif [ -f "$dir/${baseurl#/}jquery.min.js" ]; then jquery=1 jquerymin=1 elif [ -f "$dir/${baseurl#/}jquery.js" ]; then jquery=1 else jquery= fi fi if [ "$doctype" == auto ]; then if [ "$csslib" == bootstrap ]; then doctype=html5 else doctype=html4 fi fi head='<head>' if [ "$doctype" == html5 ]; then head="$head "'<meta charset="'"$encoding"'">' else head="$head "'<meta http-equiv="Content-Type" content="text/html; charset='"$encoding"'" />' fi if [ "$csslib" == bootstrap ]; then head="$head "'<meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="shortcut" href="'"$clpath"'favicon.ico" /> <link rel="icon apple-touch-icon" href="'"$clpath"'icon.png" />' csslib='<link href="'"$clpath"'bootstrap/css/bootstrap.min.css" rel="stylesheet"/> <script src="'"$clpath"'jquery.min.js" type="text/javascript"></script> <script src="'"$clpath"'bootstrap/js/bootstrap.min.js" type="text/javascript"></script> <!--[if lt IE 9]> <script src="'"$clpath"'html5shiv/html5shiv.js"></script> <script src="'"$clpath"'respond/respond.min.js"></script> <![endif]-->' startcl='<div class="container">' endcl='</div>' elif [ "$csslib" == blueprint ]; then head="$head "'<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="shortcut" href="'"$baseurl"'favicon.ico" /> <link rel="icon apple-touch-icon" href="'"$baseurl"'icon.png" />' csslib='<link rel="stylesheet" href="'"$clpath"'screen.css" type="text/css" media="screen, projection" /> <link rel="stylesheet" href="'"$clpath"'print.css" type="text/css" media="print" /> <!--[if lt IE 8]> <link rel="stylesheet" href="'"$clpath"'ie.css" type="text/css" media="screen, projection" /> <![endif]--> <'"${nobpsuppl:+!--}"'link rel="stylesheet" href="'"$baseurl"'bpsuppl.css" type="text/css" media="screen, projection" /'"${nobpsuppl:+--}"'> <'"${nobplocal:+!--}"'link rel="stylesheet" href="'"$baseurl"'bplocal.css" type="text/css" media="screen, projection" /'"${nobplocal:+--}"'> <'"${nobpmobile:+!--}"'link rel="stylesheet" href="'"$baseurl"'bpmobile.css" type="text/css" media="handheld, only screen and (max-device-width: 480px)" /'"${nobpmobile:+--}"'>' startcl='<div class="container">' endcl='</div>' else # pas de csslib ou csslib non supporté head="$head "'<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="shortcut" href="'"$baseurl"'favicon.ico" /> <link rel="icon apple-touch-icon" href="'"$baseurl"'icon.png" />' csslib= startcl= endcl= fi if [ -n "$jquery" ]; then jquery='<script src="'"${baseurl}jquery${jquerymin:+.min}.js"'"></script>' fi start='<title>'"$head_title"' ' end=' ' case "$doctype" in html4) doctype='' html='' ;; html5) doctype='' html='' ;; *) doctype= html='' ;; esac } function __before_write_html() { doctype="$doctype" } function __write_html() { # $file et $mode doivent être initialisés check_overwrite "$1" || return estep "$(ppath "$file")" echo >"$file" "$doctype$html $head ${csslib:+$csslib }${jquery:+$jquery }$start ${csslib:+$startcl }${title:+<$titlehl>$title }${csslib:+$endcl }$end" } function generate_html() { local file="$1" local mode=html local titlehl="${titlehl:-h1}" local title="$title" __update_title local doctype="$doctype" local csslib="$csslib" local jquery="$jquery" local html head start startcl endcl end __generate_html __before_write_html __write_html [ -n "$2" ] && array_add "$2" "$file" return 0 } function generate_javadoc_package() { local file="$1" local mode=html local titlehl="${titlehl:-h2}" local title="$title" __update_title # title doit se terminer par un point [ "${title:$((-1)):1}" == / ] || title="$title." # Mettre un préfixe au titre title="Package: $title" local doctype="$doctype" local csslib bootstrap jquery html head start startcl endcl end __generate_html __before_write_html __write_html [ -n "$2" ] && array_add "$2" "$file" return 0 } function generate_javadoc_overview() { local file="$1" local mode=html local titlehl="${titlehl:-h2}" local title="$title" __update_title # title doit se terminer par un point [ "${title:$((-1)):1}" == / ] || title="$title." # Mettre un préfixe au titre title="Projet: $title" local doctype="$doctype" local csslib bootstrap jquery html head start startcl endcl end __generate_html __before_write_html __write_html [ -n "$2" ] && array_add "$2" "$file" return 0 } function generate_php() { local file="$1" local mode=php local titlehl="${titlehl:-h1}" local title="$title" __update_title local doctype="$doctype" local csslib="$csslib" local jquery="$jquery" local html head start startcl endcl end __generate_html doctype="${doctype:+$doctype }" __write_html [ -n "$2" ] && array_add "$2" "$file" return 0 } function generate_cakephp_ctp() { local file="$1" local mode=php check_overwrite "$1" || return estep "$(ppath "$file")" echo >"$file" ""$file" "/* -*- coding: $encoding ${mode:+mode: $mode }-*- vim:sw=4:sts=4:et:ai:si:sta:fenc=$encoding */@CHARSET \"$encoding\";" [ -n "$2" ] && array_add "$2" "$file" return 0 } function generate_javascript() { local file="$1" local mode=javascript check_overwrite "$1" || return estep "$(ppath "$file")" echo >"$file" "/* -*- coding: $encoding ${mode:+mode: $mode }-*- vim:sw=4:sts=4:et:ai:si:sta:fenc=$encoding */" [ -n "$2" ] && array_add "$2" "$file" return 0 } template= edit=1 overwrite= encoding= doctype=auto baseurl=/ clpath= csslib=auto jquery=auto titlehl= title= head_title= parse_opts "${PRETTYOPTS[@]}" \ --help '$exit_with display_help' \ -t:,--template: template= \ -e,--edit edit=1 \ -g,--no-edit edit= \ -f,--overwrite overwrite=1 \ -E:,--encoding: encoding= \ --doctype: doctype= \ -4,--html4 doctype=html4 \ -5,--html5 doctype=html5 \ -b:,--baseurl: baseurl= \ -B:,--bspath:,--bppath: clpath= \ -s,--bootstrap,--bs csslib=bootstrap \ -p,--blueprint,--bp csslib=blueprint \ -n,--no-bootstrap,--nobootstrap,--nobs,--no-blueprint,--noblueprint,--nobp csslib= \ -j,--jquery jquery=1 \ -k,--no-jquery,--nojquery jquery= \ --titlehl:,--hl: titlehl= \ -T:,--title: title= \ --head-title: head_title= \ @ args -- "$@" && set -- "${args[@]}" || die "$args" [ -n "$encoding" ] || encoding=utf-8 [ -z "$baseurl" -o "${baseurl:$((-1)):1}" == / ] || baseurl="$baseurl/" files2edit=() r=0 for file in "$@"; do t="$template" if [ -z "$t" ]; then dir="$(dirname "$file")" name="$(basename "$file")" # Si template n'est pas spécifié, le déterminer le cas échéant à partir # du nom de fichier. Rajouter ici le code approprié case "$name" in overview.html) t=javadoc-overview;; package.html) t=javadoc-package;; esac fi case "$t" in html|htm) generate_html "$file" files2edit || r=$?;; javadoc-package|jdp) generate_javadoc_package "$file" files2edit || r=$?;; jadadoc-overview|jdo) generate_javadoc_overview "$file" files2edit || r=$?;; php|phps) generate_php "$file" files2edit || r=$?;; cakephp-ctp|ctp) generate_cakephp_ctp "$file" files2edit || r=$?;; css) generate_css "$file" files2edit || r=$?;; javascript|js) generate_javascript "$file" files2edit || r=$?;; *) die "$NAME: template invalide: $t";; esac done if [ -n "$edit" -a "${#files2edit[*]}" -gt 0 ]; then "${EDITOR:-vi}" "${files2edit[@]}" fi exit $r