Kiterjesztés:3D

MediaWiki-kiterjesztések kézikönyve

3D Kiadási állapot: béta
Megvalósítás	Média
Leírás	3D-fájlformátumok támogatása.
Szerző(k)	Gilles Dubuc Matthias Mullie Mark Holmquist
Legfrissebb verzió	0.0.1
Kompatibilitási irányelv	Snapshots releases along with MediaWiki. Master is not backward compatible.
Licenc	GNU General Public License 2.0 or later
Letöltés	Kiterjesztés letöltése Git [?]: tároló böngészése (GitHub) kódellenőrzés verziótörténet Download source tarball
Paraméterek $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Hooks used BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Vagrant-szerep	three_d
Problémák	Nyitott feladatok · Hibajelentés

A 3D kiterjesztéssel a felhasználók 3D-modelleket tölthetnek fel és tekinthetnek meg. A használati útmutatót lásd a Help:Extension:3D lapon.

A kiterjesztés jelenleg a 3D-nyomtatásban leginkább elterjedt STD formátumot. támogatja.

Telepítés

3D-modellek feltöltésének engedélyezése

Add hozzá a következő kódot a LocalSettings.php-hoz, így a MediaWiki kezelni tudja az STL-fájlokat:

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

A kiterjesztés telepítése

• Töltsd le a kiterjesztés fájljait, és mentsd el az extensions/ mappán belüli 3D könyvtárba.
• Add hozzá az alábbi kódot a LocalSettings.php fájlod aljára:

  wfLoadExtension( '3D' );
  

• Kész – A Special:Version oldalon ellenőrizheted, hogy a kiterjesztés ténylegesen feltelepült-e.

A 3d2png telepítése

A 3d2png a 3D-fájlok feldolgozásához használt eszköz, amely a modellek PNG-előnézetének megjelenítését teszi lehetővé a megegyező JS-könyvtárakkal, amelyek a böngésző helyett a Node.js-ben futnak.

A telepítéshez klónozni és aktiválni kell a 3d2png repozitóriumot:

git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install

Linuxon virtuális framebuffer telepítésére is szükség van ahhoz, hogy a 3D-objektumot a 3d2png pontosan leképezze képernyőn való megjelenés nélkül.

apt-get install xvfb

A 3d2png telepítése után a 3D kiterjesztésben be kell állítani a meghívás módját. Add hozzá a következőt a LocalSettings.php-hez (ne felejtsd el az elérési utakat beállítani):

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

A MultimediaViewer kiterjesztés telepítése

A MultimediaViewer nem kötelező, azonban szükséges a modellek nagyításához és mozgatásához. Telepítés után hozzá kell rendelned az STL kiterjesztést a megjelenítőhöz; ehhez add hozzá a következőt a LocalSettings.php-hez:

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

Beállítás

Szabadalmi nyilatkozat

Speciális:Feltöltés

Szabadalmi opciók hozzáadásához a MediaWiki:3d-patents lapot kell módosítanod. A lap minden egyes sora egy <választási lehetőség>, ahol az utolsó | utáni karakterek szövegként lesznek feldolgozva, a sablon előttiek pedig a feltöltési lap tartalmaként fognak megjelenni. Példáért lásd a commons:MediaWiki:3d-patents lapot.

Ne felejtsd el létrehozni a szükséges sablon(oka)t (például Template:3dpatent)!

Special:UploadWizard

A Special:UploadWizard is támogatja a szabadalmi nyilatkozatokat, azonban kevésbé rugalmasan. Harmadik féltől származó STL-fájl feltöltése esetén meg kell erősíteni, hogy az állomány nem sért szabadalmi jogot. Saját modell feltöltésekor meg kell erősítened, hogy a mű valóban saját alkotásod. A hozzáadott sablon a {{3dpatent}} vagy a {{3dpatent|ownwork}} lesz.

Az üzenetek a MediaWiki:Mwe-upwiz-patent-dialog-text-warranty és a MediaWiki:Mwe-upwiz-patent-dialog-text-license lapokon módosíthatóak.

A szabadalmi nyilatkozatot igénylő fájlok típusát, a sablonbeillesztés helyét, illetve az URL-eket a LocalSettings.php-ban állíthatod be. Alább az alapértelmezett konfigurációt láthatod:

$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',
	],
];

Kiterjesztés:CommonsMetadata

Végül: a Extension:CommonsMetadata kiterjesztéssel a 3D-feltöltések szabadalmi nyilatkozatok nélkül böngészhetőek, azonban ez nem kínál fel konfigurációs lehetőségeket. A kiterjesztés mindössze azon application/sla MIME-típusú (a 3D kiterjesztés által jelenleg támogatott) fájlokat keresi, amelyekről hiányzik a 3dpatent sablon. A hiányos leírólapú fájlok a Category:Files_with_no_machine-readable_patent kategóriába kerülnek.

Ha nem a 3dpatent sablont használod, a fenti nem működik, mivel ezt jelenleg nem lehet módosítani.