initial commit

.github/workflows/build.yaml

@@ -0,0 +1,19 @@
+name: Build Homepage
+on: [ push, pull_request]
+jobs:
+  build-homepage:
+    name: build-homepage
+    runs-on: ubuntu-24.04
+    container:
+      image: ghcr.io/squidfunk/mkdocs-material:9.5.18
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Build with MkDocs
+        run: |
+          mkdocs build
+      - name: Save rendered homepage
+        uses: actions/upload-artifact@v4
+        with:
+          path: site
+          name: website

.gitignore

@@ -0,0 +1,2 @@
+.cache/
+site/

docs/impressum.md

@@ -0,0 +1,16 @@
+# Impressum
+
+Freifunk Darmstadt ist ein Projekt des [Chaos Computer Club Darmstadt e.V.](https://www.chaos-darmstadt.de),
+der im Vereinsregister des Amtsgerichts Darmstadt unter der Vereinregisternummer 3413 eingetragen ist.
+
+Der Verein ist gemeinnützig und finanziert sich über Mitgliedsbeiträge und [Spenden](spenden).
+
+## Postanschrift
+<blockquote>
+    Chaos Computer Club Darmstadt e.V.<br/>
+    Wilhelminenstraße 17<br/>
+    64283 Darmstadt
+</blockquote>
+
+## Bankverbindung
+Unsere Bankverbindung findest du auf der [Spendenseite](spenden).

docs/index.md

@@ -0,0 +1,32 @@
+# Willkommen
+
+Willkommen auf der Webseite von Freifunk Darmstadt.
+
+## News
+
+Wir posten News regelmäßig auf unserem Mastodon Account. Folge uns dort, um auf dem Laufenden zu bleiben.
+
+[chaos.social/@ffda](https://chaos.social/@ffda)
+
+## Über uns
+
+### Wer seid ihr?
+
+Freifunk Darmstadt ist Teil der Freifunk-Bewegung welche sich Deutschlandweit für die verbreitung von freien Netzwerken einsetzt.
+Freie Netzwerke sind Netzwerke, welche Gemeinschaftlich von Individualpersonen betrieben werden. Diese Netzwerke sind offen für alle
+und bieten oftmals freien Zugang zum Internet.
+
+Dies betrifft nicht nur den Netzbetrieb, sondern auch die Software die wir verwenden. Wir verwenden überall wo es möglich ist freie Software
+und entwickeln diese weiter. Diese Software ist für jeden frei verfügbar und kann nach belieben angepasst werden.
+
+<Example icons with Links>
+
+### Ich will mitmachen!
+
+Wir freuen uns über jede Unterstützung. Da unser Einzugsgebiet sehr groß ist koordinieren wir uns viel über das Internet.
+
+Wenn du mit anpacken willst, trete gerne unserem <Chat> bei. Wir haben darüber hinaus auch einen Issue-Tracker auf <Github>,
+wo wir nicht nur unsere Softwareprojekte verwalten, sondern auch nicht-technische Aufgaben verwalten.
+
+Bei uns sind alle Menschen willkommen, die sich für freie Netzwerke interessieren. Egal wo du herkommst, wie alt du bist oder welche
+Fähigkeiten du hast. Wir freuen uns über jede Unterstützung! Schau am besten auf unserer <Mitmachen> Seite vorbei.

docs/mitmachen/index.md

@@ -0,0 +1,106 @@
+# Mitmachen
+
+Klasse, dass du bei uns Mitmischen möchtest! Wir haben hier für dich den typischen Weg zusammengefasst, über den
+viele unserer aktiven Community-Mitglieder zu uns gefunden haben.
+
+## Freifunk-Knoten aufstellen
+### Einen Freifunk-Knoten bekommen
+
+Das Freifunk-Netz ist ein Mesh-Netzwerk, das von vielen einzelnen Knoten gebildet wird. Als Knoten bezeichnen wir das
+Gerät, über welches du ins Freifunk-Netz mit deinem Laptop, Tablet oder Smartphone einsteigst.
+
+!!! note "Freifunk-Knoten"
+    Freifunk-Knoten werden oft auch "Freifunk-Router" genannt.
+
+Ein solcher Freifunk-Knoten ist oft ein Handelsüblicher WLAN-Router oder Access-Point, der mit unserer speziellen
+Firmware bespielt wird. Unsere Firmware basiert wie die vieler anderer Freifunk-Communities auf
+[Gluon](https://www.github.com/freifunk-gluon/gluon).
+
+Wir unterstützen viele verschiedene Geräte, welche du auf unserer Firmware-Seite findest.
+
+Solltest du noch kein kompatibles Gerät besitzen, so haben wir dir auf unserer Webseite auch einen Empfehlungs-Guide
+zusammengestellt.
+
+!!! tip "Gebrauchtgeräte"
+    Wenn du einen neuen Knoten im Netz von Freifunk Darmstadt betreiben möchtest, so kannst du auch in unserem
+    Chat nachfragen, ob jemand vielleicht ein Gerät für dich übrig hat. Oft ziehen Freifunker zum Beispiel zum Ende
+    eines Studiums um und haben dann keine Verwendung mehr für ihren Knoten, den sie dir gerne umsonst oder für wenig
+    Geld überlassen.
+
+### Firmware installieren
+
+!!! warning "Garantie"
+    Die Installation der Firmware auf deinem Gerät kann dazu führen, dass die Garantie des Herstellers erlischt.
+
+    Wir übernehmen zwar keine Haftung für Schäden, die durch die Installation unserer Firmware entstehen, aber wir
+    helfen dir gerne dabei, deinen Knoten wieder zum Laufen zu bringen, falls etwas schiefgeht.
+
+    Der Prozess ist allerdings in der Regel sehr sicher und einfach, sodass du dir keine Sorgen machen musst.
+
+Hast du einen passenden Router gefunden? Nun musst du diesen mit unserer Firmware bespielen. Da unsere Firmware
+Herstellerunabhängig ist, gibt es keine allgemeingültige Anleitung.
+
+1. Solltest du ein Gerät aus unserer Empfehlungsliste gewählt haben, so findest du dort einen direkten Link zur
+Anleitung
+
+2. Bei vielen Geräten ist auf unserer Firmware-Seite eine Anleitung verlinkt, die dir Schritt
+für Schritt erklärt, wie du die Firmware auf deinem Gerät installierst.
+
+<Bild>
+
+
+
+!!! question "Hilfe benötigt?"
+    Solltest du Hilfe benötigen, so kannst du dich gerne in unserem Chat melden.
+
+    Falls du zur Installation ein spezielles Kabel benötigst können wir dir dieses oft auch gerne ausleihen.
+
+
+### Knoten konfigurieren
+
+Nach der Installation der Firmware musst du deinen Knoten noch konfigurieren. Hierbei unterstützt dich unser
+Konfigurationsmodus, welcher bei der ersten Inbetriebnahme automatisch startet.
+
+!!! tip "Konfigurationsmodus"
+    Ein Freifunk-Knoten hat zwei Betriebsmodi: Den Konfigurationsmodus und den Betriebsmodus. Im Konfigurationsmodus
+    kannst du die Einstellungen deines Knotens ändern, im Betriebsmodus ist dein Knoten Teil des Freifunk-Netzes.
+
+    Du erkennst den Konfigurationsmodus daran, dass das Freifunk-Netzwerk in deiner WLAN-Liste fehlt. Bei den
+    meisten Geräten blinkt die Status-LED im Konfigurationsmodus gleichmäßig und langsam.
+
+Die folgenden Optionen sind für die meisten Knotenbetreiber die wichtigsten:
+
+- **Knotenname**: Der Name deines Knotens, der im Freifunk-Netz sichtbar ist. Dieser erscheint auch auf der
+    Knotenkarte.
+
+- **Mesh-VPN**: Hier kannst du einstellen, ob dein Knoten das Freifunk-Netz über das Internet erreichen soll. Dies ist
+    in der Regel sinnvoll, da dein Knoten so auch anderen Knoten im Freifunk-Netz als Internetzugang dient. Die Daten
+    werden hierbei niemals direkt über deinen Internetanschluss übertragen, sondern über unsere Server.
+
+    Ebenfalls kannst du ein Limit für die Bandbreite festlegen, welcher dein Knoten maximal verwenden darf.
+
+- **Standort**: Dein Standort, den du auf der Knotenkarte angezeigt haben möchtest. Dies ist wichtig, damit andere
+    Nutzer deinen Knoten finden können. Du kannst dich aber auch entscheiden, deinen Standort nicht zu teilen.
+
+- **Kontakt**: Deine Kontaktmöglichkeiten, die auf der Knotenkarte angezeigt werden. Diese sind optional, aber
+    empfohlen, falls es Probleme mit deinem Knoten gibt.
+
+Zusätzlich gibt es in den erweiterten Einstellungen noch weitere Optionen, die für fortgeschrittene Nutzer interessant
+sind.
+
+- **SSH-Key**: Solltest du dich mit der Materie auskennen, so kannst du hier deinen SSH-Key hinterlegen, um deinen
+    Knoten später einfacher zu verwalten.
+
+Wenn du alles eingestellt hast kannst du am Ende der Seite die Einstellungen speichern und deinen Knoten neu starten.
+
+### VPN-Key freischalten
+
+Nachdem du deinen Knoten konfiguriert hast, musst du noch deinen VPN-Key freischalten. Dieser wird benötigt, damit
+unsere Server deinen Knoten als Teil des Freifunk-Netzes erkennen.
+
+!!! tip "VPN-Key"
+    Den VPN-Key musst du nur einmal freischalten. Solltest du deinen Knoten später erneut in den Konfigurationsmodus
+    versetzen, so musst du den VPN-Key nicht erneut freischalten.
+
+Hierfür sendest du uns diesen Key per E-Mail an [email protected]. Wir schalten deinen Knoten dann so schnell
+wie möglich frei.

docs/mitmachen/kaufberatung.md

@@ -0,0 +1,49 @@
+# Kaufberatung
+
+Hier haben wir unsere Empfehlungen für Freifunk-Hardware zusammengestellt. Alle diese Geräte sind mit unserer Firmware kompatibel und können in unserem Netz betrieben werden.
+
+Ebenso verfügen sie unabhängig von der WLAN-Generation über **Dualband-WLAN** auf 2.4 und 5 GHz.
+
+Wir haben die Geräte nach Anwndungsfall in drei Kategorien
+unterteilt:
+
+ - **Empfohlen** Diese Geräte, haben wir selbst getestet und sind in der Praxis bewährt. Sie unterstützen aktuelle WLAN-Standards und sind neu im Handel erhältlich.
+
+ - **Günstig** Diese Geräte sind oft günstig auf dem Gebrauchtmarkt erhältlich. Sie unterstützen nur ältere WLAN-Standards und sind daher etwas langsamer und unterstützen weniger gleichzeitig verbundene Nutzer.
+
+ - **Experimentell** Diese Geräte sind bisher nicht in unserem stabilen Firmware-Release enthalten. Sie sind allerdings entweder attraktiv bepreist oder bieten besondere Features.
+
+
+Diese Klassen sind untereinander nach Installationsart gruppiert
+
+ - **Webinterface** Diese Geräte können über ein Webinterface geflasht werden. Das ist besonders einfach und für Einsteiger geeignet.
+
+ - **TFTP** Diese Geräte müssen über (T)FTP geflasht werden. Das ist etwas komplizierter, es existieren aber gute Anleitungen.
+
+ - **Serielles Kabel** Diese Geräte müssen über ein serielles Kabel geflasht werden. Das ist die komplizierteste Methode und benötigt spezielle Hardware.
+
+## Empfohlen
+
+=== "Webinterface"
+
+    | Gerät | Bauform |CPU | RAM / Flash | Preis | 
+    |-------|---------|----|-------------|-------|
+    | ZyXEL NWA50AX | Deckenmontage | 2x 880MHz MIPS  | 128MB / 32MB | 70 € |
+
+
+## Günstig
+
+=== "Webinterface"
+
+    | Gerät | WLAN | CPU | RAM | Flash | Preis | 
+    |-------|------|-----|-----|-------|-------|
+    | TP-Link Archer C7 | 720 MHz | 16 | 16 MB | [Anleitung](https://wiki.freifunk.net/TP-Link_Archer_C7) | 70 € |
+
+=== "TFTP"
+
+
+=== "Serielles Kabel"
+
+    1. Sed sagittis eleifend rutrum
+    2. Donec vitae suscipit est
+    3. Nulla tempor lobortis orci

docs/projekte.md

@@ -0,0 +1,2 @@
+# Projekte
+

docs/spenden.md

@@ -0,0 +1,32 @@
+# Spenden
+
+Freifunk Darmstadt ist ein Projekt des gemeinnützigen [Chaos Computer Club Darmstadt e.V.](https://www.chaos-darmstadt.de).
+
+Wir setzen uns ehrenamtlich für ein stadtübergreifendes WLAN-Netzwerk ein und unterstützen interessierte Personen gerne
+mit unseren bisherigen Erfahrungen, die wir dabei gesammelt haben.
+
+Unsere Freifunknetz wächst dank der intensiven Unterstützung durch freiwillige Knotenbetreiber seit Jahren.
+Dies erfolgt ausschließlich auf Basis freiwilliger Unterstützung vieler Menschen.
+
+## Überweisung für den Betrieb an Chaos Computer Club Darmstadt e.V.
+Solltest Du Dich auch finanziell regelmäßigen oder einmaligen Spende zu unterstützenmöchtest, freuen wir uns über
+eine Spende an den Chaos Computer Club Darmstadt e.V., mit dem Betreff Freifunk.
+
+Am einfachsten kannst Du uns Deine Spende direkt per Dauerauftrag oder Überweisung an das nachfolgende Bankkonto vornehmen:
+
+<blockquote>
+  CCC Darmstadt e.V.<br/>
+  IBAN: DE96 5085 0150 0000 7118 53<br/>
+  BIC: HELADEF1DAS<br/>
+  Stadt- und Kreis-Sparkasse Darmstadt
+</blockquote>
+
+Spenden sollten im Verwendungszweck den Hinweis enthalten, dass es sich um eine Spende für Freifunk handelt.
+
+Freifunk Darmstadt ist und bleibt kostenfrei und agiert ausschließlich auf Basis der freiwilligen Unterstützung. Durch die Nutzung entsteht für niemanden eine Zahlungsverpflichtung.
+
+Solltet Ihr eine Spendenquittung benötigen, sprecht uns bitte direkt an.
+
+!!! success "Vielen Dank deine Unterstützung!"
+    Jeder Beitrag hilft uns, die Infrastruktur zu verbessern und die Idee von Freifunk weiter zu verbreiten.
+

mkdocs.yml

@@ -0,0 +1,58 @@
+site_name: Freifunk Darmstadt
+repo_url: https://github.com/freifunk-darmstadt/website-ng
+theme:
+  name: material
+  language: de
+  logo: assets/logo/ff-500px.png
+  favicon: assets/fa-share-favicon.svg
+  icon:
+    repo: fontawesome/brands/github
+  features:
+    - search.highlight
+    - search.share
+  palette:
+    # Palette toggle for light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Palette toggle for dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+nav:
+  - Home: index.md
+  - Mitmachen: 
+    - Einstieg: mitmachen/index.md
+    - Kaufberatung: mitmachen/kaufberatung.md
+  - Projekte: projekte.md
+  - Technik: technik.md
+  - Spenden: spenden.md
+  - Impressum: impressum.md
+plugins:
+  - search
+  - privacy
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://www.github.com/freifunk-darmstadt
+      name: GitHub Orgainsation
+    - icon: fontawesome/brands/gitlab
+      link: https://git.darmstadt.ccc.de/ffda
+      name: GitLab Orgainsation
+    - icon: fontawesome/brands/mastodon
+      link: https://chaos.social/@ffda
+      name: Mastodon Feed
+markdown_extensions:
+  - attr_list
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true