aboutsummaryrefslogtreecommitdiff
path: root/README.txt
diff options
context:
space:
mode:
authorSilvio <silvio@devlet.com.br>2011-02-22 11:43:41 -0300
committerSilvio Rhatto <silvio@devlet.com.br>2011-02-22 11:43:41 -0300
commitb5b78b5778397ff4fa517d2a2bb16e580aa65290 (patch)
tree286ba87acc0528577ab279cab383255ba27051f1 /README.txt
parent3e779fc7b7389c660c4759cc1fa73302e830e451 (diff)
downloadcinisis-b5b78b5778397ff4fa517d2a2bb16e580aa65290.tar.gz
cinisis-b5b78b5778397ff4fa517d2a2bb16e580aa65290.tar.bz2
Documentation update (3)
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt51
1 files changed, 47 insertions, 4 deletions
diff --git a/README.txt b/README.txt
index f0cf0a9..c23ad25 100644
--- a/README.txt
+++ b/README.txt
@@ -1,6 +1,49 @@
Cinisis database reader
=======================
+Installation
+------------
+
+### Getting Cinisis
+
+Cinisis source code can be obtained via git:
+
+ git clone http://git.devlet.com.br/cinisis.git
+
+This documentation covers just installation with Biblio::Isis library
+and assumes a Debian like operating system.
+
+### Installing BiblioIsis
+
+The Biblio:Isis can be installed directly from package together with
+development files for perl:
+
+ apt-get install libbiblio-isis-perl libperl-dev
+
+### Installing pecl-perl
+
+Then download and build pecl-perl:
+
+ pecl install perl
+
+Due to a bug (see http://pecl.php.net/bugs/bug.php?id=16807), you might
+prefer to install it directly from source:
+
+ svn checkout http://svn.php.net/repository/pecl/perl/trunk pecl-perl
+ cd pecl-perl
+ phpize
+ ./configure
+ make install
+
+You will still need to enable the extension in your php.ini depending on
+how your system is configured.
+
+### Getting spyc
+
+Cinisis config files are written in YAML. You'll need to download Spyc
+library from https://code.google.com/p/spyc/ and put the files at
+the contrib/ folder.
+
Naming conventions
------------------
@@ -18,10 +61,10 @@ iterating over all the data from a ISIS database.
Example:
- MFN 1 with entry
- 10: First row of field 10^aWith a subfield^bAnd another one
- 10: Second row of field 10^bJust with the second subfield
- 20: This is the main item^yAnd this is another item
+ MFN 1 with entry
+ 10: First row of field 10^aWith a subfield^bAnd another one
+ 10: Second row of field 10^bJust with the second subfield
+ 20: This is the main item^yAnd this is another item
For that entry we have fields 10 and 20, where field 10 has two rows (i.e, two
repetitions). The main field is the data wich is has no qualifier (^) and a