Öffentliche Webseite der WTF Kooperative eG https://wtf-eg.de/
Go to file
zeitschlag 3451bc36d3
All checks were successful
continuous-integration/drone/pr Build is passing
Fix translation
Mascha asked us to get rid of it.

https://pocolit.com/en/2021/04/09/race-%E2%89%A0-rasse-10-terms-related-to-race-that-require-sensitivity-in-translation/
2023-02-20 17:39:24 +01:00
assets Typo. 2023-01-11 21:41:35 +01:00
content Fix translation 2023-02-20 17:39:24 +01:00
databags Add bbb channel link 2021-06-10 00:16:13 +02:00
flowblocks Change template and add image (thanks frlan 2021-04-06 21:55:31 +02:00
models feat: WIP Kontaktformular hinzugefügt. (#105) 2022-08-03 17:55:25 +02:00
templates Neutrale Formulierung statt zu duzen. 2023-01-11 21:38:23 +01:00
.drone.yml feat: Added branch spielwiese to drone trigger branches. 2022-10-25 16:07:37 +02:00
.gitattributes Add Podcast Data 2021-03-31 20:47:44 +02:00
.gitignore chore: Updated .gitignore. 2022-08-03 17:56:54 +02:00
LICENCE feat: Jahreszahlen auf 2023 geändert. 2023-01-10 22:08:11 +01:00
README.md #160 doc: adjust build steps to build und run website on my local Debian Gnu/Linux host 2022-12-02 10:07:49 +01:00
requirements.txt #160 doc: adjust build steps to build und run website on my local Debian Gnu/Linux host 2022-12-02 10:07:49 +01:00
wtf-eg.lektorproject feat: Added dev server to project file. 2022-08-03 17:55:25 +02:00

Build Status

Öffentliche Seite der WTF Kooperative eG

Öffentliche Website der Genossenschaft auf Basis des Static-Site-Generators Lektor.

WTF Logo

Das Git Repository zur Webseite ist auf git.wtf-eg.de/ag_kommunikation/webseite.

Lokales entwickeln

Vorbereitung

Installation von Lektor, siehe offizielle Doku.

# install git requirements
sudo apt install git-lfs

# install lektor requirements
sudo apt install python3-pip imagemagick

# clone git repo to folder wtf-webseite
git clone https://git.wtf-eg.de/ag_kommunikation/webseite.git wtf-webseite

# change to repo
cd wtf-webseite

# install lfs
git lfs install

# download all LFS files
git lfs fetch

# create a virtual Python environmenty `venv`
python3 -m venv venv

# activate the virtual Python environment
source venv/bin/activate

# install the packages listed in [requirements.txt](./requirements.txt) using `pip`
pip install -r requirements.txt

# run lektor
lektor server

Server starten

Der Server kann nun per lektor server gestartet werden und sollte unter http://127.0.0.1:5000/ erreichbar sein.

Git Magie

Bevor du die Änderungen an der Webseite commitest, möchtest du dir vielleicht anschauen, welche Dateien sich geändert haben. Der Befehl git status ist hier dein Freund.

Da wir das direkte pushen auf den main Branch verbieten, möchtest du vermutlich einen neuen Branch erstellen. Das geht über git checkout -b <branch_name>. Mit git status siehst du auch, auf welchem branch du bist. Den kannst du per git push origin <branch_name> dann auch auf den Webserver pushen. Pushen kannst du, was du commitest hast. git commit Eine aussagekräftige commit-beschreibung wird gerne gesehen.

LFS Überspringen.

Wir verwenden LFS zum Speichern von großen Dateien wie den Podcast, Bilder und so weiter. Wenn du ganz genau weißt, was du machen willst und in Kauf nimmst, dass nicht alle Elemente der Webseite bei dir lokal laden, kannst du das auch überspringen. Der Trick ist folgende Option:

export GIT_LFS_SKIP_SMUDGE=1
git clone <git_repo>

(Da das Rendern der Startseite die Bilder benötigt, willst du dann im lektor direkt auf eine andere Unterseite wechseln. Die Seite http://localhost:5000/admin/ sollte nützlich sein!)

Deployment

Per Drone

Drone testet bereits automatisch den eingecheckten Code im main-Branch und für Pull Requests. Deployments finden nicht automatisch statt, sondern müssen angestoßen werden.

Wähle dazu den erfolgreichen Build, den du deployen möchtest unter https://drone.wtf-eg.de/ag_kommunikation/webseite aus. Rechts oben findest du dann einen Knopf zum Deployment (Wolke mit Pfeil). Als Environment kannst du spielwiese oder www verwenden.

Per Hand

Das Deployment sollte für maximale Reproduzierbarkeit und Nachvollziehbarkeit immer über Drone stattfinden. In Ausnahmesituationen kann jedoch ein manuelles Deployment nötig sein.

lektor build
lektor deploy dev   # Deployment auf die Spielwiese
lektor deploy live  # Deployment auf die Live-Seite