Inhalt
======

1. Installationsanleitung
1.1. Allgemeine Hinweise
1.2. Manuelle Installation
1.3. Automatische Installation unter Windows
2. Versionshinweise


1. Installationsanleitung
=========================

1.1. Allgemeine Hinweise
------------------------

Das Blog-System muss auf einem Webserver installiert werden, der PHP unterstützt.
Diese Anleitung setzt voraus, dass bereits ein solcher Webserver zur Verfügung
steht und die folgenden Daten zur Hand sind:

- Die Webserver-Adresse für den Upload von Dateien per SFTP. Diese erhält man
  vom Hosting-Anbieter. Beispiel für Strato: ssh.strato.de

- Das Installationsverzeichnis. Entspricht dem Verzeichnis, auf das die Domain
  (z.B. beispiel.de) umgeleitet wurde. Wenn hier nichts angegeben wird, werden
  die Dateien ins Standard-Verzeichnis (meist das Hauptverzeichnis) hochgeladen.

- Der Benutzername für den Upload von Dateien per SFTP. Diesen erhält man vom
  Hosting-Anbieter.

- Das Passwort für den Upload von Dateien per SFTP. Dieses erhält man vom
  Hosting-Anbieter und sollte anschließend geändert werden.

Die Installation kann manuell über ein SFTP-Programm oder automatisch mit Hilfe
eines Installationsprogramms erfolgen (Letzteres nur unter Windows):


1.2. Manuelle Installation
--------------------------

Hierzu entpackt man die heruntergeladene ZIP-Datei "install-blog-v[…].zip" in
ein Verzeichnis auf dem lokalen Rechner und lädt anschließend die entpackten
Dateien mit einem SFTP-Programm (z.B. FileZilla oder WinSCP) auf den Webserver
hoch.

Die ZIP-Datei enhält folgende Verzeichnisse:

  Verzeichnis        Inhalt

  ├──install         Dateien für die Neuinstallation.
  │  │
  │  ├──common       Gemeinsame Dateien für alle Sprachen.
  │  │
  │  ├──de           Dateien für die Sprache Deutsch.
  │  │
  │  └──en           Dateien für die Sprache Englisch.
  │
  └──update          Dateien für die Update-Installation.
     │
     ├──common       Gemeinsame Dateien für alle Sprachen.
     │
     ├──de           Dateien für die Sprache Deutsch.
     │
     └──en           Dateien für die Sprache Englisch.

Das grundsätzliche Vorgehen beim Hochladen der Dateien ist wie folgt:

- SFTP-Programm starten und mit dem Webserver verbinden. Dazu die
  Webserver-Adresse, den Benutzernamen und das Passwort angeben.

- Das Fenster eines solchen SFTP-Programm ist meist zweigeteilt: Links sieht man
  die Dateien und Verzeichnisse des lokalen Rechners, rechts die des Webservers.

- Falls man die Domain, unter der das Blog-System im WWW erreichbar sein soll,
  auf ein bestimmtes Verzeichnis des Webservers umgeleitet hat, muss auf der
  rechten Seite in dieses Verzeichnis hineingewechselt werden.

- Links wechselt man in das lokale Verzeichnis, dessen Inhalte hochgeladen werden
  sollen, markiert dort alle zu sehenden Dateien und Unterverzeichnisse (meist
  geht das mit der Tastenkombination Strg+A) und startet den Upload.

Im Folgenden wird unterschieden zwischen einer Neu- und einer Update-Installation:

a) Neuinstallation

Wenn das Blog-System zum ersten Mal auf diesem Webserver bzw. in diesem Verzeichnis
installiert wird, sollte eine Neuinstallation durchgeführt werden. Hierzu öffnet
man im SFTP-Programm das lokale Verzeichnis "install" der entpackten ZIP-Datei.
Dann wechselt man ins Unterverzeichnis "common" und lädt dessen Inhalt komplett
auf den Webserver hoch. Zuletzt lädt man noch die Inhalte *eines* der beiden
Unterverzeichnisse "de" oder "en" hoch - je nachdem, in welcher Sprache (Deutsch
oder Englisch) man das Blog-System nutzen möchte.

