Changes

Jump to: navigation, search

Gramps 5.1 Wiki Manual - Reports - part 7

6,926 bytes added, 08:50, 13 May 2023
Image Generation
{{man index|Gramps 5.1 Wiki Manual - Reports - part 6|Gramps 5.1 Wiki Manual - Reports - part 8|5.1}}
{{languages|Gramps_5.1_Wiki_Manual_-_Reports - part 7}}
{{#vardefine:chapter|1113.7}}
{{#vardefine:figure|0}}
Back to [[Gramps_5.1_Wiki_Manual_-_Reports|Index of Reports]].
Genealogy records can generate a lot of files. Many web servers have a difficult time with a large number of files in a single directory. The Narrated Web report strives to keep the number of files per directory to a manageable level. To do this, a hierarchy of directories is created. The generated file names are not intuitive, but are unique for each person. Subsequent runs will generate identical file names, making it easy to update specific files.
 
<span id="HTML Code">'''HTML Code type Notes'''</span>
 
''In this subsection, the word '''tag''' does not refer to Gramps marker tags but instead refer to HTML formatting tags!''
 
Notes set to the '''HTML Code''' [[Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#note_type|type]] will be inserted under the object to which they are attached. This allows special
 
The HTML chunks must be well-formed, with all tags properly closed, to avoid conflicts with the rest of the webpage generated by the report. Only insert tags in a '''HTML Code'''-type Note that would normally be contained within the body of a HTML document.
 
The following tags will always be ignored:
<code>html</code>, <code>meta</code>, <code>doctype</code>, <code>head</code>, <code>meta</code>, <code>title</code>, <code>link</code>, <code>script</code>, <code>body</code>
 
all other tags will be available :
<code>i</code>, <code>a</code>, <code>p</code>, <code>ol</code>, <code>ul</code>, <code>div</code>, <code>h1</code>-<code>h7</code>, <code>button</code>, <code>svg</code>, <code>table</code>, <code>tr</code>, <code>td</code>, …
{{man warn|1=Generating Pages...|2=When you select the {{man button|OK}} button, the generation of the web pages will start. So first check all options on the each of the dialog tabs}}
=====Report Options=====
[[File:NarratedWebSite-WebPages-ReportOptions-tab-5051.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Report Options - tab default options]]
* {{checkbox|0}} {{man label|Store web pages in .tar.gz archive}} (Checkbox unchecked by default) If you have trouble transferring the files to an external web host, you can create a single gzip'd tar file to more easily upload the data. The large number of files and directories in this web output may make it difficult to transfer the files to an external web host. Gramps has the capability of saving all of your Narrative Web files in one compressed archive using the gzip and tar formats (casually known as a &#8216;tarball&#8217;). This single file can quickly be transferred to your server and uncompressed on the website host. '''{{man menu|Unfortunately not all web servers support saving web files in this way, so contact your hosting provider for more information.}}'''
** People with common ancestor with active person
* {{man label|Filter Person:}} The center person for the report. (defaults to Active person)
** {{checkbox|0}} {{man label|Show the relationship between the current person and the active person}} (Checkbox unchecked by default) - For each person page.
{{man warn|Please note that compliance with privacy laws and individuals' privacy concerns is '''''your''''' responsibility as a the researcher your responsibility.|The Gramps project cannot be held responsible for privacy law compliance or other privacy issues. Privacy of personal information is an important issue. <br /><br />Gramps provides tools and settings that give you some control over the privacy of your data... but these controls were built to meet the regional considerations for that tool's programmer. You are responsible for verifying compliance before publication. }}
* {{man label|Living People}} How to handle living people. You can control the display of sensitive information based on whether or not an individual is currently alive. However, since Gramps is a research tool, it is likely that there are individuals with no known date of death in your database. To deduce if an individual is ''possibly still alive'' Gramps employs an algorithm that compares death dates, birth dates, baptism/christening dates, death dates of ancestors and birth dates of ancestors. The algorithm assumes that each individual is ''possibly still alive'' unless the cross-referenced dates make the individual&#8217;s ''possibility of being alive'' unlikely.
**'''Include Full Name Only'''
**'''Include''' &#8211; Include all information of all individuals even if they are ''possibly still alive''
* {{man menu|Years from death to consider living:}} (<code>30</code> default) This option is inactive if the "Living People" option is set to '''Include'''. {{man warn|Privacy requirements can extend after Death. Laws vary regionally|Some countries have laws that specify a certain number of years after death before an individual's information can be published. Here you can specify comply with such laws by specifying the number of years after death needed to comply with such lawscontinue to apply Privacy redactions.}}
* {{checkbox|0}} {{man label|Include data marked private}}: Whether to include private objects. If your intention is to provide a complete record of your research, checking this box will include all entries marked '''private''' along with the rest of your database. (checkbox unchecked by default)
[[File:NarratedWebSite-WebPages-HtmlOptions-tab-51.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Html options - tab default options]]
* {{man label|File extension:}} The file extension to be used for the web files. Choose between ** '''.html'''(defaultDefault)/** .htm/** .shtml/** .php/** .php3/** .cgi
* {{man label|Copyright:}} ('''Standard copyright''' default) When creating a public a web site it is important to specify the copyright conditions under which you are publishing your data. International copyright law reserves all rights of your data to your discretion. You own the data and individuals must have your permission if they wish to reuse that data. In genealogical research sharing data with other researchers is a common practice. Other options include the Creative Commons licenses, offering a wide range of use restrictions or none at all. Learn more about the Creative Commons at http://creativecommons.org/
* {{man label|Stylesheet:}} Gramps provides seven built in style sheets for you to choose from to determine the appearance or your web pages. Choose between '''Basic''' (Ash, Blue, Cypress, Lilac, Peach or Spruce color schemes), '''Mainz''', or '''Nebraska''' styles. There is also the option of not including a stylesheet ('''No style sheet'''). Regardless of the style you choose, the style sheet can be found in ''<code>css/narrative-screen.css</code>''. You may edit this file to further customize the appearance of your web pages. If you make modifications to your style sheet be aware that regenerating your pages with the same output destination will overwrite your custom style sheet. To preserve your custom style sheet through subsequent web page updates select {{man label|No style sheet}}. If you want your own stylesheet, you can copy one of the existing stylesheet in ''$HOME/.gramps/css/''. This directory doesn't exist. You must create it before copying your future stylesheet. Change its name. If you ask for a new report, this new stylesheet will be added to the list of preexisting stylesheets.
* {{checkbox|1}} {{man label|Include ancestor's tree}}: Checking this box will include an ancestor graph on each individual&#8217;s detail page if they have defined ancestors in your database. (checkbox checked by default) ( Note: [[Narrated Website Ancestry Tree Design Notes|Creates a compact Ancestry trees using Buchheim/Walker algorithm]])
** You can change the number of generations shown from the {{man label|Display}} tabs ''[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Display|Graph generations:]]'' option.
* {{checkbox|0}} {{man label|Add previous/next }} (checkbox unchecked by default) - adds links to the navigation bar.* {{checkbox|0}} {{man label|This is a secure site (https) }} (checkbox unchecked by default)
{{-}}
* {{man label|Name Format:}} Select the format to display the names. Choose from '''Surname, Given Suffix''' / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
* {{man label|Translation:}} - The translation to be used for the report.
* {{man label|Date format:}} - The format and language for dates, with examples.
* {{man label|Gramps ID:}} - Option determines whether to hide or show the Gramps ID of objects in your web page output.
** '''Do not include''' (default)
** Include
* {{checkbox|0}} {{man label|Sort all children in birth order}}(checkbox unchecked by default) - Whether to display children in birth order or in entry order?
* {{checkbox|0}} {{man label|Do we display coordinates in the places list?}}(checkbox unchecked by default) - Whether to display latitude/longitude in the places list?
* {{checkbox|0}} {{man label|Sort places references either by date or by name}}(checkbox unchecked by default) - Sort the places references by date or by name. Not set means by date.
* {{man label|Graph generations}} :This option is inactive if the ''[[Gramps_5.1_Wiki_Manual_-_Reports_-_part_7#Html_options|Include ancestor graph]]'' option on the ''Html options'' tab is not checked. The default number of generations shown in the ancestor graphs is <code>4</code> with options of 2, 3, 4 or 5. The individuals represented in the ancestor graphs are the same individuals whose information is provided elsewhere in your web pages.
* {{checkbox|1}} {{man label|Include narrative notes just after name, gender}}(checkbox checked by default) - Unchecked will show them just before attributes.
{{-}}
=====Page Generation===== [[File:NarratedWebSite-WebPages-PageGeneration-tab-50.png|right|450px|thumb|Fig. {{stub#var:chapter}}* .{{checkbox#vardefineecho:figure|0}} {{man label|Suppress Gramps ID}}#expr: This option determines whether to include the Gramps ID of objects in your web page output. (checkbox unchecked by default)* {{checkbox|0#var:figure}}+1}} {{man label|Sort all children in birth order}}(checkbox unchecked by Narrated Web Site - Web Pages - Page Generation - tab default)options]]
* {{man label|Graph generations}} :This option is inactive if the "Include ancestor graph" option is not checked. The default number of generations shown in the ancestor graphs is <code>4</code> with ''Page Generation'' tab provides options for creation of 2, 3, 4 or 5. The individuals represented in the ancestor graphs are commonly expected supplemental webpages & annotations common to all webpages throughout the same individuals whose information is provided elsewhere in your web pagesgenerated website.
{{The first options are used to control generation of three supplemental pages: '''Home''' ([https://en.wikipedia.org/wiki/Home_page Home] webpage), '''Introduction''' ([https://wikipedia.org/wiki/FAQ#In_web_design FAQ] or [https://www.searchenginejournal.com/about-}}us-page-examples/250967/amp/ About Us] webpage) and '''Publisher Contact''' ([https://wikipedia.org/wiki/Contact_page Contact Us] webpage).
=====Page Generation=====Each of supplemental pages may be assigned a specific [[Gramps_Glossary#media|Media]] or [[Gramps_Glossary#note|Note]] item. By default, no content (neither media nor text from a Note) is assigned to these pages.
[[File:NarratedWebSite-WebPages-PageGeneration-tab-50Content for these pages '''''must''''' originate as Media or Notes items that have been created before running the report.png|right|450px|thumb|FigOnce the desired items have been added to your Tree, you will be able to choose them from a list of Notes or Media Objects. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Page Generation - tab default options]]
The following options can be set {{man note|Planning for sustainability|These special-purpose items do not need to generate three supplemental pages: '''Home'''have [[Gramps_Glossary#references|References]] associated with any other record in the Tree. However, '''Introduction''' and '''Contact'''(Publisher Contact). From this tab you can also assign Media or Notes items might find it helpful to each page[[Gramps_5. By default no content 1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Source_dialog|add a Source]] your generated Website as a distinct Source (media or text[[Gramps_5.1_Wiki_Manual_-_Getting_started#Privacy|marked as Private]]) is assigned to these pagesyour Tree. Content for these pages must originate <br />This [[Gramps_Glossary#private_tag|private]] Source could use the [[Gramps_Glossary#references|References]] as Media or Notes items that you have previously createda special-purpose item checklist... If the desired items have already been with an added Note to your database you will be able document the options used to choose them from a list of Notes or Image Objectsgenerate the Narrated Website.<br />Add another note documenting any idiosyncracies encountered when publishing the site.<br />''Such internal documentation makes reproducing the same appearance easier when generating website updates in the future. ''}}
* {{man label|Home Page note:}} Display an individual Note of your choice.
* {{man label|Introduction note:}} Display an individual Note of your choice.
* {{man label|Introduction image:}} Display an individual Media Object of your choice.
* {{man label|Publisher Contact note:}} Display an individual Note of your choice. '''{{man menu|Please use the Publisher contact page with caution if you are publishing your web pages on a publicly accessible web server.}}'''* {{man label|Publisher Contact image:}} Display an individual Media Object of your choice.'''{{man menuwarn|Privacy & Spam Exposure Risk |Please use the Publisher contact page with caution if you are will be publishing your web pages on a publicly accessible web server. Consider using a single-use (disposable) eMailbox or secure form mail system.}}'''* {{man label|HTML user header:}} Display an individual Note of your choice. This annotation text will appear directly below the site title on every web page.* {{man label|HTML user footer:}} Display an individual Note of your choice. This annotation text will appear within the footer, above the copyright statement on every web page.{{-}} =====Extra pages===== [[File:NarratedWebSite-WebPages-Extrapages-tab-51.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Extra pages - tab default options]] * {{man label|Extra page name:}} (blank) - Your extra page name like it is shown in the menubar.* {{man label|Your extra page path:}}(blank) - Your extra page path without extension.** {{man button|find folder}} button
{{-}}
* {{checkbox|1}} {{man label|Include unused images and media objects}} This option determines whether to include/exclude a gallery of unused media objects on your website. (checkbox checked by default)
* {{checkbox|0}} {{man label|Create and only use thumbnail- sized images}} : This option allows you to create only thumbnail images instead of full-sized images on the Media Page. This will allow you to have a much smaller total upload size to your web hosting site. (checkbox unchecked by default)
* {{man label|Max width of initial image:}} (<code>800</code> default) This allows you to set the maximum width of the image (in pixels) shown on the media page. Set to 0 for no limit.* {{man label|Max height of initial image:}} (<code>600</code> default) This allows you to set the maximum is no more used and will disappear in 5.2.* {{Man warn|Considerations for choosing image height/width|The height of & width options need further expansion but discussions on the image MailLists provide some added insight. <br /><br />See also:<br /> [https://sourceforge.net/p/gramps/mailman/message/22452425/ (Gramps-devel) NarrativeWeb and large images - Mk II]<br /><br />Some idiosyncratic browser support for images on iPad has been reported:<br />[https://sourceforge.net/p/gramps/mailman/message/36888000/ (in pixelsGramps-users) shown Narrated website images don't appear on iPad [SOLVED]]<br /><br />If the media pageimage contains regions, the size will be resized to max_width. Set to 0 for If the width of an image is less than max_width, no limitresizing will occurs.}}
{{-}}
[[File:NarrativeWeb-Media-tab-ImageReferenceRegions-example-50.png|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example of
[[How_to_create_image_reference_regions|image reference regions]] - Media tab of HTML output for "Narrative Web" Report]]
* {{man label|Character set encoding:}} The encoding to be used for the web files.
** '''Unicode UTF-8 (recommended)''' (Default)
** ISO-8859-1''- [https://wikipedia.org/wiki/ISO/IEC_8859 ISO/IEC character set standard:] Part 1 (Latin 1: Western European)''
** ISO-8859-2
** ISO-8859-3
** ISO-8859-14
** ISO-8859-15
** koi8_r''- [https://wikipedia.org/wiki/KOI8-R Kod Obmena Informatsiey, 8 bit ("Code for Information Exchange - 8 bit")'']
* {{checkbox|0}} {{man label|Include link to active person on every page}}: (If they have a webpage) (checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include a column for birth dates on the index pages}}(checkbox checked by default)
=====Include=====
[[File:NarratedWebSite-WebPages-Include-tab-5051.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Include - tab default options]]
* {{checkbox|0}} {{man label|Include family pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include event pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include places pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include sources pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include repository pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include GENDEX file (/gendex.txt)}}. This option creates a GENDEX file placed at the top of the website. You can see sites which support this format and read more about it at the [http://en.wikipedia.org/wiki/GENDEX GENDEX Wikipedia article].)(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include address book pages}}(checkbox unchecked by default)
* {{checkbox|0}} {{man label|Include the statistics page}}(checkbox unchecked by default)
[[File:NarratedWebSite-WebPages-OtherInclusionCMSWebCalendarPhp-tab-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Narrated Web Site - Web Pages - Other inclusion (CMS, Web Calendar, Php) - tab default options]]
* {{stubcheckbox|0}}{{man label|Do we include these pages in a cms web?}} (Checkbox unchecked by default)** {{man label|URI:}} <code>/NAVWEB</code> (default) - Where do you place your website ?
* {{checkbox|0}} {{man label|Do we include the web calendar?}} (Checkbox unchecked by default)
** {{man label|URI:}} <code>/WEBCAL</code> (default) - Where do you place your website ?
{{-}}
See also:
* [[Howto:_Make_a_genealogy_website_with_Gramps#Integration_of_NarrativeWeb_in_a_CMS_or_MVS]]
===<u>Web Calendar</u>===
{{man warnnote|Note|There are no links from the The Narrated Web Site Report does not currently hyperlink back to into the Web Calendar Report.}}
[[File:WebCalendar-WebPages-example-DecemberCalendar2018-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Web Calendar Report - Web Pages - default Calendar for December 2018 - HTML output]]
====Dialog tabs====
The Web Calendar report dialog window {{man label|Narrated Web SiteCalendar}} has five tabs each are reviewed below.
{{-}}
=====Report Options=====
[[File:WebCalendar-WebPages-ReportOptions2-tab-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Web Calendar - Web Pages - Report Options (2) - tab default options]]
* {{man label|Name formatFormat:}} - Select the format to display the names. Choose This choice in normally taken from the default setting in [[Gramps_5.1_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Name format:}}. Or to override that setting for the report choose from :** '''Default''' - (in a new Family Tree this is normally ''Surname, Given Suffix'''(default) / ** Surname, Given Suffix ** Given Surname Suffix / ** Given / ** Main Surnames, Given Patronymic Suffix / ** SURNAME, Given (Common)* {{checkbox|}} {{man label|Include data marked private}} (checkbox unchecked by default)* {{checkbox|1}} {{man label|Include only living people}} (checkbox checked by default) - eliminates ancestors for webcalendars being used as reminder tools instead of historical tools.* {{stubman label|Translation:}}The translation to be used for the report. Language selector showing all languages supported by Gramps. Defaults to the language you are using Gramps in.* {{man label|Date format:}} The format and language for dates, with examples** Default - Choose this option to use the default set in [[Gramps_5.1_Wiki_Manual_-_Settings#Display|Edit > Display]] tab for {{man label|Date format:}} option.** '''YYYY-MM-DD(ISO)(2018-03-14)''' (default for report)** Numerical(14/3/2018)** Month Day, Year(March 14, 2018)** MON DAY, YEAR(Mar 14, 2018)** Day Month Year(14 March 2018)** DAY MON YEAR(14 Mar 2018)
{{-}}
** Wives use husband's surname (from last family listed)
* {{man label|Home link:}} ('''<code>../../Family Tree 1_NAVWEB/index.html</code>''' default) The link to be included to direct the user to main page of the web site.
* {{checkbox|1}} {{man label|Include birthdays}} (checkbox checked by default)
* {{checkbox|1}} {{man label|Include anniversaries}} (checkbox checked by default)
{{-}}
** ISO-8859-15
** koi8_r
* {{checkbox|0}} {{man label|Create "Year At A Glance" Calendar}} (checkbox unchecked by default)
* {{checkbox|0}} {{man label|Create one day event pages for Year At A Glance Calendar}} (checkbox unchecked by default)
* {{checkbox|1}} {{man label|Include birthdays}} (checkbox checked by default)
* {{checkbox|1}} {{man label|Include anniversaries}} (checkbox checked by default)
* {{checkbox|0}} {{man label|Link to Narrated Web Report}} (checkbox unchecked by default)
** {{man label|Link prefix:}} '''<code>../../Family Tree 1_NAVWEB/</code>''' A Prefix on the links to take you to Narrated Web Report.
Back to [[Gramps 5.1 Wiki Manual - Reports|Index of Reports]].
{{man index|Gramps 5.1 Wiki Manual - Reports - part 6|Gramps 5.1 Wiki Manual - Reports - part 8|5.1}}
{{languages|Gramps 5.1 Wiki Manual - Reports - part 7}}
{{grampsmanualcopyright}}
 
===See Also===
* [[Web Solutions for Gramps]]
[[Category:Documentation]]
[[Category:Plugins]]
107
edits

Navigation menu