From f43ddd5669696c8b73829b2da661782912aaf736 Mon Sep 17 00:00:00 2001
From: tvluke <tvluke@chaotikum.org>
Date: Thu, 15 Feb 2024 16:05:27 +0100
Subject: [PATCH] docs

---
 docs/presence.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 docs/presence.md

diff --git a/docs/presence.md b/docs/presence.md
new file mode 100644
index 00000000..9de713b4
--- /dev/null
+++ b/docs/presence.md
@@ -0,0 +1,17 @@
+# Präsenz zeigen
+
+Unter https://presence.chaotikum.org/ läuft ein [Dienst](https://git.chaotikum.org/chaotikum/spacepresence), der beliebige MD5-Hashes von Werten für je 10 Minuten speichert. Es können nach Belieben Clients geschrieben werden, die einen Wert (oder vielmehr dessen hash) dort hinterlegen. Das ganze funktioniert nur, wenn der Aufruf aus dem Netz des nbsp erfolgt.
+
+Dann kann die Liste der Hashes der innerhalb der letzten 10 min übermittelten Werte unter https://presence.chaotikum.org/presence abgerufen werden.
+
+Dies tut auch JavaScript der Website und blendet Bilder, die unter `images/avatar` im Website-Repo gespeichert sein müssen, und genauso heißen wie der Hash (Endung „.jpg“) ein. Die Bilder sollten die Größe 80x80px haben.
+
+Gibt es das Bild nicht, wird stattdessen das default.png angezeigt.
+
+## Wie muss mein Bild heißen?
+Du musst ein Bild mit 80x80 px in den `images/avatar` Ordner legen. Der Name des Bildes mus der md5-hash des übertragenen Wertes sein. Du kannst z.b https://www.md5hashgenerator.com/ nutzen um den rauszufinden.
+
+## Automatisieren
+Alle paar minuten einen Wert zu übertragen ist doof, daher kann man das skripten.
+
+Für MAC mit Python ist [hier ein konkretes Beispiel](https://git.chaotikum.org/tvluke/p1)
-- 
GitLab