Bludit Dokumentation

Installation on GNU/Linux

So, 19 Sep 2021 22:10:24 +0200

All examples are out of the box installation, with Nginx Webserver. If you have the steps for other distributions, you can publish it on the forum or just edit this page on Github, you can find a button at the end of the page with the link.

Content

Installation on Ubuntu 16.04 LTS

Considerations:

PHP-FPM is running under the username www-data.
PHP-FPM is listen on Unix socket on unix:/run/php/php7.0-fpm.sock.
Nginx is running under the username www-data.
You don't have installed any other webserver.
This is a basic configuration, considere read more for production environments.

Install Nginx Webserver, PHP and some tools.

$ sudo apt install -y nginx php-fpm php-dom php-mbstring php-cli php-gd php-opcache unzip wget

Configure Nginx.

$ sudo rm -f /etc/nginx/sites-enabled/*

Add a new file with the virtual server block in /etc/nginx/conf.d/bludit.conf

server {
    listen 80;
    server_name _;
    root /www/bludit;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass    unix:/run/php/php7.0-fpm.sock;
        include         fastcgi.conf;
    }

    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}

Download the latest version of Bludit and uncompress it.

$ mkdir /www
$ cd /www
$ wget https://s3.amazonaws.com/bludit-s3/bludit-builds/bludit_latest.zip
$ unzip bludit_latest.zip
$ sudo chown -R www-data:www-data /www

Restart the services to load the new configurations.

$ sudo service php7.0-fpm restart
$ sudo service nginx restart

Open your browser and navigate to http://localhost, finish with the installation.

Installation on Centos 7 / Red Hat 7

Considerations:

PHP-FPM is running under the username nginx.
PHP-FPM is listen on Unix socket on unix:/run/php/php-fpm.sock.
Nginx is running under the username nginx.
You don't have installed any other webserver.
This is a basic configuration, considere read more for production environments.

$ sudo yum install -y epel-release

Install Nginx Webserver, PHP and some tools.

$ yum install -y nginx php-fpm php-cli php-dom php-mbstring php-zip php-gd

Configure Nginx, add a new file with the virtual server block in /etc/nginx/conf.d/bludit.conf

server {
    listen 80;
    server_name _;
    root /www/bludit;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass    unix:/run/php/php7.0-fpm.sock;
        include         fastcgi.conf;
    }

    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}

Download the latest version of Bludit and uncompress it.

$ mkdir /www
$ cd /www
$ wget https://s3.amazonaws.com/bludit-s3/bludit-builds/bludit_latest.zip
$ unzip bludit_latest.zip
$ sudo chown -R nginx:nginx /www

Restart the services to load the new configurations.

$ sudo systemctl php-fpm restart
$ sudo systemctl nginx restart

Open your browser and navigate to http://localhost, finish with the installation.

Grundlagen

So, 19 Sep 2021 22:10:24 +0200

Plugins befinden sich bei Bludit im Verzeichnis bl-plugins und haben eine vordefinierte Verzeichnis- und Dateistruktur. Jedes Plugin ist in Bludit als Objekt mit Hooks (Methoden) dargstellt und ansprechbar.

Inhalt

Hello World

Das "Hello World" Plugin für Bludit.

Plugin Struktur

Das ist die vorgegebene Verzeichnis- und Dateistruktur für ein Plugin.

/bl-plugins/{PLUGIN_NAME}/
    language/en.php
    metadata.json
    plugin.php

Informationen über das Plugin

Die Informationen über das Plugin befinden sich in der JSON-Datei metadata.json.

{
    "author": "Bludit",
    "email": "",
    "website": "https://plugins.bludit.com",
    "version": "2.0",
    "releaseDate": "2017-10-10",
    "license": "MIT",
    "compatible": "2.0",
    "notes": ""
}

Name und Beschreibung

Der Name und die Beschreibung des Plugins befinden sich in der JSON-Datei languages/en.json.

{
    "plugin-data":
    {
        "name": "Hello World",
        "description": "Print Hello World in the sidebar"
    }
}

Beispiele

Wir haben ein Gibhub-Repository mit Beispielen, welches du unter folgendem Link findest: Bludit Beispiele.

"Weiterlesen"-Link

So, 19 Sep 2021 22:10:24 +0200

Du kannst den Inhalt deiner Seite mit dem Tag  aufteilen

Beispiel:

This is the first part of the content of the page.

<!-- pagebreak -->

This is the second part of the page.

Video tutorial

Youtube

Anmerkung

Diese Funktion ist abhängig vom eingesetzten Theme. Nicht alle unterstützen diese Funktion.

Bild einfügen

So, 19 Sep 2021 22:10:24 +0200

Beim Erstellen oder Bearbeiten einer Seite kannst du über die rechte Sidebar ein Bild hochladen und danach in den Seiteninhalt einfügen.

Öffne den Abschnitt Bilder auf der rechten Sidebar.
Auf den Button Upload weitere Bilder klicken
Auf den Button Bild hochladen klicken
Wähle das Bild auf deiner Festplatte aus
Nachdem das Bild hochgeladen wurde wird eine kleine Vorschau des Bildes angezeigt. Mit einem Klick kannst du es auswählen.
Wähle Bild einfügen
Das Bild ist nun eingefügt.

Anmerkung

Der eingefügte Code kann sich je nach Editor unterscheiden. Standardmäßig wird Markdown Code erzeugt.

Editor wechseln

So, 19 Sep 2021 22:10:24 +0200

Bludit verwendet standardmäßig den Editor SimpleMDE, einen einfachen und übersichtlichen Editor für Markdown Code. Man kann auch den Editor TinyMCE verwenden, der die einfache Erstellung und Bearbeitung von HTML Code ermöglicht. Diese beiden Editoren sind bei Bludit vorinstalliert und unter Plugins aufgelistet.

Umstellung auf TinyMCE

Melde dich im Administrationsbereich an.
Wähle Plugins in der linken Seitenleiste.
Deaktiviere das Plugin SimpleMDE.
Aktiviere das Plugin TinyMCE.
Jetzt kannst du TinyMCE als Editor verwenden.

Inhalt erstellen

So, 19 Sep 2021 22:10:24 +0200

Logge dich in den Admin Bereich ein und klicke auf den Punkt Neuer Inhalt im linken Menü.

Fülle alle Felder aus und speichere deinen Beitrag mit einem Klick auf den Button Speichern.

Hinweis

Der Inhalt unterstützt Markdown und HTML-Code.

Editor

Bludit verwendet standardmäßig den Editor SimpleMDE, du kannst aber auch TinyMCE oder einen anderen Editor benutzen. Wie man den Editor wechselt

Markdown

Weitere Informationen zum Markdown Code findest du unter dem folgenden Link: Markdown Cheatsheet oder Markdown auf der Website Planet Bludit.

Beispiel: Mein erstes Theme

So, 19 Sep 2021 22:10:24 +0200

Nachfolgend erstellen wir ein neues, einfaches Theme mit dem Namen 'Coffee'.

Erstelle das Theme-Verzeichnis im Verzeichnis /bl-themes/, in unserem Fall /bl-themes/coffee/
Erstelle das Verzeichnis languages im Theme-Verzeichnis /bl-themes/coffee/
Erstelle die Datei en.json im Verzeichnis /bl-themes/coffee/languages/
Erstelle die Datei metadata.json im Verzeichnis /bl-themes/coffee/
Erstelle die Datei index.php im Verzeichnis /bl-themes/coffee/

Die Verzeichnisstruktur mit den eben erstellten Dateien muss jetzt so aussehen:

/bl-themes/coffee/
    language/en.json
    metadata.json
    index.php

Im nächsten Schritt erstellen wir den Inhalt der Dateien. Wir beginnen mit der Datei index.php und fügen dieser folgenden HTML und PHP Code zu.

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>Bludit</title>
    </head>
    <body>
        <?php foreach ($pages as $Page): ?>

        <h1><?php echo $Page->title() ?></h1>
        <div><?php echo $Page->content() ?></div>

        <hr>

        <?php endforeach; ?>
    </body>
</html>

Bearbeite jetzt die Datei languages/en.json um den Namen und die Beschreibung des Themes hinzuzufügen.

{
    "theme-data":
    {
        "name": "Coffee",
        "description": "This is my first theme for Bludit."
    }
}

Jetzt bearbeiten wir die Datei metadata.json um die Informationen über das Theme zu vervollständigen.

{
    "author": "Bludit",
    "email": "",
    "website": "",
    "version": "1.0",
    "releaseDate": "2017-10-10",
    "license": "MIT",
    "compatible": "2.0",
    "notes": ""
}

Herzlichen Glückwunsch, du hast soeben dein erstes Theme für Bludit erstellt!

Beispiele

Wir haben ein Gibhub-Repository mit Beispielen, welches du unter folgendem Link findest: Bludit Theme Beispiele.

Plugins

So, 19 Sep 2021 22:10:24 +0200

Mit Plugins können die Funktionen von Bludit erweitert werden.

Einige Plugins sind standardmässig installiert. Nicht alle sind jedoch aktiviert.

Weitere Plugins können von der Seite Bludit Plugins heruntergeladen werden.

Plugin installieren

Das ZIP-Archiv mit dem Plugin herunterladen.
Das ZIP-Archiv entpacken.
Das entpackte ZIP-Archiv in den Ordner '/bl-plugins/' auf dem Server laden.

Plugin aktivieren und konfigurieren

Im Admin-Bereich in der linken Seitenleiste unter "Einstellungen" den Menüpunkt Plugins klicken.
Beim Plugin, das verwendet werden soll, Aktivieren klicken.
Die meisten Plugins können durch Anklicken von Einstellungen den eigenen Bedürfnissen angepasst werden.

Hiawatha

So, 19 Sep 2021 22:10:24 +0200

Bludit suppors Hiawatha webserver, you can use the following rewrite rule:

UrlToolkit {
    ToolkitID = bludit
    RequestURI exists Return
    Match [^?]*(\?.*)? Rewrite /index.php$1
}

Installation

So, 19 Sep 2021 22:10:24 +0200

Bludit ist in wenigen Schtitten installiert:

Lade die neueste Version von Bludit von der offiziellen Website herunter.
Entpacke das ZIP-Archiv.
Lade den Inhalt des ZIP-Archivs in das Verzeichnis auf deinem Server, in dem du Bludit installieren möchtest. Das kann im Hauptverzeichnis sein (root) oder in einem Unterverzeichnis wie beispielsweise /bludit.
Rufe im Browser die Domain mit der Installation auf. Befindet sie im Hauptverzeichnis https://meinedomain.ch, wenn sie sich in einem Unterverzeichnis befindet beispielsweise https://meinedomain.ch/bludit.
Der Bludit-Installer führt dich darauf durch die Einrichtung der Website.

Installation in einem Unterverzeichnis

Wird Bludit in einem Unterverzeichnis eingerichtet, muss bei einigen Hostern die Datei .htaccess im Installationsverzeichnis angepasst werden.

Wird Bludit beispielsweise im Unterverzeichnis bludit installiert, muss in diesem Falle die Datei .htaccess wie folgt angepasst werden (Zeile 9):

# Base directory
RewriteBase /bludit/

IIS (Internet Information Services)

Für die Installation mit IIS (Internet Information Services, früher: Internet Information Server) von Microsoft muss die Datei .htaccess angepasst werden.

Beispielsweise:

<rules> 
   <rule name="Rule1" stopProcessing="true">
      <match url="^(.*)$" ignoreCase="false" />
         <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
            <add input="{URL}" pattern="^/favicon.ico$" ignoreCase="false" negate="true" />
         </conditions>
      <action type="Rewrite" url="index.php?q={R:1}" appendQueryString="true" />
   </rule>
</rules>

Zeitzone

Bludit versucht deine Zeitzone automatisch zu ermitteln. Es empfiehlt sich aber, die Einstellung der Zeitzone nach der Installation im Administrationsbereich unter Einstellungen > Sprache/Zeitzone > Zeitzone zu überprüfen.

Dateien auf den Server laden

Um die Dateien auf den Server zu laden, kannst du einen FTP- oder SFTP-Prograamm (FTP-Client) oder WebFTP verwenden. Weitere Informationen dazu findest du beispielsweise auf der Website Planet Bludit unter File Transfer (FTP und SFTP).