iFSR Website – TU Dresden

Dies ist die offizielle Website des iFSR (Informatik-Fachschaftsrat) der Technischen Universität Dresden. Die Seite wurde mit dem statischen Website-Generator Hugo erstellt und dient als zentrale Informationsplattform für Studierende der Fakultät Informatik.

🔧 Technologien

• Framework: Hugo – statischer Site-Generator
• CSS-Framework: Bootstrap – responsives Frontend-Toolkit

🚀 Schnellstart

Hugo installieren

# macOS / Linux (mit Homebrew)
brew install hugo

# Windows (mit Chocolatey)
choco install hugo -y

Weitere Informationen findest du hier.

Projekt klonen und lokal starten

git clone git@github.com:jannikmenzel/iFSR-Website.git
cd iFSR-Website

# Alias für die lokale Entwicklungsumgebung
alias hugodev='hugo server --disableFastRender --ignoreCache --noHTTPCache --cleanDestinationDir'

hugodev

Anschließend kannst du die Website im Browser unter http://localhost:1313 aufrufen.

📁 Projektstruktur

• content/ – Inhalte der Website (Seiten im Markdown Format)
• layouts/ – Individuelle Layouts und Templates
• static/ – Statische Dateien (z.B. Bilder, PDFs)
• assets/ – CSS, JavaScript Dateien und Images
• data/ – Navigation Config-Datei
• hugo.toml – Hauptkonfigurationsdatei für Hugo

📝 CMS

Diese Website nutzt Decap CMS als Content Management System. Damit können berechtigte Nutzer:innen Inhalte direkt über eine grafische Oberfläche im Browser bearbeiten – ganz ohne lokalen Zugriff oder technisches Vorwissen.

Zugang zum CMS

Das CMS ist unter /admin erreichbar: https://ifsr.de/admin. Die Anmeldung erfolgt über den Forgejo Account.

Erste Schritte zur Bearbeitung

1. Rufe /admin im Browser auf.
2. Melde dich mit deinem Benutzerkonto an.
3. Wähle in der linken Navigation die gewünschte Inhaltskategorie (z.B. "Über Uns").
4. Klicke auf den Eintrag, den du bearbeiten möchtest.
5. Nimm Änderungen im Editor vor und speichere sie mit "Save" und anschließend "Publish".

Hinweise

• Änderungen werden direkt im content/ Verzeichnis gespeichert (als Markdown-Dateien im Git-Repository).
• Das CMS spiegelt die Navigation basierend auf den vorhandenen Inhalten und Konfigurationen wider.
• Für neue Inhaltstypen müssen ggf. Anpassungen an der Datei static/admin/config.yml vorgenommen werden.

💡 Entwicklungs-Hinweise

Neue Seite anlegen (inkl. Navbar)

1. Erstelle eine neue Markdown-Datei im passenden Unterordner innerhalb von content/, z.B.:

   content/about/team.md
   

2. Füge in der Datei ein Front-Matter hinzu:

   ---
   title: "Title"
   draft: false
   url: /site/subsite/
   ---
   

3. Trage die Seite in der Navigationsstruktur ein, indem du sie in data/navigation.toml ergänzt:

   [[menu.main]]
   name = "Team"
   url = "/about/team"
   weight = 6
   

4. Bei Bedarf kannst du durch Verschachtelung Unterseiten eines Menüpunkts einordnen:

   [[menu.main]]
   parent = "Team"
   name = "Team Liste"
   url = "/team/teamlist"
   weight = 1
   

---

Seite bearbeiten (Content/Markdown)

1. Öffne die entsprechende .md-Datei im content/-Verzeichnis.
2. Bearbeite den Inhalt im Markdown-Format.
3. Änderungen werden beim Speichern durch hugodev automatisch neu geladen.

---

Shortcode Snippets

Du kannst Code Snippets in deine Markdown Files integrieren, um die Website interaktiver zu gestalten. Nachfolgend findest du hierfür eine Anleitung.

Details

{{< details
title="Headline"
number="01" >}}

{{ content }}

{{< /details >}}

Profile

{{< profile
name="Name"
image="/images/mitglieder/vorname-nachname.jpg"
studiengang="BA Informatik, 1. Semester"
email="vorname.nachname@ifsr.de" >}}

{{ content }}

{{< /profile >}}

📬 Kontakt

Bei Fragen oder Vorschlägen zur Website kontaktiere uns gerne:

• 📧 E-Mail: fsr@ifsr.de
• 🌐 Website: https://ifsr.de

Bei spezifischen Fragen zum Sourcecode kontaktiere:

• jannik.menzel@ifsr.de