Skip to content
Snippets Groups Projects
Commit 53f5b07d authored by David Maus's avatar David Maus
Browse files

Update documentation

parent 25e9f541
No related branches found
No related tags found
No related merge requests found
...@@ -6,23 +6,19 @@ ...@@ -6,23 +6,19 @@
PicaRecord provides an object oriented interface to Pica+ records, fields, and subfields. It does PicaRecord provides an object oriented interface to Pica+ records, fields, and subfields. It does
not provide the means to read or write Pica+ records. In order to do so you need to install the not provide the means to read or write Pica+ records. In order to do so you need to install the
packages PicaReader and PicaWriter that are available via the same PEAR channel. packages PicaReader and PicaWriter that are available as dedicated composer packages.
PicaRecord is copyright (c) 2012 by Herzog August Bibliothek Wolfenbüttel and released under the PicaRecord is copyright (c) 2012-2015 by Herzog August Bibliothek Wolfenbüttel and released under the
terms of the GNU General Public License v3. terms of the GNU General Public License v3.
* Installation * Installation
PicaRecord should be installed using the [[http://pear.php.net][PEAR Installer]]. This installer is the PHP community's You can install PicaRecord via Composer.
de-facto standard for installing PHP packages.
#+BEGIN_EXAMPLE #+BEGIN_EXAMPLE
pear channel-discover hab20.hab.de/service/pear composer require hab/picarecord
pear install --alldeps hab20.hab.de/service/pear/PicaRecord
#+END_EXAMPLE #+END_EXAMPLE
PicaRecord depends on the [[http://phix-project.org/][Phix project's]] PSR0 compliant autolader, =Autoloader=.
* Usage * Usage
** Records, Fields, and Subfields ** Records, Fields, and Subfields
...@@ -140,44 +136,11 @@ record class has its own restrictions when it comes to appending a field to it v ...@@ -140,44 +136,11 @@ record class has its own restrictions when it comes to appending a field to it v
The attempt to add a field with a different level then the allowed level results in an The attempt to add a field with a different level then the allowed level results in an
=InvalidArgumentException= to be thrown. =InvalidArgumentException= to be thrown.
* Development
If you want to patch or enhance this component, you will need to create a suitable development
environment. The easiest way to do that is to install phix4componentdev:
#+BEGIN_EXAMPLE
apt-get install php5-xdebug
apt-get install php5-imagick
pear channel-discover pear.phix-project.org
pear -D auto_discover=1 install -Ba phix/phix4componentdev
#+END_EXAMPLE
You can then clone the Git repository:
#+BEGIN_EXAMPLE
git clone git://gitorious.org/php-pica/picarecord.git
#+END_EXAMPLE
Then, install a local copy of the package's dependencies to complete the development environment:
#+BEGIN_EXAMPLE
phing build-vendor
#+END_EXAMPLE
To make life easier for you, common tasks (such as running unit tests, generating code review
analytics, and creating the PEAR package) have been automated using [[http://phing.info][Phing]]. You'll find the
automated steps inside the build.xml file that ships with the component.
Run the command 'phing' in the component's top-level folder to see the full list of available
automated tasks.
* Acknowledgments * Acknowledgments
The [[http://phix-project.org][Phix project]] makes it easy to setup and maintain a package repository for a PEAR-installable Large parts of this package would not have been possible without studying the source of
package and integrates important tools such as [[http://phpunit.de][PHPUnit]], [[http://phing.info][Phing]], [[http://pear.php.net][PEAR]], and [[http://pirum.sensiolabs.org/][Pirum]]. Large parts of this [[http://search.cpan.org/dist/PICA-Record/][Pica::Record]], an open source Perl library for handling Pica+ records by Jakob Voß, and the practical
package would not have been possible without studying the source of [[http://search.cpan.org/dist/PICA-Record/][Pica::Record]], an open source knowledge of our library's catalogers.
Perl library for handling Pica+ records by Jakob Voß, and the practical knowledge of our library's
catalogers.
* Footnotes * Footnotes
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment