GCstar documentation en

Alternatives to GCstar

Thu, 13 Aug 2009 22:46:18 +0000

This page lists applications that provides the same kind of features as GCstar does. It contains only free and open-source software. Alexandria * Website: * Environment: GNOME * Managed collections: Books collections.

Borrowings management

Tue, 16 Jan 2007 17:01:18 +0000

This section deals with all stuff related to borrowings management. Borrowers configuration In Configuration menu, there is a Borrowers items. When activated, such a window is displayed: [Borrowing configuration] On top, there is the potential borrowers. Someone needs to be in this list to be used as a borrower later. Add button is used to add a new borrower. Remove button do the opposite operation. E-mail address of someone can be changed by clicked on it on the list. Name can’t be chang…

Coding conventions

Thu, 01 Jul 2010 03:47:57 +0000

This page list the coding conventions that applies to GCstar’s code source. You should conform to them when modifying some code or creating new plugins. You may be used to other conventions. None of them are perfect. But using always the same ones in a project make work easier for all of the developers when maintenance or evolution are required. Using PerlTidy is a painless way to reformat your code according to these rules before check in.

Collections management

Sun, 04 Oct 2009 17:54:32 +0000

In this page there are all GCstar features concerning collections management. Add or remove items Adding an item can be done using first toolbar button. File menu contains also such an item. A new item is then added to list and no information is attached to it.

Command line options

Fri, 19 Jan 2007 14:37:31 +0000

This section describes the available command line options for GCstar. Introduction GCstar is launched through the main program, gcstar. When launched without any argument, it will open the graphical user interface and will load the previously opened file. After the application name, you should use a file name. Then GCstar will start and open it.

Conversions

Thu, 05 Feb 2009 01:36:10 +0000

GCstar can be used with other softwares. It requires collection conversions. Export allows you to use your collection in another software. While Import do the opposite, so you could use a collection generated with another software with GCstar. Introduction Plugins are described in the same order as the one they should have in Export and Import menus (sub-menus of File). If one of them is not present, user may know why thanks to Dependencies item in help menu ?). It will open such a window:

Debugging GCstar

Thu, 01 Jul 2010 03:13:06 +0000

Debugging GCstar Info from a forums post print statements There is no known way of using an IDE to debug gcstar - if you do, we’d really like to hear. Usually debug is done the old school way using print statements throughout the code. The Data::Dumper module is really useful here. On debugging plugins this Code:

Dependencies

Thu, 23 Aug 2007 10:40:55 +0000

To use GCstar, you need to have these packages installed: * Perl * Gtk2 * gtk2-perl Other packages are useful, but they should be found in standards Perl distributions. Installation does test if they can be used. Any operating system having these packages is able to have GCstar running. It was for the moment tested only on GNU/Linux, MacOS X systems and on Windows 2000/XP.

Displayed items

Thu, 11 Feb 2010 01:01:36 +0000

This documentation section explains what are different items displayed by GCstar. Main window Here is GCstar main window (of course, there won’t be so many information the first time it is launched). [Main GCstar window] On the left side, there is the collection content. Clicking on an item will display its information on the right side. Double-clicking on it will open a window containing also its information.

Command line execution

Sun, 28 Feb 2010 23:22:30 +0000

GCstar could perform some operations from the command line without launching the whole graphical interface. It could be useful to do these tasks from shell-script or time-initiated jobs. There are features to do importation, exportation and download.

FAQ

Mon, 23 Aug 2010 07:15:40 +0000

Frequently asked questions about GCstar and its usage. Why some import/export modules are not in the corresponding menus? Import and export modules may use some Perl (language used to create GCstar) components that are not available on any systems. To avoid blocking users that won’t need these modules, GCstar can be installed without them, but the modules will be deactivated and won’t appear inside the Import and Export sub-menus of the File menu.

Filtering

Sun, 19 Aug 2007 12:41:20 +0000

This part of the documentation deals with what can be done inside an existing collection to better organize it and find information. Ordering list Collections are displayed in list according to a certain order. Default one is an alphabetical order for names. But this may be reversed by user.

GCstar 1.5.0

Tue, 03 Aug 2010 20:44:26 +0000

This is the release notes for GCstar 1.5.0 containing the main new features and bug fixes. You may also read the full CHANGELOG Collection Grouping [Image mode grouping]You can now group your collections while you’re viewing them in image mode.

GCstar 1.6.0

Wed, 04 Aug 2010 12:57:46 +0000

About GCstar GCstar is an application for managing your collections. It supports many types of collections, including movies, books, games, comics, stamps, coins, and many more. You can even create your own collection type for whatever unique thing it is that you collect! Detailed information on each item can be automatically retrieved from the internet and you can store additional data, such as the location or who you’ve lent it to. You may also search and filter your collecti…

GCstar Viewer

Thu, 12 Aug 2010 07:33:24 +0000

GCstar Viewer is an Android applications to view your collections on a smart phone. Installation It can be downloaded from the Android Market. This link will directly show it if used from an Android device:

