bunteshaus.de/docs/artikelstruktur.md
2022-04-04 20:17:08 +02:00

4.1 KiB

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 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

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)