site/README.md

82 lines
2.7 KiB
Markdown
Raw Normal View History

2019-07-08 21:05:12 +00:00
# site
2014-10-20 21:30:51 +00:00
2019-07-08 21:05:12 +00:00
Die Chaospott Seite / Der Blog
Zu finden auf [chaospott.de](https://chaospott.de)
2014-10-20 21:30:51 +00:00
2014-11-03 21:39:52 +00:00
jekyll + bootstrap
2023-03-12 20:39:24 +00:00
## Initialisierung
Für die Seite benötigt ihr Ruby 2.7.0
<pre><code>---
rbenv install 2.7.0
rbenv local 2.7.0
bundle install --path=vendor/cache
---</code></pre>
## Blogeinträge
### Text
2020-07-05 16:11:07 +00:00
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:
2015-02-12 10:49:20 +00:00
<pre><code>---
layout: post
title: "Neues Update für DocPatch"
date: 2015-05-23 13:37:00
categories: docpatch
---</code></pre>
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
2014-11-03 21:39:52 +00:00
Bilder für Blogeinträge werden unterhalb von Media in einem eigenen Verzeichnis (Jahr-MM-TT) abgelegt.
2014-11-03 21:39:52 +00:00
2015-03-22 13:45:39 +00:00
<pre><code>~/site/media/jahr-mm-tt
</code></pre>
Als erstes sollte man die Exif-Daten (z.B. Geoinformation) der Bilder entfernen. Dabei wird auch die „Rotation“ des Bildes entfernt.
2015-02-12 10:49:20 +00:00
<pre><code>exiftool -all= $Bild
</code></pre>
Ggf. muss das Bild gedreht werden, wenn es ohne die Metatags auf dem Kopf steht oder auf der Seite liegt.
2020-01-14 20:38:19 +00:00
<pre><code>convert -rotate 90 $Bild $Bild_out.jpg</code></pre>
2015-02-12 10:49:20 +00:00
Der vorletzte Schritt setzt die Bilder auf eine einheitliche Breite.
2015-02-12 10:49:20 +00:00
<pre><code>mogrify -resize "1140>" $Bild
2015-03-25 15:58:49 +00:00
</code></pre>
Viele Bilder können noch optimiert werden, damit der benötige Speicherplatz und die zu übertragende Datenmenge reduziert wird.
2020-01-14 20:38:19 +00:00
<pre><code>jpegoptim -m 80 %Bild.jpg</code></pre>
2015-03-25 15:58:49 +00:00
Wenn das Bild in der korrekten Größe und Ausrichtung vorliegt, kann es wie Folgt eingebunden werden.
2015-03-25 15:59:21 +00:00
<pre><code>![Quelle: Chaospott]({{ site.url }}/media/Jahr-MM-TT/$Bild.jpg)
2015-03-25 15:58:49 +00:00
</code></pre>
2022-06-12 14:38:20 +00:00
### Web Key Directory (GPG/PGP-Keys zur Suche ablegen)
Um, neben [keys.openpgp.org](https://keys.openpgp.org/), den eigenen Chaospott-GPG-Key über das WKD-Protokoll verfügbar zu machen, gehe wie folgt vor:
1. Clone das Repo.
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.
```bash
# 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//')
```
4. Füge es zum git hinzu, commite und pushe.