- Nix 72.2%
- HTML 23.6%
- Shell 4.2%
| archetypes | ||
| content | ||
| layouts/partials | ||
| static/assets | ||
| themes | ||
| .envrc | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .gitmodules | ||
| .hugo_build.lock | ||
| flake.lock | ||
| flake.nix | ||
| hugo.yaml | ||
| pkg.nix | ||
| README.md | ||
| renovate.json | ||
| serve | ||
Die Fachschafts website
CICD:
- Artefakte herunterladen
- Zip entpacken (runner Artefakte)
- zip entpacken (website.zip)
- in entpacktem ordner:
python3 -m http.server - angezeigten Link öffnen
Developing
git pullgit submodule upate --initnix flake develop/direnv allow .hugo serverstarten (watched auf changes)
Kurz zur Struktur
Generelle information (z.B. FS-Bild) sollte kontinuierlich ge-updated werden und braucht nicht in Semester unterteilt zu werden.
Events z.B. sollten mit Semester unterteilt werden (siehe existierende Struktur).
Wie füge ich eine Seite hinzu?
Genereller syntax ist
hugo new --kind <archetype> <pfad>
Gerade existier nur ein archetype, der sich "post" nennt. Der Pfad wird dann unter dem content/ ordner erstellt.
z.B. hugo new --kind post impressum.md kopiert die datei "archetypes/post.md" nach "content/impressum.md".
Dann kann man content/impressum.md editieren.
Wie schalte ich die Seite live?
Auf den FS-Server ssh'n und den nix flake input "website" updaten.
nix flake update website.
Dann rebuild & switch.
Deutsch und Englisch Versionen
Die Deutsche und Englische Versionen / Variationen von einem Post werden mit <name>.en.md (englisch) und <name>.md (deutsch) erstellt
Pitfalls:
- immer STRG+SHIFT+R zum reloaden verwenden sonst werden links evtl nicht geupdated
Nicht vergessen:
git config user.name xyz12345
git config user.email vorname.nachname@st.oth-regensburg.de