Über das Wiki
Bookstack
Wir nutzen das Open-Source Projekt Bookstack https://www.bookstackapp.com/ von Dan Brown. Um das Projekt zu unterstützen, haben wir den Professional-Support-Plan abgeschlossen. Das Projekt wird aktiv entwickelt, es erscheinen regelmäßig neue Versionen.
Bookstack ist ziemlich geradeaus und nutzt eine feste Struktur: Regal, Buch, Kapitel, Seite. Wir nutzen derzeit keine Regale. Regale sind "nur" ein Ordnungsmerkmal. Anders als bei Bücher, Kapitel und Seiten, können Regalen keine Rechte zugeordnet werden.
Zugriff / Benutzerkonten
Die meisten Bücher werden nicht öffentlich sein. Alle von uns erhalten eine Einladung um ein Konto zu aktivieren. Man sieht dann nur öffentliche Bücher oder welche auf die man Zugriff hat. In Zukunft werden wir uns mit dem Konto aus dem AD authentifizieren, vorerst nutzen wir separate Konten.
Obwohl wir das Wiki unter einer öffentlichen Domain in einem Rechenzentrum hosten, ist der Zugriff derzeit nur von unserem Netzwerk in der Julius-Allgeyer-Straße aufrufbar. Ob und wie wir den Zugriff öffentlich erlauben ist noch nicht entschieden.
Export / Import
Bookstack kann Inhalte als HTML, PDF, Text oder Text mit Markdown-Markierungen exportieren. Inhalte können aus als ZIP-Datei exportiert werden. Das ist dafür gedacht, um Dateien zwischen Bookstack-Instanzen auszutauschen.
Import ist grundsätzlich per Copy & Paste möglich. Darüberhinaus haben wir einen Konverter eingebunden, der nicht verschlüsselte Word-Dateien (*.docx) direkt per Drag & Drop importieren kann. Dieser Import läuft direkt per Javascript im Browser. Beim Import erscheint am oberen Rand des Editor eine Fehlermeldung, dass das Format nicht unterstützt ist. Das kann ignoriert werden. Diese Meldung ist vom Standardeditor, der weiß nichts vom dem Javascript für die Konvertierung.
Für den Import nutzen wir Mammoth von Michael Williamson (https://github.com/mwilliamson/mammoth.js). Wir verwenden die aktuelle Version 1.11.0 und hosten diese selber. So verlassen ganz sicher keine Daten unser Netzwerk. Die Authentizität des Javascript wurde über 3 verschiedene Quellen geprüft. Direkt aus dem NPM-Package und über die NPM-Bereitstellungen von Cloudflare und JSDelivr.
https://cdnjs.cloudflare.com/ajax/libs/mammoth/1.11.0/mammoth.browser.js
https://cdn.jsdelivr.net/npm/mammoth@1.11.0/mammoth.browser.js
SHA1: e33cc6ce2b0acafb0141f24f03efd2de3a2219e2 mammoth.browser.js
Benachrichtigungen
Es können einzelne Seiten oder auch ganze Bücher "beobachtet" werden. D. h. bei Änderungen wird man per Email benachrichtigt. Nachdem man auf "beobachten" geklickt hat, wird der Beobachtungsstatus in den Seiten- oder Buchdetails angezeigt. Da lassen sich dann noch zusätzliche Einstellungen vornehmen.
Ein paar technische Details
Bookstack läuft auf einem Ubuntu-Server 24.04.3 LTS mit einer MySql-Datenbank und nutzt PHP/Laravel. Die VM läuft bei der mitteldeutschen IT in einer KVM-Umgebung. Als Zertifikat nutzen wir Let's Encrypt, das über Certbot automatisch erneuert wird.
Was dieses Wiki nicht ist
Dieses Wiki ist kein Ersatz für Office, Teams, OneNote, OneDrive und soll auch kein Kollaborationstool oder Aufgabenplanungstool sein. Es ist ein Ort an dem Informationen abgelegt werden, die einer Gruppe von Personen einfach zugänglich sein soll. Das Wiki ist ein weiteres Werkzeug, das sich wie viele Tools mit anderen überschneidet.
Bekannte Limitationen
- Die Breite der erfassten Inhalte kann die fest vorgegebene Breite im Editor nicht überschreiten.
- Es gibt keine vorgefertigte Blogfunktion. Stattdessen verwenden wir Bücher deren Einträge nach Anlagedatum absteigend sortiert sind. Solche News- oder Blogbücher werden mit dem Tag "autochapter" versehen. Bücher die so markiert sind, werden automatisch 1x täglich mit einem kleinen Python-Script so umsortiert, dass pro Monat ein Kapitel mit den entsprechenden Inhalten vorhanden ist.