Aus einem Flora Incognita Export eine Website erzeugen

Auf dieser Seite findest Du ein Programm und eine Anleitung, mit denen Du Dein eigenes Flora Incognita Projekt als einfache (statische) Website sichtbar machen kannst.

Inhalt dieser Seite: Anleitung; ausführliches Beispiel; Anmerkungen zur Benutzung; Programm herunterladen; Liste der Quelltexte; Wenn Du etwas anpassen möchtest: das local Verzeichnis; Offene Baustellen

Anleitung

Diese Anleitung gilt für Unix Betriebssysteme, zB Linux und BSD.

Lege einen Ordner im Dateisystem an, in dem Du die statische Website erzeugen willst. Alle weiteren Arbeiten finden in diesem Ordner statt.
Lade den für die Erzeugung benötigten Quelltext ("source") herunter (s.u.) und entpacke die Archivdatei (ZIP- oder tar-Datei).
Exportiere Dein Projekt incl. der Fotos in eine Exportdatei (ZIP-Archiv). Dazu gibt es eine Anleitung auf dieser Seite im Abschnitt "Flora-Incognita-Beobachtungen aus der App heraus exportieren".
Speichere die Exportdatei in den Arbeitsordner.
Führe das Programm aus, das die Website erzeugt: src/floraincognita2html.sh
Wenn alles gepasst hat, wurde ein Unterordner namens website erzeugt.
In diesem gibt es eine Datei index.html, die Du im Webbrauser öffnen kannst.
Vor dem erneuten Starten von src/floraincognita2html.sh muss der bereits bestehende website-Ordner gelöscht (rm -rf website) oder weggeschoben (mv website website.bak.1) werden.

Ausführliches Beispiel

Öffne eine shell (Kommandozeile, Terminal, Konsole).
Lege einen Ordner im Dateisystem an, in dem Du die statische Website erzeugen willst. Hier als Beispiel den Ordner floraweb:
```
$ mkdir floraweb
```
Alle weiteren Arbeiten finden in diesem Ordner statt.
Wechsle mit cd in den Arbeitsordner:
```
$ cd floraweb
```
Lade den für die Erzeugung benötigten Quelltext ("source") herunter (s.u.) und speichere die Archivdatei (ZIP- oder tar-Datei) im Arbeitsordner.

Entpacke dort die Archivdatei (mit unzip bzw. tar xvpf):

floraweb$ tar xvpf floraincognita2html.txz

Der source befindet sich nun im Unterordner src:

src/floraincognita2html.sh
src/floraincognita2html.awk
src/index.html.head
src/index.html.tail
src/src.html

Exportiere Dein Projekt incl. der Fotos in eine Exportdatei (ZIP-Archiv). Dazu gibt es eine Anleitung auf dieser Seite im Abschnitt "Flora-Incognita-Beobachtungen aus der App heraus exportieren".
Speichere die Exportdatei in den Arbeitsordner.
Der Dateiname sieht (bis auf die Zeitangabe) so aus:
```
flora_incognita_2026-03-15T12_54_05.zip
```
Der Dateiname muss diese Form haben: flora_incognita_YYYY-MM-DDThh_mm_ss.zip

Führe das Programm aus, das die Website erzeugt:

floraweb$ src/floraincognita2html.sh

ls: Zugriff auf 'flora_incognita_20??-??-??T??_??_??' nicht möglich: Datei oder Verzeichnis nicht gefunden
Archive:  ../flora_incognita_2026-03-15T18_05_51.zip
inflating: flora_incognita_2026-03-15T18_05_51.csv
inflating: 2026-03-15T16_54_50Z/2026-03-15T16_54_50Z-0.jpg
inflating: 2026-03-15T16_54_50Z/2026-03-15T16_54_50Z-1.jpg
[...]
inflating: 2025-08-22T09_38_48Z/2025-08-22T09_38_48Z-0.jpg
inflating: 2025-08-22T09_27_02Z/2025-08-22T09_27_02Z-0.jpg
ln: auf 'flora_incognita_2026-03-15T18_05_51/2025-09-07T09_59_06Z/*.jpg' konnte nicht zugegriffen werden: Datei oder Verzeichnis nicht gefunden
src/floraincognita2html.sh
src/floraincognita2html.awk
src/index.html.head
src/index.html.tail
src/src.html
adding: src/floraincognita2html.sh (deflated 58%)
adding: src/floraincognita2html.awk (deflated 71%)
adding: src/index.html.head (deflated 48%)
adding: src/index.html.tail (deflated 5%)
adding: src/src.html (deflated 57%)

Die obigen Fehlermeldungen ...

Datei oder Verzeichnis nicht gefunden

... sind nicht schlimm. Die erste ...

ls: Zugriff auf 'flora_incognita_20??-??-??T??_??_??' nicht möglich: Datei oder Verzeichnis nicht gefunden

... kommt daher, dass es beim ersten Benutzen des Programms noch kein ausgepacktes Exportverzeichnis gibt.
Die zweite ...

ln: auf 'flora_incognita_2026-03-15T18_05_51/2025-09-07T09_59_06Z/*.jpg' konnte nicht zugegriffen werden: Datei oder Verzeichnis nicht gefunden

... entsteht, weil im Index des Exports (also in der CSV-Datei im ausgepackten Exportverzeichnis) eine Beobachtung referenziert wird, zu der aber kein Unterverzeichnis mit den zugehörigen Fotos existiert.
Beide Meldungen kannst Du ignorieren:-)

Wenn sonst alles gepasst hat, wurde ein Unterordner namens website erzeugt:

floraweb$ ls -l

