Package: photo-calendar
PhotoCalendarAPythonutility to create custom weekly/monthly/... photo calendars.
For example:Table of ContentsOverviewExamplesUsageTemplatesInstallationWhat is hereContributionLicenseAcknowledgementsOverviewThe program creates the calendar in HTML format.Note: you can then print it to PDF using browser or, e.g.,weasyptint utility.User may provide (seeexamples below):name of weekdays and months and their abbreviationsimages (for each week, for title page, for backgrounds)name-dayspublic holidaysreligious holidaysnotes (friends' birthdays, anniversaries, ...)template how the final calendar looks liketitle, first week day, ...HTML templatesThe produced HTML structure and CSS styling is defined by template - a python module definingtoHTMLString(calendar)function andCSSStringstring variable.
As an example and inspiration, a few predefined templates are provided.
Seeexamples, documentation or source code for more information how to create a custom template.CompatibilityThe package works with both Python 2 and 3 (tested onUbuntu 16.04 LTSand Python 2.7.12 and Python 3.5.2).ExamplesUsagePython:fromphotocalendarimportPhotoCalendarcalendar=PhotoCalendar(# not all arguments are mandatoryoutputBase="/some/output/base",year=2019,firstWeekDay="Tu",# Tuesday as the first week day? Well, why not...imagesDirectory="/some/directory/with/images/for/each/week",imageDescriptionsFile="/some/file/with/image/descriptions/for/each/week",backgroundImagesDirectory="/some/directory/with/backround/images/for/each/week",title="Some calendar title",titlePageImage="/some/image/for/title/page",titlePageBackground="/some/background/image/for/titlepage",lastPageBackground="/some/background/image/for/last/page",nameDaysFile="/some/file/with/name-days",religiousHolidaysFile="/some/file/with/religious/holidays",publicHolidaysFile="/some/file/with/public/holidays",notesFile="/some/file/with/notes/like/birthdays/etc",weekDayNamesFile="/some/file/with/custom/weekday/names",abbrWeekDayNamesFile="/some/file/with/custom/abbreviated/weekday/names",monthNamesFile="/some/file/with/custom/month/names",abbrMonthNamesFile="/some/file/with/custom/abbreviated/month/names",template="delphinus",)calendar.toHTML()Shell:# not all arguments are mandatoryphotocalendar\--output-base/some/output/base\--year2019\--first-week-dayTu\--images-directory/some/directory/with/images/for/each/week\--image-descriptions-file/some/file/with/image/descriptions/for/each/week\--background-images-directory/some/directory/with/backround/images/for/each/week\--title"Some calendar title"\--title-page-image/some/image/for/title/page\--title-page-background/some/background/image/for/titlepage\--last-page-background/some/background/image/for/last/page\--name-days-file/some/file/with/name-days\--religious-holidays-file/some/file/with/religious/holidays\--public-holidays-file/some/file/with/public/holidays\--notes-file/some/file/with/notes/like/birthdays/etc\--week-day-names-file/some/file/with/custom/week/day/names\--abbr-week-day-names-file/some/file/with/custom/abbreviated/week/day/names\--month-names-file/some/file/with/custom/month/names\--abbr-month-names-file/some/file/with/custom/abbreviated/month/names\--templatedelphinusTemplate examplesNote:
the photos and backgrounds are only illustrative.
They are provided by the user in the real use case.The title page and one inside page is shown.In the illustrations,pictureofGolden Gate BridgeandpictureofMatterhornare used.Template delphinus:Weekly A5 landscape calendarTemplate columba:Monthly A4 portrait calendarTemplate lupus:Two-weeks calendarInstallationUsingsetup.pyfile:python setup.py install [options], e.g.python setup.py --userUsingmake(callssetup.pyinternally):make install [options], e.g.make install USER=TRUE PYTHON=python3Usingpip[sudo] pip install [options] photo-calendar, e.g.pip install --user photo-calendarWhat is herefile/directorydescriptionbindirectory containing executable python scriptdocsource files for HTML documentationexamplesdirectory with examplesimagesimages for github page (e.g., templates illustrations)localefiles for localization (public holidays, name days, etc.)Makefilemakefile for the project (with targetshelp,install,doc,test,clean,dist)photocalendaractual python packagesetup.pypython setup file for installationtestspython unit testsContributionPull RequestsAre welcome. Especially:locales (name-days, public holidays)templatesBut, please, discuss the intention beforehand with the author.Bug reportingIn case of any question or problem, please leave an issue at thegithup page of the project.ContributorsJan StránskýLicenseThis project is licensed under the LGPL License - see thelicense filefor details.Acknowledgementsto Petr Hlaváček for the inital idea and LaTeX implementation and providing his source codetodominate python packagefor HTML creation inspiration