b) Update-Installation

Wurde das Blog-System bereits installiert und man möchte es auf eine neue Version
aktualisieren, empfiehlt sich eine Update-Installation. Dabei werden nur Dateien
aktualisiert, die normalerweise nicht vom Benutzer verändert werden.

Vor einem Update empfiehlt es sich auf jeden Fall, ein Backup zu erstellen (im
Editor des Blog-Systems unter "Öffnen > Auflisten: Backup > Button: Erstellen").

Das Vorgehen beim Update entspricht dem einer Neuinstallation, jedoch mit dem
Unterschied, dass sich die hochzuladenden Unterverzeichnisse nicht im Verzeichnis
"install" der entpackten ZIP-Datei befinden, sondern im Verzeichnis "update".

Nun sollte die Website durch Eingabe der Adresse (z.B. „beispiel.de“) im Browser
aufgerufen werden können. Dort wird ein Text mit weiteren Informationen zur
Ersteinrichtung des Blog-Systems angezeigt.


1.3. Automatische Installation unter Windows
--------------------------------------------

Hierzu startet man den heruntergeladen Installer "install-blog-v[…].exe" und
bestätigt die Meldung "Do you want to install Blog System Version […]?" mit OK.
Die enthaltenen Dateien werden nun in ein temporäres Verzeichnis entpackt und
das eigentliche Installationsprogramm gestartet. Alternativ kann man auch die
Datei "install.bat" aus der heruntergeladenen und entpackten ZIP-Datei
"install-blog-v[…].zip" ausführen.

Wenn der Installer das erste Mal aufgerufen wurde und noch keine Daten eingegeben
wurden, werden nun die oben unter "Allgemeine Hinweise" genannten Daten
(Sprache, Webserver-Adresse, Installationsverzeichnis, Benutzername, Passwort)
abgefragt. Nach Eingabe der Daten wird ein Auswahlmenü angezeigt:

L = Inhalt des Installationsverzeichnisses anzeigen
N = Neuinstallation
U = Update-Installation
H = Zugriffsschutz entfernen (löscht die .htaccess-Datei)
E = Eingegebene Werte ändern
I = Info (zeigt die "Readme"-Datei an)
X = Beenden

Die Auswahl einer Funktion erfolgt durch Eingabe des angegebenen Buchstabens und
der Enter-Taste.

Es ist ratsam, sich zuerst den Inhalt des Installationsverzeichnisses anzeigen
zu lassen, um sich zu vergewissern, dass man das richtige Verzeichnis angegeben
hat. Außerdem wird so auch gleich geprüft, ob die SFTP-Verbindung zum Webserver
funktioniert. Falls es hier zu einer Fehlermeldung kommt, kann man die 
Verbindungsdaten durch Eingabe von E korrigieren.

Wenn das Blog-System zum ersten Mal auf diesem Webserver bzw. in diesem Verzeichnis
installiert wird, sollte eine Neuinstallation durchgeführt werden. Dabei werden
alle erforderlichen Dateien in das angegebene Installationsverzeichnis auf den
Webspace hochgeladen.

Wurde das Blog-System bereits installiert und man möchte es auf eine neue Version
aktualisieren, sollte eine Update-Installation durchgeführt werden. Bei einem
Update werden nur Dateien installiert, die normalerweise nicht vom Benutzer
verändert werden. Vor einem Update empfiehlt es sich auf jeden Fall, ein Backup
zu erstellen (im Editor unter "Öffnen > Auflisten: Backup > Button: Erstellen").

Die Funktion "H = Zugriffsschutz entfernen" ist hilfreich, falls man einmal das
Passwort für den Zugriffsschutz vergessen hat oder sich durch Eingabe falscher
Werte selber ausgeschlossen hat. Diese Funktion löscht die Datei lib/.htaccess.

