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.
MediaWiki	>= 1.43
Licenc	GNU General Public License 2.0 or later
Letöltés	Kiterjesztés letöltése Git [?]: Git master letöltése tároló böngészése (GitHub) verziótörténet a tároló közreműködői (GitHub) kódellenőrzés
Paraméterek $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Hooks used BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	101 (Ranked 53rd)
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.