try to reproduce build steps in local web: trying to get a small webserver running to which the make steps can push.

content/mailinglisten/sympa/_index.md

@@ -0,0 +1,18 @@
+---
+title: "Unverschlüsselte Listen"
+date: 2022-11-06T16:54:00+01:00
+geekdocCollapseSection: true
+---
+
+Für unverschlüsselte Mailinglisten nutzen wir den Listenmanager [Sympa](https://sympa.community). Alle Listen laufen unter der Domain `@wat.systemausfall.org`.
+
+## Eigenschaften
+
+| Option | Beschreibung |
+|--------|--------------|
+| Maximal Anzahl der Adressen | unbegrenzt |
+| Größe des Archivs | 100 MB |
+| Maximale Größe eines Anhangs | 10 MB |
+| Speicherplatz für gemeinsame Dokumente | 10 MB |
+
+Der Speicherplatz kann bei begründeten Bedarf auch erhöht werden.

content/mailinglisten/sympa/abo/_index.md

@@ -0,0 +1,30 @@
+---
+title: "Abonnements"
+date: 2022-11-08T21:23:13+01:00
+resources:
+  - name: abo-1
+    src: "sympa_empfang.png"
+    title: "E-Mail-Empfang deaktivieren"
+---
+
+Es gibt verschiedene Möglichkeiten, E-Mail-Adressen zu einer Liste hinzuzufügen oder zu entfernen. Am einfachsten ist es über die [Verwaltungsoberfläche](/mailinglisten/sympa/verwaltung).
+
+## Hinzufügen und Entfernen von Adressen per E-Mail
+
+Um dich bei einer Liste anzumelden, kannst du eine E-Mail an diese Adresse schicken:
+```Plain
+LISTENNAME-subscribe@wat.systemausfall.org
+```
+*LISTENNAME* musst du natürlich durch den Namen deiner Liste ersetzen. Du wirst anschließend eine Bestätigungsmail mit weiteren Anweisungen erhalten.
+
+Das Abbestellen einer Liste per E-Mail muss durch den Listen-Admin in der Verwaltungoberfläche aktiviert werden. Ist das erfolgt, sende eine E-Mail an: 
+```Plain
+LISTENNAME-unsubscribe@wat.systemausfall.org
+```
+
+## Stille Abos
+Du kannst eine E-Mail-Adresse zum Einsenden an die Mailingliste berechtigen, ohne dass die Listennachrichten selbst an diese E-Mail-Adresse zugestellt werden. Dies kann z.B. dann sinnvoll sein, wenn du externen Personen (oder einem Newsletter) die Möglichkeit geben willst, an alle Listenmitglieder zu senden.
+
+Füge dazu die Absenderadresse als Abonnentin zur Liste hinzu. Suche anschließend diese Adresse aus der Liste der Abonnentinnen heraus und klicke sie an. Du kannst nun unter *Empfang:* die Einstellung *Keine Mails* auswählen:
+
+{{< img name="abo-1" size="small" >}}

content/mailinglisten/sympa/antwortadresse/_index.md

@@ -0,0 +1,28 @@
+---
+title: "Antwortadresse"
+date: 2022-11-08T21:49:12+01:00
+resources:
+  - name: adresse-1
+    src: "sympa_antwortadresse01.png"
+    title: Listenhautpseite
+  - name: adresse-2
+    src: "sympa_antwortadresse02.png"
+    title: Festlegen der Antwortadresse
+---
+
+Du kannst für deine Mailingliste festlegen, an wen die Antwort auf eine Listennachricht gehen soll. Die Einstellungen kannst du in der [Verwaltungsoberfläche](/mailinglisten/sympa/verwaltung) auf der Listenhauptseite unter *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* vornehmen:
+
+{{< img name="adresse-1" size="small" >}}
+
+Dort findest du die Einstellungen zur *Antwortadresse (reply_to_header)*:
+
+{{< img name="adresse-2" size="small" >}}
+
+Folgende Möglichkeiten stehen dir zur Verfügung:
+
+| Option | Beschreibung |
+|--------|--------------|
+| Absender (sender) | Antworten gehen nur an die Absender:in |
+| Liste (list) | Antworten gehen an die Listenadresse |
+| alle (all) | Antworten gehen an die Listenadresse und zusätzlich an die Absender:in |
+| andere E-Mail-Adresse (other_email) | Antworten gehen an eine von dir festgelegte E-Mail-Adresse |

content/mailinglisten/sympa/domain.md

@@ -0,0 +1,88 @@
+---
+title: "Eigene Domain"
+date: 2022-11-07T16:41:58+01:00
+---
+
+Du kannst deine eigene Maildomain mit unserem Sympa-Mailinglistenserver verknüpfen. Dazu musst du im Wesentlichen bei deinem Domainanbieter einige DNS-Einträge anlegen. Den Rest erledigen wir. Auf dieser Seite findest du dazu alle notwendigen Angaben. Die Erläuterungen erfolgen am Beispiel der Maildomain `example.org`.
+
+{{< hint title="Hinweis" >}}
+Sofern du deine Domain bereits für E-Mail-Konten benutzt, benötigst du für die Mailinglisten eine neue Subdomain. Es ist nicht möglich, dass du für die E-Mail-Konten und Mailinglisten die selbe Domain verwendest. Oft verwendete Subdomains für Mailinglisten sind `lists.example.org`, `listen.example.org` oder auch `ml.example.org`.
+{{< /hint >}}
+
+{{< toc >}}
+
+## Nutzungsvereinbarungen
+
+{{< include file="/static/_includes/tos.md.part" >}}
+
+## Kostenbeteiligung
+
+{{< include file="/static/_includes/spendenhinweis.md.part" >}}
+
+{{< rawhtml >}}
+{{< include file="/static/_includes/twingle.md.part" >}}
+{{< /rawhtml >}}
+
+## Domainregistrierung
+
+{{< include file="/static/_includes/domainanbieter.md.part" >}}
+
+## DNS-Einstellungen
+Die DNS-Einstellungen kannst du in der Weboberfläche deines Domainanbieters vornehmen. Es ist möglich, dass die Bezeichnungen dort von den hier verwendeten leicht abweichen. 
+
+### A-Eintrag
+
+Du kannst deine Mailinglisten bequem per Weboberfläche verwalten. Lege dazu einen so genannten A-Eintrag an:
+- Record-Type: A
+- Record-Name: example.org
+- Inhalt/Ziel: 51.75.71.249
+
+### MX-Eintrag
+
+Für die Subdomain deiner Wahl musst du einen MX_Resource_Record anlegen. Dieser gibt an, welcher Mailserver für deine Maildomain zuständig ist.
+
+Folgende MX-Einträge sind für deine Domain notwendig:
+```Plain
+NAME          INHALT                  Priorität  TTL
+example.org   mx1.systemausfall.org   20         86400
+example.org   mx2.systemausfall.org   80         86400
+```
+
+### SPF-Eintrag
+
+{{< include file="/static/_includes/spf.md.part" >}}
+
+### DKIM-Eintrag
+
+{{< include file="/static/_includes/dkim.md.part" >}}
+
+### DNS-Einstellungen überprüfen
+
+Ob deine Einstellungen korrekt gespeichert wurden, kannst du mit dem Linux-Programm `dig` testen.
+- Prüfen des MX-Eintrags:
+  ```Shell
+  dig MX example.org
+  ```
+- Prüfen des SPF-Eintrags:
+  ```Shell
+  dig TXT example.org
+  ```
+- Prüfen des DKIM-Eintrags:
+  ```Shell
+  dig TXT mail._domainkey.example.org
+  ```
+
+Bei frisch angelegten DNS-Einträgen kann es eine Weile dauern, bis du eine Antwort auf deine Abfrage erhältst. Im Abfrage-Ergebnis sollten deine Einträg korrekt angezeigt werden, bspw:
+```Plain
+;; ANSWER SECTION:
+example.org. 86400       IN      MX      20 mx2.systemausfall.org.
+```
+
+## Abschließende Einrichtung
+
+- Verwaltungsoberfläche: Du kannst deine Mailinglisten selbständig verwalten. Den Link zur Verwaltungsoberfläche senden wir dir per E-Mail zu.
+- Listmaster festlegen: Als Listmaster wird eine Person bezeichnet, die in der Verwaltungsoberfläche die vollen Rechte hat. Bitte teile uns eine oder mehrere E-Mailadressen mit, die wir als Listmaster festlegen sollen.
+- Berechtigungen zum Listenanlegen festlegen: Die Listensoftware erlaubt die Festelegung der Rechte zum Listenerstellen. Es gibt folgende Möglichkeiten:
+  - Listen dürfen beliebig angelegt werden
+  - Listen dürfen beliebig angelegt werden, müssen aber vom Listmaster aktiviert werden
+  - Listen dürfen nur von bestimmten Personen angelegt werden. Die Identifizierung kann anhand einzelner Mailadressen oder einer Maildomain erfolgen 

content/mailinglisten/sympa/faq.md

@@ -0,0 +1,19 @@
+---
+title: "FAQ"
+date: 2022-11-08T22:15:13+01:00
+---
+
+## Wie lässt sich ein ein Präfix zum Betreff jeder Listen-Mail hinzufügen?
+
+Über die Listen-Hauptseite --> *Listenkonfiguration* --> *Listenkonfiguration bearbeiten* --> *Einstellungen zum Senden/Empfangen*. Dort kannst du nun unter *Titelmarkierung (custom_subject)* den Präfix eintragen.
+
+## Wie kann ich das Archiv ein- oder ausschalten?
+
+Du kannst das Archiv deiner Liste selbständig ein- oder auszuschaten. Die Einstellungen findet du unter *Administration* --> *Listenkonfiguration bearbeiten* --> *Archive*.
+
+## Wie kann ich den Absender einer Listenmail verändern?
+
+Du kannst als privelegierter Listenbesitzer deine Mailingliste so einrichten, dass eine beliebige Adresse als Absenderadresse erscheint. So ist von außen nicht ersichtlich, wer die Nachricht eingeschickt hat. Die Einstellung findest du auf der Listen-Hauptseite unter *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* --> *Anonymer Absender*. Durch das Setzen dieser Option werden folgende Kopfzeilen aus jeder Listennachricht entfernt:
+```Plain
+Received:, Reply-To:, Sender:, X-Sender:, Message-id:, Resent-From:
+```

content/mailinglisten/sympa/kopfzeilen/_index.md

@@ -0,0 +1,26 @@
+---
+title: "Kopf- und Fußzeilen"
+date: 2022-11-06T17:10:15+01:00
+resources:
+  - name: kopfzeile-1
+    src: "sympa_vorlagen01.png"
+    title: Fußzeile erstellen
+---
+
+Jede Nachricht kann mit einer festegelten Kopf- und Fußzeile versehen werden. Bspw. enthalten viele Listen Hinweise auf das selbständige Abbestellen einer Liste in der Fußzeile. Die Einstellungen kannst du unter *Administration* --> dann im Menü *Listenkonfiguration bearbeiten* --> *Nachrichtenvorlagen* vornehmen.
+
+{{< img name="kopfzeile-1" size="small" >}}
+
+## Fußzeile mit Abbestellen-Link
+
+Du kannst die Fußzeile so gestalten, dass sie einen Link zur Abbestellung der Liste enthält:
+- Aktiviere die Nachrichtenpersonalisierung. Durch die Aktivierung der Personalisierung behandelt der Mailinglisten-Manager die Textbereich eingehender Nachrichten als Template. Dadurch können Variablen genutzt werden, die dann automatisch ersetzt werden. Die Aktivierung erfolgt über: *Listen-Hauptseite* --> *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* --> *Nachrichtenpersonalisierung zulassen*".
+- Erstelle eine Fußzeile (siehe oben).
+- Füge folgenden Text ein:
+  ```Plain
+  Zum Abbestellung dieser Liste hier klicken:
+  [% wwsympa_url %][% 'auto_signoff' | url_abs([listname],{email=>user.email}) %]
+  ```
+- Während du die erste Zeile anpassen kannst, muss die zweite Zeile unverändert bleiben.
+ 
+Weitere Informationen zur Nachrichtenpersonalisierung und den möglichen Template-Variablen findest du [hier](https://www.sympa.community/manual/customize/message-personalization.html).

content/mailinglisten/sympa/neue_admins/_index.md

@@ -0,0 +1,18 @@
+---
+title: "Neue Admins hinzufügen"
+date: 2022-11-06T16:59:28+01:00
+resources:
+  - name: admin-1
+    src: "sympa_admin01.png"
+    title: Neue Besitzerin zur Liste hinzufügen 
+---
+
+Die Mailingliste unterscheidet verschiedene Rollen:
+- Abonnenten: Können E-Mails an der Liste schicken und/oder von ihr empfangen.
+- Moderatoren (editor): Sofern die Liste so konfiguriert ist, begutachten sie eingesandte Nachrichten, bevor sie an die Liste weitergeleitet werden-
+- Besitzer (owner): Auch Eigentümer genannt. Kann alle Einstellungen an der Liste vornehmen.
+
+## Weitere Besitzer und Moderatoren hinzufügen
+Du kannst beliebig viele Besitzer und Moderatoren zu deiner Liste hinzufügen. Klicke dazu rechts im Menü auf *Administration*. Anschließend findest du in der roten Menüleiste unter *Benutzer* die entsprechenden Funtkionen:
+
+{{< img name="admin-1" size="small" >}}

content/mailinglisten/sympa/neue_liste.md

@@ -0,0 +1,17 @@
+---
+title: "Neue Liste anlegen"
+date: 2022-11-06T16:55:20+01:00
+---
+Neue Listen können über die [Verwaltungsoberfläche](https://wat.systemausfall.org) angelegt werden. Nach der Anmeldung findest du oben rechts oben im Menü den Punkt *Liste beantragen* über den du zum entsprechenden Formular gelangst. Wichtig ist, dass du alle Felder ausfüllst:
+
+| Option | Bedeutung |
+|--------|-----------|
+| Listenname | Ein beliebiger Name für deine Liste. Der Listenname ist Teil der Listenadresse nach dem Muster: `LISTENNAME@wat.systemausfall.org`. Trage hier nur den Listennamen ein (ohne @wat.systemausfall.org). |
+| Listentyp | Entsprechend deiner Auswahl wird die Liste eingerichtet, damit du nicht alle Einstellungen manuell vornehmen musst. Du kannst deine Liste anschließend individuell anpassen. |
+| Titel | Eine Beschreibung, die unter deiner Listen in der Listenübersicht angezeigt wird. |
+| Zielgruppe | Damit lassen sich Listen nach Themen gruppieren - das ist für dich praktisch, wenn du viele Listen verwaltest. |
+| Beschreibung | Trage eine aussagekräftige Beschreibung der Liste, damit für uns ersichtlich ist, dass die Liste unseren Nutzungsvereinbarungen entspricht. |
+
+{{< hint title="Hinweis" >}}
+Sofern du dich mit deinem systemausfall.org-Konto angemeldet hast, ist deine neue Liste sofort aktiv. Alle anderen Listen werden wir nach Prüfung aktivieren.
+{{< /hint >}}

content/mailinglisten/sympa/verwaltung.md

@@ -0,0 +1,11 @@
+---
+title: "Verwaltung"
+date: 2022-11-06T16:55:26+01:00
+---
+
+Die Verwaltung deiner Liste geht am einfachsten über unsere [Weboberfläche](https://wat.systemausfall.org). Mit deinem systemausfall.org-Konto kannst du dich dort automatisch anmelden. Listen-Verwalter:innen ohne systemausfall.org-Konto können sich selbständig ein Verwaltungskonto [einrichten](https://wat.systemausfall.org/firstpasswd).
+
+| Option | Beschreibung |
+|--------|--------------|
+| Verwaltungsoberfläche | [wat.systemausfall.org](https://wat.systemausfall.org ) |
+| Registrierung | [wat.systemausfall.org/firstpasswd](https://wat.systemausfall.org/firstpasswd) |