Simple Topic Maps Management

Donwloads

To run Simple Topic Maps Management follow these four steps:

Install Perl, mySql (or other database engine), Apache (or other web server) and DBI module for Perl. You need: DBD-mysqlPP and Algorithm-Diff installed.
Run this SQL script (database_builder_for_mysql.sql.txt) to build a database with this structure. The SQL is for mySql but you can easily change it also for other databases if you need.

Download one of these zip files and save it in the cgi-bin directory and docs directory of your web server:

Version 0.2 (SimpleTopicMapsManagement_v02.zip) This version has some bug fixed and it trace the history of each node.
Version 0.1 (SimpleTopicMapsManagement_v01.zip)

These are the files in the ZIP archive:

database_builder_for_mysql.sql.txt   SQL command to generate the tables in the database

tm_cgi.pl      Very short program that need to be customized (see Instructions below)

TM.pm          The core of the application. Store it in the same directory of tm_cgi.pl

```
topicmaps.gif  Image       
```
```
add.gif        Image       
```

remove.gif     Image              Save the images and the CSS file in a

xtm.css        CSS file           directory that can be read by the server.

Configure the CGI tm_cgi.pl (see Instructions section below) and run it on your local server (something similar to http://localhost/cgi-bin/tm/tm_cgi.pl).

That's all!

Instructions

Before running the CGI (tm_cgi.pl) remember to configure it. This is the CGI:

1 #! d:/Perl/bin/perl.exe
2 # By Luca Mugnaini
3 # http://www.geocities.com/lucamugnaini/tm/
4 # use CGI::Carp qw(fatalsToBrowser);
5 use TM;
6 TM->connect('dbi:mysqlPP:database=topic_maps;host=localhost', '', '');
7 $TM::image_directory = "/images";
8 $TM::cgi_name = "tm_cgi.pl";
9 print TM::cgi->cgi();

At line #1 specify the path to your Perl binary
Uncomment the line #4 if you want to see nice error report in HTML format. Useful for debugging if you are going to modify the application.
At line #6 give detail for the connection to the database such us database serve, database name, login and password. Refer to the module DBI for more details.
Specify at line #7 the directory where you have stored the images (remove.gif and add.gif) plus the CSS file xtm.css.
Line #8 is for the name of the CGI in case you want to change it.
External Modules

The only external module necessary to run this tool is DBI. Find it here: http://search.cpan.org/dist/DBI/

Characteristics of the module TM.pm

With this application you have an object oriented interface to store easily topic maps in a relational database. The most simple way to create a new topic is:
```
use TM;
TM->connect('dbi:mysqlPP:database=topic_maps;host=localhost', '', '');
my $topic = TM::topic->new;
$topic->save();
```
To read the topic that has ID = 1:
```
my $topic = TM::topic->new(id => 1);
$topic->load();
```
To display the value of the first scope of the first occurrence of certain topic:
```
print $topic->{'occurrence'}->[0]->{'scope'}->[0]->{'content'};
```
To change the value and save it:
```
$topic->{'occurrence'}->[0]->{'scope'}->[0]->{'content'} = 'new value';
$topic->save();
```
To display all the attributes of a topic:
```
use Data::Dumper;
print Dumper($topic);
```
To create a topic that is instance of the topic #1 and topic #2:
```
my $topic = TM::topic->new
(
	instanceOf =>
	[
		TM::instanceOf->new( content => '#1', type => 't' ),
		TM::instanceOf->new( content => '#2', type => 't' ),
	],
);
$topic->save();
```
To add a new instance for topic #3
```
push @{$topic->{instanceOf}}, TM::instanceOf->new( content => '#3', type => 't' );
$topic->save();
```
To remove this last instance (both from the database and from the object):
```
$topic->{intanceOf}->[2]->remove($topic);
```
To remove the whole topic:
```
$topic->remove($topic);
```
To output the part of XML related to topics (sorry, I forget to build a method that generate all the XML. For the next version...):
```
TM::cgi::create_xml('topic');
```
Limitations
Recursive variants in topic > baseName are not supported yet.
mergeMap editing is still not supported even if the database is able to save it.
Importing of XTM is not supported yet.
History is not supported yet.

Home |

Simple Topic Maps Management

Donwloads

Instructions

External Modules

Characteristics of the module TM.pm

Limitations