aboutsummaryrefslogtreecommitdiff
path: root/README.txt
diff options
context:
space:
mode:
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