diff --git a/README.md b/README.md index d7739ac..13e9a38 100644 --- a/README.md +++ b/README.md @@ -10,23 +10,28 @@ jekyll + bootstrap Für die Seite benötigt ihr Ruby 2.7.0 -
---
+```
rbenv install 2.7.0
rbenv local 2.7.0
-bundle install --path=vendor/cache
----
+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:
----
+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
@@ -35,29 +40,37 @@ Sollte der Blogeintrag nicht in den nächsten Minuten auf der Webseite erscheine
### Bilder
-Bilder für Blogeinträge werden unterhalb von Media in einem eigenen Verzeichnis (Jahr-MM-TT) abgelegt.
-
-~/site/media/jahr-mm-tt
-
+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
-
+
+```
+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
+
+```
+convert -rotate 90 $Bild $Bild_out.jpg
+```
Der vorletzte Schritt setzt die Bilder auf eine einheitliche Breite.
-mogrify -resize "1140>" $Bild
-
+
+```
+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.
-
-
+```
+jpegoptim -m 80 %Bild.jpg
+```
+Wenn das Bild in der korrekten Größe und Ausrichtung vorliegt, kann es wie folgt eingebunden werden:
+
+```
+
+```
### Web Key Directory (GPG/PGP-Keys zur Suche ablegen)
@@ -66,7 +79,7 @@ Um, neben [keys.openpgp.org](https://keys.openpgp.org/), den eigenen Chaospott-G
1. Clone das Repo.
-2. Im Repo geh in den Ordner `.well-known/openpgpkey/hu`.
+2. Im Repo geh in den Ordner `.well-known/openpgpkey/hu`.
3. 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.