Compare commits

..

3 Commits

Author SHA1 Message Date
Daniel Maslowski
2102546be8 upgrade Jekyll to 4.3.4 2024-12-11 20:05:27 +01:00
Daniel Maslowski
9c8466944a ungitignore Gemfile.lock
This is necessary to pin the resolved dependencies.
2024-12-11 20:04:54 +01:00
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
4 changed files with 109 additions and 22 deletions

1
.gitignore vendored
View File

@ -1,7 +1,6 @@
.idea/*
_site/
.sass-cache/
Gemfile.lock
.DS_Store
vendor/*

View File

@ -1,5 +1,5 @@
source 'https://rubygems.org'
gem 'jekyll', '~>3.8.4'
gem 'jekyll', '~>4.3.4'
gem 'jekyll-paginate'
gem 'rexml'

75
Gemfile.lock Normal file
View File

@ -0,0 +1,75 @@
GEM
remote: https://rubygems.org/
specs:
addressable (2.8.7)
public_suffix (>= 2.0.2, < 7.0)
colorator (1.1.0)
concurrent-ruby (1.3.4)
em-websocket (0.5.3)
eventmachine (>= 0.12.9)
http_parser.rb (~> 0)
eventmachine (1.2.7)
ffi (1.17.0)
forwardable-extended (2.6.0)
google-protobuf (3.25.5-x86_64-linux)
http_parser.rb (0.8.0)
i18n (1.14.6)
concurrent-ruby (~> 1.0)
jekyll (4.3.4)
addressable (~> 2.4)
colorator (~> 1.0)
em-websocket (~> 0.5)
i18n (~> 1.0)
jekyll-sass-converter (>= 2.0, < 4.0)
jekyll-watch (~> 2.0)
kramdown (~> 2.3, >= 2.3.1)
kramdown-parser-gfm (~> 1.0)
liquid (~> 4.0)
mercenary (>= 0.3.6, < 0.5)
pathutil (~> 0.9)
rouge (>= 3.0, < 5.0)
safe_yaml (~> 1.0)
terminal-table (>= 1.8, < 4.0)
webrick (~> 1.7)
jekyll-paginate (1.1.0)
jekyll-sass-converter (3.0.0)
sass-embedded (~> 1.54)
jekyll-watch (2.2.1)
listen (~> 3.0)
kramdown (2.5.1)
rexml (>= 3.3.9)
kramdown-parser-gfm (1.1.0)
kramdown (~> 2.0)
liquid (4.0.4)
listen (3.9.0)
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
mercenary (0.4.0)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
public_suffix (6.0.1)
rake (13.2.1)
rb-fsevent (0.11.2)
rb-inotify (0.11.1)
ffi (~> 1.0)
rexml (3.3.9)
rouge (4.5.1)
safe_yaml (1.0.5)
sass-embedded (1.69.5)
google-protobuf (~> 3.23)
rake (>= 13.0.0)
terminal-table (3.0.2)
unicode-display_width (>= 1.1.1, < 3)
unicode-display_width (2.6.0)
webrick (1.9.1)
PLATFORMS
x86_64-linux
DEPENDENCIES
jekyll (~> 4.3.4)
jekyll-paginate
rexml
BUNDLED WITH
2.3.5

View File

@ -10,23 +10,28 @@ jekyll + bootstrap
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>
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:
<pre><code>---
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
---</code></pre>
```
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.
<pre><code>~/site/media/jahr-mm-tt
</code></pre>
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.
<pre><code>exiftool -all= $Bild
</code></pre>
```
exiftool -all= $Bild
```
Ggf. muss das Bild gedreht werden, wenn es ohne die Metatags auf dem Kopf steht oder auf der Seite liegt.
<pre><code>convert -rotate 90 $Bild $Bild_out.jpg</code></pre>
```
convert -rotate 90 $Bild $Bild_out.jpg
```
Der vorletzte Schritt setzt die Bilder auf eine einheitliche Breite.
<pre><code>mogrify -resize "1140>" $Bild
</code></pre>
```
mogrify -resize "1140>" $Bild
```
Viele Bilder können noch optimiert werden, damit der benötige Speicherplatz und die zu übertragende Datenmenge reduziert wird.
<pre><code>jpegoptim -m 80 %Bild.jpg</code></pre>
Wenn das Bild in der korrekten Größe und Ausrichtung vorliegt, kann es wie Folgt eingebunden werden.
<pre><code>![Quelle: Chaospott]({{ site.url }}/media/Jahr-MM-TT/$Bild.jpg)
</code></pre>
```
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)
@ -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.