File: README

package info (click to toggle)
libxtm-perl 0.37-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 1,536 kB
  • ctags: 410
  • sloc: perl: 23,045; makefile: 37
file content (92 lines) | stat: -rw-r--r-- 2,396 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
What is it?
-----------
This base package contains Perl extension interfaces for Topic Maps

   http://www.topicmaps.org/xtm/1.0/

!!!
!!! NOTE: THIS PACKAGE IS NO LONGER ACTIVELY MAINTAINED. We are working on
!!! a completely new distribution.

With it you can

  - read/write XTM files
  - read/write AsTMa resources
  - manipulate and query topic maps via an API

See also for xtm.pl, a simple command line driven workbench.

Other packages of interest:

  - XTM::slides .... creating slides from topic maps

Prerequisites
-------------

Of course, XTM::base relies heavily on other Perl packages. Most
of them (hopefully all) should be resolved automatically if you
use the cpan frontend.

One notable thing is that XTM::base depends on finding an XML SAX
parser, so it depends on XML::SAX which ships with a Perl SAX parser.
It is good, but not the fastest.

  -  If you are using XML::LibXML (see KNOWN_ISSUES) then obviously
     the libraries have to be installed:

     For Debian users this is trivially done with 

       apt-get install libxml2
       apt-get install libxml2-dev

     The others can find sources (RPMs?) at

     http://www.xmlsoft.org/

  -  If you want to use the SAX version of Expat, install XML::SAX::Expat
     (see KNOWN_ISSUES).

Installation
------------

This module should be completely installable via the cpan frontend.
To build the extensions manually, unpack this distribution somewhere, and
exercise the usual incantation:

perl Makefile.PL
make
make test
make install

You will need perl version 5.6.1 or better to install these modules.


Documentation
-------------

You can learn about Topic Maps in general at

  http://www.topicmaps.org/xtm/ (XTM standard)
  http://topicmaps.bond.edu.au/ (tutorials, other stuff)
  http://easytopicmaps.com/     (tutorials, lotta links and hints)

You will find an overview in XTM::base, further documentation is embedded 
in the individual modules. Most of the Perl packages come with a POD 
description and there is also a docs directory in the distribution.

Support
-------

You can either

  - mail to the author (rho@telecoma.net)
  - discuss this in one of the topicmap mailing lists, or
  - create an bug entry in rt.cpan.org (preferred)




Copyright 200[1-2] Robert Barta, rho@telecoma.net

This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.