Diese Erweiterung ist derzeit Teil der BlueSpice Roadmap und befindet sich in der Entwicklung.
Anzeige von Office-Dateien[Bearbeiten | Quelltext bearbeiten]
Diese Funktion ermöglicht es, Microsoft Office- und OpenDocument-Dateien, die an eine Wiki-Seite angehängt sind, direkt als Vorschaubild (Thumbnail) im Wiki anzuzeigen. Die Dokumente werden seitenweise gerendert, sodass Benutzer einzelne Seiten eines mehrseitigen Dokuments betrachten können, ohne das Originaldokument herunterladen oder eine externe Anwendung öffnen zu müssen.
Neben den klassischen Microsoft-Formaten (DOC, XLS, PPT) werden auch die modernen OOXML-Formate (DOCX, XLSX, PPTX) sowie OpenDocument-Formate (ODT, ODS, ODP) unterstützt. Damit wird ein Ersatz für einen Teil des Confluence OfficeConnectors geschaffen.
| Begriff | Definition |
|---|---|
| MediaHandler | MediaWiki-Komponente, die für einen bestimmten MIME-Typ die Darstellung (Thumbnails, Metadaten) übernimmt. |
| Backend-Service | Eigenständiger Microservice, der Office-Dokumente via z. B. LibreOffice in Bilder konvertiert. |
| Thumbnail | Vorschaubild einer einzelnen Dokumentseite in einem vom Wiki darstellbaren Bildformat (z. B. JPEG). |
Beschreibung des Features[Bearbeiten | Quelltext bearbeiten]
Unterstützte Dateiformate[Bearbeiten | Quelltext bearbeiten]
Die Erweiterung registriert MediaHandler für die folgenden MIME-Typen:
| Kategorie | Format | Dateierweiterung | MIME-Typ |
|---|---|---|---|
| Textverarbeitung | Microsoft Word (alt) | .doc
|
application/msword
|
| Textverarbeitung | Microsoft Word (OOXML) | .docx
|
application/vnd.openxmlformats-officedocument.wordprocessingml.document
|
| Textverarbeitung | OpenDocument Text | .odt
|
application/vnd.oasis.opendocument.text
|
| Tabellenkalkulation | Microsoft Excel (alt) | .xls
|
application/vnd.ms-excel
|
| Tabellenkalkulation | Microsoft Excel (OOXML) | .xlsx
|
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
|
| Tabellenkalkulation | OpenDocument Spreadsheet | .ods
|
application/vnd.oasis.opendocument.spreadsheet
|
| Präsentation | Microsoft PowerPoint (alt) | .ppt
|
application/vnd.ms-powerpoint
|
| Präsentation | Microsoft PowerPoint (OOXML) | .pptx
|
application/vnd.openxmlformats-officedocument.presentationml.presentation
|
| Präsentation | OpenDocument Presentation | .odp
|
application/vnd.oasis.opendocument.presentation
|
Funktionsweise[Bearbeiten | Quelltext bearbeiten]
- Upload: Bei der Installation werden die oben genannten Dateiendungen automatisch zur Upload-Whitelist hinzugefügt, sodass Benutzer Office-Dokumente hochladen können.
- Metadaten-Ermittlung: Beim Upload wird das Dokument an den Backend-Service gesendet. Dieser liefert Seitenanzahl und Seitenabmessungen als JSON zurück. Falls der Service nicht erreichbar ist, werden Fallback-Werte verwendet.
- Thumbnail-Erzeugung: Wenn ein Vorschaubild einer bestimmten Seite angefordert wird, sendet die Erweiterung das Dokument via HTTP-Anfrage an den Backend-Service mit den Parametern Seitennummer, Ausgabeformat (JPEG) und gewünschter Größe. Das zurückgelieferte Bild wird als Thumbnail gespeichert und über die MediaWiki-Thumbnail-Infrastruktur ausgeliefert.
- Mehrseitige Dokumente: Die Erweiterung unterstützt die Navigation durch mehrseitige Dokumente (z. B. PowerPoint-Präsentationen, mehrseitige Word-Dokumente) analog zur bereits existierenden Erweiterung PdfHandler.
- Caching: Metadaten (Seitenanzahl) werden über den MediaWiki-WANObjectCache mit einer TTL von einem Monat gecacht. Thumbnails werden im MediaWiki-Thumbnail-Cache gespeichert und bei erneutem Aufruf direkt ausgeliefert.
Bearbeitung von Office-Dateien[Bearbeiten | Quelltext bearbeiten]
Die Erweiterung bietet die Funktion, Office-Dokumente (Word, Excel, PowerPoint) direkt aus dem Wiki heraus zu bearbeiten und die Änderungen automatisch als neue Dateiversion zurück ins Wiki speichern tz können. Es werden zwei sich ergänzende Integrationswege umgesetzt:
- WebDAV + MS Office URI Schemes – Öffnet Dateien in der lokal installierten Microsoft Office Anwendung (Word, Excel, PowerPoint). Geeignet für Umgebungen mit Microsoft Office Desktop-Clients.
- WOPI (Web Application Open Platform Interface) – Öffnet Dateien in einem webbasierten Editor direkt im Browser. Unterstützt werden Collabora Online und OnlyOffice Docs als Editor-Anwendungen. Geeignet für heterogene Umgebungen und Szenarien ohne lokale Office-Installation.
| Begriff | Definition |
|---|---|
| WebDAV | Web Distributed Authoring and Versioning – ein Netzwerkprotokoll (RFC 4918) zur Bereitstellung von Dateien über HTTP(S), das Lesen, Schreiben und Sperren unterstützt. |
| WOPI | Web Application Open Platform Interface – ein REST-basiertes Protokoll zur Anbindung von webbasierten Dokumenten-Editoren an einen Datei-Speicher. |
| MS Office URI Schemes | Von Microsoft definierte Protokoll-Handler (z.B. ms-word:), die es ermöglichen, Office-Anwendungen über einen Link im Browser zu starten.
|
| Collabora Online | Ein quelloffener, webbasierter Office-Editor auf Basis von LibreOffice. Wird als Dienst neben dem Wiki betrieben. |
| OnlyOffice Docs | Ein quelloffener, webbasierter Office-Editor. Wird als Dienst neben dem Wiki betrieben. |
| Locking (Dateisperre) | Mechanismus, der verhindert, dass mehrere Benutzer gleichzeitig dieselbe Datei überschreiben. |
| Dateiversion / Revision | Jede Speicherung einer Datei erzeugt eine neue Version. Ältere Versionen bleiben im Wiki nachvollziehbar erhalten. |
