docs: update website
This commit is contained in:
parent
d25841b359
commit
8f8671fbe0
1 changed files with 43 additions and 2 deletions
45
website.md
45
website.md
|
@ -2,7 +2,7 @@
|
|||
title: Website
|
||||
description: Unsere Website
|
||||
published: 1
|
||||
date: 2025-02-15T19:07:04.634Z
|
||||
date: 2025-02-15T19:25:44.406Z
|
||||
tags:
|
||||
editor: markdown
|
||||
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
|
||||
|
||||
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
|
||||
|
||||
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.
|
||||
|
@ -61,4 +63,43 @@ Dort kannst du entweder ein Bild per URL hinzufügen oder aus den verfügbaren B
|
|||
|
||||

|
||||
|
||||
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.
|
Loading…
Add table
Reference in a new issue