You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
excerpt: ediarum.WEB ist eine Bibliothek für die eXist-db, die die schnelle und einfache Publikation von (TEI-)XML-Datein ermöglichen soll
10
10
11
-
last_modified_at: 2023-11-12
11
+
last_modified_at: 2024-01-21
12
12
13
13
---
14
14
15
-
16
15
# Allgemeine Beschreibung
17
16
18
-
[In Bearbeitung]
19
-
20
17
ediarum.WEB ist ein sich in Entwicklung befindliches Modul von [ediarum](https://www.ediarum.org/index.html), einem Open-Source-Softwareprojekt der TELOTA-Initiative der Berlin-Brandenburgischen Akademie der Wissenschaften. Bei ediarum.WEB handelt es sich um eine Bibliothek für die [eXist-db](http://www.exist-db.org), die es zum Ziel hat, das schnelle und einfache Publizieren von (TEI-)XML-Dateien zu ermöglichen.
21
18
22
19
23
20
## Anwendungsbereiche
24
21
25
-
26
-
27
22
* Webpublikation von (TEI-)XML-Daten
28
23
29
-
30
24
## Funktionsübersicht
31
25
32
-
33
-
34
26
* Erstellung von digitalen Editionen
35
27
* Einfaches Anlegen von sogenannten Objekten (z. B. Briefen, Personen, Orte und Organisationen im Falle unserer Briefedition) und Beziehungen zwischen den Objekten (z. B. Person A als Absender von Brief B oder Nennung von Ort X in Brief Y)
36
28
* Anlegen von Filtern bei Objekten (z. B. nach Jahreszahlen bei Briefen oder nach Alphabet bei Personen) möglich
@@ -41,33 +33,24 @@ ediarum.WEB ist ein sich in Entwicklung befindliches Modul von [ediarum](https:/
41
33
42
34
## Voraussetzungen
43
35
44
-
45
36
Jedes Tool kann einerseits bestimmte Vorkenntnisse der Benutzer:innen voraussetzen und andererseits auch hinsichtlich der Software-Umgebung gewisse Anforderungen stellen.
* Docker Desktop (für eine weniger fehleranfällige Installation von eXist-db)
66
-
50
+
* Docker Desktop (für eine einfachere Installation von eXist-db)
67
51
68
52
## Tool-Kompatibilität
69
53
70
-
71
54
<table>
72
55
<tr>
73
56
<td>
@@ -112,11 +95,8 @@ Jedes Tool kann einerseits bestimmte Vorkenntnisse der Benutzer:innen voraussetz
112
95
</table>
113
96
114
97
115
-
116
98
## Kostenübersicht
117
99
118
-
119
-
120
100
***_ediarum.WEB_ & _eXist-db_:**
121
101
* kostenlos
122
102
@@ -125,11 +105,8 @@ Jedes Tool kann einerseits bestimmte Vorkenntnisse der Benutzer:innen voraussetz
125
105
126
106
Da jedes Projekt unterschiedliche Anforderungen mit sich bringt, sollen nachfolgend mögliche Vor- und Nachteile des getesteten Tools dargestellt werden.
127
107
128
-
129
108
## Stärken
130
109
131
-
132
-
133
110
* Vorkonfiguriertes Basislayout, das adaptiert werden kann
134
111
* Basale digitale Editionen mit typischen Funktionalitäten (z. B. Filter bei Objekten wie Personen (z. B. alphabetisch) und Texten (z. B. nach Jahreszahl) schnell und relativ einfach umsetzbar
135
112
* Rückgriff auf eine große Menge an vordefinierten XQuery-Funktionen möglich, um eine Vielzahl an potentiell gewünschten Funktionalitäten umzusetzen
***Installation der XML-Datenbank eXist-db:** Da es sich bei ediarum.WEB um eine Bibliothek für eXist-db handelt, müssen wir diese Datenbank zunächst installieren. Wir entscheiden uns für die Installation via Docker Desktop, die [hier](https://digedtnt.github.io/docker-exist/) erläutert wird.
157
132
***Installation von _ediarum.WEB_ in _eXist-db_:** Im nächsten Schritt muss nun ediarum-WEB in eXist-db eingerichtet werden.
158
133
* Dafür laden wir aus dem _[ediarum.WEB-GitHub-Repository](https://github.com/ediarum/ediarum.WEB/releases)_ die aktuellste Version (2.1.1) von _ediarum.WEB_ als XAR-Datei herunter.
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/ediarum_web_installiert.png" description="ediarum.WEB in der eXide-IDE" %}
169
144
170
-
***Erzeugen eines Projekttemplates mittels Apache Ant:**[In Bearbeitung]
171
-
172
-
173
145
## 2. Einrichtung des Projekts
174
146
175
-
176
-
177
147
* Zunächst müssen wir unsere XML-Dateien, die Briefe Hugo Schuchardts und das Named-Entity-Register, in eXist-db hochladen. Dazu öffnen wir eXide, wählen im Reiter “File” und daraus “Manage” aus, woraufhin sich der Dateimanager öffnet.
178
148
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/exide_create_collection.png" description="Der eXide-Dateimanager" %}
179
149
@@ -183,14 +153,9 @@ Auf der Ebene der Ordner “apps” und “system” legen wir einen Ordner name
183
153
Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol und laden die fünf Briefe Hugo Schuchardts hoch. Ist dies erledigt, kehren wir mittels Klick auf “done” zur Navigationsansicht zurück und laden in gleicher Weise das Named-Entity-Register in den Ordner “register” hoch.
184
154
185
155
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/upload_xml.png" description="Das Hochladen der Briefe" %}
186
-
187
-
188
-
189
156
190
157
## 3. Bearbeitung der Dokumente
191
158
192
-
193
-
194
159
***Anpassen des Titels der Indexsseite:** Zuerst wollen wir den Titel unseres Projekts abändern und navigieren dazu über eXide in den Ordner “templates” und öffnen die Datei “page.html”. Dort ändern wir die beiden Vorkommnisse von “Workshop” auf “Hugo Schuchardt: Briefe” ab, speichern die Datei und laden dann die Indexseite neu.
195
160
196
161
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/landing_page_schuchardt.png" description="Die neue Indexsseite" %}
@@ -202,10 +167,8 @@ Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol
202
167
203
168
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/appconf.png" description="Die Datei appconf.xml" %}
204
169
205
-
206
170
Wir ändern die dort im `<project>`-Element vorhandenen Daten wie folgt ab:
@@ -217,7 +180,6 @@ Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol
217
180
</config>
218
181
```
219
182
220
-
221
183
Folgende Informationen werden hier mittels XML-Elemente festgelegt:
222
184
223
185
* `<name>`: Hier wird der Projektname festgelegt, der Name dient auch als ID
@@ -648,7 +610,6 @@ Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol
648
610
</parts>
649
611
```
650
612
651
-
652
613
Die Attribute `@separator` und `@prefix` müssen verpflichtend angegeben werden. Ersteres legt fest, wie Teile und Unterteile im Falle von Verschachtelung abgeteilt würden (also z. B. durch Punkt wie in unserem Fall). Zweiteres legt fest, wie die Namespaces (`@starts-with`) von den Werten getrennt werden (also z. B. durch Bindestrich in unserem Fall wie etwa “page-1”). `<root>` legt wieder das Wurzelelement des Teils fest, in unserem Fall die Seiten (`<tei:pb>`), `<id>` gibt die ID des Teils an, in unserem Fall das `@n`.
653
614
654
615
@@ -686,21 +647,11 @@ Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol
686
647
</div>
687
648
</div>
688
649
```
689
-
690
-
691
650
Navigieren wir nun zu der Detailansicht eines Briefes, zeigt sich, dass nur die erste Seite angezeigt wird und ein Navigationsmenü zur Verfügung steht, mit dem zwischen den einzelnen Seiten umgeschaltet werden kann.
692
651
693
652
694
653
{% include image.html url="../data/pipelines/pipeline_2/ediarum_web/img/briefe_pages.png" description="Das Menü zum Umschalten zwischen den einzelnen Briefseiten" %}
695
654
696
-
* **Einfügen einer Suchfunktion:** [In Arbeit]
697
-
698
-
699
-
## 5. Export
700
-
701
-
[In Arbeit]
702
-
703
-
704
655
# Kontakt
705
656
706
657
**Unternehmensgröße:**
@@ -717,36 +668,17 @@ Danach navigieren wir in den Ordner “letters”, klicken auf das Wolkensymbol
0 commit comments