4,602
edits
Changes
m
Explanation of how to add or change the [[File:Calendar-GraphicalReports-Content-tab-Country for holidays appearing on the output of the Calendar-based reports in Grampsdefault-list-51.png|thumb|450px|right|Content tab showing "Country for holidays:" option showing "Country for holidays" default list]]
==CalendarDetails on how to add custom holiday set or change the built-based reports==in holiday set appearing on the output of the [[File:#Calendar-GraphicalReportsbased_reports|Calendar-Content-tab-50.png|thumb|450px|right|Content tab showing "Country for holidays:" optionbased reports]]in Gramps.
{{-}}===Custom holidays.xml===You can select which create a separate custom <code>holidays to show by setting the .xml</code> file in your personal [[Gramps_{{man label|Country for holidays:Version manual}} option in either the {{man label_Wiki_Manual_-_User_Directory|Content}} tab of the reportsUser directory]] <code>.gramps/plugins/</code> folder.
[[File:Calendar-GraphicalReports-Content-tab-Country for ====Adding your countries holidays-default-list-51.png|thumb|450px|right|Content tab showing "Country for holidays:" option showing "Country for ====Are your countries holidays" missing or incomplete and you would like Gramps to have them by default list]]{{-}}?
==Separate If you would like to add your [http://en.wikipedia.org/wiki/Holiday countries holidays.xml==Note that ] to the calendar, then you can have two separate add them to the file <code>holidays.xml.in</code> fileslocated:# One where * Gramps is installed# and you can have a custom one in your personal 5 or newer: [[Gramps_{{Version manual}}_Wiki_Manual_https://github.com/gramps-_User_Directory|User directory]] <code>.project/gramps/pluginsblob/master/<data/holidays.xml.in data/code> folderholidays.xml.in]
===Adding and then raise a feature request and submit your countries holidays===If you would like to add your [http://en.wikipedia.org/wiki/Holiday countries holidays] to the calendar, then you can add them to the updated file <code>holidays.xml.in</code> located:* Gramps 4 and older: [https://github.com/gramps-project/gramps/blob/maintenance/gramps42/gramps/plugins/lib/holidays.xml.in gramps/plugins/lib/holidays.xml.in]* Gramps 5 or newer: [https://github.com/gramps-project/gramps/blob/master/data/holidays.xml.in data/holidays.xmlcreate a pull request on Github.in]
no edit summary
==Custom holiday set==Gramps comes installed with the following Calendar-based reports:* [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_4#Calendar|Calendar Report]]: (menu {{man menu|Reports-a default <code>Graphical Reports-holidays.xml</code>Calendar...}} )* [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_6#Birthday_and_Anniversary_Report|Birthday file and Anniversary Report]]: (menu {{man menu|Reports->Text Reports-you can either add more holiday sets to it or create your own custom <code>Birthday and Anniversary Reportholidays...}} )* And an output for the Web with [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_7#Web_Calendar|Web Calendar Report]]:(menu {{man menu|Reports->Web Pages-xml</code>Web Calendar...}} )
====format of holidays.xml====
In the file <code>holidays.xml.in</code>, you can add recurring annual events in a variety of ways. The format is generally:
</pre>
where each of the capitalized words would be filled in with appropriate values, as shown in list of keywords. ====Keywords====The following is a list of keywords to be used when creating or expanding the holidays.xml file see:* [https://github.com/gramps-project/gramps/blob/master/gramps/plugins/lib/libholiday.py /gramps/plugins/lib/libholiday.py]. All but NAME and VALUE are optional.
*'''COUNTRYNAME''' => "United States", "China", etc. You don't have to make these countries, however. You can make these just a "holiday set" which could be "Christian", "Muslim", "Eastern European", etc. These names can be selected from the {{man label|Country for holidays:}} list option when running calendar-related reports. You can use your own language for this name.
** "workday" or "weekend" (may be negative) - the next workday/weekend that is on this day, or the next/prev
=== Translations ===
Holiday entries are generally written for a specific country, and thus typically don't need to be written for more than one language. However, it might be appropriate to have your entries country name and holiday text be translated into the language that Gramps is running in. To make a country name or holiday name get translated, simply precede the name of the XML item with an underscore. For example:
In this example, "Jewish Holidays", "Purim", and "Passover" will be looked up in the Gramps gettext system for translations. If you would like to help add those translations, please see [[Translating Gramps]].
===Example===
The last set ( <country name="Finland"> ) will only load if your country is Finland. It says that Card Night is the last Thursday of every month, every year. Let's play!
</pre>
==Available CalendarsCalendar-based reports==[[File:Calendar-GraphicalReports-Content-tab-50.png|thumb|450px|right|Content tab showing "Country for holidays:" option]] Gramps comes with the following Calendar-based reports:* [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_4#Calendar|Calendar Report]]: (menu {{man menu|Reports->Graphical Reports->Calendar...}} )* [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_6#Birthday_and_Anniversary_Report|Birthday and Anniversary Report]]: (menu {{man menu|Reports->Text Reports->Birthday and Anniversary Report...}} )* And an output for the Web with [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_7#Web_Calendar|Web Calendar Report]]:(menu {{man menu|Reports->Web Pages->Web Calendar...}} ) {{-}}You can select which holidays to show by setting the {{man label|Country for holidays:}} option in either the {{man label|Content}} tab of the reports. [[File:Calendar-GraphicalReports-Content-tab-Country for holidays-default-list-51.png|thumb|450px|right|Content tab showing "Country for holidays:" option showing "Country for holidays" default list]]{{-}} ===Gramps 4.2Available Calendars===
Countries:
* Bulgaria / Canada / Chile / China / Croatia / Czech Republic / England / Finland / France / Germany / Japan / New Zealand / Russia / Serbia / Serbia (Latin) / Slovakia / Sweden / Ukraine / United States of America
Holidays
* Jewish Holidays