Durch Eingabe von "X" wird der Installer beendet. Falls anschließend eine
Windows-Meldung "Programmkompatibilitätsassistent" aufpoppt, kann diese
ignoriert bzw. geschlossen werden.


2. Versionshinweise
===================

Version 1.8.0 (2026-03-03)

- Neu: Bildbetrachter (ImageViewer). Wird aktiviert via Snippet oder durch Einfügen
  der Bilder in eine FIGURE oder DIV mit class="viewer".
- Neu: Bildraster (ImageGrid), um Bilder als Thumbnails im Raster anzuordnen. Wird
  aktiviert via Snippet oder durch Einfügen in ein DIV mit class="image-grid".
- Neu: Snippets zum Auskommentieren von Inline-Text und Zeilen.
- Geändert: Snippets umorganisiert/umbenannt und Tooltips mit Hinweisen hinzugefügt.
- Geändert: Snippets zur Übersetzung von Link/Seite: Keine Angabe der Quellsprache
  mehr erforderlich; standardmäßig wird die Sprache des HTML-Dokuments verwendet.
- Geändert: Erweiterung des Website-Statistik-Scripts und Möglichkeit, das Logging
  eigener Seiteaufrufe zu deaktivieren.
- Kleinere Bugfixes.

Version 1.7.0 (2026-02-01)

- Neu: Gästebuch
- Neu: Umschaltung des Farb-Designs (Automatisch, Hell, Dunkel).
- Neu: RSS-Feed (incl. Widget)
- Neu: Mehrsprachige Artikel mit automatischer Umschaltung der Sprache.
- Neu: Snippets "Zentriert nebeneinander" und "Mehrsprachiger Artikel".
- Geändert: Titel und Beschreibung im HTML-Header der Artikel.
- Bugfix: Kategorie- und Schlagwort-Links unter dem Artikel waren fehlerhaft,
  wenn die Seite vom Typ "index" nicht die Startseite (Dateiname "index") war.
- Bugfix: "Hüpfen" der Seite beim Laden durch Initialisierung des Menüs.
- Bugfix: Table-Sorter korrigiert (lib/tableSorter.js).
- Weitere kleinere Bugfixes (z.B. Editor).

Version 1.6.0 (30.12.2025)

- Neu: Snippets "Artikel-Card intern", "Website-Card extern", "Audioclip für
  Playlist" und "Bereich aufklappbar".
- Geändert: HTML-Metadaten für Keywords, Website-Name, Artikel-Veröffentlichungs-
  und Aktualisierungs-Datum sowie Generator hinzugefügt.
- Geändert: Farbschema (light/dark) konfigurierbar gemacht.
- Bugfix: Kontaktformular XSS-sicher gemacht.

Version 1.5.0 (20.05.2025)

- Neu: Snippets "Tooltip" und "Kein automat. Umbruch".
- Geändert: Default-Stylesheet angepasst.
- Bugfix: Pfade in der sitemap.xml korrigiert.

Version 1.4.0 (04.07.2024)

- Neu: Archiv-Widget zur Auswahl der Artikel nach Jahr und Monat.
- Neu: Übersetzungs-Widget zur Übersetzung der Website in eine andere Sprache.

Version 1.3.0 (27.06.2024)

- Neu: Editor: "Veröffentlicht"-Flag für Artikel-Eigenschaften.
- Geändert: Nur veröffentlichte Artikel sind in Sitemap und Widgets enthalten.

Version 1.2.0 (26.06.2024)

- Neu: Print-Style zum Ausdrucken von Artikeln.
- Neu: Kontaktformular: Administrative Angaben sind nun ebenfalls mehrsprachig.

Version 1.1.0 (25.06.2024)

- Neu: Editor: Dark-Modus.

Version 1.0.1 (22.06.2024)

- Bugfix: Editor: Backup-Dialog: Button "Start" wird nun korrekt initialisiert.

Version 1.0 (21.06.2024)

- Erstveröffentlichung