insgesamt 46065
drwxrwxr-x 210 susi susi      211 Apr 10 14:51 flora_incognita_2026-03-15T18_05_51
-rwxr-----   1 susi susi 47144411 Mär 15 18:11 flora_incognita_2026-03-15T18_05_51.zip
-rw-rw-r--   1 susi susi     6900 Apr 10 14:39 floraincognita2html.txz
drwxrwxr-x   2 susi susi        7 Apr 10 14:42 src
drwxrwxr-x 134 susi susi      140 Apr 10 14:51 website

In dem Ordner website gibt es eine Datei index.html, die Du im Webbrauser öffnen kannst.

Vor dem erneuten Starten von src/floraincognita2html.sh muss der bereits bestehende website-Ordner gelöscht (rm -rf website) oder weggeschoben (mv website website.bak.1) werden.

Anmerkungen

Du solltest die Dateien config und ggf. index.html.head auf Dein Projekt anpassen, s.u.
Wenn mehrere Exportdateien oder (ausgepackte) Exportordner im Arbeitsordner liegen, verwendet das Programm von diesen die jüngste Version (laut Zeitangabe im Namen).
Du kannst aber explizit eine andere Quelle für die exportierten Daten als Parameter des Programms angeben:
```
% src/floraincognita2html.sh --help

src/floraincognita2html.sh [<flora_export> [<website_dir>]]
	<flora_export> = Exportarchiv oder ausgepackter Exportordner
	<website_dir> = zu erzeugender Ordner mit der Website
```
Bei unterschiedlichen Betriebssystemen und AWK-Implementierungen können mit den bisherigen Scripten Fehler auftreten. Falls Dir das passiert, bitte melden, danke!
Bisher funktioniert es mit:
- FreeBSD 14, One True Awk 20250116
- Ubuntu 22.04.5, mawk 1.3.4

Quelltexte des Programms herunterladen

Du kannst Dir die Quelltexte für das src-Verzeichnis als Archivdatei herunterladen. Entweder als ZIP Datei oder als mit xz komprimiertes tar Archiv.
(Da das Programm nur aus shell- und AWK-Skripten besteht, müssen die Quelltexte nicht zu einem ausführbaren Programm kompiliert werden.)
Einige der Dateien kannst Du leicht für Dein Projekt anpassen, s.u..

Erläuterungen zu den `src` Dateien

In dem Quelltextarchiv befinden sich folgende Dateien:

config: Projektspezifische Textersetzung für die Übersichtsseite. Trage hier (statt "Mein Projekt") den Namen und ggf. (statt "index.html") die URL (Webadresse) Deines Projektes ein.
floraincognita2html.sh: Ausführbares shell script, das die Erzeugung der Website steuert.
floraincognita2html.awk: AWK script, das aus der von Flora Incognita exportierten CSV Tabelle eine Artentabelle im HTML Format berechnet.; Außerdem wird ein shell script erzeugt, das für jede Art ein Unterverzeichnis anlegt und die zugehörigen Fotos aus dem Export dorthin kopiert.; Schließlich wird für jede Art eine Webseite erzeugt (Wissenschaftlicher Artname/index.html), in der die Fotos dieser Art angezeigt werden.
index.html.head: Das HTML Fragment, das den Anfang der Übersichtsseite bildet.
index.html.tail: Das HTML Fragment, das nach der Artentabelle das Ende der Übersichtsseite bildet.
floraincognita2html.css: Eine CSS-Datei, mit der das Erscheinungsbild der Webseiten verändert werden kann.
src.html: Das ist der Quelltext der Seite, die Du gerade liest:-)
util: Unterverzeichnis mit Hilfsfunktionen.

Wenn Du etwas anpassen möchtest: das `local` Verzeichnis

Wenn Du eine oder mehrere der Dateien config, index.html.head, index.html.tail und floraincognita2html.css für Deine Website anpassen möchtest, dann ändere sie nicht im src Verzeichnis, sondern

lege im Arbeitsverzeichnis ein neues Verzeichnis namens local an,
kopiere die zu verändernde(n) Datei(en) vom src in das local Verzeichnis,
öffne die Datei(en) im local Verzeichnis mit einem Texteditor und ändere sie nach Deinen Bedürfnissen.

Zum Erzeugen der Website werden dann Deine modifizierten Versionen der o.g. Dateien verwendet, nicht die aus dem src Verzeichnis.

Darüber hinaus gibt bereits folgende Anpassungsmöglichkeiten, die ihren Weg noch ins src Verzeichnis finden müssen. (Bei Interesse daran bitte kurz im WiLaDo "Bescheid" sagen.)

Eigenes Logo/Bild nach website/img kopieren.
Löschen einer Liste von Fehlerfotos, die zB durch versehentliches Auslösen der Kamera entstanden sind, aber nicht aus dem Flora Incognita Projekt gelöscht werden können.
Einpflegen einer CSV Datei mit Markierungen (tags) und Anmerkungen (notes) zu den Arten. In der App ist es sehr mühsam, Arten im nachhinein zu bearbeiten. Eine CSV Datei hingegen lässt sich mit einem Tabellenkalkulationsprogramm übersichtlich bearbeiten.

Offene Baustellen:

Anzahl der gefundenen Arten automatisch in die index.html einfügen.
Integration in die /permakultur-Website (hugo)
Tags (Markierungen) ergänzen: z.B. Nutz-, Hifs-, Zier-, Wildpflanze. (Sehr mühselig in der App, also lokale Lösung entwickeln.)

Ein erster Ansatz existiert bereits, s.o. Anpassungen: CSV Datei.

Nach tags sortierte Tabelle erzeugen.
...