bunteshaus.de/docs/artikelstruktur.md

# Anleitung fuer Artikel

## Grundlegendes

Jeder Artikel ist ein Ordner der in dem Ordner `content/news` liegen muss.  
In diesem Ordner 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
        |_ 2.png
```
In diesem Falle gibt es den Artikel auf Deutsch und Enlisch und ein Bild für die Artikelübersicht und eins zum illustrieren des Artikeltextes.


Eine gute 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)