docs: update website

This commit is contained in:
Elouin 2025-02-15 19:25:46 +00:00 committed by flipdot Wiki
parent d25841b359
commit 8f8671fbe0

View file

@ -2,7 +2,7 @@
title: Website title: Website
description: Unsere Website description: Unsere Website
published: 1 published: 1
date: 2025-02-15T19:07:04.634Z date: 2025-02-15T19:25:44.406Z
tags: tags:
editor: markdown editor: markdown
dateCreated: 2025-02-15T19:07:04.634Z dateCreated: 2025-02-15T19:07:04.634Z
@ -18,6 +18,8 @@ Die Website hosten wir auf GitLab pages. Das Repo zur Website findet ihr demnach
## Blogpost erstellen ## Blogpost erstellen
Da wir unsere Website auf [GitLab.com](https://gitlab.com) hosten, brauchst du dort einen Account um einen Blogpost erstellen zu können. Dein Account braucht auch Zugriffsrechte auf dem Repository. Um diese zu erhalten sprich einfach ein anderes Member an, welches schon Zugriff hat(Elouin z.B.).
### Decap CMS ### Decap CMS
Das [Decap CMS](https://decapcms.org/) findest du unter [flipdot.org/admin](https://flipdot.org/admin). Um dort hin zu kommen kann man auch auf den Login Button unten auf der Website klicken. Als erstes musst du dich mit deinem GitLab.com account einloggen und dann Decap Zugriffsrechte gewähren. Das [Decap CMS](https://decapcms.org/) findest du unter [flipdot.org/admin](https://flipdot.org/admin). Um dort hin zu kommen kann man auch auf den Login Button unten auf der Website klicken. Als erstes musst du dich mit deinem GitLab.com account einloggen und dann Decap Zugriffsrechte gewähren.
@ -62,3 +64,42 @@ Dort kannst du entweder ein Bild per URL hinzufügen oder aus den verfügbaren B
![screenshot_from_2025-02-15_18-03-52.png](/screenshot_from_2025-02-15_18-03-52.png) ![screenshot_from_2025-02-15_18-03-52.png](/screenshot_from_2025-02-15_18-03-52.png)
Um ein Bild hochzuladen, klicke auf "Hochladen" und wähle ein Bild aus. Dieses erscheint dann in der Auswahl und kann eingesetzt werden. Um ein Bild hochzuladen, klicke auf "Hochladen" und wähle ein Bild aus. Dieses erscheint dann in der Auswahl und kann eingesetzt werden.
### Lokal mit Editor
Zuerst clone das [git Repository der Website](https://gitlab.com/flipdot/nusite).
```bash
git clone git@gitlab.com:flipdot/nusite.git
```
Im checkout findest du dann die Blogposts im Ordner "content/blog". Erstelle dort eine neue Datei. Benne sie am besten wie folgt: `YYYY-MM-DD-titel-ohne-leerzeichen.md`, also zum Beispiel `2024-03-04-hackerein-am-nachmittag.md`.
Die Blogposts an sich sind einfach in [Markdown](https://commonmark.org/) geschrieben. Um [Zola](https://www.getzola.org/) noch ein paar Infos mit zu geben muss am Anfang allerdings eine Front Matter eingefügt werden. Diese muss mindestens folgende Felder haben:
- **title**
Der Titel deines Blogposts
- **date**
Das Datum an welchem der Blogposts veröffentlicht werden soll
- **author**
Dein Name
- **path**
Der Pfad unter dem der Blogpost erreichbar sein soll(am besten `/blog/<Jahr>/<Monat>/<Tag>/<titel_ohne_leerzeichen>`)
- **draft**
Wenn gesetzt wird der Artikel nicht direkt veröffentlicht
Also zum Beispiel:
```yaml
+++
title = "Hackerein am Nachmittag"
date = 2024-03-04T12:30:00.000Z
author = "elouin"
path = "/blog/2024/03/04/hackerein-am-nachmittag"
draft = false
+++
```
Diese muss am Anfang der Datei eingefügt sein. Danach kannst du dann den Inhalt deines Blogposts schreiben. Wenn du sehen möchtest wie dein Post auf der Seite aussieht kannst du dir den lokalen Stand mit dem Befehl `zola serve` kompilieren und serven lassen.
Bist du mit deinem Post zufrieden, musst du nur noch deine Änderungen pushen. Auf dem `main` Branch läuft ein CI Job, welche dann die Änderungen baut und released.