Merge pull request 'develop' (#7) from develop into main

Reviewed-on: #7

.github/workflows/develop.yml

@@ -0,0 +1,43 @@
+name: ci 
+on:
+  push:
+    branches:
+      - develop
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    if: github.event.repository.fork == false
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: apt-get update && apt-get install -y pngquant rsync
+      - run: pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git
+      - run: pip install -r requirements.txt
+      - run: mkdocs build
+      - name: Create private key
+        run: |
+          echo "${{ secrets.ACT_RUNNER_KEY }}" > /tmp/act_runner_key
+          chmod 600 /tmp/act_runner_key          
+      - name: rsync public directory
+        run: |
+          /usr/bin/rsync -avz --delete -e "ssh -i /tmp/act_runner_key -o StrictHostKeyChecking=no" ${{ gitea.workspace }}/site/* root@vps03.hadan-it.com:/data/webspace/stephan.preview.hadan.de/          
+      - run: echo "This job's status is ${{ job.status }}."
+env:
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}

README.md

@@ -11,6 +11,12 @@
   </strong>
 </p>
 
+<!-- BADGIE TIME -->
+
+
+
+<!-- END BADGIE TIME -->
+
 <p align="center">
   <a href="https://git.hadan-it.com/web/stephan.hadan.de/actions"><img
     src="https://git.hadan-it.com/web/stephan.hadan.de/actions/workflows/ci.yml/badge.svg?branch=main"

docs/blog/.authors.yml

@@ -3,3 +3,5 @@ authors:
     name: Stephan Hadan
     description: Senior IT Operations Engineer
     avatar: assets/logo.png
+    url: https://stephan.hadan.de/about/
+    email: stephan@hadan.de

docs/rss/index.md

@@ -0,0 +1,26 @@
+# RSS-Feeds
+
+## Was sind RSS-Feeds?
+
+**RSS** steht für **Really Simple Syndication** und beschreibt eine Methode, Informationen in einem maschinenlesbaren Format bereitzustellen. Mit RSS können Nutzer spezifische Texte oder Multimedia-Dateien einer Website abonnieren. 
+
+Mit Hilfe von RSS können abonnierte Inhalte automatisch auf den Computer des Nutzers oder auf Websites geladen werden, wodurch der Abonnent bequem mit den neuesten Informationen versorgt wird.
+
+## Was benötigst du, um einen RSS-Feed zu abonnieren?
+
+Um einen RSS-Feed zu abonnieren, benötigst du einen RSS-Reader. Es gibt mehrere, die kostenlos im Internet verfügbar sind und individuell konfiguriert werden können. Die neuesten Browserversionen verfügen über diese Funktion. Sie ermöglichen es den Nutzern zu entscheiden, welche Quellen gelesen werden sollen.
+
+Der Reader zeigt den Titel oder, alternativ, die ersten Zeilen eines Artikels an. Ein begleitender Link ermöglicht es dem Abonnenten, den gesamten Artikel im Browser zu öffnen.
+
+!!! tip "Ein kleiner Tipp"
+
+    Es ist nicht nötig, deinen RSS-Reader jede Minute aktualisieren zu lassen. Die meisten Feeds ändern sich nicht so häufig, und ein zu häufiger Abruf kann sowohl deine Ressourcen als auch die des Servers belasten. Als Faustregel gilt: Ein Abruf pro Stunde reicht in den meisten Fällen völlig aus.
+
+## Wie abonnierst du einen RSS-Feed?
+
+Du kannst die auf meiner Website verfügbaren RSS-Feeds abonnieren, indem du auf die Links in der untenstehenden Liste klickst oder den jeweiligen Link in den RSS-Reader Deiner Wahl einfügst.
+
+## Verfügbare Feeds
+
+Der RSS-Feed zu den Blogartikeln: :fontawesome-solid-rss: [https://stephan.hadan.de/feed_rss_created.xml](https://stephan.hadan.de/feed_rss_created.xml)
+

mkdocs.yml

@@ -111,7 +111,8 @@ plugins:
       exclude:
         - index.md
   - rss:
-      enabled: !ENV [CI, false]
+#      enabled: !ENV [CI, false]
+      pretty_print: true
       match_path: blog/posts/.* 
       date_from_meta:
         as_creation: date
@@ -150,8 +151,8 @@ extra:
     - icon: fontawesome/brands/slack
       link: https://hadanit.slack.com/team/U04BLKQF2M8
     - icon: fontawesome/solid/rss
-      link: https://stephan.hadan.de/feed_rss_created.xml
-      name: Neueste Blogbeiträge
+      link: https://stephan.hadan.de/rss/
+      name: RSS-Feeds dieser Webseite
   isso:
     custom_url: https://comments.hadan-it.com
 
@@ -219,6 +220,7 @@ nav:
   - Kontakt: contact/index.md
   - Datenschutz: dataprivacy/index.md
   - Impressum: imprint/index.md
+  - RSS: rss/index.md
   - Blog:
     - blog/index.md  
         

overrides/home.html

@@ -12,6 +12,7 @@
   {{ super() }}
 
   {% block extrahead %}
+
   {% set title = config.site_name %}
   {% if page and page.meta and page.meta.title %}
     {% set title = title ~ " - " ~ page.meta.title %}
@@ -19,7 +20,7 @@
     {% set title = title ~ " - " ~ page.title %}
   {% endif %}
 
-<!-- Umami analytics, https://squidfunk.github.io/mkdocs-material/customization/#overriding-blocks -->
+  <!-- Umami analytics, https://squidfunk.github.io/mkdocs-material/customization/#overriding-blocks -->
   <script async src="https://analytics.hadan-it.com/script.js" data-website-id="edea79df-8252-4223-adae-46663a8aaa1a"></script>
 
   {% endblock %}

overrides/main.html

@@ -1,6 +1,7 @@
 {% extends "base.html" %}
 
 {% block extrahead %}
+
   {% set title = config.site_name %}
   {% if page and page.meta and page.meta.title %}
     {% set title = title ~ " - " ~ page.meta.title %}
@@ -9,6 +10,6 @@
   {% endif %}
 
   <!-- Umami analytics, https://squidfunk.github.io/mkdocs-material/customization/#overriding-blocks -->
-<script async src="https://analytics.hadan-it.com/script.js" data-website-id="edea79df-8252-4223-adae-46663a8aaa1a"></script>
+  <script async src="https://analytics.hadan-it.com/script.js" data-website-id="edea79df-8252-4223-adae-46663a8aaa1a"></script>
 
 {% endblock %}