4,602
edits
Changes
m
{{stub}}<!--have not update below this-->
{{man note|Website gone?|Please remove those example website links that have gone.}}
→Integrate with Joomla CMS: add 2016 Drupal integration
{{languages|Howto:_Make_a_genealogy_website_with_Gramps}}
{{man note|How to make a genealogy website|Using Gramps 4.x. and the [[Gramps_4.2_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).}}
== Before you start ==
You can easily generate a nice looking an inviting website from within Gramps.
Before you start , you should have an idea about the data you want to present on the website. If Due to the liabilities related to accidentally revealing private information, consider exporting your Tree without living persons and without data marked as 'private'. Then import that into a new Tree BEFORE using this report. Be certain to check the Researcher tab in Preferences and to use the [[Gramps_{{man version}}_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]] tool to protect your own identity. Also, if your complete family tree is large, the number of generated files can be '''huge''', and possibly take up a lot of file storage space.
==How to limit the amount of data==
If you have a large database, it is wise to start with a [[filter]] to limit the number of people: In the People view of Gramps, go to the View menu, and activate the Filter sidebar. Next, go to {{man menu|Edit --> Person Filter Editor}} menu, and make a suitable filter. Read the [[Gramps_4.2_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Filters#Custom_Filter_Editor|help manual]] if necessary. Once a filter is defined, you can test it in the People view, by selecting the filter in the Filter Sidebar, and clicking find. You can combine filters (yes, it helps if you have experience with some basic and/or logic) until you have a selection of all the people you want on your website.
==Make a Home Page, Introduction Page, and more==
===Whatspecial content needs to be created?===
Before you use the ''Narrated Web Site report'', you should make some custom pages with the information not yet in Gramps:
<!-- already part of report in Gramps 4? -->
* Publisher info: extra information on you, the publisher of the page, to appear on every page
{{man note|Note|Gramps works with [https://en.wikipedia.org/wiki/Style_sheet_%28web_development%29 style sheets], so the exact ordering, and look of the website is all contained in '''one''' file, the style sheet, eg e.g., <code>narrative.css</code>. You should at this moment Do NOT concern distract yourself about with customizing style, only . Focus on content, and some basic markup (paragraphs, italic/bold text, div sections, ...).}}
===How?to customize==={{stub}}<!--work works differently in gramps 4-->Go to the Media View in Gramps, and click on the add icon. In the ''Select a media object'' dialog, you need to click on the option ''Internal Note'', and give a title, eg e.g., ''Home Page'', ''Footer'', ...
Next, you select the new media object, and edit it (double -click or Edit button). Everything you write add in the Note tab of the media object, will appear on your webpage if you select this media object during the website generation.
If you know htmlHTML, you can just type the text wrapped with the needed appropriate html codescode tags. If you do not know htmlHTML, consider making a page with a "What You See Is What You Get" web editor like Bluefish, Quanta Plus, ... . These tools contain icons to dynamically create webpages. The html HTML text created like this in such tools can then be copied in the note section of your ''Home Page'' Gramps media object.
{{man tip|Tip|if If you have experience with cascading style sheets, you can use specific <code><div ></code> tags in your pages, and edit the style sheet to contain your custom tags.}}
==Choosing the layout==
Gramps provides a selection of seven built -in style sheets for you to choose from to determine the general appearance or your web pages. You can 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).
Whatever the style you choose, after generation, it will default to the ''narrative-screen.css'' file which can be found in the <code>css</code> directory.
If you have some experience with websites , you can easily customise customize this one file and without . Without changing the content files, your web pages will be completely changed to the form, colours, etc. that you specified. Do backup these changes, as you might easily regenerate your website and accidentally overwrite this file by error.
If you make a custom style sheet you would like to share with other Gramps users. You can do this by adding to your custom css CSS file and ensuring that its copyright is creative commons alike, and attaching to an feature request or you can send it to the developers on: <code>gramps-devel <<at> lists.sourceforge.net </code> to be addedto future releases.
==Generate the pages==
In the '''Page Generation''' tab, choose the internal notes you created above. It is recommended you "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 Hosting site has enough file storage space.
# You extensively use the private marker on sensitive data'''. {{man warn|Be careful with Sensitive to respect sensitive and private data|Many people have unintentionally published private email conversations they (stored for research and reference reasons in Gramps, ) on the net without realizing.}}
The '''Privacy''' 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. It is recommended you leave the ''Years from death to consider living:'' as the default of a '''minimum of 30 years'''! This will lessen the issue of revealing sensitive data on the internet of living people that . Such revelations may have legal ramifications for you. A number of genealogists have found themselves in disputes due to publication of information on living people. You have been warned. Please also take into account your local legislation (eg:e.g., there are very strict privacy law in Italy, France, Finland...).
To create the report you select '''OK''' and Gramps starts generating your '''Narrated Web Site''' pages : this will take some time depending on the size of your family tree, as a lot of files and directories will be made. When completed you will be the owner of a complete structure ready to publish on the internet.
==Publishing==
Now you can publish your work on the web.
First, check the size of your web page. Go to the directory where you stored the web site, and in a modern file browser, right-click and select properties. This normally allows to calculate the directory size. Write down this info, and check your webhosting contract. Above a certain size, you will need to pay extra. Investigate before you burn yourself! If your site is too large, you can make a filter which produces a smaller website, or disable images, or split your site in pieces, and host it with different providers.
There are some free providers around: eg e.g. Lycos , but there are maybe may be better alternatives.
===Transfer your files===
*[[sitecopy]]: This is generally the best option. Only changed pages are uploaded to the server hosting your website. You can install sitecopy with every distribution via the package manager. Read the manual, it is self-explanatory: type in a console <code>man sitecopy</code> (or in konqueror type address <code>man:sitecopy</code>). Windows or Mac OS users could try the [http://filezilla-project.org/ FileZilla client].
*rsync : This is for advanced linux users. It is a better solution than sitecopy, but you need full access to the webhost, which normal users normally not have. Rsync only uploads the changes to a file, whereas sitecopy uploads the entire file.
*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!
|[http://family.dave.org.uk/ Cross Family Tree]||Basic (Ash)||English||version 3.2.5-1
|-
|[https://www.bosharst.home.xs4all.nl/gramps/ Van den Bos - Van der Harst]||Basic (Spruce)||Dutch||version 45.20.40
|}
== Comparison with other programs==
# Copy the GRAMPS NAVWEB website that is generated on to your WordPress site somewhere where you will find it.
# Generate a Page in WordPress for your GRAMPS Website to be located. Add the following if you are using Iframe Embedder : [ iframe NAVWEB-url 100% 200]
==== See Also ====
* Many Roads: Tips & Opinions, Tools - [https://www.many-roads.com/2010/04/30/further-wordpress-gramps-integration/ Further WordPress – GRAMPS Integration] ''<small>30 April 2010</small>''
===Integrate with Joomla CMS ===
{{stub}}
[https://sourceforge.net/p/joomlagen/wiki/Home/ JoomlaGen!] is a free and open-source content management system (CMS) for publishing web content.
Integrating Gramps via the [https://sourceforge.net/p/joomlagen/wiki/Home/ JoomlaGen] component is [[Joomla|detailed in another article]]. The component was designed for use with the 1.5 Joomla! version. By late 2020, version of Joomla! was at the 3.9.22 release. The most recent JoomlaGen version is the 0.3 pre-release version and was posted in July 2012. The author tested for compatibilty with the Gramps 3.3.0 version. (As of {{CURRENTDAYNAME}}, {{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, Gramps is at {{version}} version.)
===Integrate with Drupal CMS ===
{{stub}}
In 2016, Drupal consultant Killed ceated an experimental sandbox project which allows importing of a back up file from the Gramps genealogy package into Drupal.
Quoted from the [https://www.drupal.org/sandbox/killes/2758441 documentation]:
<q>It consists of two parts:<br /><br /> 1) granny: a features based module that defines entities, views, and such<br /> 2) migrate_gramps: a migration module that includes the XML parser, defines how the XML is to be parsed and the results being put into Drupal<br /><br />The goal is to present the data entered into gramps within the context of a Drupal website.<br /><br />This is currently very rough, the import mostly works (some parts such as media are still missing), but there are few views defined to actually show the data.
</q>
===Integration of NarrativeWeb in a CMS or MVS===
The feature request was [https://gramps-project.org/bugs/view.php?id=5530 #0005530] :
The NarrativeWeb generate flat html files.
If you use a <abbr title="Model, View, Controller">MVC </abbr> or a <abbr title="Content Management System">CMS </abbr> like itseasy, [https://www.pmwiki.org/wiki?n=PmWiki.PmWiki PmWiki], ... you can't return to the home page.You loose lose all the look and feel of your website.If we create some <code>.php </code> files which include those <code>.html </code> files ( mode_rewrite ), it doesn't work because we have headers and <code></html></code> in them.
CMS=[Content Management System] and MVC=[ Model View Controller ]
====Patch for release 3.4 and 4.2====
====For release 5.0 and above====
The patch will be is integrated in 5.0.
====How it works ?====
The following show how to proceed with joomla Joomla (3.1.1):
I suppose NAVWEB is the directory under your root web site in which you put all the gramps Gramps tree.
I suppose I only have html page pages for grampsGramps. No other html application.
The <code>.htaccess </code> in the root web directory has now only the following lines :
RewriteEngine on
====What is necessary when creating the Narrative Web ?====
save as a <code>tar </code> 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 ?"
[[Category:Tutorials|Make a genealogy website with Gramps]]
[[Category:Documentation]]
==See Also==
* [[Web Solutions for Gramps]]
