Eero Tamminen 2bf08ece8f Major updates to GraphViz plugin.
Re-factoring:
- split large functions to smaller ones to make code more readable
- renamed few methods and variables to what they actually do
- collect the report text to a buffer first so that it can be
  converted to latin-1 at one go
- Move common style stuff to GraphViz header and remove from .dot
  comments stuff that's obvious from first .dot file settings
Fixes:
- latin-1 conversion option is explicit, not depending on font
- set the GraphViz charset attribute according to latin1
- quote node and edge identifiers
- rankdir options correspond now to TB and LR (earlier LR and RL)
New features:
- Use christening/burial dates if birth/death dates are missing
- User can add a (e.g. copyright) note to the graph and set its
  location (newlines and double quotes are automatically escaped)
- User can give the paging direction
- User can set the GraphViz aspect ratio setting
- The weight option (either for children or parents)
- Women have rounded boxes, except in filled mode
  (current GraphViz doesn't support boxes that are both rounded and filled)
New default settings:
- set the ratio to "compress" instead of "fill"
- "mclimit=2.0", prevents crossed lines
- minimum node separation is 0.25


svn: r6010
2006-02-27 22:02:27 +00:00
..
2006-02-19 00:52:49 +00:00
2006-02-27 22:02:27 +00:00
2006-02-27 22:02:27 +00:00
FAQ
2006-02-25 07:08:05 +00:00

Please read the COPYING file first.
If building from source, also read the INSTALL file (at least through the
"SUPER-SHORT VERSION") before going further.

Requirements
--------------------------------
The following packages *MUST* be installed in order for Gramps to work:
   Python 2.3 or greater
   Gnome 2.8 or greater
   PyGTK2 2.4 or greater
   Gnome-python 2.6 or greater

The following packages are *STRONGLY RECOMMENDED* to be installed:
   Reportlab         Enable creation of PDF documents 
                     http://www.reportlab.com

   GraphViz         Enable creation of graphs using GraphViz engine
                    http://www.graphviz.org


Documentation
---------------------------------
Gramps documentation is supplied in the form of XML files, which will be
installed in the GNOME help path(*).  Gnome help browser (Yelp) uses these 
(properly installed) XML files to display the documentation.

Of course, current HTML documentation can also be found on the gramps website,
http://gramps-project.org/index.php?module=pagemaster&PAGE_user_op=view_page&PAGE_id=7

(*) More precisely, they are installed 
in ${prefix}/share/gramps/gnome/help/gramps, 
where ${prefix} is given by the --prefix= option 
to configure (defaults to /usr).  


Building on non-Linux systems: i18n support and GNU make
--------------------------------------------------------

Linux has libintl (GNU gettext) built-in the C library. Other systems
are likely to have libintl as a separate or optional library. Also,
other systems may have a different make utility.

On those systems, like FreeBSD, you must tell configure where to find
the libintl library and the libintl.h include file:

CPPFLAGS="-I/usr/local/include -L/usr/local/lib" ./configure --prefix=/usr/local

Once you have done this, if make fails, use gmake (the name FreeBSD
gives to GNU make) instead.

--------------------------------
Donald Allingham
dallingham@users.sourceforge.net