forked from Bunteshaus/bunteshaus.de
87 lines
3.9 KiB
Markdown
87 lines
3.9 KiB
Markdown
# Anleitung fuer Artikel
|
|
|
|
## Grundlegendes
|
|
|
|
Jeder Artikel ist ein Ordner der in den Ordnern `content/events` `content/news` oder `content/bunteshaus` liegen kann.
|
|
Dadrin muss sich mindestens eine `index.*.md` Datei befinden und ggf. noch Bilder, die den Artikel illustrieren.
|
|
Das Sternchen steht dabei fuer `de`, `ku` oder `en`. Dieses steht für die Übersetzung des Artikels.
|
|
|
|
Ein Beispiel sieht so aus:
|
|
|
|
```
|
|
--content/news/2323.12.29-Konzert
|
|
|_ index.de.md
|
|
|_ index.en.md
|
|
|_ 1.jpg
|
|
```
|
|
|
|
Eine Methode ist, einen Artikel auf Deutsch anzulegen (`index.de.md`), diese Datei zu `index.ku.md` kopieren und dann den [Inhalt](https://schlomp.space/Bunteshaus/bunteshaus.de#inhalt) zu übersetzen.
|
|
|
|
## Metadaten
|
|
|
|
```
|
|
1 ---
|
|
2 title: "Testtitel"
|
|
3 date: 2021-10-23T18:15:19+02:00
|
|
4 featured: false
|
|
5 about: false
|
|
6 when: "Jeden Montag, 19Uhr"
|
|
7 categories: ["Pressemitteilung"]
|
|
8 events: ["Konzert"]
|
|
9 tags: ["Interpretin 1", "Interpretin 2", "Interpret 3"]
|
|
10 price: "3€"
|
|
11 registeremail: "mail@bunteshaus.de"
|
|
12 covid: "3G"
|
|
13 ---
|
|
14 Endlich wieder Konzerte und den Auftakt macht Testtitel!
|
|
|
|
```
|
|
|
|
| ZeilenNr.| | Bedeutung | notwendig |
|
|
|---:|:---:|:---|---:|
|
|
| Zeile 1| | und 13 Kennzeichnen die Metadaten.| yes |
|
|
| Zeile 2| | ist der Titel, wie er auf der Homepage auftauchen wird.| yes |
|
|
| Zeile 3| | ist das Datum und die Zeit (und Zeitzone (`+02:00`)), an dem der Artikel erstellt wird.| yes |
|
|
| Zeile 4| | kann benutzt werden, um den Artikel prominent zu Platzieren. (Pressemitteilungen etc.)| |
|
|
| Zeile 5| | damit wird ein artikel in die ueberuns kategorie aufgenommen (das projek "café" zb)| |
|
|
| Zeile 6| | wenn etwas ein Event ist, dann hat es ein Datum. Hier kann man das wie im beispiel angeben.| |
|
|
| Zeile 7| * | da alles eine news ist, gibt man so die kategorie fuer diese an. Fuer zb Partys oder Konzerte Inhaus empfiehlt sich "Buha"| |
|
|
| Zeile 8| * | Wenn etwas ein Event ist, kriegt es eine spezielle Kategorie. (Konzert, Party, Regelmäßig, Workshop (siehe Liste auf der homepage))| |
|
|
| Zeile 9| * | zum taggen von artikeln. zb interpreten von konzerten, thematliche schwerpunkte, vortragende.| |
|
|
|Zeile 10| | kann benutzt werden um die Kosten des Termin anzugeben. Füllbar mit Text "3€" oder "free"| |
|
|
|Zeile 11| | heisst irrtuemlich noch so, wird aber geaendert| |
|
|
|Zeile 12| | falls man noch vor covid warnen muss (work in progress :D)| |
|
|
|Zeile 14| | Ab Zeile 14 Beginnt der Inhalt| |
|
|
|
|
**\* Kategorien und Tags funktionieren so:**
|
|
Da man da mehrere Daten angeben kann, muss ein Eintrag in eckige Klammern:
|
|
`categories: ["einzelne kategorie"]`
|
|
Sollen da mehr Kategorien stehen, gibt man diese so an:
|
|
`categories: ["erste kategorie","zweite kategorie","dritte kategorie"]`
|
|
|
|
## Inhalt
|
|
|
|
Soll eine Überschrift im Text passieren, schreibe `##` vor den Teile. Eine Unterüberschrift geht mit `###`
|
|
`## Kapitelüberschrift`
|
|
`### Absatzüberschrift`
|
|
|
|
Soll etwas **fettschrift** geschrieben werden, schreibe `**` davor und dahinter.
|
|
`**worte in fettschrift**`
|
|
|
|
Soll eine neue Zeile angefangen werden, schreibe zwei Leerzeichen hinter den Satz.
|
|
`[...] am ende des satzes. | <- Der Strich symbolisiert das Zeilenende`
|
|
|
|
Soll ein Absatz gemacht werden, lasse eine Zeile zwischen dem ersten und dem neuen Absatz frei.
|
|
Eine Link kann einfach geschrieben werden, allerdings kann man diesen auch gestalten:
|
|
`[Bunteshaus](https://bunteshaus.de)` wird [Bunteshaus](https://bunteshaus.de)
|
|
|
|
Du kannst ein Bild aus dem Ordner des Artikels hinzufuegen:
|
|
`{{< picture 1 "Beschreibung" >}}`
|
|
Benenne Bilder Alphabetisch.
|
|
Fuer einen Artikel brauchst du im Optimalfall min. 1 Bild.
|
|
Das erste Bild, welches gefunden wird, illustriert den Artikel in der Übersicht.
|
|
Jedes weitere Bild steht zu Verfuegung um damit den Artikel im Text zu illustrieren.
|
|
Das Snippet oben wird and der Stelle eingefuegt, an der das Bild erscheinen soll.
|
|
Die Nummer dadrin ist fortlaufend ab 1. (Das Snippet oben symbolisiert quasi das zweite Bild im Ordner)
|
|
|