Generating Web pages

From Gramps
Revision as of 22:40, 21 January 2013 by Patsyblefebre (talk | contribs) (Gramps)
Jump to: navigation, search
This page needs a cleanup. Please help keep Gramps Wiki a useful resource by refactoring this page. Consider also updating the screenshots.

Read this page instead in the manual: Narrated Web Site, for info in 3.3.x.


This section is now part of the official documentation

Selecting the output

This section is now part of the official documentation

Applying a filter

Added to the official documentation

Applying a style sheet

moved to official documentation

Character set encoding

Because of Gramps internationalization ability, the default character set for the HTML pages is UTF-8. This provides support for virtually all characters.

The Apache web server is sometimes misconfigured to override the character set specified in an HTML page. This causes problems with the UTF-8 character set generated by Gramps, distorting characters on the screen.

If your web server is misconfigured and you do not have privilege to fix the configuration, you may solve this problem by overriding the default character set to match what your web server may be expecting.

Copyright notice

International copyright law reserves all rights to your data. You own the data, and people must get your permission to use it. In genealogy, however, sharing data is a common ideal. It this case, you may wish to grant the user more rights.

While the default for Gramps is to place a notice indicating that all rights are reserved, we give you the option to place your site under one of several of the Creative Commons licenses. With a Creative Commons license, you grant user's certain permission to use your data without requiring them to contact you directly for permission.

See the Creative Commons web site for more information.

Controlling page generation

Three additional pages can be generated by the web page generator. The Home page is a page that will display an image and a whatever text you wish. To enable this page, choose a Media Object from the Home Media/Note ID menu on the Page Generation tab. If the media object contains an image, the image is displayed at the top of the page. If the Media Object contains a Note, the Note's text is used for the text of the page. A second page, the Introduction page, works similarly. Just choose the Media Object in the Introduction Media/Note ID menu.

If you choose to include a contact page, The researcher information stored in the database is displayed, along with the information specified in the Publisher contact/Note ID menu. Please use this page with caution, since you may consider your contact information to be private.


Privacy of personal information is an important issue on the web today. Gramps tries to give you control over the information that is presented.

Gramps provides two options to control the privacy of your information. If you select the Do not include records marked private option, any data that is marked as private will not be displayed on the generated site. If you select Restrict information on living people, Gramps will attempt to determine which people have the potential of still being alive, and will omit these people from the database. Some countries have laws that indicate that a certain number of years must pass after someone's death before information can be published. The Years to restrict from a person's death option allows you to specifiy how many years a person must be deceased before the information is included.

Please note that it is your responsibility to double check all information in the pages for any privacy information. Gramps cannot be held responsible for any privacy issues.

Adding custom code your pages

Note: If you are not interested in customizing your pages, you may skip the section.

The previous web generator allowed you to customize your pages using HTML templates. Your data would be substituted for certain markers in the code.

This method proved to be too cumbersome for most users. The Narrative Web Page Generator introduces a simpler mechanism. On the Page Generation tab, you may specify text (including HTML code) that will be inserted into each page.

To create this code, you need to create a Media Object marked as an internal note. To create this, add a new Media Object from the Media View, and select the internal note option. You may then enter your HTML code.

Two div sections are added to the page - userheader and userfooter. The corresponding HTML code is inserted into the HTML page surrounded by div markers. You can customize your style sheet to provide additional formatting and positioning information to control these sections.

More Info