Documentation for Ghini 1.0

Ghini is a suite of applications for managing botanical specimen collections.

• ghini.desktop lets you create and query a database representing objects and events in your plant collection.
• ghini.web publishes highlights from your database on the web.
• ghini.pocket puts a snapshot of your database in your handheld device.
• ghini.tour assists garden visitors with a map and spoken virtual panels.

The bulk of this documentation focuses on ghini.desktop. One final chapter presents the rest of the Ghini family: ghini.pocket, ghini.web, ghini.tour, and the data streams between software components.

All Ghini software is open and free. Our standalone software is released under the GNU Public License. Our client-server software follows the GNU Affero Public License.

Statements

• Ghini’s goals and highlights
• Mission & Vision

Installing Ghini

• Installation
  • Installing on GNU/Linux
  • Installing on MacOSX
  • Installing on Windows
  • Installing on Android

User’s Guide

• Initial Configuration
  • Should you SQLite?
  • Connecting to a database
  • Initialize a database
• Searching in Ghini
  • Search Strategies
  • The Query Builder
  • Query Grammar
• Editing and Inserting Data
  • Notes
  • Family
  • Genus
  • Species/Taxon
  • Accessions
  • Plant
  • Locations
• Dealing with Propagations
  • Creating a Propagation
  • Using a Propagation
• Tagging
  • dialog box tagging
  • windowless tagging
• Generating reports
  • The Report Tool
  • Using the Mako Report Formatter
  • Using the XSL Report Formatter
• Importing and Exporting Data
  • Importing from CSV
  • Exporting to CSV
  • Importing from JSON
  • Exporting to JSON
  • Importing from a Generic Database
  • Importing a Pictures Collection
• Managing Users
  • Creating Users
  • Permissions

Cookbook

• Contributed recipes collection
  • Quito Botanical Garden
  • using ghini for a seed database

Administration

• Database Administration
  • SQLite
  • MySQL
  • PostgreSQL
• Ghini Configuration
• Reporting Errors

Ghini Family

• the Ghini family
  • ghini.pocket
  • ghini.web
  • ghini.tour
  • data streams between software components

Ghini Development

• Developer’s Manual
  • Helping Ghini development
  • Software source, versions, branches
  • Development Workflow
  • Updating the set of translatable strings
  • Producing the docs locally
  • Which way do the translated strings reach our users?
  • Adding missing unit tests
  • Structure of user interface
  • Extending Ghini with Plugins
  • Plugins structure
  • bug solving workflow
  • Distributing ghini.desktop
• Template Letters
  • Dear conservator or scientist,
  • free botanic data management systems
  • Welcome to Ghini/Bauble
  • Do you want to join Ghini?

Supporting Ghini

If you’re using Ghini, or if you feel like helping its development anyway, please consider donating.