Extension: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í.
Parametry $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Použité háčky (hooks) BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Nápověda	Help:Extension:3D/cs
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.