Version vom 7. Oktober 2026, 13:43 Uhr von Margit Link-Rodrigue (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „{{BSVersion|info=roadmap}} 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,…“)
Diese Erweiterung ist derzeit Teil der BlueSpice Roadmap und befindet sich in der Entwicklung.
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.
