Umstrukturierung und Erweiterung

Author: nichtich

CONTRIBUTING.md

@@ -6,14 +6,14 @@ Die jeweils aktuelle HTML-Version steht unter <https://pro4bib.github.io/pica/>
 
 Das Verzeichnis `slides` enthält begleitende Vortragsfolien.
 
-## Technische Details
+## Technische Details {.unnumbered}
 
 Um das Handbuch lokal nach HTML zu übersetzen wird [quarto](https://quarto.org/) benötigt:
 
 ~~~bash
 git clone git@github.com:pro4bib/pica.git && cd pica
-npm i
-npm run serve
+quarto preview
+quarto render
 ~~~
 
 Der Markdown-Quelltext lässt sich mit [markdownlint](https://www.npmjs.com/package/markdownlint) auf ein einheitliches Format überprüfen:
@@ -24,11 +24,11 @@ npm run lint
 
 Zur Erstellung der HTML-Version der Vortragsfolien in `slides` muss Pandoc installiert sein, dann reicht dort ein Aufruf von `make`.
 
-## Danksagung
+## Danksagung {.unnumbered}
 
 Die Technische Infrastruktur für die Bereitstellung dieses Handbuchs wurde von [Felix Lohmeier](https://felixlohmeier.de/) abgeschaut, der übrigens auch weitere interessante Einführungen in Themen der Datenverarbeitung für Bibliotheks- und Kultureinrichtungen anbietet. Die Implementierungen zur [Verarbeitung von PICA-Daten](verarbeitung) basieren zu wesentlichen Teilen auf der Arbeit von Carsten Klee und Johann Rolschewski. Weitere Beiträge und hilfreiche Hinweise zu diesem Handbuch stammen von Cornelius Amzar, Nico Wagner, Sabrina Gaab und Anne Schuchardt. Das Handbuch wurde von Monty Bitto zu Quarto konvertiert.
 
-## Lizenz
+## Lizenz {.unnumbered}
 
 Dieses Werk ist lizenziert unter einer [Creative Commons Namensnennung 4.0 International Lizenz](http://creativecommons.org/licenses/by/4.0/)
 

README.md

@@ -1,4 +1,3 @@
 # Einführung in die Verarbeitung von PICA-Daten
 
 Das Handbuch in diesem Repository wird mit quarto erstellt.
-

_quarto.yml

@@ -12,8 +12,9 @@ book:
     - index.md
     - part: "Theorie"
       chapters:
-        - grundlagen.qmd
-        - formate.qmd
+        - hintergrund.qmd
+        - datenformate.qmd
+        - pica-formate.qmd
     - part: "Praxis"
       chapters:
         - darstellung.qmd
@@ -25,6 +26,9 @@ book:
         - picadata.qmd
         - catmandu.qmd
         - pica-rs.qmd
+        - qa-catalogue.qmd
+        - metafacture.qmd
+        - winibw.qmd
     - literatur.md
   appendices:
     - CONTRIBUTING.md
@@ -60,3 +64,4 @@ format:
     published-title: "Letzte Änderung"
     number-sections: true
     number-depth: 2
+    tbl-cap-location: bottom

bearbeitung.qmd

@@ -16,7 +16,7 @@ indirekt zu Änderungen an PICA-Daten führen können:
 - den **Digitalen Assistent** (DA-3)
 - das Mapping-Werkzeug **[Cocoda](https://coli-conc.gbv.de/cocoda/)**
 
-Um unabhängig von einzelnen Werkzeugen Änderungen an PICA-Datensätzen auszudrücken, wurde an der VZG das [PICA-Patch-Format](formate.qmd#änderungsformat) entwickelt.
+Um unabhängig von einzelnen Werkzeugen Änderungen an PICA-Datensätzen auszudrücken, wurde an der VZG das [PICA-Patch-Format](pica-formate.qmd#änderungsformat) entwickelt.
 
 ## Änderungen mit Catmandu
 

catmandu.qmd

@@ -1,4 +1,4 @@
-# Das Werkzeug Catmandu {#sec-catmandu}
+# Catmandu {#sec-catmandu}
 
 **Catmandu** ist ein digitaler Werkzeugkasten für die Verarbeitung von Metadaten. Im Gegensatz zu ähnlichen ETL-Tools unterstützt Catmandu gängige Datenformate und Schnittstellen von Bibliothekssoftware, darunter auch PICA. Die PICA-Unterstützung in Catmandu basiert auf [picadata] und geht darüber hinaus, vor allem was Möglichkeiten des Zugriffs auf Schnittstellen (@sec-apis) und der Konvertierung zwischen PICA und anderen Formaten betrifft.
 
@@ -47,10 +47,10 @@ catmandu convert pp to JSON < example.pica
 
 Funktionen zur Verarbeitung von PICA in Catmandu werden erst durch das Paket [Catmandu-PICA](https://metacpan.org/release/Catmandu-PICA) bereitgestellt (siehe [Installation](#installation)):
 
-* Lesen und Schreiben verschiedener [PICA-Serialisierungen](formate.qmd#serialisierungen)
+* Lesen und Schreiben verschiedener [PICA-Serialisierungen](pica-formate.qmd#serialisierungen)
 * Auswerten und Verändern der Inhalte von PICA-Datensätzen
 * Abruf von PICA-Daten über [SRU-Schnittstellen](schnittstellen.qmd#sru)
-* Validierung von PICA-Daten mit [Avram-Schemas](formate.qmd#avram-schemas)
+* Validierung von PICA-Daten mit [Avram-Schemas](pica-formate.qmd#avram-schemas)
 
 ## Fix-Skripte
 
@@ -67,7 +67,7 @@ _id,titel
 
 Dieses Fix-Skript besteht aus zwei Befehlen (bei längeren Fix-Skripten empfiehlt sich das Auslagern in eine eigene Datei):
 
-* `pica_map(021A$ah,titel,join:" ")` fügt ein neues Feld `titel` mit dem Inhalt der Unterfelder `$a` und `$h` des PICA-Feld `021A` hinzu, wobei mehrere Inhalte durch Leerzeichen verbunden werden. Der Zugriff auf die Unterfelder erfolgt mittels [PICA Path Expression](formate.qmd#abfragesprache).
+* `pica_map(021A$ah,titel,join:" ")` fügt ein neues Feld `titel` mit dem Inhalt der Unterfelder `$a` und `$h` des PICA-Feld `021A` hinzu, wobei mehrere Inhalte durch Leerzeichen verbunden werden. Der Zugriff auf die Unterfelder erfolgt mittels [PICA Path Expression](pica-formate.qmd#abfragesprache).
 * `remove_field(record)` entfernt den PICA-Datensatz, so dass nur noch `_id` und `titel` übrig bleiben.
 
 Umgekehrt lassen sich mit Catmandu auch PICA-Daten erzeugen oder verändern. Hier ein Beispiel zur Änderung des Unterfelds `021A$a`:

darstellung.qmd

@@ -1,6 +1,6 @@
 # Anzeigen von PICA-Daten {#sec-anzeigen}
 
-Der erste Schritte bei jeder Analyse und Verarbeitung von PICA-Daten besteht darin, sich die Daten anzusehen. Dazu ist am besten die [PICA Plain Serialisierung](formate.qmd#serialisierungen) geeingnet. Werkzeuge zur Konvertierung in dieses Format werden in @sec-verarbeiten vorgestellt. Zur übersichtlicheren Anzeige von PICA Plain gibt es verschiedene Methoden der [Syntaxhervorhebung](#syntaxhervorhebung).
+Der erste Schritte bei jeder Analyse und Verarbeitung von PICA-Daten besteht darin, sich die Daten anzusehen. Dazu ist am besten die [PICA Plain Serialisierung](pica-formate.qmd#serialisierungen) geeingnet. Werkzeuge zur Konvertierung in dieses Format werden in @sec-verarbeiten vorgestellt. Zur übersichtlicheren Anzeige von PICA Plain gibt es verschiedene Methoden der [Syntaxhervorhebung](#syntaxhervorhebung).
 
 ::: {.callout-important appearance="simple"}
 Dieses Kapitel soll noch um Methoden ergänzt werden um Hilfe zu einzelnen PICA-Feldern abzurufen.
@@ -53,12 +53,16 @@ Der Texteditor [Sublime Text](https://www.sublimetext.com/) kann um Syntax-Highl
 + 021A $aEin gutes Buch$hzum Lesen
 ~~~
 
-::: {.callout-note appearance="simple"}
+::: {.callout-note}
 [Anleitung der Nutzung von Prism für PICA](https://gbv.github.io/lipstick/prism/)
 :::
 
 ### CodeMirror
 
+::: {.callout-warning}
+Die Darstellung an dieser Stelle wird gerade überarbeitet!
+:::
+
 [CodeMirror](https://codemirror.net/) ist eine HTML-Komponente für ansprechende Textformulare mit Syntaxhervorhebung. Der PICA+ Datensatz im folgenden Beispiel kann direkt im Browser bearbeitet werden. Umfangreichere Möglichkeiten zur Bearbeitung und Analyse bietet der auf CodeMirror aufbauende [PicaEditor](verarbeitung.qmd#picaeditor).
 
 <div>