Jump to content
MediaWiki

Erweiterung:3D

From mediawiki.org
This page is a translated version of the page Extension:3D and the translation is 97% complete.
Outdated translations are marked like this.
Support level: Pending
The support level for this extension is currently under review. The Reader Growth Team is the maintainer of last resort for the time being.
MediaWiki-Erweiterungen
3D
Freigabestatus: Beta
Einbindung Medien
Beschreibung Bietet Unterstützung für 3D-Dateiformate.
Autor(en)
Letzte Version 0.0.1
Kompatibilitätspolitik Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
  • $wgMax3d2pngMemory
  • $wg3dProcessEnviron
  • $wgAjaxPatentPreview
Licence GNU General Public License 2.0 oder neuer
Herunterladen
Hilfe Help:Extension:3D/de
Vagrant-Rolle three_d
Probleme Offene Aufgaben · Einen Fehler melden

Die 3D-Erweiterung bietet dem Nutzer eines Wikis Unterstützung beim Hochladen und Betrachten von 3D-Modellen. Siehe Hilfe:Erweiterung:3D für Dokumentation zur Verwendung.

Es unterstützt derzeit das STL-Dateiformat, das im 3D-Druckbereich üblich ist.

Installation

Erlaube 3D-Datei-Uploads

Sag MediaWiki, dass es STL-Uploads verarbeiten kann. Füge dies zu deinem LocalSettings.php:

$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';

Installiere Erweiterung:3D

  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens 3D im Ordner extensions/ ablegen.
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    wfLoadExtension( '3D' );
    
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

3d2png installieren

3d2png ist der Thumbnail-Renderer für 3D-Dateien. Er rendert png-Thumbnails genau so, wie diese Erweiterung die Objekte anzeigt, indem er die gleichen JS-Bibliotheken verwendet, die in Node.js statt im Browser laufen.

Um zu installieren, klone und aktiviere das 3d2png-Repository:

gitclonehttps://gerrit.wikimedia.org/r/3d2png
cd3d2png
npminstall

Unter Linux musst du zudem einen virtuellen Framebuffer installieren, damit 3d2png das 3D-Objekt kopflos erfassen kann.

apt-getinstallxvfb

Nachdem wir 3d2png erfolgreich installiert haben, müssen wir Extension:3D mitteilen, wie der Thumbnail-Generatordienst aufgerufen werden soll. Füge dies zu deinen LocalSettings.php hinzu und stelle sicher, dass du die Pfade an deine Konfiguration anpasst:

$wg3dProcessor = [
 '/usr/bin/xvfb-run',
 '-a',
 '-s',
 '-ac -screen 0 1280x1024x24',
 '/path-to-your-repository/3d2png.js'
];

Installiere Erweiterung:MultimediaViewer

MultimediaViewer ist keine feste Abhängigkeit von der 3D-Erweiterung, du musst ihn jedoch installieren, wenn du mit den 3D-Modellen interagieren (verschieben, schwenken, zoomen) willst. Nach der Installation des MultimediaViewers musst du den STL-Dateityp mit der richtigen Viewer-Erweiterung verknüpfen, indem du diese in deine LocalSettings.php-Datei einfügst:

$wgMediaViewerExtensions['stl'] = 'mmv.3d';

Konfiguration

Patentvereinbarung

Spezial:Upload

Um die Auswahlmöglichkeiten für Patentvereinbarungen zu Spezial:Upload hinzuzufügen, bearbeite die MediaWiki:3d-patents-Seite deines Wikis. Jede Zeile auf dieser Seite wird in eine <Option> umgewandelt, wobei alles nach dem letzten |-Zeichen der Text und alles davor die Vorlage ist, die dem Upload-Inhalt hinzugefügt wird. Ein Beispiel dafür ist commons:MediaWiki:3d-patents.

Stelle sicher, dass du die Vorlage(n) durchführst, die dem Inhalt hinzugefügt wird (werden). z.B. Template:3dpatent

Spezial:UploadWizard

Spezial:UploadWizard unterstützt zudem Patentvereinbarungen, wenn auch etwas weniger flexibel. Wenn du eine STL-Datei eines Drittanbieters hochlädst, wird ein Dialog angezeigt, der bestätigt, dass dein Upload keine Patente verletzt. Wenn du ein eigenes hochlädst, musst du zudem bestätigen, dass es sich bei den abgebildeten 3D-Objekten um dein eigenes Werk handelt. Die Vorlage, die dem Upload-Inhalt hinzugefügt wird, kostet {{3dpatent}} bzw. {{3dpatent|ownwork}}.

Um die Formulierung dieser Nachrichten zu ändern, können diese Seiten geändert werden: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Um zu ändern, für welche Dateitypen eine Patentvereinbarung erforderlich ist, welche Vorlage zum Upload-Inhalt hinzugefügt wird oder wohin die URLs zeigen, ändere LocalSettings.php. Unten sind die Standardeinstellungen:

$wgUploadWizardConfig['patents'] = [
	'extensions' => [ 'stl' ],
	'template' => '3dpatent',
	'url' => [
		'legalcode' => '//wikimediafoundation.org/wiki/Wikimedia_3D_file_patent_license',
		'warranty' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'license' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
		'weapons' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing#Weapons',
	],
];

Erweiterung:CommonsMetadata

Und schließlich bietet Erweiterung:CommonsMetadata eine Möglichkeit, 3D-Uploads ohne die besagte Patentlizenz zu verfolgen, die allerdings nicht konfigurierbar ist. Es wird nur nach Uploads mit dem Mime-Typ application/sla (derzeit die einzigen, die von Extension:3D unterstützt werden) gesucht, denen die Vorlage 3dpatent fehlt. Passende Dateien, die diese Vorlage nicht in ihrem Inhalt haben, werden automatisch zu Category:Files_with_no_machine-readable_patent hinzugefügt.

Wenn du eine andere Vorlage als 3dpatent verwendest, wird dir das nichts nützen, da dies derzeit nicht konfigurierbar ist.

Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt.
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet:

AltStyle によって変換されたページ (->オリジナル) /