File: thumbspage/build/x-publish-external-demos-prod/_generate-@-trnpix.sh

#===================================================================
# Generate trnpix galleries, but do not upload them.
# Run this script in its own folder, with 'bash _generate.sh'.
#
# This is also run as a subscript from this folder's _publish.py 
# prior to automatic uploads.  
#
# thumbspage's examples/trnpix runs this too, to ensure that trnpix
# results copied are current (but examples/dynamiclayout does not).
#
#=====================================================================
# [2.3] UPDATE: this now also builds a second index page for the 
# gallery, with thumbspage dynamic-index layout for less horizontal
# scrolling on typical mobile devices (i.e., candy-bar phones).  Open 
# its index-dynamic.html to view the alternative index page.  A link
# to the other index page is inserted into both indexes automatically.
#
# Details: as coded, the dynamic-alternative build creates a second 
# index page, but also remakes both thumbnails and viewer pages in a 
# second folder.  It's possible to instead reuse a single and shared 
# thumbs+viewers folder and skip thumbnail rebuilds (by simply using 
# the default folder name in the second build below).  But a second 
# folder allows thumbs size to vary if desired (e.g., smaller for 
# mobile), and also ensures that each variant's viewer pages return
# to its own index page on Index button taps.  This also replaces a
# _HEADER.html tag to make HEADER.html twice, for preamble links.
#
# Discussion: 2.3's new .5 'em' dynamic-layout scheme packs labels 
# tighter, so the new dynamic variant now renders as more than one 
# column on larger phones.  It's still not the index.html default,
# because it can leave some extra empty space on the right for some 
# window sizes on desktop, and this website's traffic is 71% desktop 
# over the last year (and probably higher, given analytics disabling).  
#
# Moreover, fixed layout may be preferred for the 26% mobile-browser 
# audience too.  Fixed requires minor horizontal scrolling in portrait
# on mobile, but not once a user is inside the gallery.  And smaller 
# phones may still display just one column of thumbnails in dynamic
# layout, which makes for a lot more vertical scrolling in this > 100 
# image gallery; dynamic largely trades hscrolls for vscrolls.
#
# OTOH, most full-size photos are larger in portrait, so rotating 
# to landscape to reduce hscrolls isn't a good workaround for mobile. 
# The real issue here is that most mobiles' form factors make them 
# inherently subpar for viewing nontrivial content; see foldables!
#=====================================================================

source ~/MY-STUFF/Websites/_admin/BUILD-THUMBSPAGE-CLIENTS/common.sh


#---------------------------------------------------------------------
# 1) Default index page: fixed layout
# make thumbs, viewer pages, and default index.html
#---------------------------------------------------------------------


# replace header tag
note='<A HREF="index-dynamic.html">dynamic-layout</A> alternative \
      resizes to fill space and avoids horizontal scrolls on mobile'

py3 -c \
    "open('HEADER.html',  'w', encoding='utf8').write( \
     open('_HEADER.html', 'r', encoding='utf8').read().replace('\$ALTPAGE\$', '$note'))"

        
# build gallery
py3 $C/thumbspage/thumbspage.py . \
           INDEX=\'index\' \
           useDynamicIndexLayout=False \
           inputCleanThumbsFolder=True inputThumbsPerRow=4 \
           inputThumbMaxSize=100 inputUseViewerPages=True \
           popupFgColor=\'tan\' \
           popupOpacity=0.45 \
           omitIndexPageLabels=False


#---------------------------------------------------------------------
# 2) Alternative index page: dynamic layout
# make new thumbs and viewer pages, and index-dynamic.html
#---------------------------------------------------------------------


# replace header tag
note='<A HREF="index.html">fixed-layout</A> alternative \
      expands to fill space and requires horizontal scrolls on mobile'

py3 -c \
    "open('HEADER.html',  'w', encoding='utf8').write( \
     open('_HEADER.html', 'r', encoding='utf8').read().replace('\$ALTPAGE\$', '$note'))"


# build gallery
py3 $C/thumbspage/thumbspage.py . \
           INDEX=\'index-dynamic\' \
           THUMBS=\'_thumbspage-dynamic\' \
           useDynamicIndexLayout=True \
           dynamicLayoutPaddingH=\'6px\' \
           dynamicLayoutPaddingV=\'6px\' \
           inputCleanThumbsFolder=True \
           inputThumbMaxSize=100 inputUseViewerPages=True \
           popupFgColor=\'tan\' \
           popupOpacity=0.45 \
           omitIndexPageLabels=False


#---------------------------------------------------------------------
# Prior build-command form (doc only)
#---------------------------------------------------------------------


## old style: use bash here document for console inputs
## use all defaults except muted white popup text (#dddddd == #ddd)
##
## py3 $C/thumbspage/thumbspage.py . popupFgColor=\'#dddddd\' <<-EOF
##	
##	
##	
##	
##	EOF



[Home page] Books Code Blog Python Author Train Find ©M.Lutz