# # Gramps - a GTK+/GNOME based genealogy program # # Copyright (C) 2007 Thom Sturgill # Copyright (C) 2007-2009 Brian G. Matherly # Copyright (C) 2008-2009 Rob G. Healey # Copyright (C) 2008 Jason Simanek # Copyright (C) 2008 Kees Bakker # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Pubilc 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # $Id$ """ Web Calendar generator. Refactoring. This is an ongoing job until this plugin is in a better shape. TODO list: - progress bar, rethink its usage - in year navigation, use month in link, or 'fullyear' - use standard Gramps method to display surname, see _get_regular_surname - daylight saving not just for USA and Europe - move the close_file() from one_day() to caller """ #------------------------------------------------------------------------ # # python modules # #------------------------------------------------------------------------ import os import time import datetime import calendar import codecs import shutil from gettext import gettext as _ from gettext import ngettext #------------------------------------------------------------------------ # # Set up logging # #------------------------------------------------------------------------ import logging log = logging.getLogger(".WebPage") #------------------------------------------------------------------------ # # GRAMPS module # #------------------------------------------------------------------------ import gen.lib import const from GrampsCfg import get_researcher from gen.plug import PluginManager from ReportBase import Report, ReportUtils, MenuReportOptions, CATEGORY_WEB from gen.plug.menu import BooleanOption, NumberOption, StringOption, \ EnumeratedListOption, FilterOption, PersonOption, \ DestinationOption import Utils import GrampsLocale from QuestionDialog import WarningDialog from Utils import probably_alive from DateHandler import displayer as _dd from DateHandler import parser as _dp import libholiday #------------------------------------------------------------------------ # # constants # #------------------------------------------------------------------------ # This information defines the list of styles in the Web calendar # options dialog as well as the location of the corresponding SCREEN # stylesheets. _CSS_FILES = [ # First is used as default selection. [_("Basic-Ash"), 'Web_Basic-Ash.css'], [_("Basic-Cypress"), 'Web_Basic-Cypress.css'], [_("Basic-Lilac"), 'Web_Basic-Lilac.css'], [_("Basic-Peach"), 'Web_Basic-Peach.css'], [_("Basic-Spruce"), 'Web_Basic-Spruce.css'], [_("Mainz"), 'Web_Mainz.css'], [_("Nebraska"), 'Web_Nebraska.css'], [_("Visually Impaired"), 'Web_Visually.css'], [_("No style sheet"), ''], ] _CHARACTER_SETS = [ # First is used as default selection. [_('Unicode (recommended)'), 'utf-8'], ['ISO-8859-1', 'iso-8859-1' ], ['ISO-8859-2', 'iso-8859-2' ], ['ISO-8859-3', 'iso-8859-3' ], ['ISO-8859-4', 'iso-8859-4' ], ['ISO-8859-5', 'iso-8859-5' ], ['ISO-8859-6', 'iso-8859-6' ], ['ISO-8859-7', 'iso-8859-7' ], ['ISO-8859-8', 'iso-8859-8' ], ['ISO-8859-9', 'iso-8859-9' ], ['ISO-8859-10', 'iso-8859-10' ], ['ISO-8859-13', 'iso-8859-13' ], ['ISO-8859-14', 'iso-8859-14' ], ['ISO-8859-15', 'iso-8859-15' ], ['koi8_r', 'koi8_r', ], ] _CC = [ '', '' 'Creative Commons License - By attribution', '' 'Creative Commons License - By attribution, No derivations', '' 'Creative Commons License - By attribution, Share-alike', '' 'Creative Commons License - By attribution, Non-commercial', '' 'Creative Commons License - By attribution, Non-commercial, No derivations', '' 'Creative Commons License - By attribution, Non-commerical, Share-alike' ] _COPY_OPTIONS = [ _('Standard copyright'), # This must match _CC _('Creative Commons - By attribution'), _('Creative Commons - By attribution, No derivations'), _('Creative Commons - By attribution, Share-alike'), _('Creative Commons - By attribution, Non-commercial'), _('Creative Commons - By attribution, Non-commercial, No derivations'), _('Creative Commons - By attribution, Non-commercial, Share-alike'), _('No copyright notice'), ] # Compute the first day to display for this month. # It can also be a day in the previous month. def get_first_day(year, month): current_date = datetime.date(year, month, 1) # first day of the month # monthinfo is filled using standard Python library # calendar.monthcalendar. It fills a list of 7-day-lists. The first day # of the 7-day-list is determined by calendar.firstweekday. monthinfo = calendar.monthcalendar(year, month) current_ord = current_date.toordinal() - monthinfo[0].count(0) return current_date, current_ord, monthinfo # get last month's last week for previous days in the month def get_previous_day(year, month, day_col): if month == 1: prevmonth = calendar.monthcalendar(year - 1, 12) else: prevmonth = calendar.monthcalendar(year, month-1) num_weeks = len(prevmonth) lastweek_prevmonth = prevmonth[num_weeks - 1] return lastweek_prevmonth[day_col] # get next month's first week for next days in the month def get_next_day(year, month, day_col): if month == 12: nextmonth = calendar.monthcalendar(year + 1, 1) else: nextmonth = calendar.monthcalendar(year, month + 1) firstweek_nextmonth = nextmonth[0] return firstweek_nextmonth[day_col] #------------------------------------------------------------------------ # # WebCalReport # #------------------------------------------------------------------------ class WebCalReport(Report): """ Create WebCalReport object that produces the report. """ def __init__(self, database, options): Report.__init__(self, database, options) menu = options.menu self.database = database self.options = options self.html_dir = menu.get_option_by_name('target').get_value() self.title_text = menu.get_option_by_name('title').get_value() filter_option = menu.get_option_by_name('filter') self.filter = filter_option.get_filter() self.ext = menu.get_option_by_name('ext').get_value() self.copy = menu.get_option_by_name('cright').get_value() self.encoding = menu.get_option_by_name('encoding').get_value() self.css = menu.get_option_by_name('css').get_value() self.country = menu.get_option_by_name('country').get_value() self.start_dow = menu.get_option_by_name('start_dow').get_value() self.partyear = menu.get_option_by_name('partyear').get_value() self.multiyear = menu.get_option_by_name('multiyear').get_value() self.start_year = menu.get_option_by_name('start_year').get_value() self.end_year = menu.get_option_by_name('end_year').get_value() self.fullyear = menu.get_option_by_name('fullyear').get_value() self.maiden_name = menu.get_option_by_name('maiden_name').get_value() self.alive = menu.get_option_by_name('alive').get_value() self.birthday = menu.get_option_by_name('birthdays').get_value() self.anniv = menu.get_option_by_name('anniversaries').get_value() self.home_link = menu.get_option_by_name('home_link').get_value().strip() self.month_notes = [menu.get_option_by_name('note_jan').get_value(), menu.get_option_by_name('note_feb').get_value(), menu.get_option_by_name('note_mar').get_value(), menu.get_option_by_name('note_apr').get_value(), menu.get_option_by_name('note_may').get_value(), menu.get_option_by_name('note_jun').get_value(), menu.get_option_by_name('note_jul').get_value(), menu.get_option_by_name('note_aug').get_value(), menu.get_option_by_name('note_sep').get_value(), menu.get_option_by_name('note_oct').get_value(), menu.get_option_by_name('note_nov').get_value(), menu.get_option_by_name('note_dec').get_value()] # identify researcher name and e-mail address # as Narrated WebSite already does researcher = get_researcher() self.author = researcher.name if self.author: self.author = self.author.replace(',,,', '') self.email = researcher.email self.start_month = 1 # set to January, and it can change self.end_month = 12 # set to December, this value never changes today = time.localtime() # set to today's date self.today = datetime.date(today[0], today[1], today[2]) self.warn_dir = True # Only give warning once. self.imgs = [] # self.calendar is a dict; key is the month number # Each entry in the dict is also a dict; key is the day number. # The day dict is a list of things to display for that day. # These things are: birthdays and anniversaries self.calendar = {} calendar.setfirstweekday(_dow_gramps2iso[self.start_dow]) def copy_file(self, from_fname, to_fname, to_dir=''): """ Copy a file from a source to a (report) destination. If to_dir is not present and if the target is not an archive, then the destination directory will be created. Normally 'to_fname' will be just a filename, without directory path. 'to_dir' is the relative path name in the destination root. It will be prepended before 'to_fname'. """ dest = os.path.join(self.html_dir, to_dir, to_fname) destdir = os.path.dirname(dest) if not os.path.isdir(destdir): os.makedirs(destdir) if from_fname != dest: shutil.copyfile(from_fname, dest) elif self.warn_dir: WarningDialog( _("Possible destination error") + "\n" + _("You appear to have set your target directory " "to a directory used for data storage. This " "could create problems with file management. " "It is recommended that you consider using " "a different directory to store your generated " "web pages.")) self.warn_dir = False def add_day_item(self, text, year, month, day, event): if day == 0: # This may happen for certain "about" dates. day = 1 # Use first day of the month month_dict = self.calendar.get(month, {}) day_list = month_dict.get(day, []) if month > 0: try: event_date = gen.lib.Date() event_date.set_yr_mon_day(year, month, day) except ValueError: event_date = '...' else: event_date = '...' #Incomplete date as in about, circa, etc. day_list.append((text, event, event_date)) month_dict[day] = day_list self.calendar[month] = month_dict def __get_holidays(self, year): """ Get the holidays for the specified country and year """ holiday_table = libholiday.HolidayTable() country = holiday_table.get_countries()[self.country] holiday_table.load_holidays(year, country) for month in range(1, 13): for day in range(1, 32): holiday_names = holiday_table.get_holidays(month, day) for holiday_name in holiday_names: self.add_holiday_item(holiday_name, year, month, day) def add_holiday_item(self, text, year, month, day): if day == 0: # This may happen for certain "about" dates. day = 1 # Use first day of the month month_dict = self.holidays.get(month, {}) day_list = month_dict.get(day, []) day_list.append(text) month_dict[day] = day_list self.holidays[month] = month_dict def copy_calendar_files(self): """ Copies all the necessary files """ # Copy the normal stylesheet if self.css != "": fname = os.path.join(const.DATA_DIR, self.css) self.copy_file(fname, self.css, "styles") # copy print stylesheet fname = os.path.join(const.DATA_DIR, "Web_Print-Default.css") self.copy_file(fname, "Web_Print-Default.css", "styles") # Copy GRAMPS favicon fname = os.path.join(const.IMAGE_DIR, "favicon.ico") self.copy_file(fname, "favicon.ico", "images") # copy copyright image if 0 < self.copy < len(_CC): fname = os.path.join(const.IMAGE_DIR, 'somerights20.gif') self.copy_file(fname, 'somerights20.gif', 'images') for f in self.imgs: from_path = os.path.join(const.IMAGE_DIR, f) self.copy_file(from_path, f, "images") def display_month_navs(self, of, nr_up, year, currentsection, use_home=False): """ Will create and display the navigation menu bar use_home will produce a link to wherever you specify as a home link cal is one of these: od = one_day(), wc = normal_cal(), yg = year_glance(), by = blank_year() """ navs = [] # check to see if we are using a home link??? if use_home: navs.append((self.home_link, _('Home'), True)) for month in range(self.start_month, self.end_month + 1): navs.append((month, month, True)) # Add a link for year_glance() if requested navs.append(('fullyear', _('Year Glance'), self.fullyear)) of.write('\n\n') def display_year_navs(self, of, nr_up, currentsection): """ This will create the year navigation menu bar """ of.write('\n\n') def calendar_common(self, of, nr_up, year, currsec1, title, use_home=False): """ Will create the common information for each calendar being created """ # Header Title of.write('\n') # end header if self.multiyear: # create Year Navigation menu self.display_year_navs(of, nr_up, str(year)) # adjust the months being created if self.partyear is True # and year is eequal to current year, then start_month is current month self.start_month = 1 if year == self.today.year: if self.partyear: self.start_month = self.today.month # Create Month Navigation Menu # identify currentsection for proper highlighting self.display_month_navs(of, nr_up, year, currsec1, use_home) of.write('
\n') def calendar_build(self, of, cal, year, month): """ This does the work of building the calendar 'cal' - one of "yg", "wc" 'month' - month number 1, 2, .., 12 """ # define names for long and short month names full_month_name = _get_full_month_name(month) abbr_month_name = _get_short_month_name(month) # dow (day-of-week) uses Gramps numbering, sunday => 1, etc start_dow = self.start_dow col2day = [(x-1)%7+1 for x in range(start_dow, start_dow + 7)] # Translate a Gramps day number into a HTMLclass def get_class_for_daycol(col): day = col2day[col] if day == 1: return "weekend sunday" elif day == 7: return "weekend saturday" return "weekday" def get_name_for_daycol(col): day = col2day[col] return day_names[day] # Note. GrampsLocale has sunday => 1, monday => 2, etc # We slice out the first empty element. day_names = GrampsLocale.long_days # Begin calendar head. We'll use the capitalized name, because here it # seems appropriate for most countries. month_name = full_month_name.capitalize() th_txt = month_name if cal == 'wc': # normal_cal() if not self.multiyear: th_txt = '%s %d' % (month_name, year) of.write('\n\n' % month_name) of.write('\n' % month_name) of.write('\t\n') of.write('\t\t\n') of.write('\t\t\t\n' % th_txt) of.write('\t\t\n') # Calendar weekday names header of.write('\t\t\n') for day_col in range(7): dayclass = get_class_for_daycol(day_col) dayname = get_name_for_daycol(day_col) of.write('\t\t\t\n' % dayname[0]) of.write('\t\t\n') of.write('\t\n') # begin table body of.write('\t\n') current_date, current_ord, monthinfo = get_first_day(year, month) nweeks = len(monthinfo) for week_row in range(0, nweeks): week = monthinfo[week_row] # if you look this up in wikipedia, the first week is called week0 of.write('\t\t\n' % week_row) for day_col in range(0, 7): dayclass = get_class_for_daycol(day_col) day = week[day_col] if day == 0: # a day in the previous or next month if week_row == 0: # a day in the previous month specday = get_previous_day(year, month, day_col) specclass = "previous " + dayclass elif week_row == nweeks-1: # a day in the next month specday = get_next_day(year, month, day_col) specclass = "next " + dayclass of.write('\t\t\t\n') else: # normal day number in current month thisday = datetime.date.fromordinal(current_ord) of.write('\t\t\t\n') # change day number current_ord += 1 # close the week/ row of.write('\t\t\n') if cal == "yg": # Fill up till we have 6 rows, so that the months align properly for i in range(nweeks, 6): of.write('\t\t\n' % (i+1)) of.write('\t\t\t\n') of.write('\t\t\n') # close table body of.write('\t\n') def write_header(self, of, nr_up, title, add_print=True): """ This creates the header for the Calendars including style embedded for special purpose 'nr_up' - number of directory levels up, started from current page, to the root of the directory tree (i.e. to self.html_dir). """ of.write('\n') xmllang = Utils.xml_lang() of.write('\n' % (xmllang, xmllang)) of.write('\n') of.write('\t%s\n\n' % title) of.write('\t\n' % self.encoding) of.write('\t\n' % (const.PROGRAM_NAME, const.VERSION, const.URL_HOMEPAGE)) of.write('\t\n\n' % self.author) subdirs = ['..'] * nr_up # link to screen stylesheet fname = '/'.join(subdirs + ['styles'] + [self.css]) of.write('\t\n') # link to print stylesheet if add_print: fname = '/'.join(subdirs + ['styles'] + ["Web_Print-Default.css"]) of.write('\t\n') # link to GRAMPS favicon fname = '/'.join(subdirs + ['images'] + ['favicon.ico']) of.write('\t\n') of.write('\n\n') def write_footer(self, of, nr_up): """ Writes the footer section of the pages 'nr_up' - number of directory levels up, started from current page, to the root of the directory tree (i.e. to self.html_dir). """ of.write('
\n') of.write('\n') # Closing "content" of.write('\n') of.write('\n') of.write('\n') def create_file(self, fname, subdir): """ Create a file in the html_dir tree. If the directory does not exist, create it. """ fname = os.path.join(self.html_dir, subdir, fname) if not _has_webpage_extension(fname): fname += self.ext destdir = os.path.dirname(fname) if not os.path.isdir(destdir): os.makedirs(destdir) of = codecs.EncodedFile(open(fname, "w"), 'utf-8', self.encoding, 'xmlcharrefreplace') return of def close_file(self, of): of.close() def one_day(self, of, event_date, one_day_cal, day_list): """ This method creates the One Day page for "Year At A Glance" event_date -- date for this file and events one_day_cal -- either year_glance() or WebCal() day_list - a combination of both dictionaries to be able to create one day nyears, date, text, event --- are necessary for figuring the age or years married for each year being created... """ # This is one_day in the year-at-a-glance calendar if one_day_cal == "OneDay": # break up event_date to get year, month, day for this day year = event_date.get_year() month = event_date.get_month() day = event_date.get_day() # create fname date string for "One Day" calendar pages filename # using yyyymmdd for filename two_digit_month = '%02d' % month two_digit_day = '%02d' % day fname_date = str(year) + str(two_digit_month) + str(two_digit_day) # define names for long month full_month_name = _get_full_month_name(month) # Name the file, and create it (see code in calendar_build) fpath = os.path.join(str(year), full_month_name) one_day_fname = self.create_file(fname_date, fpath) nr_up = 2 # number of directory levels up to get to root # set date display as in user prevferences pg_date = _dd.display(event_date) # page title title = _('One Day Within A Year') # Add Header self.write_header(one_day_fname, nr_up, title, False) one_day_fname.write('\n' % pg_date) self.calendar_common(one_day_fname, nr_up, year, full_month_name, title) one_day_fname.write('\t

