Daniel Maslowski f7a2458e05 README: format markdown with backticks, update setup instructions

NOTE: `bundle install --path` is deprecated.

2024-12-11 20:03:45 +01:00

2.6 KiB

Raw Blame History

site

Die Chaospott Seite / Der Blog

Zu finden auf chaospott.de

jekyll + bootstrap

Initialisierung

Für die Seite benötigt ihr Ruby 2.7.0

rbenv install 2.7.0
rbenv local 2.7.0
bundle config set --local path 'vendor/cache'
bundle install

Blogeinträge

Text

Blogeinträge werden in dem Verzeichnis _posts abgelegt. Um einen Blogeintrag zu verfassen legt man eine Datei mit dem Schema Jahr-MM-TT-Titel.markdown an. Der Blogeintrag beginnt mit folgenden Metadaten:

layout: post
title: "Neues Update für DocPatch"
date: 2015-05-23 13:37:00
categories: docpatch

Damit wird der Titel des Blogeintrags, das Datum der Veröffentlichung und die Kategorie (optional) festgelegt.

Troobleshooting fürs NOC

Sollte der Blogeintrag nicht in den nächsten Minuten auf der Webseite erscheinen muss ein manueller Pull von */_posts ausgeführt werden.

Bilder

Bilder für Blogeinträge werden unterhalb von Media in einem eigenen Verzeichnis (Jahr-MM-TT) abgelegt: ~/site/media/jahr-mm-tt

Als erstes sollte man die Exif-Daten (z.B. Geoinformation) der Bilder entfernen. Dabei wird auch die „Rotation“ des Bildes entfernt.

exiftool -all= $Bild

Ggf. muss das Bild gedreht werden, wenn es ohne die Metatags auf dem Kopf steht oder auf der Seite liegt.

convert -rotate 90 $Bild $Bild_out.jpg

Der vorletzte Schritt setzt die Bilder auf eine einheitliche Breite.

mogrify -resize "1140>" $Bild

Viele Bilder können noch optimiert werden, damit der benötige Speicherplatz und die zu übertragende Datenmenge reduziert wird.

jpegoptim -m 80 %Bild.jpg

Wenn das Bild in der korrekten Größe und Ausrichtung vorliegt, kann es wie folgt eingebunden werden:

![Quelle: Chaospott]({{ site.url }}/media/Jahr-MM-TT/$Bild.jpg)

Web Key Directory (GPG/PGP-Keys zur Suche ablegen)

Um, neben keys.openpgp.org, den eigenen Chaospott-GPG-Key über das WKD-Protokoll verfügbar zu machen, gehe wie folgt vor:

Clone das Repo.
Im Repo geh in den Ordner .well-known/openpgpkey/hu.
Folgendes Skript exportiert deinen öffentlichen Schlüssel in eine Datei, die den Namen deines WKD-Hashes trägt. Dieses wird zur Suche nach deinem GPG-Key benutzt.

# Deine Mailadresse hier eintragen.
MAILADRESSE=name@chaospott.de

# Dieses danach im o.g. Ordner ausführen.
gpg --no-armor --export "$MAILADRESSE" > $(gpg --with-wkd-hash --fingerprint "$MAILADRESSE" | egrep "[ ]{14}[0-9a-z]{32}@chaospott\.de" | sed 's/ //g;s/@chaospott\.de//')

Füge es zum git hinzu, commite und pushe.

2.6 KiB Raw Blame History