Webseite des Netz39 e.V.
Find a file
2023-11-09 13:45:34 +01:00
.github Revert "Merge pull request #46 from netz39/hotfix_jekyll-build-action" 2023-10-27 13:45:31 +02:00
_data Merge pull request #57 from netz39/remove-wiki-link-in-footer 2023-11-01 12:26:06 +01:00
_events Move 2023 Events to subfolder 2023-11-06 13:08:40 +01:00
_includes Add a class to the space status image 2023-11-03 23:37:02 -05:00
_layouts Turn off showing share buttons 2023-11-01 13:10:01 +01:00
_portfolio Initial commit 2023-10-16 01:36:59 +02:00
_posts Add blogpost "Projekt: DDR-Taschenlampe - Von 4,5V auf 6V LED" 2023-11-05 20:17:12 +01:00
_sass Fix table view for bank account data 2023-11-07 12:43:19 -06:00
assets feat: add page ¨Spenden" from old website 2023-11-07 19:14:01 +01:00
blog Only show the three newest blog entries on landing page 2023-10-25 13:32:01 +02:00
pages fix: wiki redirect url 2023-11-08 18:49:50 +01:00
tools ✏️ Fix indentation 2023-11-09 13:45:34 +01:00
.gitattributes migrate img and pdf files to git lfs 2023-10-23 09:14:05 +02:00
.gitignore Initial commit 2023-10-16 01:36:59 +02:00
.gitpod.yml Initial commit 2023-10-16 01:36:59 +02:00
_config.yml Add board members to configuration 2023-11-06 18:13:44 -06:00
calendar-data.html Add built-in calender by using fullcalendar.io 2023-10-20 14:22:48 +02:00
CNAME Update CNAME 2023-10-18 21:25:26 +02:00
docker-compose.yml Add docker-compose 2023-10-16 03:36:36 +02:00
Gemfile Initial commit 2023-10-16 01:36:59 +02:00
index.html Initial commit 2023-10-16 01:36:59 +02:00
LICENSE Initial commit 2023-10-16 01:36:59 +02:00
README.md doc: add git-lfs info to reamde 2023-10-23 09:14:07 +02:00
type-on-strap.gemspec Pin jekyll to 4.2.2 to work with webrick 2023-10-16 03:36:21 +02:00

www.netz39.de

Warum Jekyll?

Unsere Webseite setzt aus folgenden Gründen auf Jekyll, einen statischen Website-Generator:

  • Einfache Handhabung: Jekyll ermöglicht es, Inhalte in Markdown zu schreiben, was die Erstellung und Aktualisierung von Webseiten vereinfacht.

  • Schnelle Ladezeiten: Da Jekyll statische Seiten generiert, werden die Webseiten schnell geladen.

  • GitHub Pages Integration: Jekyll wird von GitHub Pages unterstützt, was bedeutet, dass wir unsere Website direkt aus dem GitHub-Repository hosten können.

Neue Blogeinträge erstellen:

  1. Blogeintrag erstellen:

    • Erstelle eine neue Markdown-Datei im _posts-Verzeichnis unter das aktuelle Jahr. Benenne die Datei nach dem Format YYYY-MM-DD-titel-des-eintrags.md

    • Front Matter: Füge am Anfang der Datei das YAML-Front Matter hinzu. Das Front Matter enthält Metadaten für den Blogeintrag, wie z.B. den Layout-Typ, den Titel, den Autor und das Veröffentlichungsdatum. Hier ein Beispiel für das Front Matter:

      ---
      layout: post
      title: "Titel des Blogeintrags"
      author: MaxMustermann
      date: 2023-10-20
      feature-img: "assets/img/feature-img.jpg" # optional
      thumbnail: "assets/img/thumbnail-img.jpg" # optional
      ---
      
    • Schreibe den Inhalt deines Blogeintrags im Markdown-Format unterhalb des Front Matter.

    • Bilder eines Blogeintrags werden unter /assets/img/post-imgin das jeweilige Jahr abgelegt.

  2. Pull Request erstellen:

    • Erstelle einen neuen Branch, füge die Markdown-Datei hinzu und committe/pushe sie.
    • Erstelle einen Pull Request von deinem Branch zum Hauptbranch im GitHub-Repository.
    • Teammitglieder können deine Änderungen überprüfen und den Pull Request akzeptieren.

Neue Events erstellen:

  • Analog zu "Blogeintrag erstellen" wird im _events-Verzeichnis eine Markdown-Datei erstellt.
  • Das Front Matter sollte wie folgt aussehen:
    ---
    layout: event
    title: "Titel des Events"
    author: MaxMustermann # optional, soll gemacht werden, wenn du der Ansprechpartner des Events bist
    event_date: 2023-10-20 # Datum, an dem das Event stattfindet
    ---
    
  • Unterhalb des Front Matters die Beschreibung des Events in Markdown aufschreiben

Installation und lokale Entwicklung mit Docker:

  1. Docker und Docker Compose auf deinem System installieren

  2. Docker Container im root-Verzeichnis starten:

    docker-compose up
    

    Der Jekyll-Buildserver wird nun in einem Docker-Container gestartet und ist unter http://localhost:4000 verfügbar. Du kannst Änderungen vornehmen, und sie werden automatisch in Echtzeit aktualisiert.

  3. Nach der Entwicklung den Container mit docker-compose down beenden.

git-lfs

Dieses Repository nutzt zur Verwaltung von großen Binärdaten (Bilder und PDFs) git-lfs. Zur Installation folge bitte der Installationsanleitung für dein Betriebssystem.

Die Arbeit mit den Dateien ändert sich durch die Verwendung von git-lfs nicht.

License

© Netz39 e.V