%s

\n' % pg_date) of = one_day_fname # because of two different fnames needing # to access this variable # for both "WebCal" and "One Day" of.write('\t\t\t\t\t\n') # if calendar is one_day(), write footer, and close the file if one_day_cal == "OneDay": self.write_footer(of, nr_up) self.close_file(of) def year_glance(self, year): """ This method will create the Full Year At A Glance Page... year -- year being created """ nr_up = 1 # Number of directory levels up to get to root # Name the file, and create it cal_fname = 'fullyear' year_glance_fname = self.create_file(cal_fname, str(year)) # page title title = _("%(year)d, At A Glance") % {'year' : year} # Add Header self.write_header(year_glance_fname, nr_up, title, False) year_glance_fname.write('\n') self.calendar_common(year_glance_fname, nr_up, year, 'fullyear', title) # page description year_glance_fname.write('
\n') year_glance_fname.write('

\n') # TODO. The "red square" is only valid for some style sheets. year_glance_fname.write(_('This calendar is meant to give you access ' 'to all your data at a glance compressed into one page. Clicking ' 'on a date will take you to a page that shows all the events for ' 'that date, if there are any!

\n')) year_glance_fname.write('
\n') # generate progress pass for "Year At A Glance" self.progress.set_pass(_('Creating Year At A Glance calendars'), \ self.end_month - self.start_month) for month in range(self.start_month, self.end_month + 1): # build the calendar self.calendar_build(year_glance_fname, "yg", year, month) # create note section for "Year At A Glance" note = self.month_notes[month-1].strip() note = note or " " year_glance_fname.write('\t\n') year_glance_fname.write('\t\t\n') year_glance_fname.write('\t\t\t\n' % note) year_glance_fname.write('\t\t\n') year_glance_fname.write('\t\n') year_glance_fname.write('
%s
\n' % (dayclass, dayname)) of.write('\t\t\t\t%s
\n' % specclass) of.write('\t\t\t\t
%d
\n' % specday) of.write('\t\t\t		 [] or bday_anniv_list > []: hilightday = 'highlight ' + dayclass # specify day class for this day of.write('class="%s">\n' % hilightday) event_date = gen.lib.Date() event_date.set_yr_mon_day(thisday.year, thisday.month, thisday.day) day_list = get_day_list(event_date, holiday_list, bday_anniv_list) if day_list: # Year at a Glance if cal == "yg": # create yyyymmdd date string for # "One Day" calendar page filename two_digit_month = '%02d' % month two_digit_day = '%02d' % day fname_date = str(year) + str(two_digit_month) + str(two_digit_day) # create web link to corresponding "One Day" page... # The HREF is relative to the year path. fname_date = '/'.join([full_month_name, fname_date]) fname_date += self.ext of.write('\t\t\t\t\n' % (fname_date, abbr_month_name, day)) of.write('\t\t\t\t\t
%d
\n' % day) one_day_cal = "OneDay" # WebCal else: one_day_cal = "WebCal" of.write('\t\t\t\t
%d
\n' % day) # both WebCal and Year_Glance needs day_list displayed self.one_day(of, event_date, one_day_cal, day_list) # no holiday/ bday/ anniversary this day else: of.write('class="%s">\n' % dayclass) of.write('\t\t\t\t
%d
\n' % day) # no holiday/ bday/ anniversary this month else: of.write('class="%s">\n' % dayclass) of.write('\t\t\t\t
%d
\n' % day) # close the day/ column of.write('\t\t\t
%s
\n\n') # increase progress bar self.progress.step() # write footer section, and close file self.write_footer(year_glance_fname, nr_up) self.close_file(year_glance_fname) def write_report(self): """ The short method that runs through each month and creates a page. if self.partyear, use will enter the start month, ending month, start year, and ending year else, year is equal to the current year, set by self.today """ # open progress meter bar self.progress = Utils.ProgressMeter(_("Web Calendar Report"), '') # get data from database for birthdays/ anniversaries # TODO. Verify that we collect correct info based on start_year self.collect_data(self.start_year) if self.css == "Web_Mainz.css": # Copy Mainz Style Images self.imgs += ["Web_Mainz_Bkgd.png", "Web_Mainz_Header.png", "Web_Mainz_Mid.png", "Web_Mainz_MidLight.png", ] # Copy all files for the calendars being created self.copy_calendar_files() # create calendars with multiple years up to twenty-five years # navigation bar length will only support twenty-five years at any given time if self.multiyear: # Clip to max 25 years if ((self.end_year - self.start_year + 1) > 25): self.end_year = self.start_year + 25 - 1 for cal_year in range(self.start_year, (self.end_year + 1)): # generate progress pass for year ???? self.progress.set_pass(_('Creating year %d calendars') % cal_year, '') # initialize the holidays dict to fill: self.holidays = {} # get the information, first from holidays: if self.country != 0: self.__get_holidays(cal_year) # adjust the months being created if self.partyear is True, # and if the year is the current year, then start month is current month self.start_month = 1 if cal_year == self.today.year: if self.partyear: self.start_month = self.today.month # create "WebCal" calendar pages self.normal_cal(cal_year) # create "Year At A Glance" and "One Day" calendar pages if self.fullyear: self.year_glance(cal_year) # a single year else: cal_year = self.start_year self.holidays = {} # get the information, first from holidays: if self.country != 0: self.__get_holidays(cal_year) # generate progress pass for single year #self.progress.set_pass(_('Creating calendars'), self.end_month - self.start_month) # adjust the months being created if self.partyear is True, # and if the year is the current year, then start month is current month self.start_month = 1 if cal_year == self.today.year: if self.partyear: self.start_month = self.today.month # create "WebCal" calendar pages self.normal_cal(cal_year) # create "Year At A Glance" if self.fullyear: self.year_glance(cal_year) # Close the progress meter self.progress.close() def normal_cal(self, year): """ This method provides information and header/ footer to the calendar month year -- year being created """ # do some error correcting if needed if self.multiyear: if self.end_year < self.start_year: # Huh? Why start_year+1? self.end_year = self.start_year + 1 nr_up = 1 # Number of directory levels up to get to self.html_dir / root # generate progress pass for "WebCal" self.progress.set_pass(_('Formatting months ...'), self.end_month - self.start_month) for month in range(self.start_month, self.end_month + 1): # Name the file, and create it cal_fname = _get_full_month_name(month) webcal_fname = self.create_file(cal_fname, str(year)) # Add Header self.write_header(webcal_fname, nr_up, self.title_text, True) webcal_fname.write('\n') self.calendar_common(webcal_fname, nr_up, year, cal_fname, self.title_text, True) # build the calendar self.calendar_build(webcal_fname, "wc", year, month) # create note section for "WebCal" note = self.month_notes[month-1].strip() note = note or " " webcal_fname.write('\t\n') webcal_fname.write('\t\t\n') webcal_fname.write('\t\t\t%s\n' % note) webcal_fname.write('\t\t\n') webcal_fname.write('\t\n') webcal_fname.write('\n\n') # write footer section, and close file self.write_footer(webcal_fname, nr_up) self.close_file(webcal_fname) # increase progress bar self.progress.step() def collect_data(self, this_year): """ This method runs through the data, and collects the relevant dates and text. TODO The use of living variable is too loosely and too liberable to be properly used. It only checks to see i an individual was dead as of January, 1, ????--see line 1147 if person is dead, then do nothing more!!! """ people = self.database.get_person_handles(sort_handles=False) self.progress.set_pass(_('Applying Filter...'), len(people)) people = self.filter.apply(self.database, people, self.progress) self.progress.set_pass(_("Reading database..."), len(people)) for person_handle in people: self.progress.step() person = self.database.get_person_from_handle(person_handle) family_list = person.get_family_handle_list() birth_ref = person.get_birth_ref() birth_date = None if birth_ref: birth_event = self.database.get_event_from_handle(birth_ref.ref) birth_date = birth_event.get_date_object() # determine birthday information??? if self.birthday and birth_date is not None: # determine if birthdadate is a valid date??? complete_date = False if birth_date.is_valid(): complete_date = True if complete_date: year = birth_date.get_year() month = birth_date.get_month() day = birth_date.get_day() prob_alive_date = gen.lib.Date(this_year, month, day) # add some things to handle maiden name: father_lastname = None # husband, actually sex = person.get_gender() if sex == gen.lib.Person.FEMALE: # get husband's last name: if self.maiden_name in ['spouse_first', 'spouse_last']: if len(family_list) > 0: if self.maiden_name == 'spouse_first': fhandle = family_list[0] else: fhandle = family_list[-1] fam = self.database.get_family_from_handle(fhandle) father_handle = fam.get_father_handle() mother_handle = fam.get_mother_handle() if mother_handle == person_handle: if father_handle: father = self.database.get_person_from_handle(father_handle) if father != None: father_name = father.get_primary_name() father_lastname = _get_regular_surname(sex, father_name) short_name = _get_short_name(person, father_lastname) alive = probably_alive(person, self.database, prob_alive_date) text = _('%(short_name)s') % {'short_name' : short_name} if (self.alive and alive) or not self.alive: self.add_day_item(text, year, month, day, 'Birthday') # add anniversary if requested if self.anniv: for fhandle in family_list: fam = self.database.get_family_from_handle(fhandle) father_handle = fam.get_father_handle() mother_handle = fam.get_mother_handle() if father_handle == person.get_handle(): spouse_handle = mother_handle else: continue # with next person if this was the marriage event if spouse_handle: spouse = self.database.get_person_from_handle(spouse_handle) if spouse: spouse_name = _get_short_name(spouse) short_name = _get_short_name(person) are_married = get_marrital_status(fam, self.database) if are_married is not None: for event_ref in fam.get_event_ref_list(): event = self.database.get_event_from_handle(event_ref.ref) event_obj = event.get_date_object() year = event_obj.get_year() month = event_obj.get_month() day = event_obj.get_day() prob_alive_date = gen.lib.Date(this_year, month, day) # determine if anniversary date is a valid date??? complete_date = False if event_obj.get_valid(): complete_date = True if complete_date: text = _('%(spouse)s and %(person)s') % { 'spouse' : spouse_name, 'person' : short_name} alive1 = probably_alive(person, self.database, prob_alive_date) alive2 = probably_alive(spouse, self.database, prob_alive_date) if ((self.alive and alive1 and alive2) or not self.alive): self.add_day_item(text, year, month, day, 'Anniversary') #------------------------------------------------------------------------ # # WebCalOptions # #------------------------------------------------------------------------ class WebCalOptions(MenuReportOptions): """ Defines options and provides handling interface. """ def __init__(self, name, dbase): self.__db = dbase self.__pid = None self.__filter = None MenuReportOptions.__init__(self, name, dbase) def add_menu_options(self, menu): """ Add options to the menu for the web calendar. """ self.__add_report_options(menu) self.__add_content_options(menu) self.__add_notes_options(menu) def __add_report_options(self, menu): """ Options on the "Report Options" tab. """ category_name = _("Report Options") target = DestinationOption( _("Destination"), os.path.join(const.USER_HOME, "WEBCAL")) target.set_help( _("The destination directory for the web files")) target.set_directory_entry(True) menu.add_option(category_name, "target", target) title = StringOption(_('Calendar Title'), _('My Family Calendar')) title.set_help(_("The title of the calendar")) menu.add_option(category_name, "title", title) self.__filter = FilterOption(_("Filter"), 0) self.__filter.set_help( _("Select filter to restrict people that appear on calendar")) menu.add_option(category_name, "filter", self.__filter) self.__filter.connect('value-changed', self.__filter_changed) self.__pid = PersonOption(_("Filter Person")) self.__pid.set_help(_("The center person for the filter")) menu.add_option(category_name, "pid", self.__pid) self.__pid.connect('value-changed', self.__update_filters) self.__update_filters() ext = EnumeratedListOption(_("File extension"), ".html" ) for etype in ['.html', '.htm', '.shtml', '.php', '.php3', '.cgi']: ext.add_item(etype, etype) ext.set_help( _("The extension to be used for the web files")) menu.add_option(category_name, "ext", ext) cright = EnumeratedListOption(_('Copyright'), 0 ) for index, copt in enumerate(_COPY_OPTIONS): cright.add_item(index, copt) cright.set_help( _("The copyright to be used for the web files")) menu.add_option(category_name, "cright", cright) encoding = EnumeratedListOption(_('Character set encoding'), _CHARACTER_SETS[0][1]) for eopt in _CHARACTER_SETS: encoding.add_item(eopt[1], eopt[0]) encoding.set_help( _("The encoding to be used for the web files")) menu.add_option(category_name, "encoding", encoding) css = EnumeratedListOption(_('StyleSheet'), _CSS_FILES[0][1]) for style in _CSS_FILES: css.add_item(style[1], style[0]) css.set_help( _("The Style Sheet to be used for the web page")) menu.add_option(category_name, "css", css) def __add_content_options(self, menu): """ Options on the "Content Options" tab. """ category_name = _("Content Options") # set to today's date for use in menu, etc. # 0 = year, 1 = month, 2 = day today = time.localtime() today = datetime.date(today[0], today[1], today[2]) partyear = BooleanOption(_('Create Partial Year calendar'), False) partyear.set_help(_('Create a partial year calendar. The start month will be' ' equal to the current month to the end of the year.')) menu.add_option(category_name, 'partyear', partyear) self.__multiyear = BooleanOption(_('Create multiple year calendars'), False) self.__multiyear.set_help(_('Whether to create Multiple year calendars or not.')) menu.add_option(category_name, 'multiyear', self.__multiyear) self.__multiyear.connect('value-changed', self.__multiyear_changed) self.__start_year = NumberOption(_('Start Year for the Calendar(s)'), today.year, 1900, 3000) self.__start_year.set_help(_('Enter the starting year for the calendars between 1900 - 3000')) menu.add_option(category_name, 'start_year', self.__start_year) self.__end_year = NumberOption(_('End Year for the Calendar(s)'), today.year, 1900, 3000) self.__end_year.set_help(_('Enter the ending year for the calendars between 1900 - 3000.' ' if multiple years is selected, then only twenty years at any given time')) menu.add_option(category_name, 'end_year', self.__end_year) self.__multiyear_changed() fullyear = BooleanOption(_('Create "Year At A Glance" Calendar(s)'), False) fullyear.set_help(_('Whether to create A one-page mini calendar with dates highlighted')) menu.add_option(category_name, 'fullyear', fullyear) country = EnumeratedListOption(_('Country for holidays'), 0 ) holiday_table = libholiday.HolidayTable() for index, item in enumerate(holiday_table.get_countries()): country.add_item(index, item) country.set_help(_("Holidays will be included for the selected " "country")) menu.add_option(category_name, "country", country) maiden_name = EnumeratedListOption(_("Birthday surname"), "own") maiden_name.add_item("spouse_first", _("Wives use husband's surname (from first family listed)")) maiden_name.add_item("spouse_last", _("Wives use husband's surname (from last family listed)")) maiden_name.add_item("own", _("Wives use their own surname")) maiden_name.set_help(_("Select married women's displayed surname")) menu.add_option(category_name, "maiden_name", maiden_name) # Default selection ???? start_dow = EnumeratedListOption(_("First day of week"), 1) for count in range(1, 8): start_dow.add_item(count, GrampsLocale.long_days[count].capitalize()) start_dow.set_help(_("Select the first day of the week for the calendar")) menu.add_option(category_name, "start_dow", start_dow) home_link = StringOption(_('Home link'), '../index.html') home_link.set_help(_("The link to be included to direct the user to " "the main page of the web site")) menu.add_option(category_name, "home_link", home_link) alive = BooleanOption(_("Include only living people"), True) alive.set_help(_("Include only living people in the calendar")) menu.add_option(category_name, "alive", alive) birthdays = BooleanOption(_("Include birthdays"), True) birthdays.set_help(_("Include birthdays in the calendar")) menu.add_option(category_name, "birthdays", birthdays) anniversaries = BooleanOption(_("Include anniversaries"), True) anniversaries.set_help(_("Include anniversaries in the calendar")) menu.add_option(category_name, "anniversaries", anniversaries) def __add_notes_options(self, menu): """ Options on the "Months Notes" tabs. """ category_name = _("Jan - Jun Notes") note_jan = StringOption(_('Jan Note'), _('This prints in January')) note_jan.set_help(_("The note for the month of January")) menu.add_option(category_name, "note_jan", note_jan) note_feb = StringOption(_('Feb Note'), _('This prints in February')) note_feb.set_help(_("The note for the month of February")) menu.add_option(category_name, "note_feb", note_feb) note_mar = StringOption(_('Mar Note'), _('This prints in March')) note_mar.set_help(_("The note for the month of March")) menu.add_option(category_name, "note_mar", note_mar) note_apr = StringOption(_('Apr Note'), _('This prints in April')) note_apr.set_help(_("The note for the month of April")) menu.add_option(category_name, "note_apr", note_apr) note_may = StringOption(_('May Note'), _('This prints in May')) note_may.set_help(_("The note for the month of May")) menu.add_option(category_name, "note_may", note_may) note_jun = StringOption(_('Jun Note'), _('This prints in June')) note_jun.set_help(_("The note for the month of June")) menu.add_option(category_name, "note_jun", note_jun) category_name = _("Jul - Dec Notes") note_jul = StringOption(_('Jul Note'), _('This prints in July')) note_jul.set_help(_("The note for the month of July")) menu.add_option(category_name, "note_jul", note_jul) note_aug = StringOption(_('Aug Note'), _('This prints in August')) note_aug.set_help(_("The note for the month of August")) menu.add_option(category_name, "note_aug", note_aug) note_sep = StringOption(_('Sep Note'), _('This prints in September')) note_sep.set_help(_("The note for the month of September")) menu.add_option(category_name, "note_sep", note_sep) note_oct = StringOption(_('Oct Note'), _('This prints in October')) note_oct.set_help(_("The note for the month of October")) menu.add_option(category_name, "note_oct", note_oct) note_nov = StringOption(_('Nov Note'), _('This prints in November')) note_nov.set_help(_("The note for the month of November")) menu.add_option(category_name, "note_nov", note_nov) note_dec = StringOption(_('Dec Note'), _('This prints in December')) note_dec.set_help(_("The note for the month of December")) menu.add_option(category_name, "note_dec", note_dec) def __update_filters(self): """ Update the filter list based on the selected person """ gid = self.__pid.get_value() person = self.__db.get_person_from_gramps_id(gid) filter_list = ReportUtils.get_person_filters(person, False) self.__filter.set_filters(filter_list) def __filter_changed(self): """ Handle filter change. If the filter is not specific to a person, disable the person option """ filter_value = self.__filter.get_value() if filter_value in [1, 2, 3, 4]: # Filters 1, 2, 3 and 4 rely on the center person self.__pid.set_available(True) else: # The rest don't self.__pid.set_available(False) def __multiyear_changed(self): """ Handles the ability to print multiple year calendars or not? """ self.__start_year.set_available(True) if self.__multiyear.get_value(): self.__end_year.set_available(True) else: self.__end_year.set_available(False) def _get_regular_surname(sex, name): """ Return a name string built from the components of the Name instance. """ surname = name.get_surname() prefix = name.get_surname_prefix() if prefix: surname = prefix + " " + surname if sex == gen.lib.Person.FEMALE: pass else: suffix = name.get_suffix() if suffix: surname = surname + ", " + suffix return surname def _get_short_name(person, maiden_name=None): """ Return person's name, unless maiden_name given, unless married_name listed. """ # Get all of a person's names: primary_name = person.get_primary_name() sex = person.get_gender() married_name = None names = [primary_name] + person.get_alternate_names() for n in names: if int(n.get_type()) == gen.lib.NameType.MARRIED: married_name = n # Now, decide which to use: if maiden_name is not None: if married_name is not None: first_name, family_name = married_name.get_first_name(), _get_regular_surname(sex, married_name) call_name = married_name.get_call_name() else: first_name, family_name = primary_name.get_first_name(), maiden_name call_name = primary_name.get_call_name() else: first_name, family_name = primary_name.get_first_name(), _get_regular_surname(sex, primary_name) call_name = primary_name.get_call_name() # If they have a nickname use it if call_name is not None and call_name.strip() != "": first_name = call_name.strip() else: # else just get the first name: first_name = first_name.strip() if " " in first_name: first_name, rest = first_name.split(" ", 1) # just one split max return ("%s %s" % (first_name, family_name)).strip() def _get_marrital_status(family, db): """ Returns the marital status of two people, a couple are_married will either be the marriage event or None if not married anymore """ are_married = None for event_ref in family.get_event_ref_list(): event = db.get_event_from_handle(event_ref.ref) if event.type in [gen.lib.EventType.MARRIAGE, gen.lib.EventType.MARR_ALT]: are_married = event elif event.type in [gen.lib.EventType.DIVORCE, gen.lib.EventType.ANNULMENT, gen.lib.EventType.DIV_FILING]: are_married = None return are_married def _has_webpage_extension(fname): for ext in ('.html', '.htm' '.shtml', '.cgi', '.php', '.php3'): if fname.endswith(ext): return True return False # Simple utility list to convert Gramps day-of-week numbering to calendar.firstweekday numbering _dow_gramps2iso = [ -1, calendar.SUNDAY, calendar.MONDAY, calendar.TUESDAY, calendar.WEDNESDAY, calendar.THURSDAY, calendar.FRIDAY, calendar.SATURDAY ] def _gramps2iso(dow): """ Convert GRAMPS day of week to ISO day of week """ # GRAMPS: SUN = 1 # ISO: MON = 1 return (dow + 5) % 7 + 1 # define names for long and short month in GrampsLocale _full_month_name = GrampsLocale.long_months _abbr_month_name = GrampsLocale.short_months def _get_full_month_name(month): return _full_month_name[month] def _get_short_month_name(month): return _abbr_month_name[month] def get_day_list(event_date, holiday_list, bday_anniv_list): """ Will fill day_list and return it to its caller: calendar_build() holiday_list, or bday_anniv_list -- will always have something in it... event_date -- date for this day_list 'day_list' - a combination of both dictionaries to be able to create one day nyears, date, text, event --- are necessary for figuring the age or years married for each day being created... """ # initialize day_list day_list = [] # holiday on this day if holiday_list > []: # will force holidays to be first in the list nyears = 0 for p in holiday_list: for line in p.splitlines(): day_list.append((nyears, event_date, line, _('Holiday'))) # birthday/ anniversary on this day if bday_anniv_list > []: for text, event, date in bday_anniv_list: # '...' signifies an incomplete date for an event. See add_day_item() txt_str = None if date != '...': # number of years married, ex: 10 nyears = event_date.get_year() - date.get_year() # number of years for birthday, ex: 10 years age_str = event_date - date age_str.format(precision=1) # a birthday if event == 'Birthday': if nyears == 0: txt_str = _('%(person)s, birth') % { 'person' : text} else: txt_str = _('%(person)s, %(age)s old') % {'person' : text, 'age' : age_str} # an anniversary elif event == 'Anniversary': if nyears == 0: txt_str = _('%(couple)s, wedding') % { 'couple' : text} else: txt_str = (ngettext('%(couple)s, %(years)d year anniversary', '%(couple)s, %(years)d year anniversary', nyears) % {'couple' : text, 'years' : nyears}) txt_str = '%s' % txt_str if txt_str is not None: day_list.append((nyears, date, txt_str, event)) # sort them based on number of years # holidays will always be on top of day day_list.sort() return day_list def get_marrital_status(family, db): """ Returns the marital status of two people, a couple are_married will either be the marriage event or None if not married anymore """ are_married = None for event_ref in family.get_event_ref_list(): event = db.get_event_from_handle(event_ref.ref) if event.type in [gen.lib.EventType.MARRIAGE, gen.lib.EventType.MARR_ALT]: are_married = event elif event.type in [gen.lib.EventType.DIVORCE, gen.lib.EventType.ANNULMENT, gen.lib.EventType.DIV_FILING]: are_married = None return are_married def gen_key(event): return ((event.get_year(), event.get_month(), event.get_day())) #------------------------------------------------------------------------- # # # #------------------------------------------------------------------------- pmgr = PluginManager.get_instance() pmgr.register_report( name = 'WebCal', category = CATEGORY_WEB, report_class = WebCalReport, options_class = WebCalOptions, modes = PluginManager.REPORT_MODE_GUI, translated_name = _("Web Calendar"), status = _("Stable"), author_name = "Thom Sturgill", author_email = "thsturgill@yahoo.com", description = _("Produces web (HTML) calendars."), )