Rozšíření:3D

Základní informace k tomuto rozšíření MediaWiki

3D Stav rozšíření: beta
Zavádění	Média
Popis	Poskytuje podporu pro soubory typu 3D.
Napsal(i)	Gilles Dubuc Matthias Mullie Mark Holmquist
Nejnovější verze	0.0.1
Zásady kompatibility	Vydání snímků následuje MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	>= 1.41
Licence	GNU General Public License 2.0 nebo pozdější
Zdrojový kód	Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu
Nápověda	Help:Extension:3D/cs
Parametry $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Použité háčky (hooks) BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Čtvrtletní stahování	93 (Ranked 82nd)
Vagrant role	three_d
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření 3D umožňuje uživateli wiki možnost načítat a prohlížet 3D modely. Dokumentaci pro použití naleznete na stránce Nápověda:Rozšíření:3D .

Aktuálně podporuje souborový formát STL, který je v oblasti 3D tisku běžný.

Instalace

Povolení načítání 3D souborů

Řekne MediaWiki, že smí načítat STL soubory. Přidejte do svého LocalSettings.php následující:

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

Instalace Rozšíření:3D

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného 3D ve vaší složce extensions/.
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( '3D' );
  

•  Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Instalace 3d2png

3d2png je vykreslování miniatur pro 3D soubory. Vykreslí miniatury png přesně tak, jako toto rozšíření zobrazí objekty, pomocí stejných knihoven JS spuštěných v Node.js namísto prohlížeče.

Chcete-li nainstalovat, naklonovat a aktivovat úložiště 3d2png:

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

V Linuxu si také budete muset nainstalovat virtuální framebuffer, abyste na 3d2png mohli bezhlavě zachytit 3D objekt.

apt-get install xvfb

Po úspěšné instalaci 3d2png budeme muset Extension:3D sdělit, jak volat tuto službu generátoru náhledů. Přidejte toto k vašemu LocalSettings.php a nezapomeňte aktualizovat cesty, aby odpovídaly vaší konfiguraci:

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

Instalace Extension:MultimediaViewer

MultimediaViewer není tvrdá závislost 3D rozšíření, ale budete si ho muset nainstalovat, pokud chcete s 3D modely pracovat (přesouvat, posouvat, přibližovat). Po instalaci MultimediaViewer budete muset přiřadit typ souboru STL ke správné příponě prohlížeče přidáním tohoto do svého souboru LocalSettings.php:

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

Konfigurace

Patentová smlouva

Special:Upload

Chcete-li přidat možnosti výběru patentové smlouvy do Special:Upload, upravte stránku MediaWiki:3d-patents vaší wiki. Každý řádek na této stránce se změní na <volba>, kde vše za posledním znakem | je text a vše před je šablona, která bude přidána do nahrávaného obsahu. Podívejte se na příklad commons:MediaWiki:3d-patents.

Ujistěte se, že jste vytvořili šablony, které budou přidány do obsahu. tj. Template:3dpatent

Special:UploadWizard

Special:UploadWizard také podporuje patentovou dohodu, i když o něco méně flexibilně. Při nahrávání souboru STL třetí strany se zobrazí dialogové okno pro potvrzení, že vaše nahrání neporušuje žádné patenty. Když nahrajete jeden z vašich vlastních, požádá vás také o potvrzení, že zobrazené 3D objekty jsou vaším vlastním dílem. Šablona přidaná k nahrávanému obsahu bude mít hodnotu {{3dpatent}} nebo {{3dpatent|ownwork}}.

Chcete-li změnit formulaci těchto zpráv, lze tyto stránky změnit: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

Chcete-li změnit, které typy souborů vyžadují patentovou dohodu, která šablona se přidá k nahrávanému obsahu nebo kam odkazují adresy URL, změňte LocalSettings.php. Níže jsou výchozí nastavení:

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

Extension:CommonsMetadata

A konečně, Rozšíření:CommonsMetadata poskytuje způsob, jak sledovat 3D nahrávání bez uvedené patentové licence, i když to není vůbec konfigurovatelné. Zkontroluje pouze nahrání s typem mime application/sla (v současnosti jediné podporované rozšířením: 3D), které postrádá šablonu 3dpatent. Odpovídající soubory bez této šablony ve svém obsahu budou automaticky přidány k Category:Files_with_no_machine-readable_patent.

Pokud používáte jinou šablonu než 3dpatent, nebude to pro vás užitečné, protože ji nelze aktuálně konfigurovat.