See the notes about overall structure in Section 23.19, “MonthCell.__birdForm(): Render one
BirdForm”.
# - - - M o n t h C e l l . _ _ s i n g le S i g h t i n g
def __singleSighting ( self, parent, birdForm ):
'''Render the single-sighting case of a bird form.
[ (parent is an et.element) and
(birdForm is a birdnotes.BirdForm instance with
one sighting) ->
parent +:= (that sighting's age-sex-group) +
(that sighting's loc-group, if any) +
(that sighting's sighting-notes, if any) ]
'''
See Section 23.26, “MonthCell.__ageSexGroup(): Render
age-sex-group content”.
#-- 1 --
# [ sight := the first child sighting of birdForm ]
sight = birdForm[0]
#-- 2 --
# [ if sight.ageSexGroup is not None ->
# parent +:= XHTML rendering of sight.ageSexGroup
# else -> I ]
if sight.ageSexGroup is not None:
self.__ageSexGroup ( parent, sight.ageSexGroup )
See Section 23.22, “MonthCell.__locGroup(): Render a
locality group”.
#-- 3 --
# [ paretn +:= XHTML rendering of sight's effective locality ]
self.__locGroup ( parent, sight.getLocGroup() )
See Section 23.23, “MonthCell.__sightNotes(): Render a
sighting notes group”.
#-- 4 --
# [ if sight.sightNotes is not None ->
# parent +:= XHTML rendering of sight.sightNotes
# else -> I ]
if sight.sightNotes is not None:
self.__sightNotes ( parent, sight.sightNotes )