Installationspaket für knowledge.ralf-peter-kleinert.de

ComputerRalle-Logo von Ralf-Peter Kleinert und DIGITAL-easy

Dieses Paket legt die öffentliche Identität eindeutig fest:

Dateien in den Webroot kopieren

Kopiere alle Dateien direkt in das Stammverzeichnis von:

https://knowledge.ralf-peter-kleinert.de/

Danach sollten diese URLs erreichbar sein:

Die menschenlesbaren Inhalte stehen als HTML-Seiten bereit; die gleichnamigen Markdown-Dateien bleiben als maschinenlesbare Quellen erhalten.

Software und Eigenentwicklungen

Inhalte manuell erweitern

Die sichtbaren Pflegevorlagen befinden sich in:

Die Dateien books.json und videos.json enthalten bereits die erfassten Bücher und Videos als itemListElement-Listen. Neue Einträge werden dort zusätzlich zu den Markdown-Dateien als gültige Schema.org-Datensätze ergänzt. Platzhalter aus den Markdown-Vorlagen nicht veröffentlichen, sondern vor dem Hochladen durch echte Angaben ersetzen.

Wichtig

Die kanonische Schreibweise der Marke ist überall:

DIGITAL-easy

Die Varianten DIGITALeasy und DIGITAL-easy ComputerRalle werden nur als alternative Bezeichnungen geführt, damit Suchmaschinen und KI-Systeme ältere Fundstellen korrekt zuordnen können.

Auffindbarkeit und strukturierte Daten

node generate-html.mjs ergänzt individuelle Seitenbeschreibungen, Open-Graph-Metadaten und die jeweils passende JSON-LD-Datei direkt im HTML. Die Startseite erhält einen automatisch aktualisierten Datenblock aus person.json, organization.json und einem WebSite-Datensatz. profile.json ist kein JSON-LD und wird nicht eingebettet. Den markierten Datenblock in index.html nicht von Hand pflegen.

Beschreibungen stehen zentral in pageDescriptions im HTML-Generator; neue Inhaltsseiten dort ergänzen. Inhalte zuerst in Markdown und den zuständigen JSON-Dateien pflegen, anschließend den Generator ausführen. Eingebettete Daten müssen zum sichtbaren Inhalt passen. Eine erfolgreiche Generierung bestätigt keine vollständige Schema.org-Prüfung oder Suchmaschinenaufnahme.

Bücher und Videos haben dauerhafte Direktziele in ihren Markdown-Quellen: books.html#book-<bestehende Buch-ID> und videos.html#video-<YouTube-ID>. Bei neuen Einträgen entsprechende Anker ergänzen, bestehende Anker und Entitäts-IDs erhalten. Die Inhaltsdaten behalten bei rein technischen Änderungen ihr bisheriges Aktualisierungsdatum.

Unterstützer und Rückmeldungen

Die anonymisierte, vom Autor bereitgestellte Buy-Me-a-Coffee-Kopie steht in unterstuetzer.md und unterstuetzer.html. Der Originalprofil ist dort direkt verlinkt. Die angegebene Profilzahl (59) und die 62 übermittelten Listeneinträge werden getrennt ausgewiesen. Kommentare und Antworten bleiben unverändert; die Profilzahl wird nicht automatisch aktualisiert.

Strukturierte Daten aktuell halten

Die Bereiche Dienstleistungen, Impressum und Unterstützer stehen jeweils als HTML, Markdown und JSON-LD bereit. node generate-knowledge-data.mjs erzeugt diese drei JSON-Dateien. node generate-html.mjs erzeugt anschließend die HTML-Seiten aus Markdown. Aktualisierungsdaten bei inhaltlichen Änderungen in den betroffenen Quellen und JSON-Dateien anpassen. Der HTML-Generator übernimmt das Datum aus jeder Markdown-Datei; das Startseitendatum separat pflegen. Fest hinterlegte Daten im JSON-Generator nur bei Änderungen seiner drei Ausgabebereiche abgleichen.

Lehrgänge und Kurse

Das Verzeichnis steht unter /lehrgaenge-und-kurse.html, /lehrgaenge-und-kurse.md und /lehrgaenge-und-kurse.json bereit. Erfasst ist der kostenlose Proxmox-VE-Komplettlehrgang von Ralf-Peter Kleinert / ComputerRalle: zwei YouTube-Playlists und das vollständige Proxmox VE 8 Praxisbuch als kostenloses PDF. Der Eintrag enthält eine Kurzbeschreibung und verweist auf das Originalangebot unter https://blog.ralf-peter-kleinert.de/proxmox-virtual-environment/kostenloser-und-umfassender-proxmox-ve-lehrgang-proxmox-lernen-verstehen-und-nutzen/ . Der Blogartikel wird hier nicht reproduziert. Ein Kauf des separat angebotenen VE-9-Praxisbuchs ist nicht erforderlich.

Neue Einträge in Markdown und JSON-LD gemeinsam pflegen; Titel, Inhalte und offizielle Links nur nach vorliegenden Angaben ergänzen. numberOfItems mit der Liste abgleichen und anschließend HTML generieren.

Bestehenden Lehrgang pflegen

Transparenz

transparenz.md, transparenz.html und transparenz.json enthalten eine eigenständige Kurzfassung der Grundsätze zu Affiliate-Partnerschaften und unabhängigen Empfehlungen. Die ausführliche Erklärung bleibt im verlinkten Originalartikel. Markdown und JSON-LD manuell gemeinsam pflegen, anschließend HTML generieren. Partner, Beginn der Partnerschaften und Aussagen zur Arbeitsweise nur anhand bestätigter Angaben ändern. Keine Blog-Vollkopie und keine unbelegten Zusagen ergänzen.