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/* .idea/*
_site/ _site/
.sass-cache/ .sass-cache/
Gemfile.lock
.DS_Store .DS_Store
vendor/* vendor/*

View File

@ -1,5 +1,5 @@
source 'https://rubygems.org' source 'https://rubygems.org'
gem 'jekyll', '~>3.8.4' gem 'jekyll', '~>4.3.4'
gem 'jekyll-paginate' gem 'jekyll-paginate'
gem 'rexml' 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 Für die Seite benötigt ihr Ruby 2.7.0
<pre><code>--- ```
rbenv install 2.7.0 rbenv install 2.7.0
rbenv local 2.7.0 rbenv local 2.7.0
bundle install --path=vendor/cache bundle config set --local path 'vendor/cache'
---</code></pre> bundle install
```
## Blogeinträge ## Blogeinträge
### Text ### 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.
<pre><code>--- 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 layout: post
title: "Neues Update für DocPatch" title: "Neues Update für DocPatch"
date: 2015-05-23 13:37:00 date: 2015-05-23 13:37:00
categories: docpatch categories: docpatch
---</code></pre> ```
Damit wird der Titel des Blogeintrags, das Datum der Veröffentlichung und die Kategorie (optional) festgelegt. Damit wird der Titel des Blogeintrags, das Datum der Veröffentlichung und die Kategorie (optional) festgelegt.
#### Troobleshooting fürs NOC #### Troobleshooting fürs NOC
@ -35,29 +40,37 @@ Sollte der Blogeintrag nicht in den nächsten Minuten auf der Webseite erscheine
### Bilder ### Bilder
Bilder für Blogeinträge werden unterhalb von Media in einem eigenen Verzeichnis (Jahr-MM-TT) abgelegt. Bilder für Blogeinträge werden unterhalb von Media in einem eigenen Verzeichnis (Jahr-MM-TT) abgelegt: `~/site/media/jahr-mm-tt`
<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. 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. 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. 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. 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) jpegoptim -m 80 %Bild.jpg
</code></pre> ```
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) ### Web Key Directory (GPG/PGP-Keys zur Suche ablegen)