Skip to content
Knut Perseke edited this page Nov 6, 2017 · 1 revision

Neuen Post anlegen

Erstelle eine Text-Datei im Ordner

blog/_posts/[Jahr]/

mit dem Namensformat

[Jahr]-[zweistelliger Monat]-[zweistelligere Tag]-[Datei-Titel].md

Der Datei-Titel darf keine Umlaute, Emojis oder ähnliches enthalten, aus Kleinbuchstaben bestehen und anstelle von Leerzeichen muss das Minus "-" verwendet werden.

Beispiel: blog/_posts/2015/2015-12-01-mein-neuer-blogpost.md

Am Anfang in der Datei muss ein Textblock mit den Metainformationen, dann folgt der Inhalt.

Blogpost-Bilder

Bilder zum Blogpost sollen in den Pfad files/blog/[Jahr]/[zweistelliger Monat]/ gelegt und zu git hinzugefügt werden. Alternativ kann man sie im entsprechenden Pfad direkt über GitHub hochladen über "Upload files" (Knopf rechts oben). Die Bilder können dann in Metainformationen als ein Hauptbild oder im Text verwendet werden. (siehe unten)

Keine zu großen Dateien (maximal 1 MB) hochladen, bitte bedenke dass die Blogposts auch über langsame Mobilverbindungen gelesen werden.

Blogpost-Metainformationen

Die Metainformation müssen am Anfang der Datei stehen und von zwei Zeilen mit "---" umschlossen werden.

---
author: 
   - Petra Musterfrau
   - Max Mustermann
date: 2015-12-01 10:42:49
picture:
  src: /files/blog/2015/12/dateiname.png
  title: Kurze Bildbeschreibung
  license: Wird in einer Zeile unter dem Bild angezeigt
  license_url: http://lizenzseite.de
tags: 
   - Sinnvoller Tag für den Inhalt 1
   - Sinnvoller Tag für den Inhalt 2
title: "Hier steht der Titel des Posts (bitte nicht mehr als 90 Zeichen)"
---

author

Wenn du deinen Namen exakt so (Vorname und Nachname) schreibst wie im Team, wird beim Blogpost automatisch dein Foto mit angezeigt.

Petra Musterfrau

date

Das Datum des Blogposts [vierstelliges Jahr]-[zweistelliger Monat]-[zweistelliger Tag] [zweistellige Stunde]:[zweistellige Uhrzeit]:[zweistellige Sekunde] Achtung: Liegt das Datum in der Zukunft wird der Post (noch) nicht veröffentlicht. Jekyll verwendet GMT-0 aus einem uns unbekannten Grund, das bei Zeiteingabe beachten!

z.B. 2015-12-01 13:37:00

published

Hiermit kann man den Post unveröffentlicht lassen. (So er veröffentlicht werden, diese Zeile löschen oder auf 'true' setzen.

z.B. published: false

image src

Die (relative) Pfad des Bildes

z.B. /files/blog/2015/12/dateiname.png

Bitte nicht die volle Adresse angeben (http:/datenschule.de/files/blog/2015/12/dateiname.png), da sonst bei https://okfn.de die Datei eben nicht über https übertragen wird.

image title

Dieser Text wird beim Mouse-Over gezeigt und blinden Menschen vorgelesen.

Bitte nicht nur den Dateinamen z.B. "OERcamp-Logo-300px.jpeg" eintragen, sondern eine kurze Beschreibung was auf dem Bild zu sehen ist z.B. "OERCamp Logo".

image license

Wird in einer Zeile unter dem Bild angezeigt, kann Markdown enthalten.

z.B. "[CC BY-NC 2.0](https://creativecommons.org/licenses/by-nc/2.0/), Leif Hinrichsen via [flickr](https://www.flickr.com/photos/leifhinrichsen/15084392262/)"

oder z.B. "CC BY 2.0 Awesome Image by fotografiona"

image license_url

Die Lizenz unter dem Bild wird verlinkt. Dieser Link führt zur hier angegebenen Addresse

tags

Einzelne Tags werden je in eine neue Zeile geschrieben, jeweils eingeleitet mit "- "

z.B.

- Open Data
- Hackathon

Eine Liste bereits genutzter Tags kannst du hier anschauen.

title

Der Titel des Blogposts. Dieser wird auch von Social Media wie Twitter als Text zum Link angezeigt. Deshalb ist eine Länge von maximal 80-90 Zeichen günstig (damit Links und "via @datenschule" etc. mit in einen Tweet passen).

Blogpost-Text

Der Text kann in Markdown und/oder HTML verfasst werden. Besser ist Markdown, weil die Texte dann nicht mehr sauber gemacht werden müssen (z.b. für den RSS-Feed).

Bilder einbetten

TODO: Dokumentieren

Tweets einbetten

TODO: Dokumentieren

Youtube einbetten

{% youtube videoid höhe breite %}

z.B. {% youtube lD34A2nuWCs 560 315 %}

Vimeo einbetten

{% vimeo videoid höhe breite %}

z.B. {% vimeo 55933806 600 337 %}

Soundcloud einbetten

{% soundcloud trackid höhe breite %}

z.B. {% soundcloud lD34A2nuWCs 100% 166 %}

IFrames einbetten

TODO: Dokumentieren

Post veröffentlichen

Im entsprechenden Pfad zu git hinzufügen oder über "Upload Files" (Button rechts oben) im entsprechenden Pfad hochladen.

Sonstiges

Früher wurde das Blog auf GitHub selbst veröffentlicht. Wenn dann ein Fehler im Master war, ging die Seite nicht mehr. Heute funktioniert das von unserem Server aus. Wenn dem was nicht passt, liefert er weiterhin die alte Version aus. Es ist also kein Problem mehr, direkt etwas auf dem Master Branch zu ändern.

Anchor zum reinhüpfen

z.B. <a id="Update-Termine"></a> ist dann mittles https://okfn.de/blog/2017/03/OGP-zivilgesellschaftlichen-Ideen/#Update-Termine abrufbar an der Stelle, Hinweis Anchor paar Zeilen oberhalb einbauen, da sonst der Header übergeblendet wird.