Download and installation

Wed, 01 Sep 2010 05:02:59 +0000

Before continuing, you may want to read the list of dependencies Download GCstar sources You can download gcstar through this link: download GCstar v[VERSION] Change to directory where this file has been saved and enter: A gcstar directory will be created. It contains the installation script, install. Change to this directory. You now have to choose between three kind of installations detailed in next chapters.

FreeBSD installation

Sun, 17 Feb 2008 10:41:30 +0000

This page contains specific installations procedures for FreeBSD systems. Dependencies should be managed automatically. FreeBSD offers two ways for installing software the Packages system and the Ports collection. The Packages system You can use the pkg_add command: but not always up to date.

GNU/Linux installation

Sun, 15 Aug 2010 09:37:02 +0000

GNU/Linux installation This page contains specific installations procedures for Gnu/Linux systems. Dependencies should be managed automatically. Most of these packages are external contributions. So they may be out of synchronization with last offical one.

Mac OS X installation

Mon, 12 Jan 2009 17:48:51 +0000

This page describes how GCstar and its dependencies could be installed on Mac OS X. Preparation GCstar has to be installed in X11 environments, not on native ones. So first step would be to install it if you won’t already have it. You may find more information about this on the X11 for Mac OS X page. Just note that X11 is installed by default on Mac OS X v10.5 Leopard. So you won’t have anything to do if you have this version.

Windows installation

Thu, 29 May 2008 20:39:34 +0000

This page contains instructions to install GCstar on Microsoft Windows systems. Current version Just download the GCstar installation program for Windows [VERSION] . It contains all the dependencies you need. Once installed, the update feature doesn’t work. This is a known problem in 1.4.0. It should be fixed in a feature release.

Plugin status

Thu, 12 Aug 2010 05:57:05 +0000

used symbols ‘+’: information available and correctly fetched. ‘o’: information not available for the plugin. (o): too much information available, plugin can not automatically choose one. ‘-’: available, but not fetched. Needs work.

Requested Plugins

Mon, 24 May 2010 11:06:36 +0000

Requested Plugins This list is taken form the following thread Categories are as in the thread Completed plugins have been deleted mostly because they have been combined into the program and the install information would be superfluous.

Schemas

Mon, 08 Jun 2009 01:32:03 +0000

This page aims to provide documentation of the Schema’s used by GCStar to store information about Collection Items Configuration Schemas GCconf (main config file) Item Schemas * GCBoardGames * GCBooks * GCcoins * GCcomics * GCFilms * GCgames * GCmusics * GCTVepisodes * GCTVSeries * GCWines

Settings

Sun, 04 May 2008 17:36:05 +0000

GCstar behaviour can be changed through many options. First item of Configuration menu opens a window containing these options. They are grouped in 5 tabs. Under the tabs, there is a checkbox, Expert Mode. When it is checked, some extra features will be available. By default it is unchecked to hide some settings that won’t be needed most of the time. But in this documentation, everything is explained. So on screenshots, this option is activated.

Test beta or Subversion versions

Sat, 26 Jul 2008 12:34:39 +0000

To help GCstar’s development, you may test new versions. They could be beta versions, that are released, but announced as potentially unstable ones. Or you may try the current version from Subversion (referred sometimes as SVN). As this may lead to some problems, you could want to perform these tests without interfering with your previous installation and your actual collections.

Translating GCstar in other languages

Thu, 24 Jul 2008 08:30:59 +0000

GCstar could be translated in many languages. Every single text that is shown on screen is in a separate file (one for each language). Preparation First, you should get the last GCstar version available (see Download and installation). It’s even better to get the last CVS version. Read the instructions on Gna! website.

Software updates

Wed, 27 Jan 2010 22:36:06 +0000

Some parts of GCstar could be updated without updating the whole software. This page describes how this should be done. Requirements The update should be launched with a user that have enough rights to modify files where GCstar have been installed. On a Unix system, the root user may perform that.

Creation of user models

Sun, 19 Aug 2007 12:23:38 +0000

If none of the available collection types included in GCstar fits your needs, you may create a personal one with the information you want. This page explains how it has to be done. Creating a collection of a personal type The first action is to create a new collection using the New item in the File menu. You will have such a window.

Information for webmasters

Mon, 19 May 2008 11:39:48 +0000

This page gives informations to webmasters managing a website that is available in GCstar through a plugin. GCstar's overview Presentation You could find more information in the documentation on this website. But here are the key features you may want to know about.

Plugins to fetch information from websites

Sat, 28 Aug 2010 14:39:04 +0000

These plugins are used to fetch information concerning items in default collections from websites. It will fill the fields with all the information it could get. This page describes how to create such a plugin. Please keep in mind the Coding conventions when writing such a plugin.

Create Windows installer

Thu, 08 May 2008 11:33:42 +0000

This page explains how an installer for Windows system could be created. It will contain all the required dependencies. The archive is enough to create a portable version. The real installer unpacks everything in a directory and also creates some shortcuts.