Gramps 3.1 Wiki Manual - Reports - part 3
This section describes the Book report available in GRAMPS.
|Special copyright notice: All edits to this page need to be under two different copyright licenses:
These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [http://www.gramps-project.org/...]), not via internal links.
Back to Index of Reports.
Currently, the only available report under this category is the Book Report.
The Book Report creates a single document (i.e. a Book) containing a collection of graphical and textual reports. Consequently, this allows for a very rich set of documents that GRAMPS can produce.
When Reports-->Books-->Book Report... is selected, the following book configuration dialog appears:
The Book name text entry field is used to save the book (a set of configured selections) for future use. The top pane Available items lists the items available for inclusion in the book. The bottom panel Current book lists the currently selected items in the order they will appear in the book.
The horizontal set of buttons by the Book name field operates on the whole book. Click the Clear button (clear the book) to clear all items from the current book. Click the Save button to save the current book (under the name typed in the Book name text entry field) for future use. This saves the current set of configured selections.
Saving the book also saves the configuration for each item.
Click the Open button to load the book (Open previously created book) from the list of previously saved books.
Finally, click the Edit books button to invoke the editable list of available books (Manage previously created books).
The vertical set of buttons to the right of the bottom pane operates on the selected book item. Click the Add button to add selected item from the available list to the current book. Click the Remove button to remove an item from the current book. Use Up and Down to change the items order in the current book. Click the Setup button to configure the options of the selected item of the current book.
The configuration dialogs invoked by Setup are item-specific. If you choose not to configure the item, same defaults will be used for all needed options. The common option for almost all book items is the center person: the person on whom the item is centered. Thanks to this option, you can create a book with items centered on different people (e.g. your mom's and dad's ancestors as separate chapters). By default, the center person is set to the Active Person.
If all selections of the reports to be included are made, click the OK button. This will invoke a GRAMPS Book window. There is one tab with available Paper Options where you can change Size, and Orientation for the Paper Format and all Margins. Click box is available to change to metric values.
In the lower part of the window you can change some Document Options:
- Output Format: drop down menu let you choose between: Open Document Text, PDF document or Print.... Click box is available to open in OpenOffice.org Word Processor
- Filename: default value is /yourhomedir/book.odt. Click the Save as button and you can change the file name settings in the usual way.
Almost all items available for inclusion in the book are textual or graphical reports, and are therefore available in the form of standalone reports. The exception is the following items which are only available as book items:
- Title Page
If you selected the Title page item and clicked the Add button to put this item in your book and you click Preferences button (Configure currently selected item) you will get a Title Page window. Two tabs are available: Text and Image. In the Text tab you have three text input fields available where you can change the Title, the subtitle and a Footer (default Copyright 2008).
The lower window part shows some Document Options: here you can choose the Style. You can choose the default style or click on the Style Editor... button. This brings up a Style Editor window where you can add and remove Styles.
TODO link to Style Editor window
In the Image tab an image can be optionally placed between the subtitle and the footer. There is Preview facility and with the from gallery... button you can select via the Select Media Object dialogue the image you want. You can also change the Size
Because of you can configure the various elements , this item can be used to create title pages for the whole book, its chapter, or even a single item.
- Custom Text
This item produces a page with three paragraphs, each containing custom text: Initial Text, Middle Text and Final Text. The text input fields are expandable so you can really put all the text you want in there. The appearance of the text can be adjusted by using custom styles (see Document options Title Page). This item was meant to be used for epigraphs, dedications, explanations, notes, and so forth.