Rozšíření:3D

Příručka k rozšířením MediaWiki

3D Stav rozšíření: beta
Implementace	Média
Popis	Poskytuje podporu pro soubory typu 3D.
Autoři	Gilles Dubuc Matthias Mullie Mark Holmquist
Nejnovější verze	0.0.1
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	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í	89 (Ranked 56th)
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ý.

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

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

• 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.

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

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';

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

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.

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Miraheze WikiForge Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.