107
edits
Changes
→How it works ?
{{languages}}
How to make a genealogy website with Gramps 4.x. and the [[Gramps_4.1_Wiki_Manual_-_Reports_-_part_7#Narrated_Web_Site|Narrated Web Site]] report, from conception, to uploading your genealogical website to an internet service provider (ISP).
==Generate the pages==
In the Report menu, choose {{man menu|Reports > Web Page--Pages >Narrative Narrated Web Site...}}.
Choose a suitable directory where you want to generate your website locally. It is best to do this locally, and upload your website only afterwards.
In the '''Report Options Tab''' tab, set select the filter you created. Choose a ''Filter'GOOD'you created previously if any. Change the '' Web site title for your webpage. Choose file extension: html (the rest is for experienced users), Set character encoding '' to something more meaningful to Unicode (only use other encoding if you have very specific reasons)than "My Family Tree". Choose the style you want and set the copyright notice (use the footer for specific extra legalese necessary in your country). ''StyleSheet'Think about copyright!''' Ancestor graph generation relates to the how many ancestors will be visible on the people pages in a nice graphyou want (See [[Gramps_4. Try different settings for this1_Wiki_Manual_-_Reports_-_part_7#Report_Options|examples]]).
In the '''Page Generation Tab''' tab, choose the internal notes you created, as related above. I suggest It is recommended you suppress the GRAMPS "Suppress Gramps ID"'s, as visitors are not interested in this. Be careful with the option ''Include images and media objects''. '''Only choose this option if:# your Your Hosting site can be VERY bighas enough file storage space.# you You extensively use the private marker on sensitive data'''. {{man warn|Be careful with Sensitive data|Many people have burnt themselves with this option, publishing unintentionally published private email conversations they stored for research reasons in Gramps, on the net without realizing.}}
The '''Privacy Tab '''tab {{man menu|is one of the most important settings''' }}. Make it a habit to never include private data, and restrict the information on living people. I suggest It is recommended you set leave the ''years to restrict Years from person's deathto consider living:'' to as the default of a '''minimum of 25 30 years'''! This will prevent grave mistakes having sour consequenceslessen the issue of revealing sensitive data on the internet of living people that may have legal ramifications for you. Many A number of genealogists have found themselves in disputes due to publication of information on living people. You have been warned. Also Please also take into account your local legislation (eg:very strict privacy law in e.g. Italy, France, ...).
==Regeneration of your site==
Every time you change make changes to your database family tree you need to regenerate your site to see the changes. Although Gramps will regenerate the entire site, '''only the pages with changed dataNarrated Web Site''' will be different. You therefore need not republish all the website report to the internet again, but can limit yourself to only upload the changed pages. Specific tools to do this exist, like sitecopy. See furthersee those changes.
Although Gramps will regenerate the entire site, '''Limitationonly the pages with changed data''': If you upgrade Grampswill be different. You therefore need not republish all the website to the internet again, changes might have happened but can limit yourself to only upload the website generation, meaning all changed pages will have changed. Investigate Specific tools to do this before you upgradeexist, and consider the benefits of upgrading against this possible drawbacklike sitecopy. See further.
==Publishing==
{{out of date|have not update below this}}
Now you can publish your work on the web.
*ftp/ssh: You can also use a wide range of ftp clients to upload your site. The easiest for new users is in GNOME/KDE, go to Remote Places, and click to add a new remote place. Choose the settings for your provider (ftp/ssh, login, password), and now you can drag and drop files in Nautilius/Konqueror, like on your own PC. You can also use one of the many specific ftp applications, like gFTP (it should be in the repositories of your distribution). Basically you transfer all the files to the server and that's it. However : as you have probably seen, you created with "NarrativeWeb" an awful lot of directories and files, so transferring the vast amount of files will take some time! If you update your site often, consider learning sitecopy!
== Examples of websitesNarrated Web Sites==Feel free to add your with Gramps generated website Narrated Web Site here. Please, remove missing links if you encounter those. Style is one of the Gramps styles, or custom.
{|{{prettytable}}
|-
|[http://users.telenet.be/frederik.de.richter/stamvaders.html De Richter]||Custom made ||Dutch || version 2.2.6
|[http://www.xs4all.nl/~bosharst/gramps/ Van den Bos - Van der Harst]||Basic (Spruce)||Dutch||version 4.1.1
|}
{{man note|Website gone?|Please remove those example website links that have gone.}}
== Comparison with other programs==
What if your database is really really huge? I did not try this yet, but you could split your data, say ''the descendants of Jacobus Roelants'' on one Lycos site and the other part of the family ''the descendants of Sebadiah Johansson '' on another Lycos site and so on. It should be fairly easy to install links to switch between sites, eg in the home page, as the directory structure Gramps generates does not change.
===Integration of NarrativeWeb in a CMS or MVS===
{{man warn| Warning |This section is a work in progress.}}
The feature request was [https://gramps-project.org/bugs/view.php?id=5530 #0005530] :
The NarrativeWeb generate flat html files.
If you use a MVC or a CMS like itseasy, pmwiki, ... you can't return to the home page.
You loose all the look and feel of your website.
If we create some php files which include those html files ( mode_rewrite ), it doesn't work because we have headers and </html> in them.
CMS=[Content Management System] and MVC=[ Model View Controller ]
====Patch for release 3.4 and 4.2====
The patchs are available and attached to the feature request : [https://gramps-project.org/bugs/view.php?id=5530 #0005530]
====For release 5.0 and above====
The patch will be integrated in 5.0.
====How it works ?====
The following show how to proceed with joomla (3.1.1):
I suppose NAVWEB is the directory under your root web site in which you put all the gramps tree.
I suppose I only have html page for gramps. No other html application.
The .htaccess in the root web directory has now only the following lines :
RewriteEngine on
# rules for narrativeweb
RewriteRule ^(.*)\.html$ http://%{HTTP_HOST}/index.php/tree?page=$1.html [QSA,R,L]
RewriteRule ^(css/.*)\.css$ http://%{HTTP_HOST}/NAVWEB/$1.css [QSA,R,L]
RewriteRule ^(thumb/.*)$ http://%{HTTP_HOST}/NAVWEB/$1 [QSA,R,L]
RewriteRule ^((images|img|thumb)\/.*\.(jpeg|jpg|gif|png)$) http://%{HTTP_HOST}/NAVWEB/$1 [QSA,R,L]
For Joomla, I installed the plugin : DirectPHP
And I create an article named tree in which I put :
{source}
<?php
$rep = "/var/www/NAVWEB/";
// You can place PHP like this
$page = JRequest::getVar('page');
// for security reason, don't allow .. in path
$pageok = str_replace("..", "", $page);
if ($pageok == "") $pageok = "index.html";
include($rep.$pageok);
?>
{/source}
====What is necessary when creating the Narrative Web ?====
save as a tar file.
In the Narrative web Report options menu, choose the "CMS inclusion" tab and select the only option of this tab : "Do we include these pages in a cms web ?"
===Changing a word present on multiple pages===
