Resource Description with Allegro-C (rdac) ========================================== Thomas Berger Stand 2008-11-01 Das Projekt ``rdac'' (Allegro-C eXTensions) beinhaltet behutsame Verbesserungen an den Standard-Parameterdateien von http://www.allegro-c.de[_allegro-C_] und eine möglichst Extensive Verlinkung zu online verfügbaren Ressourcen zur Katalogisierung. Die Änderungen umfassen insbesondere: - Stärker RAK-gerechte ISBD-Anzeige - Elaboriertere Behandlung von GMD (Allgemeiner Materialbenennung) und Online-Ressourcen - Personennormsätze entsprechen vom Datenmodell stärker der PND Beschreibung ------------ Verzeichnisstruktur ~~~~~~~~~~~~~~~~~~~ Generiert werden in den Verzeichnissen: link:rdacdir[]:: - Parameterdateien als Austausch der Standarddateien aus +inst-all.exe+ der jeweils aktuellen Version von _allegro-C_. - Linklisten, Ersatzdokumentation Versionshinweise ~~~~~~~~~~~~~~~~ * Der Stand der Parameterdateien korrespondiert mit allegro-C V28.8.2 und etwas neuer (29.10.2008) * Es gibt ein link:CHANGES.html[Changelog]. * Unter < http://svn.gymel.com/viewvc/allegro/rdac/trunk/[http://svn.gymel.com/viewvc/allegro/rdac/...] > ist die Historie der Parameterdateien zugänglich, die kleinteilige Liste aller Änderungen ist im http://svn.gymel.com/viewvc/allegro/rdac/trunk/?view=log[SVN-Log] dokumentiert. * Unter < http://svn.gymel.com/rdac/produkt/[] > liegen stets aktuell generierte Dateien dieses Projekts, Der Stand des Abgleichs gegen die Standardparameter ist dokumentiert in der Datei http://svn.extra.gymel.com/rdac/produkt/VERSION.txt[VERSION.txt]. DOWNLOAD & Installation ----------------------- .. Download http://svn.gymel.com/rdac/produkt/rdacdir.zip[] .. Entpacken in das allegro-Programmverzeichnis (Standard ist ++c:\allegro++, ggfls. über den Button +DbInf+ in _a99_ ermitteln): + ****************************** unzip -a rdacdir -d c:\allegro (vorzugsweise. Alternativ kann auch das Kontext-Menue (rechte Maustaste) im Windows-Explorer genutzt werden) ****************************** .. Enthalten sind insbesondere - Indexparameter +rdac.api+ - Eingabeformular +rdac.frm+ + Diese sind ggfls. in das eigene Datenverzeichnis zu kopieren und dabei auf den Namen der Datenbank umzubenennen. + ******************************* Also etwa im Windows-Explorer: * +rdac.api+ auswählen und im Kontext-Menue (rechte Maustaste) ``kopieren'' auswählen. * In das (Unter-)Verzeichnis mit der Datenbank wechseln * Im Kontext-Menue (rechte Maustaste) ``einfügen'' auswählen Die folgenden zwei Schritte nur, wenn die Datenbank nicht _rdac_ heisst: * Vorhandene Indexparameterdatei (etwa +cat.api+) löschen * +rdac.api+ umbenennen in +cat.api+ ******************************* + Für die Formulardatei +rdac.frm+ ist analog vorzugehen HOWTO ----- a) Auschecken ................................... svn co https://svn.extra.gymel.com/repos/allegro/rdac/trunk rdac ................................... b) Inititalisieren des Build-Verzeichnisses (`./produkt`) ................................... cd rdac Configure <1> ................................... <1> damit wird implizit ein neues Unterverzeichnis ``produkt'' zum Build-Verzeichnis c) Generieren der Dateien ................................... cd produkt mingw32-make setup mingw32-make ................................... d) Optional: Vergleich mit Originalparametern in _c:/allegro_ ................................... diff --strip-trailing-cr checkdir c:/allegro | grep -v "^Only" ................................... b') Alternative Build-Verzeichnisse: ................................... mkdir p:/fad/to/newdir <2> cd p:/fad/to/newdir <2> f:/ad/to/rdac/Configure <1> ................................... <1> Projekt sei ausgecheckt in _f:/ad/to/rdac_. <2> Dateien sollen in einem Verzeichnis _p:/fad/to/newdir_ generiert werden. SYSTEMVORAUSSETZUNGEN --------------------- Für die Build-Umgebung: - _Perl_ (etwa ActivePerl, < http://www.activestate.com/Products/activeperl/[] >) - _zip_ und _unzip_ (infozip, < http://www.info-zip.org/[] >) - GNU _make_ (auf Windows-Plattformen: stets die mingw-Version), vorzugsweise 3.82, vorzugsweise +mingw32-make.exe+ (< http://www.mingw.org/download.shtm[] >) - zwingend weitere GNU coreutils: _cp_, _echo_, _mv_, _mkdir_, _rm_, _rmdir_, _sh_, _touch_ - optional weitere Utilities: _xsltproc_, _xmllint_, _asciidoc_ Beispielsweise das Paket MSYS (< http://www.mingw.org/msys.shtml[] >) enthält alle benötigten GNU-Utilities, allerdings _make_ v3.79. In diesem Fall dann bitte angeben: ................................... Configure --msys=path/to/MSYS ................................... also etwa ................................... Configure --msys=C:\MSYS --config=config.hint --prefix=x:\yz\rdac\produkt ................................... und config.hint enthält (mindestens) die Zeile ................................... make=make.exe --unix ................................... Fallen: ~~~~~~~ -- * wird das MSYS-Toolset benutzt, muss `--msys=...` angegeben werden, auch wenn das bin-Verzeichnis im PATH ist (es erfolgen sonst gewisse Anpassungen an den Hints nicht) * Cygwin's make kommt mit Laufwerksbuchstaben in Pfaden nicht mehr klar, weil es in neueren Versionen zu sehr POSIX ist. * Ältere Versionen von make (3.79, 3.80) + sollten möglichst nicht genommen werden, sind aber u.U. Standard in gewissen Linux-Distributionen - ältere Versionen kennen `$(abspath ...)` nicht, daher bitte stets den absoluten Pfad des Zielverzeichnisses als `--prefix=...` beim _Configure_ angeben: ................................... perl $projdir/Configure.cmd --prefix=$projdir/produkt ................................... - _make_ v3.79 unterscheidet einen MAKE_MODE (Environmentvariable oder Aufrufschalter) zwischen Win32 und Unix. Die Makefiles sind auf _unix_ eingestellt, d.h. entweder Vorbesetzung `set MAKE_MODE=unix` im Environment oder Angabe von `--unix` als Schalter in einer Hint-Datei - wird das +make.exe+ aus MSYS (im Gegensatz zu +mingw32-make.exe+, das auf Stand v3.82 ist) eingesetzt, muss _make_ im PATH sein (und damit tendenziell das gesamte MSYS-bin-Verzeichnis). -- Fazit: ~~~~~~ Schmerzfrei ist die Kombination a. http://www.mingw.org/msys.shtml[MSYS] installieren (bin-Verzeichnis nicht in den PATH) bzw. minimales cygwin-System installieren. b. http://www.mingw.org/download.shtm[mingw32-make] installieren (es genügt, nur +bin/mingw32-make.exe+ zu extrahieren und irgendwo in den Suchpfad abzulegen). c. _zip_ und _unzip_ von http://www.info-zip.org/[InfoZip] downloaden und in den Suchpfad legen. d. Aufruf als ................................... Configure --msys=Msys-Verzeichnis ................................... Adressen -------- .Notifications / Views * http://svn.extra.gymel.com/viewvc/allegro/rdac/?date=month&view=query&format=rss[] - Änderungen als RSS Feed * http://svn.gymel.com/viewvc/allegro/rdac/[] - Repository-Browser .SVN-Repository * https://svn.extra.gymel.com/repos/allegro/rdac/trunk/[https://svn.extra.gymel.com/repos/allegro/rdac/] (Repository-URL) * http://svn.gymel.com/repos/allegro/rdac/trunk/[https://svn.gymel.com/repos/allegro/rdac/trunk/] (dsgl. Readonly) .Ausgecheckte Kopie / Vorgenerierte Versionen * http://svn.gymel.com/rdac/[] (mehrmals täglich aktualisiert) * http://svn.gymel.com/rdac/produkt/rdacdir/[] (Mit analyze.pl verarbeitete Parameterdateien) * bzw. gepackt unter http://svn.gymel.com/rdac/produkt/rdacdir.zip[rdacdir.zip] (Download mit Standardvorgaben) Über dieses Dokument ~~~~~~~~~~~~~~~~~~~~ $HeadURL: https://svn.extra.gymel.com/repos/allegro/rdac/trunk/README.txt $ $Id: README.txt 22175 2008-11-01 21:42:09Z ThB $ Kontakt ~~~~~~~ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ mailto:ThB@gymel.com[Thomas Berger < ThB (at) gymel (dot) com >] ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++