diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml new file mode 100644 index 0000000..68bd8e1 --- /dev/null +++ b/.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 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..46e8bab --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +.cache/ +site/ diff --git a/docs/assets/fa-share-favicon.svg b/docs/assets/fa-share-favicon.svg new file mode 100644 index 0000000..bae0c81 --- /dev/null +++ b/docs/assets/fa-share-favicon.svg @@ -0,0 +1,38 @@ + + + + + + + diff --git a/docs/assets/logo/ff-500px.png b/docs/assets/logo/ff-500px.png new file mode 100644 index 0000000..7cb9993 Binary files /dev/null and b/docs/assets/logo/ff-500px.png differ diff --git a/docs/assets/logo/ff-large.png b/docs/assets/logo/ff-large.png new file mode 100644 index 0000000..aaa9d3f Binary files /dev/null and b/docs/assets/logo/ff-large.png differ diff --git a/docs/impressum.md b/docs/impressum.md new file mode 100644 index 0000000..21a1f5d --- /dev/null +++ b/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 +
+ Chaos Computer Club Darmstadt e.V.
+ Wilhelminenstraße 17
+ 64283 Darmstadt +
+ +## Bankverbindung +Unsere Bankverbindung findest du auf der [Spendenseite](spenden). diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..ffe85ef --- /dev/null +++ b/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. + + + +### 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 bei. Wir haben darüber hinaus auch einen Issue-Tracker auf , +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 Seite vorbei. \ No newline at end of file diff --git a/docs/mitmachen/index.md b/docs/mitmachen/index.md new file mode 100644 index 0000000..16d2cd9 --- /dev/null +++ b/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. + + + + + +!!! 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 keys@darmstadt.freifunk.net. Wir schalten deinen Knoten dann so schnell +wie möglich frei. diff --git a/docs/mitmachen/kaufberatung.md b/docs/mitmachen/kaufberatung.md new file mode 100644 index 0000000..7193a21 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/docs/projekte.md b/docs/projekte.md new file mode 100644 index 0000000..d30af4c --- /dev/null +++ b/docs/projekte.md @@ -0,0 +1,2 @@ +# Projekte + diff --git a/docs/spenden.md b/docs/spenden.md new file mode 100644 index 0000000..971c1e9 --- /dev/null +++ b/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: + +
+ CCC Darmstadt e.V.
+ IBAN: DE96 5085 0150 0000 7118 53
+ BIC: HELADEF1DAS
+ Stadt- und Kreis-Sparkasse Darmstadt +
+ +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. + diff --git a/docs/technik.md b/docs/technik.md new file mode 100644 index 0000000..e69de29 diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..f68ff36 --- /dev/null +++ b/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 \ No newline at end of file